external/aurweb
0
0
Fork 0
mirror of https://gitlab.archlinux.org/archlinux/aurweb.git synced 2025-02-03 10:43:03 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
aurweb/migrations
History
Kevin Morris b5ff8581f3
feat(migrations): add upgrade_voteinfo_integers ref 
This migration modifies the Yes, No, Abstain and ActiveTUs columns
of the TUVoteInfo table from unsigned TINYINT to unsigned INTEGER.

TINYINT supports a total of 1 byte (up to 255 trusted users). This
is quite limited and we don't spend too much more by storing a
standard 4-byte INTEGER.

Signed-off-by: Kevin Morris <kevr@0cost.org>
2022-01-06 20:27:23 -08:00
..
versions feat(migrations): add upgrade_voteinfo_integers ref 2022-01-06 20:27:23 -08:00
env.py change(aurweb): add parallel tests and improve aurweb.db 2021-11-17 01:34:59 -08:00
README Set up Alembic for database migrations 2020-02-27 16:44:36 +01:00
script.py.mako Set up Alembic for database migrations 2020-02-27 16:44:36 +01:00

README 

This directory contains Alembic's environment for managing database migrations.

From Alembic's documentation: Alembic is a lightweight database migration tool
for usage with the SQLAlchemy Database Toolkit for Python.
https://alembic.sqlalchemy.org/en/latest/index.html


Upgrading to the latest version
-------------------------------

Simply run `alembic upgrade head` from aurweb's root.


Creating new migrations
-----------------------

When working with Alembic and SQLAlchemy, you should never edit the database
schema manually. Please proceed like this instead:

1. Edit `aurweb/schema.py` to your liking.
2. Run `alembic revision --autogenerate -m "your message"`
3. Proofread the generated migration.
4. Run `alembic upgrade head` to apply the changes to the database.
5. Commit the new migration.

To revert a migration, you may run `alembic downgrade -1` and then manually
delete the migration file. Note that SQLite is limited and that it's sometimes
easier to recreate the database.

For anything more complicated, please read Alembic's documentation.


Troubleshooting
---------------

- `ModuleNotFoundError: No module named 'aurweb'`

  You may either install the aurweb module with pip, or set PYTHONPATH to your
  aurweb repository. Since alembic must be run from the aurweb root, you may
  simply use: `PYTHONPATH=. alembic [...]`.

- `FAILED: No config file 'alembic.ini' found, or file has no '[alembic]' section`

  You need to run Alembic from the project's root, and not from `migrations/`.

- `configparser.NoSectionError: No section: 'database'`

  You need to set AUR_CONFIG, as explained in `TESTING`.