No project description provided
Project description
atlas-provider-django
Load Django models into an Atlas project.
Use-cases
- Declarative migrations - use a Terraform-like
atlas schema apply --env django
to apply your Django schema to the database. - Automatic migration planning - use
atlas migrate diff --env django
to automatically plan a migration from the current database version to the Django schema.
Installation
Install Atlas for macOS or Linux by running:
curl -sSf https://atlasgo.sh | sh
See atlasgo.io for more installation options.
Install the provider by running:
pip install atlas-provider-django
Configuration
Add the provider to your Django project's INSTALLED_APPS
in settings.py
:
INSTALLED_APPS = [
...,
'atlas_provider_django',
...
]
In your project directory, create a new file named atlas.hcl
with the following contents:
data "external_schema" "django" {
program = [
"python",
"manage.py",
"atlas-provider-django",
"--dialect", "mysql" // mariadb | postgresql | sqlite | mssql
// if you want to only load a subset of your app models, you can specify the apps by adding
// "--apps", "app1", "app2", "app3"
]
}
env "django" {
src = data.external_schema.django.url
dev = "docker://mysql/8/dev"
migration {
dir = "file://migrations"
}
format {
migrate {
diff = "{{ sql . \" \" }}"
}
}
}
Usage
Apply
You can use the atlas schema apply
command to plan and apply a migration of your database to your current Django schema.
This works by inspecting the target database and comparing it to the Django Apps models and creating a migration plan.
Atlas will prompt you to confirm the migration plan before applying it to the database.
atlas schema apply --env django -u "mysql://root:password@localhost:3306/mydb"
Where the -u
flag accepts the URL to the
target database.
Diff
Atlas supports a versioned migrations
workflow, where each change to the database is versioned and recorded in a migration file. You can use the
atlas migrate diff
command to automatically generate a migration file that will migrate the database
from its latest revision to the current Django schema.
atlas migrate diff --env django
Supported Databases
The provider supports the following databases:
- MySQL
- MariaDB
- PostgreSQL
- SQLite
- Microsoft SQL Server
Issues
Please report any issues or feature requests in the ariga/atlas repository.
License
This project is licensed under the Apache License 2.0.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for atlas_provider_django-0.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | f4f8f01790391df907d62c608b753707204ecb514b4890499773f142d240e3bf |
|
MD5 | c6c7fd5032f57af9d5bda626923e8fe9 |
|
BLAKE2b-256 | 490e1369ff280b08aeeeca4325ec5593be7cf896f8ccdbdf774675bafe083c96 |
Hashes for atlas_provider_django-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb7f756a97f575390822cd060e646c3a0d387826c7fb4cb6c5832907e66cb8f6 |
|
MD5 | 2acf576e20479fc7426e7d0ab7d3429d |
|
BLAKE2b-256 | f33b0ad8e5ad182720b766afa6856cb99b25ac18e4dd5411b065b72160dc671d |