Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
django-cloud-provider-zones
Django app providing a static list of cloud provider regions and AZs
Readme
https://pypi.org/project/django-cloud-provider-zones/
For reference, and for use outside of Django, region_data/normalized_azs.json and region_data/normalized_regions.json contain all generated region and az names.
This Django app provides a static list of region and availability zones for AWS (Amazon Web Services) and GCP (Google Cloud Platform) cloud providers.
The purpose of this app is to provide Cloud Provider Region/AZ lists easily available to Django apps. It provides stable, shortened, versions of names for provisioning naming conventions.
The Regions/AZ list is currrent as of March 2024.
pip install django-cloud-provider-zones
Add to project's settings.py INSTALLED_APPS:
'rest_framework',
'django_cloud_provider_zones',
Optionally, include the DRF REST urls in your project's urls.py
:
from django.contrib import admin
from django.urls import path, include
import django_cloud_provider_zones
urlpatterns = [
path('admin/', admin.site.urls),
path('api/cloudzones/', include('django_cloud_provider_zones.urls')),
]
Import model data
./manage.py loaddata django_cloud_provider_zones-CloudProvider django_cloud_provider_zones-CloudRegion django_cloud_provider_zones-CloudAvailabilityZone
If exposed via the Django admin, it is recommended that these App's models are "read only" so grant only View permissions.
This app provides the following models:
CloudProvider
: Cloud provider names - currently AWS
or GCP
CloudRegion
: Cloud regionsCloudAvailabilityZone
: Availability zones within a regionEach region and AZ provides, as properties, short name versions with dashes removed. For example, AWS us-east-1
has names
short_name: use1
short_name_with_provider: awsuse1
## CloudProvider ##
>>> CloudProvider.objects.values().first()
{'provider': 'aws'}
## CloudRegion ##
>>> CloudRegion.objects.values().first()
{'cardinality': 'northeast',
'created': datetime.date(2024, 3, 27),
'geographic_region': 'ap',
'id': 11,
'number': '1',
'original_region_name': 'ap-northeast-1',
'provider_id': 'aws'}
>>> CloudRegion.objects.first().short_name
'apne1'
>>> CloudRegion.objects.first().short_name_with_provider
'awsapne1'
## CloudAvailabilityZone ##
>>> CloudAvailabilityZone.objects.values().first()
{'az': 'a', 'created': datetime.date(2024, 3, 27), 'id': 27, 'region_id': 11}
>>> CloudAvailabilityZone.objects.first().short_name
'apne1a'
>>> CloudAvailabilityZone.objects.first().short_name_with_provider
'awsapne1a'
Regions and AZs use Django "natural keys" which allows filtering by the Provider's region name
## Region natural key ##
>>> CloudRegion.objects.first().natural_key()
('aws', 'ap-northeast-1')
>>> CloudRegion.objects.get_by_natural_key("aws", "us-east-1")
<CloudRegion: aws-us-east-1>
## AZ natural key ##
>>> CloudAvailabilityZone.objects.first().natural_key()
('a', ('aws', 'ap-northeast-1'))
>>> CloudAvailabilityZone.objects.get_by_natural_key('a', ('aws', 'ap-northeast-1'))
<CloudAvailabilityZone: aws-ap-northeast-1a>
All generated names are exported to these files for reference
tasks/django_management_commands.py django_serialize_azs > region_data/normalized_azs.json
tasks/django_management_commands.py django_serialize_regions > region_data/normalized_regions.json
Basic REST Get endpoints available see urls.py
To add a new provider, activate the poetry virtualenv with poetry shell && poetry install
Fetch raw json from the provider's API or cli tool, save it to region_data/PROVIDER_unprocessed.json see AWS and GCP examples. Create tasks/format_json_PROVIDER which creates properly formatted json files
region_data/PROVIDER_provider.json
region_data/PROVIDER_region.json
region_data/PROVIDER_az.json
see AWS and GCP examples.
Add new provider CLOUD_PROVIDERS
in tasks/update_db_from_json.py
then run
tasks/django_management_commands.py django_makemigrations
tasks/django_management_commands.py django_migrate
tasks/django_management_commands.py django_update_fixture_from_json
Once that looks good add a couple simple tests to src/django_cloud_provider_zones/tests.py then
tasks/django_management_commands.py django_test
Bump version, commit and push as needed.
poetry version patch && poetry publish
Contributions are welcome! Please feel free to open issues or submit pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
FAQs
Django app providing a static list of cloud provider regions and AZs
We found that django-cloud-provider-zones demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.