Metadata-Version: 2.1
Name: tortoise-data-migration
Version: 0.1.9
Summary: Tortoise migrations for data, not structure
License: MIT
Author-email: Guillermo Manzato <manzato@ekumenlabs.com>
Requires-Python: >=3.8
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Database
Project-URL: Documentation, https://github.com/Ekumen-OS/tortoise-data-migration
Project-URL: Repository, https://github.com/Ekumen-OS/tortoise-data-migration
Project-URL: homepage, https://github.com/Ekumen-OS/tortoise-data-migration
Description-Content-Type: text/markdown
Description: # tortoise-data-migration
        
        [![tests](https://github.com/Ekumen-OS/tortoise-data-migration/actions/workflows/tests.yaml/badge.svg)](https://github.com/Ekumen-OS/tortoise-data-migration/actions/workflows/tests.yaml)
        [![codecov](https://codecov.io/gh/Ekumen-OS/tortoise-data-migration/branch/main/graph/badge.svg?token=P92AYYHAR1)](https://codecov.io/gh/Ekumen-OS/tortoise-data-migration)
        [![black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
        [![pdm-managed](https://img.shields.io/badge/pdm-managed-blueviolet)](https://pdm.fming.dev)
        ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/tortoise-data-migration)
        ![PyPI - Wheel](https://img.shields.io/pypi/wheel/tortoise-data-migration)
        ![PyPI](https://img.shields.io/pypi/v/tortoise-data-migration?logo=python)
        
        `tortoise-data-migration` is a very simple project meant to perform migrations of data, similar to regular structural migrations.
        
        The main use case is when your system has some "default data" that needs to exist for the system to work. Some examples:
         - The default username/password of a system
         - The default configuration values (if you store the config in the DB)
        
        These values could be set in the system as part of the installation process, but then when writing tests that use those,
        you would have to somehow get those values to the DB. So you create a test fixture, and very probably you will be
        introducing duplication (the bringup/installation process has these values, and the fixture too).
        
        tortoise-data-migrations are meant to be executed by the software (either during test execution of production) after the
        database structure is up-to-date (in production software after running [aerich](https://github.com/tortoise/aerich) migrations for example
        or during tests after the DB setup is done), but before the actual software starts executing. That's why
        `tortoise-data-migration` is a library and not a command line tool.
        
        
        ## Installation
        
        ### Pip
        
        `pip install tortoise-data-migration`
        
        ### Pipenv
        
        `pipenv install tortoise-data-migration`
        
        ### PDM
        
        `pdm add tortoise-data-migration`
        
        ## Notes for maintainers
        
        ### Release
        
        To create a new release, create a github release and a github action will take care of building and publishing. After
        that, the version in `main` should be bumped to the next release.

