minimi-para 0.1.0__tar.gz

minimi_para-0.1.0/AUTHORS

@@ -0,0 +1 @@
+The Minimi was created by Petr Jindra

minimi_para-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Authors and contributors listed in the AUTHORS file
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

minimi_para-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: minimi-para
+Version: 0.1.0
+Summary: A mini migration tool
+Author-email: Petr Jindra <el.mordo@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/elmordo/minimi
+Project-URL: Repository, https://github.com/elmordo/minimi
+Keywords: migrations,sqlalchemy,database
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: sqlalchemy<3.0,>=2.0.52
+Requires-Dist: sa-values<0.2,>=0.1.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: dev
+Requires-Dist: sa-values[test]; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+**MINI**mal **MI**gration library tool for managing database migrations in small projects where
+a full-featured migration tool would be overkill.
+
+Why the "_para_" suffix? The original name of the library `minimi` was rejected by the pypi.org because
+it is too similar to another library. Also, the Minimi Para is compatct version of the original Minimi :-)
+
+```
+
+                                     ====
+             __@----------------\     \
+||=========||====             ===\_____\___________        // //
+||         ||====                                  |======|=| ALTER TABLE users DROP COLUMN email
+||=========||---_____======------------------------|=|     \\ \\
+               /   /  \\ /    \____________|      ||
+              /   /------                         ||
+             /___/                                ||
+                                                  ||
+                                                 ====
+```
+
+# Quick start
+
+Create a migration module in your source directory
+
+```
+src
+  +- mylib
+    +- migrations
+    |  +- __init__.py          <- list of migration modules
+    |  +- m01_db_init.py       <- first revision
+    |  +- m02_new_table.py     <- second revision
+    +- other module
+    +- main.py
+```
+
+```python
+# __init__.py
+
+from . import m01_db_init, m02_new_table
+
+MIGRATIONS = [
+    m01_db_init,
+    m02_new_table,
+]
+```
+
+```python
+# m01_db_init.py
+
+# the UP migration only
+MIGRATIONS = """
+CREATE TABLE IF NOT EXISTS users (
+    id INTEGER PRIMARY KEY,
+    name TEXT NOT NULL,
+    email TEXT NOT NULL UNIQUE
+);
+"""
+```
+
+```python
+# m02_new_table.py
+
+# the UP and DOWN migrations as tuple of two strings
+MIGRATIONS = """
+CREATE TABLE IF NOT EXISTS user_comments (
+    id INTEGER PRIMARY KEY,
+    user_id INTEGER NOT NULL
+        REFERENCES users(id),
+    subjects TEXT NOT NULL,
+    message TEXT NOT NULL
+);
+""", """
+DROP TABLE IF EXISTS user_comments;
+"""
+```
+
+```python
+# main.py
+
+from minimi import Minimi
+from sqlalchemy import create_engine
+from sa_values import setup_sa_values
+
+import mylib.migrations as migrations
+
+
+def main():
+    # initialize the sa_values first
+    conn = create_engine("sqlite:///:memory:").connect()
+    setup_sa_values(conn)
+    # run the migrations
+    Minimi(conn, migrations).apply()
+
+
+if __name__ == "__main__":
+    main()
+```
+
+# Usage
+
+The `__init__.py` file contains a list of migration modules in the `MIGRATIONS` global variable with list of migration
+modules.
+
+Each migration module must contain the `MIGRATION` global variable with the migration.
+
+# Buy me a ~~coffee~~ beer
+
+If you like this library, or you want to support its development, support me by one
+cold [beer](https://www.buymeacoffee.com/elmordo). The beer is tasty and full of vitamins :-)

minimi_para-0.1.0/README.md

@@ -0,0 +1,109 @@
+**MINI**mal **MI**gration library tool for managing database migrations in small projects where
+a full-featured migration tool would be overkill.
+
+Why the "_para_" suffix? The original name of the library `minimi` was rejected by the pypi.org because
+it is too similar to another library. Also, the Minimi Para is compatct version of the original Minimi :-)
+
+```
+
+                                     ====
+             __@----------------\     \
+||=========||====             ===\_____\___________        // //
+||         ||====                                  |======|=| ALTER TABLE users DROP COLUMN email
+||=========||---_____======------------------------|=|     \\ \\
+               /   /  \\ /    \____________|      ||
+              /   /------                         ||
+             /___/                                ||
+                                                  ||
+                                                 ====
+```
+
+# Quick start
+
+Create a migration module in your source directory
+
+```
+src
+  +- mylib
+    +- migrations
+    |  +- __init__.py          <- list of migration modules
+    |  +- m01_db_init.py       <- first revision
+    |  +- m02_new_table.py     <- second revision
+    +- other module
+    +- main.py
+```
+
+```python
+# __init__.py
+
+from . import m01_db_init, m02_new_table
+
+MIGRATIONS = [
+    m01_db_init,
+    m02_new_table,
+]
+```
+
+```python
+# m01_db_init.py
+
+# the UP migration only
+MIGRATIONS = """
+CREATE TABLE IF NOT EXISTS users (
+    id INTEGER PRIMARY KEY,
+    name TEXT NOT NULL,
+    email TEXT NOT NULL UNIQUE
+);
+"""
+```
+
+```python
+# m02_new_table.py
+
+# the UP and DOWN migrations as tuple of two strings
+MIGRATIONS = """
+CREATE TABLE IF NOT EXISTS user_comments (
+    id INTEGER PRIMARY KEY,
+    user_id INTEGER NOT NULL
+        REFERENCES users(id),
+    subjects TEXT NOT NULL,
+    message TEXT NOT NULL
+);
+""", """
+DROP TABLE IF EXISTS user_comments;
+"""
+```
+
+```python
+# main.py
+
+from minimi import Minimi
+from sqlalchemy import create_engine
+from sa_values import setup_sa_values
+
+import mylib.migrations as migrations
+
+
+def main():
+    # initialize the sa_values first
+    conn = create_engine("sqlite:///:memory:").connect()
+    setup_sa_values(conn)
+    # run the migrations
+    Minimi(conn, migrations).apply()
+
+
+if __name__ == "__main__":
+    main()
+```
+
+# Usage
+
+The `__init__.py` file contains a list of migration modules in the `MIGRATIONS` global variable with list of migration
+modules.
+
+Each migration module must contain the `MIGRATION` global variable with the migration.
+
+# Buy me a ~~coffee~~ beer
+
+If you like this library, or you want to support its development, support me by one
+cold [beer](https://www.buymeacoffee.com/elmordo). The beer is tasty and full of vitamins :-)

minimi_para-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "minimi-para"
+version = "0.1.0"
+description = "A mini migration tool"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+  { name = "Petr Jindra", email = "el.mordo@gmail.com" }
+]
+keywords = ["migrations", "sqlalchemy", "database"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+  "sqlalchemy>=2.0.52,<3.0",
+  "sa-values>=0.1.0,<0.2"
+]
+
+[project.optional-dependencies]
+test = [
+  "pytest",
+]
+dev = [
+  "sa-values[test]",
+  "build",
+  "twine",
+]
+
+[project.urls]
+Homepage = "https://github.com/elmordo/minimi"
+Repository = "https://github.com/elmordo/minimi"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint.isort]
+force-sort-within-sections = true
+order-by-type = false
+lines-after-imports = 2
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true

minimi_para-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

minimi_para-0.1.0/src/minimi/__init__.py

@@ -0,0 +1,26 @@
+# MIT License
+#
+# Copyright (c) 2026 Authors and contributors listed in the AUTHORS file
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+from .minimi import Minimi
+
+
+__all__ = ["Minimi"]

minimi_para-0.1.0/src/minimi/exceptions.py

@@ -0,0 +1,33 @@
+# MIT License
+#
+# Copyright (c) 2026 Authors and contributors listed in the AUTHORS file
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+
+class MinimiException(Exception):
+    pass
+
+
+class MigrationFailedError(MinimiException):
+    pass
+
+
+class InvalidModuleStructureError(MinimiException):
+    pass

minimi_para-0.1.0/src/minimi/migrations.py

@@ -0,0 +1,136 @@
+# MIT License
+#
+# Copyright (c) 2026 Authors and contributors listed in the AUTHORS file
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+from dataclasses import dataclass
+
+from sqlalchemy import Connection, text
+
+from .exceptions import InvalidModuleStructureError
+from .types import MigrationCallback, MigrationModule, MigrationStatement, MigrationStep
+
+
+@dataclass
+class MigrationCallbackPair:
+    """Container for normalized migration step logic.
+
+    The `up` contains a callback called when migration is applied.
+    The `down` contains a callback called when migration is rolled back.
+
+    Both callbacks must be defined, even if the migration logic for the step part is empty.
+    """
+
+    up: MigrationCallback
+    down: MigrationCallback
+
+
+def normalize_migration_steps(
+        steps: MigrationStep | list[MigrationStep],
+) -> list[MigrationCallbackPair]:
+    """Get a list of migration steps in generic format (see the `MigrationStep` type) and convert
+    it into the list of `MigrationCallbackPair` instances.
+
+    Each step can be one of the following variants:
+
+    * `None` or `tuple[None, None]` - the empty step is converted to the "noop-noop" pair
+    * `str | MigrationCallback` or `tuple[str | MigrationCallback, None]` - up-only step is converted to "up-noop" pair
+    * `tuple[str | MigrationCallback, str | MigrationCallback]` - the full step is converted to the "up-down" pair
+    * `tuple[None, str | MigrationCallback]` - down-only step is converted to "noop-down" pair
+    """
+    steps = _generic_steps_to_list(steps)
+    return [_step_to_callback_pair(s) for s in steps]
+
+
+def get_migration_name(mod: MigrationModule) -> str:
+    """Extract migration name from the module
+
+    Raises:
+        InvalidModuleStructureError: If module does not have the `__name__` attribute
+    """
+    try:
+        return mod.__name__
+    except AttributeError:
+        raise InvalidModuleStructureError(
+            f"Module {mod} does not have __name__ attribute. "
+            "Make sure that module is a valid Python module.",
+        )
+
+
+def noop_migration(_conn: Connection):
+    """Follows the migration callback interface and do nothing"""
+
+
+def _generic_steps_to_list(steps: MigrationStep | list[MigrationStep]) -> list[MigrationStep]:
+    """Convert migration steps into a list of migration steps.
+
+    The `steps` could be:
+
+    * a single migration step - the step is wrapped into the list with the single item
+    * a list of migration steps - a copy of the list is returned
+    """
+    if isinstance(steps, list):
+        # nothing to do - list of steps
+        return list(steps)
+    else:
+        # single step
+        return [steps]
+
+
+def _step_to_callback_pair(step: MigrationStep | None) -> MigrationCallbackPair:
+    """Convert a generic step into a `MigrationCallbackPair` instance.
+
+    See the `normalize_migration_steps` function for more details.
+    """
+    step_tuple = _step_to_tuple(step)
+    up = _statement_to_callback(step_tuple[0])
+    down = _statement_to_callback(step_tuple[1])
+    return MigrationCallbackPair(up, down)
+
+
+def _step_to_tuple(
+        step: MigrationStep | None,
+) -> tuple[MigrationStatement | None, MigrationStatement | None]:
+    """Convert step to tuple. Each element of the tuple is a migration statement or `None`."""
+    if step is None:
+        return None, None
+    elif isinstance(step, tuple):
+        return step
+    else:
+        return step, None
+
+
+def _statement_to_callback(stmt: MigrationStatement | None) -> MigrationCallback:
+    """Check the type of the stmt. If it is the `str`, convert it into the callback"""
+
+    if stmt is None:
+        return noop_migration
+    if callable(stmt):
+        return stmt
+    else:
+        return _make_callback_from_string(stmt)
+
+
+def _make_callback_from_string(stmt: str) -> MigrationCallback:
+    """Convert the string statement into the `MigrationCallback`."""
+
+    def _callback(conn: Connection):
+        conn.execute(text(stmt))
+
+    return _callback

minimi_para-0.1.0/src/minimi/minimi.py

@@ -0,0 +1,115 @@
+# MIT License
+#
+# Copyright (c) 2026 Authors and contributors listed in the AUTHORS file
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+from sa_values import SaValues
+from sqlalchemy import Connection
+from sqlalchemy.exc import DBAPIError
+
+from .exceptions import InvalidModuleStructureError, MigrationFailedError
+from .migrations import get_migration_name, MigrationCallbackPair, normalize_migration_steps
+from .types import MigrationCallback, MigrationModule
+
+
+class Minimi:
+    """Apply or roll back migrations"""
+
+    SA_VALUE_MIGRATION_KEY = "minimi.migration"
+
+    def __init__(self, connection: Connection, migrations: list[MigrationModule]):
+        self.connection = connection
+        self.migrations = migrations
+        self._applied_migrations = SaValues(self.connection).multi_value_key(
+            self.SA_VALUE_MIGRATION_KEY,
+        )
+
+    def apply(self):
+        """Apply all unapplied migrations"""
+        applied_migrations = set(self._applied_migrations.get_all())
+        for mod in self.migrations:
+            migration_name = get_migration_name(mod)
+            if migration_name in applied_migrations:
+                continue
+            self._apply_migration(mod)
+
+            try:
+                self._applied_migrations.add(migration_name)
+            except Exception:
+                try:
+                    self._rollback_migration(mod)
+                except Exception:  # noqa
+                    # TODO: log error and better exception catching
+                    pass
+
+                raise
+
+    def rollback(self):
+        """Roll back all migrations"""
+        applied_migrations = set(self._applied_migrations.get_all())
+
+        for m in reversed(self.migrations):
+            migration_name = get_migration_name(m)
+            if migration_name not in applied_migrations:
+                continue
+            self._rollback_migration(m)
+            self._applied_migrations.delete(migration_name)
+
+    def _apply_migration(self, mod: MigrationModule) -> None:
+        """Apply a single migration module"""
+        steps = self._get_normalized_steps(mod)
+        applied_steps = []
+        for step in steps:
+            try:
+                self._call_callback(step.up)
+            except MigrationFailedError:
+                for revert_step in reversed(applied_steps):
+                    try:
+                        self._call_callback(revert_step.down)
+                    except MigrationFailedError:
+                        # stop on rollback failure
+                        break
+                raise
+            applied_steps.append(step)
+
+    def _rollback_migration(self, mod: MigrationModule) -> None:
+        """Roll back a single migration module"""
+        steps = self._get_normalized_steps(mod)
+        for step in reversed(steps):
+            self._call_callback(step.down)
+
+    def _call_callback(self, cbk: MigrationCallback | None):
+        """Call the migration callback and handle DB related errors."""
+        if cbk is None:
+            return
+
+        try:
+            cbk(self.connection)
+        except DBAPIError as err:
+            raise MigrationFailedError from err
+
+    @staticmethod
+    def _get_normalized_steps(mod) -> list[MigrationCallbackPair]:
+        try:
+            return normalize_migration_steps(mod.MIGRATIONS)
+        except AttributeError:
+            raise InvalidModuleStructureError(
+                f"Module {mod.__name__} does not have a MIGRATIONS attribute",
+            )

minimi_para-0.1.0/src/minimi/types.py

@@ -0,0 +1,45 @@
+# MIT License
+#
+# Copyright (c) 2026 Authors and contributors listed in the AUTHORS file
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+from collections.abc import Callable
+from typing import Protocol
+
+from sqlalchemy import Connection
+
+
+MigrationCallback = Callable[[Connection], None]
+
+MigrationStatement = str | MigrationCallback
+"""Single migration statement or callable with execution logic"""
+
+MigrationStep = MigrationStatement | tuple[MigrationStatement | None, MigrationStatement | None]
+"""One step of migration. One migration can contain multiple steps"""
+
+
+class MigrationModule(Protocol):
+    """Each migration module must contain list of migrations in the `MIGRATIONS` global variable."""
+
+    __name__: str
+    """Name of the migration module"""
+
+    MIGRATIONS: MigrationStep | list[MigrationStep]
+    """Migration step or list of migration steps. The container MUST be the `list`"""

minimi_para-0.1.0/src/minimi_para.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: minimi-para
+Version: 0.1.0
+Summary: A mini migration tool
+Author-email: Petr Jindra <el.mordo@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/elmordo/minimi
+Project-URL: Repository, https://github.com/elmordo/minimi
+Keywords: migrations,sqlalchemy,database
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: sqlalchemy<3.0,>=2.0.52
+Requires-Dist: sa-values<0.2,>=0.1.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: dev
+Requires-Dist: sa-values[test]; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+**MINI**mal **MI**gration library tool for managing database migrations in small projects where
+a full-featured migration tool would be overkill.
+
+Why the "_para_" suffix? The original name of the library `minimi` was rejected by the pypi.org because
+it is too similar to another library. Also, the Minimi Para is compatct version of the original Minimi :-)
+
+```
+
+                                     ====
+             __@----------------\     \
+||=========||====             ===\_____\___________        // //
+||         ||====                                  |======|=| ALTER TABLE users DROP COLUMN email
+||=========||---_____======------------------------|=|     \\ \\
+               /   /  \\ /    \____________|      ||
+              /   /------                         ||
+             /___/                                ||
+                                                  ||
+                                                 ====
+```
+
+# Quick start
+
+Create a migration module in your source directory
+
+```
+src
+  +- mylib
+    +- migrations
+    |  +- __init__.py          <- list of migration modules
+    |  +- m01_db_init.py       <- first revision
+    |  +- m02_new_table.py     <- second revision
+    +- other module
+    +- main.py
+```
+
+```python
+# __init__.py
+
+from . import m01_db_init, m02_new_table
+
+MIGRATIONS = [
+    m01_db_init,
+    m02_new_table,
+]
+```
+
+```python
+# m01_db_init.py
+
+# the UP migration only
+MIGRATIONS = """
+CREATE TABLE IF NOT EXISTS users (
+    id INTEGER PRIMARY KEY,
+    name TEXT NOT NULL,
+    email TEXT NOT NULL UNIQUE
+);
+"""
+```
+
+```python
+# m02_new_table.py
+
+# the UP and DOWN migrations as tuple of two strings
+MIGRATIONS = """
+CREATE TABLE IF NOT EXISTS user_comments (
+    id INTEGER PRIMARY KEY,
+    user_id INTEGER NOT NULL
+        REFERENCES users(id),
+    subjects TEXT NOT NULL,
+    message TEXT NOT NULL
+);
+""", """
+DROP TABLE IF EXISTS user_comments;
+"""
+```
+
+```python
+# main.py
+
+from minimi import Minimi
+from sqlalchemy import create_engine
+from sa_values import setup_sa_values
+
+import mylib.migrations as migrations
+
+
+def main():
+    # initialize the sa_values first
+    conn = create_engine("sqlite:///:memory:").connect()
+    setup_sa_values(conn)
+    # run the migrations
+    Minimi(conn, migrations).apply()
+
+
+if __name__ == "__main__":
+    main()
+```
+
+# Usage
+
+The `__init__.py` file contains a list of migration modules in the `MIGRATIONS` global variable with list of migration
+modules.
+
+Each migration module must contain the `MIGRATION` global variable with the migration.
+
+# Buy me a ~~coffee~~ beer
+
+If you like this library, or you want to support its development, support me by one
+cold [beer](https://www.buymeacoffee.com/elmordo). The beer is tasty and full of vitamins :-)

minimi_para-0.1.0/src/minimi_para.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+AUTHORS
+LICENSE
+README.md
+pyproject.toml
+src/minimi/__init__.py
+src/minimi/exceptions.py
+src/minimi/migrations.py
+src/minimi/minimi.py
+src/minimi/types.py
+src/minimi_para.egg-info/PKG-INFO
+src/minimi_para.egg-info/SOURCES.txt
+src/minimi_para.egg-info/dependency_links.txt
+src/minimi_para.egg-info/requires.txt
+src/minimi_para.egg-info/top_level.txt

minimi_para-0.1.0/src/minimi_para.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

minimi_para-0.1.0/src/minimi_para.egg-info/requires.txt

@@ -0,0 +1,10 @@
+sqlalchemy<3.0,>=2.0.52
+sa-values<0.2,>=0.1.0
+
+[dev]
+sa-values[test]
+build
+twine
+
+[test]
+pytest

minimi_para-0.1.0/src/minimi_para.egg-info/top_level.txt

@@ -0,0 +1 @@
+minimi