Update migration script to handle multiple migrations automatically #425

[joelvdavies]

Description

See #425. In its current form this PR replicates similar behaviour to alembic. New migrations can be added using

ims-migrate generate test_migration "Does nothing"

Then the last migration applied is stored inside the database, and looked up to determine which migrations need to be applied in order to reach a desired one e.g.

ims-migrate forward latest

Applies all unapplied forward migrations in a single transaction. (This asks first although it would be simple to add a -y and even do what others do with alembic and put this in the docker file on start up - but its only a single command now anyway.)

This should hopefully make it easier to to apply the required migrations in the right order without specifying a list of migrations to perform when its time to update production.

Notes

• The changes applied outside of a transaction e.g. dropping collections still occurs outside of the transaction but will be applied after all of the migrations have inside so these operations will technically be out of order

Testing instructions

Add a set up instructions describing how the reviewer should test the code

• Review code
• Check Actions build
• Review changes to test coverage
• Test creating a new migration and migrating forward and backwards locally

Agile board tracking

Closes #425

[codecov]

Codecov Report

Attention: Patch coverage is 98.05825% with 2 lines in your changes missing coverage. Please review.

Project coverage is 97.89%. Comparing base (b742092) to head (b728441).
Report is 29 commits behind head on develop.

Files with missing lines	Patch %	Lines
inventory_management_system_api/migrations/base.py	88.23%	2 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #430      +/-   ##
===========================================
- Coverage    97.92%   97.89%   -0.04%     
===========================================
  Files           45       48       +3     
  Lines         1594     1712     +118     
===========================================
+ Hits          1561     1676     +115     
- Misses          33       36       +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[asuresh-code]

Looks good overall and works well. Just have some comments to make on core.py and some minor ones for the test.

[asuresh-code]

Just some more minor docstring comments.

[asuresh-code]

Also, the base.py file is missing full stops in most of the docstring comments.