diff options
| -rw-r--r-- | CHANGELOG.rst | 1 | ||||
| -rw-r--r-- | Makefile | 5 | ||||
| -rw-r--r-- | docs/contributing.rst | 16 |
3 files changed, 21 insertions, 1 deletions
diff --git a/CHANGELOG.rst b/CHANGELOG.rst index b184203..2c52315 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -41,6 +41,7 @@ Added - Improve settings documentation styling (#251) - Add a ihatemoney delete-project command to delete a project (#375) - Add nice 404 error pages (#379) +- Document database migrations (#390) Changed ======= @@ -61,6 +61,11 @@ create-database-revision: ## Create a new database revision @read -p "Please enter a message describing this revision: " rev_message; \ $(PYTHON) -m ihatemoney.manage db migrate -d ihatemoney/migrations -m "$${rev_message}" +.PHONY: create-empty-database-revision +create-empty-database-revision: ## Create an empty database revision + @read -p "Please enter a message describing this revision: " rev_message; \ + $(PYTHON) -m ihatemoney.manage db revision -d ihatemoney/migrations -m "$${rev_message}" + .PHONY: build-requirements build-requirements: ## Save currently installed packages to requirements.txt $(VIRTUALENV) $(TEMPDIR) diff --git a/docs/contributing.rst b/docs/contributing.rst index 1944d67..4b9e58b 100644 --- a/docs/contributing.rst +++ b/docs/contributing.rst @@ -39,7 +39,6 @@ Accessing dev server In any case, you can point your browser at `http://localhost:5000 <http://localhost:5000>`_. It's as simple as that! - Updating -------- @@ -47,6 +46,21 @@ In case you want to update to newer versions (from git), you can just run the "u make update +Create database migrations +-------------------------- + +In case you need to modify the database schema, first update the models in ihatemoney/models.py. +Then run the following command to create a new database revision file:: + + make create-database-revision + +If your changes are simple enough, the generated script will be populated with +the necessary migrations steps. +For complex migrations, it is recommended to start from an empty revision file which can be created +with the following command:: + + make create-empty-database-revision + Useful settings ---------------- |