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 altas-provider-django
Configuration
Add the provider to your Django project's INSTALLED_APPS
in settings.py
:
INSTALLED_APPS = [
...,
'altas_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
// 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
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.1.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a0935510e74334adb74173972bab0b37e568760257c697f639a27445cdfac157 |
|
MD5 | 05a6d1d032633090505727538ddfaa37 |
|
BLAKE2b-256 | 77a871de10dd54586af4c1bcc26fadea3bb8a880d1fd00e979c76cd3694602dc |
Hashes for atlas_provider_django-0.1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2ab39d08233007b9cf56fb98f4cc9b2cc197628395d56eb88b41038b15f638f7 |
|
MD5 | d2f23cc3e0a9184192f64b0e3a315acb |
|
BLAKE2b-256 | f7266ff7c1433181b001f3acda2541728f421bb7ef7de5f12d2501c967e7ec3a |