sqlalchemyseed 2.0.0__tar.gz → 2.2.0__tar.gz

{sqlalchemyseed-2.0.0 → sqlalchemyseed-2.2.0}/PKG-INFO

@@ -1,25 +1,27 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: sqlalchemyseed
-Version: 2.0.0
+Version: 2.2.0
 Summary: SQLAlchemy Seeder
-Home-page: https://github.com/jedymatt/sqlalchemyseed
-Author: Jedy Matt Tabasco
-Author-email: jedymatt@gmail.com
-License: MIT
+Author-email: Jedy Matt Tabasco <hello@jedymatt.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jedymatt/sqlalchemyseed
 Project-URL: Documentation, https://sqlalchemyseed.readthedocs.io/
 Project-URL: Source, https://github.com/jedymatt/sqlalchemyseed
 Project-URL: Tracker, https://github.com/jedymatt/sqlalchemyseed/issues
 Keywords: sqlalchemy,orm,seed,seeder,json,yaml
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.7
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Provides-Extra: yaml
 License-File: LICENSE
+Requires-Dist: SQLAlchemy>=2.0
+Provides-Extra: yaml
+Requires-Dist: PyYAML>=6.0; extra == "yaml"
+Dynamic: license-file
 
 # sqlalchemyseed
 
@@ -87,6 +89,40 @@ data.json
 }
 ```
 
+## Command-line usage
+
+Seed a database directly from data files without writing Python:
+
+```shell
+sqlalchemyseed data.json --url sqlite:///app.db
+```
+
+The command accepts one or more files and/or directories (a directory seeds
+every `.json`/`.yaml`/`.yml` file inside it, in sorted order):
+
+```shell
+sqlalchemyseed seeds/ --url "$DATABASE_URL"
+sqlalchemyseed a.json b.yaml --url sqlite:///app.db
+```
+
+The database URL may be passed with `--url` or the `DATABASE_URL` environment
+variable. Model paths in the data files (e.g. `models.Person`) are resolved
+against the current working directory, so run the command from your project
+root.
+
+Options:
+
+- `--dry-run` — seed inside a transaction, then roll back (validate without writing)
+- `--seeder hybrid` — use `HybridSeeder` instead of the default `Seeder`
+- `--model models.Person` — required for CSV inputs, which are not self-describing
+- `--ref-prefix` — override the relationship reference prefix (default `!`)
+
+The same command is available as a module:
+
+```shell
+python -m sqlalchemyseed data.json --url sqlite:///app.db
+```
+
 ## Documentation
 
 <https://sqlalchemyseed.readthedocs.io/>
@@ -100,34 +136,38 @@ Report here in this link:
 
 First, Clone this [repository](https://github.com/jedymatt/sqlalchemyseed).
 
+This project uses [uv](https://docs.astral.sh/uv/) for dependency management and running tasks.
+
 ### Install dev dependencies
 
-Inside the folder, paste this in the terminal to install necessary dependencies:
+Inside the folder, sync the environment (uv creates the virtualenv and installs the project plus dev dependencies):
 
 ```shell
-pip install -r requirements.txt -r docs/requirements.txt
+uv sync
 ```
 
-Note: make sure you have the virtual environment and enabled, or if you are using vs code and docker then you can simply re-open this as container.
-
 ### Run tests
 
-Before running tests, make sure that the package is installed as editable:
+```shell
+uv run pytest
+```
+
+Run the tests against a specific Python version (uv downloads it if needed):
 
 ```shell
-python setup.py develop --user
+uv run --python 3.14 pytest
 ```
 
-Then run the test:
+Run the tests against the lowest supported dependencies (e.g. SQLAlchemy 2.0):
 
 ```shell
-pytest tests
+uv run --resolution lowest-direct pytest
 ```
 
-Run test with coverage
+Run tests with coverage:
 
 ```shell
-coverage run -m pytest
+uv run coverage run -m pytest
 ```
 
 Autobuild documentation

sqlalchemyseed-2.0.0/src/sqlalchemyseed.egg-info/PKG-INFO → sqlalchemyseed-2.2.0/README.md

@@ -1,26 +1,3 @@
-Metadata-Version: 2.1
-Name: sqlalchemyseed
-Version: 2.0.0
-Summary: SQLAlchemy Seeder
-Home-page: https://github.com/jedymatt/sqlalchemyseed
-Author: Jedy Matt Tabasco
-Author-email: jedymatt@gmail.com
-License: MIT
-Project-URL: Documentation, https://sqlalchemyseed.readthedocs.io/
-Project-URL: Source, https://github.com/jedymatt/sqlalchemyseed
-Project-URL: Tracker, https://github.com/jedymatt/sqlalchemyseed/issues
-Keywords: sqlalchemy,orm,seed,seeder,json,yaml
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-Provides-Extra: yaml
-License-File: LICENSE
-
 # sqlalchemyseed
 
 [![PyPI](https://img.shields.io/pypi/v/sqlalchemyseed)](https://pypi.org/project/sqlalchemyseed)
@@ -87,6 +64,40 @@ data.json
 }
 ```
 
+## Command-line usage
+
+Seed a database directly from data files without writing Python:
+
+```shell
+sqlalchemyseed data.json --url sqlite:///app.db
+```
+
+The command accepts one or more files and/or directories (a directory seeds
+every `.json`/`.yaml`/`.yml` file inside it, in sorted order):
+
+```shell
+sqlalchemyseed seeds/ --url "$DATABASE_URL"
+sqlalchemyseed a.json b.yaml --url sqlite:///app.db
+```
+
+The database URL may be passed with `--url` or the `DATABASE_URL` environment
+variable. Model paths in the data files (e.g. `models.Person`) are resolved
+against the current working directory, so run the command from your project
+root.
+
+Options:
+
+- `--dry-run` — seed inside a transaction, then roll back (validate without writing)
+- `--seeder hybrid` — use `HybridSeeder` instead of the default `Seeder`
+- `--model models.Person` — required for CSV inputs, which are not self-describing
+- `--ref-prefix` — override the relationship reference prefix (default `!`)
+
+The same command is available as a module:
+
+```shell
+python -m sqlalchemyseed data.json --url sqlite:///app.db
+```
+
 ## Documentation
 
 <https://sqlalchemyseed.readthedocs.io/>
@@ -100,34 +111,38 @@ Report here in this link:
 
 First, Clone this [repository](https://github.com/jedymatt/sqlalchemyseed).
 
+This project uses [uv](https://docs.astral.sh/uv/) for dependency management and running tasks.
+
 ### Install dev dependencies
 
-Inside the folder, paste this in the terminal to install necessary dependencies:
+Inside the folder, sync the environment (uv creates the virtualenv and installs the project plus dev dependencies):
 
 ```shell
-pip install -r requirements.txt -r docs/requirements.txt
+uv sync
 ```
 
-Note: make sure you have the virtual environment and enabled, or if you are using vs code and docker then you can simply re-open this as container.
-
 ### Run tests
 
-Before running tests, make sure that the package is installed as editable:
+```shell
+uv run pytest
+```
+
+Run the tests against a specific Python version (uv downloads it if needed):
 
 ```shell
-python setup.py develop --user
+uv run --python 3.14 pytest
 ```
 
-Then run the test:
+Run the tests against the lowest supported dependencies (e.g. SQLAlchemy 2.0):
 
 ```shell
-pytest tests
+uv run --resolution lowest-direct pytest
 ```
 
-Run test with coverage
+Run tests with coverage:
 
 ```shell
-coverage run -m pytest
+uv run coverage run -m pytest
 ```
 
 Autobuild documentation

sqlalchemyseed-2.2.0/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "sqlalchemyseed"
+description = "SQLAlchemy Seeder"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Jedy Matt Tabasco", email = "hello@jedymatt.dev" },
+]
+keywords = ["sqlalchemy", "orm", "seed", "seeder", "json", "yaml"]
+classifiers = [
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "SQLAlchemy>=2.0",
+]
+dynamic = ["version"]
+
+[project.optional-dependencies]
+yaml = [
+    "PyYAML>=6.0",
+]
+
+[project.scripts]
+sqlalchemyseed = "sqlalchemyseed.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/jedymatt/sqlalchemyseed"
+Documentation = "https://sqlalchemyseed.readthedocs.io/"
+Source = "https://github.com/jedymatt/sqlalchemyseed"
+Tracker = "https://github.com/jedymatt/sqlalchemyseed/issues"
+
+[dependency-groups]
+dev = [
+    "pytest>=7.0",
+    "coverage>=6.2",
+    "PyYAML>=6.0",
+]
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.dynamic]
+version = { attr = "sqlalchemyseed.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.uv]
+default-groups = ["dev"]

sqlalchemyseed-2.2.0/setup.cfg

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

{sqlalchemyseed-2.0.0 → sqlalchemyseed-2.2.0}/src/sqlalchemyseed/__init__.py

@@ -11,7 +11,7 @@ from . import util
 from . import attribute
 
 
-__version__ = "2.0.0"
+__version__ = "2.2.0"
 
 if __name__ == '__main__':
     pass

sqlalchemyseed-2.2.0/src/sqlalchemyseed/__main__.py

@@ -0,0 +1,6 @@
+"""Enable ``python -m sqlalchemyseed``."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

sqlalchemyseed-2.2.0/src/sqlalchemyseed/cli.py

@@ -0,0 +1,169 @@
+"""Command-line interface for seeding a database from data files."""
+
+import argparse
+import os
+import sys
+from pathlib import Path
+
+import sqlalchemy
+from sqlalchemy.orm import Session
+
+from . import loader
+from .seeder import HybridSeeder, Seeder
+
+_JSON_EXTENSIONS = {".json"}
+_YAML_EXTENSIONS = {".yaml", ".yml"}
+_CSV_EXTENSIONS = {".csv"}
+# Only self-describing formats are auto-discovered inside a directory. CSV
+# needs an explicit --model, so a CSV must be named as an individual file.
+_DISCOVERABLE_EXTENSIONS = _JSON_EXTENSIONS | _YAML_EXTENSIONS
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build the argument parser for the ``sqlalchemyseed`` command."""
+    parser = argparse.ArgumentParser(
+        prog="sqlalchemyseed",
+        description="Seed a database from JSON, YAML, or CSV data files.",
+    )
+    parser.add_argument(
+        "paths",
+        nargs="+",
+        metavar="PATH",
+        help="data files or directories to seed from",
+    )
+    parser.add_argument(
+        "--url",
+        help="SQLAlchemy database URL (defaults to the DATABASE_URL env var)",
+    )
+    parser.add_argument(
+        "--seeder",
+        choices=("basic", "hybrid"),
+        default="basic",
+        help="seeder to use (default: basic)",
+    )
+    parser.add_argument(
+        "--model",
+        help="model class path (e.g. models.Person) required for CSV inputs",
+    )
+    parser.add_argument(
+        "--ref-prefix",
+        default="!",
+        help="prefix marking relationship references (default: !)",
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="seed within a transaction but roll back instead of committing",
+    )
+    return parser
+
+
+def collect_files(paths) -> list:
+    """Expand each path into data files, walking directories in sorted order."""
+    files = []
+    for raw_path in paths:
+        files.extend(_files_in(Path(raw_path)))
+    return files
+
+
+def _files_in(path: Path) -> list:
+    """Return the data files contributed by a single path argument."""
+    if path.is_dir():
+        return _discover_directory(path)
+    if path.is_file():
+        return [path]
+    raise FileNotFoundError(f"path does not exist: {path}")
+
+
+def _discover_directory(directory: Path) -> list:
+    """Return the JSON/YAML files inside a directory, sorted by name."""
+    discovered = sorted(
+        child for child in directory.iterdir()
+        if child.suffix.lower() in _DISCOVERABLE_EXTENSIONS
+    )
+    if not discovered:
+        raise FileNotFoundError(
+            f"no JSON or YAML seed files found in directory: {directory}"
+        )
+    return discovered
+
+
+def load_file(path: Path, model=None) -> dict:
+    """Load entities from a single data file, dispatching on its extension."""
+    suffix = path.suffix.lower()
+    if suffix in _JSON_EXTENSIONS:
+        return loader.load_entities_from_json(str(path))
+    if suffix in _YAML_EXTENSIONS:
+        return loader.load_entities_from_yaml(str(path))
+    if suffix in _CSV_EXTENSIONS:
+        return _load_csv(path, model)
+    raise ValueError(f"unsupported file type: {path}")
+
+
+def _load_csv(path: Path, model) -> dict:
+    """Load entities from a CSV file, which requires an explicit model."""
+    if model is None:
+        raise ValueError(f"CSV input requires --model to name the target class: {path}")
+    return loader.load_entities_from_csv(str(path), model)
+
+
+def _make_seeder(name, session, ref_prefix):
+    """Return the seeder implementation selected on the command line."""
+    if name == "hybrid":
+        return HybridSeeder(session, ref_prefix=ref_prefix)
+    return Seeder(session, ref_prefix=ref_prefix)
+
+
+def _seed_all(seeder, files, model) -> int:
+    """Seed every file through the seeder and return the entity count."""
+    seeded = 0
+    for path in files:
+        seeder.seed(load_file(path, model))
+        seeded += len(seeder.instances)
+    return seeded
+
+
+def main(argv=None) -> int:
+    """Entry point for the ``sqlalchemyseed`` command."""
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    url = args.url or os.environ.get("DATABASE_URL")
+    if not url:
+        parser.error("a database URL is required via --url or the DATABASE_URL env var")
+
+    # Make the caller's project importable so model paths like "models.Person"
+    # resolve against the current working directory.
+    sys.path.insert(0, os.getcwd())
+
+    try:
+        files = collect_files(args.paths)
+    except FileNotFoundError as error:
+        parser.error(str(error))
+
+    engine = sqlalchemy.create_engine(url)
+    with Session(engine) as session:
+        seeder = _make_seeder(args.seeder, session, args.ref_prefix)
+        try:
+            seeded = _seed_all(seeder, files, args.model)
+        except Exception as error:  # noqa: BLE001 - report any seeding failure as a clean exit
+            session.rollback()
+            print(f"error: {error}", file=sys.stderr)
+            return 1
+
+        return _finish(session, seeded, len(files), args.dry_run)
+
+
+def _finish(session, seeded, file_count, dry_run) -> int:
+    """Commit or roll back the seeded session and print a summary."""
+    if dry_run:
+        session.rollback()
+        print(f"Dry run: would seed {seeded} entities from {file_count} file(s) (rolled back).")
+        return 0
+    session.commit()
+    print(f"Seeded {seeded} entities from {file_count} file(s).")
+    return 0
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())

sqlalchemyseed-2.2.0/src/sqlalchemyseed.egg-info/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: sqlalchemyseed
+Version: 2.2.0
+Summary: SQLAlchemy Seeder
+Author-email: Jedy Matt Tabasco <hello@jedymatt.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jedymatt/sqlalchemyseed
+Project-URL: Documentation, https://sqlalchemyseed.readthedocs.io/
+Project-URL: Source, https://github.com/jedymatt/sqlalchemyseed
+Project-URL: Tracker, https://github.com/jedymatt/sqlalchemyseed/issues
+Keywords: sqlalchemy,orm,seed,seeder,json,yaml
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: SQLAlchemy>=2.0
+Provides-Extra: yaml
+Requires-Dist: PyYAML>=6.0; extra == "yaml"
+Dynamic: license-file
+
+# sqlalchemyseed
+
+[![PyPI](https://img.shields.io/pypi/v/sqlalchemyseed)](https://pypi.org/project/sqlalchemyseed)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/sqlalchemyseed)](https://pypi.org/project/sqlalchemyseed)
+[![PyPI - License](https://img.shields.io/pypi/l/sqlalchemyseed)](https://github.com/jedymatt/sqlalchemyseed/blob/main/LICENSE)
+[![Python package](https://github.com/jedymatt/sqlalchemyseed/actions/workflows/python-package.yml/badge.svg)](https://github.com/jedymatt/sqlalchemyseed/actions/workflows/python-package.yml)
+[![Maintainability](https://api.codeclimate.com/v1/badges/2ca97c98929b614658ea/maintainability)](https://codeclimate.com/github/jedymatt/sqlalchemyseed/maintainability)
+[![codecov](https://codecov.io/gh/jedymatt/sqlalchemyseed/branch/main/graph/badge.svg?token=W03MFZ2FAG)](https://codecov.io/gh/jedymatt/sqlalchemyseed)
+[![Documentation Status](https://readthedocs.org/projects/sqlalchemyseed/badge/?version=latest)](https://sqlalchemyseed.readthedocs.io/en/latest/?badge=latest)
+
+Sqlalchemy seeder that supports nested relationships.
+
+Supported file types
+
+- json
+- yaml
+- csv
+
+## Installation
+
+Default installation
+
+```shell
+pip install sqlalchemyseed
+```
+
+## Quickstart
+
+main.py
+
+```python
+from sqlalchemyseed import load_entities_from_json
+from sqlalchemyseed import Seeder
+from db import session
+
+# load entities
+entities = load_entities_from_json('data.json')
+
+# Initializing Seeder
+seeder = Seeder(session)
+
+# Seeding
+seeder.seed(entities)
+
+# Committing
+session.commit()  # or seeder.session.commit()
+```
+
+data.json
+
+```json
+{
+    "model": "models.Person",
+    "data": [
+        {
+            "name": "John March",
+            "age": 23
+        },
+        {
+            "name": "Juan Dela Cruz",
+            "age": 21
+        }
+    ]
+}
+```
+
+## Command-line usage
+
+Seed a database directly from data files without writing Python:
+
+```shell
+sqlalchemyseed data.json --url sqlite:///app.db
+```
+
+The command accepts one or more files and/or directories (a directory seeds
+every `.json`/`.yaml`/`.yml` file inside it, in sorted order):
+
+```shell
+sqlalchemyseed seeds/ --url "$DATABASE_URL"
+sqlalchemyseed a.json b.yaml --url sqlite:///app.db
+```
+
+The database URL may be passed with `--url` or the `DATABASE_URL` environment
+variable. Model paths in the data files (e.g. `models.Person`) are resolved
+against the current working directory, so run the command from your project
+root.
+
+Options:
+
+- `--dry-run` — seed inside a transaction, then roll back (validate without writing)
+- `--seeder hybrid` — use `HybridSeeder` instead of the default `Seeder`
+- `--model models.Person` — required for CSV inputs, which are not self-describing
+- `--ref-prefix` — override the relationship reference prefix (default `!`)
+
+The same command is available as a module:
+
+```shell
+python -m sqlalchemyseed data.json --url sqlite:///app.db
+```
+
+## Documentation
+
+<https://sqlalchemyseed.readthedocs.io/>
+
+## Found Bug?
+
+Report here in this link:
+<https://github.com/jedymatt/sqlalchemyseed/issues>
+
+## Want to contribute?
+
+First, Clone this [repository](https://github.com/jedymatt/sqlalchemyseed).
+
+This project uses [uv](https://docs.astral.sh/uv/) for dependency management and running tasks.
+
+### Install dev dependencies
+
+Inside the folder, sync the environment (uv creates the virtualenv and installs the project plus dev dependencies):
+
+```shell
+uv sync
+```
+
+### Run tests
+
+```shell
+uv run pytest
+```
+
+Run the tests against a specific Python version (uv downloads it if needed):
+
+```shell
+uv run --python 3.14 pytest
+```
+
+Run the tests against the lowest supported dependencies (e.g. SQLAlchemy 2.0):
+
+```shell
+uv run --resolution lowest-direct pytest
+```
+
+Run tests with coverage:
+
+```shell
+uv run coverage run -m pytest
+```
+
+Autobuild documentation
+
+```shell
+sphinx-autobuild docs docs/_build/html
+```

{sqlalchemyseed-2.0.0 → sqlalchemyseed-2.2.0}/src/sqlalchemyseed.egg-info/SOURCES.txt

@@ -1,10 +1,10 @@
 LICENSE
 README.md
 pyproject.toml
-setup.cfg
-setup.py
 src/sqlalchemyseed/__init__.py
+src/sqlalchemyseed/__main__.py
 src/sqlalchemyseed/attribute.py
+src/sqlalchemyseed/cli.py
 src/sqlalchemyseed/constants.py
 src/sqlalchemyseed/dynamic_seeder.py
 src/sqlalchemyseed/errors.py
@@ -16,10 +16,12 @@ src/sqlalchemyseed/validator.py
 src/sqlalchemyseed.egg-info/PKG-INFO
 src/sqlalchemyseed.egg-info/SOURCES.txt
 src/sqlalchemyseed.egg-info/dependency_links.txt
+src/sqlalchemyseed.egg-info/entry_points.txt
 src/sqlalchemyseed.egg-info/requires.txt
 src/sqlalchemyseed.egg-info/top_level.txt
 src/sqlalchemyseed/_future/__init__.py
 src/sqlalchemyseed/_future/seeder.py
+tests/test_cli.py
 tests/test_json.py
 tests/test_loader.py
 tests/test_seeder.py

sqlalchemyseed-2.2.0/src/sqlalchemyseed.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sqlalchemyseed = sqlalchemyseed.cli:main

{sqlalchemyseed-2.0.0 → sqlalchemyseed-2.2.0}/src/sqlalchemyseed.egg-info/requires.txt

@@ -1,4 +1,4 @@
 SQLAlchemy>=2.0
 
 [yaml]
-PyYAML>=5.4
+PyYAML>=6.0

sqlalchemyseed-2.2.0/tests/test_cli.py

@@ -0,0 +1,133 @@
+"""Tests for the sqlalchemyseed command-line interface."""
+
+import json
+
+import pytest
+from sqlalchemy import create_engine
+from sqlalchemy.orm import Session
+
+from sqlalchemyseed import cli
+from tests.models import Base, Person
+
+
+@pytest.fixture
+def db_url(tmp_path):
+    """A file-backed SQLite URL with the test schema already created."""
+    url = f"sqlite:///{tmp_path / 'seed.db'}"
+    engine = create_engine(url)
+    Base.metadata.create_all(engine)
+    engine.dispose()
+    return url
+
+
+def count_persons(url):
+    with Session(create_engine(url)) as session:
+        return session.query(Person).count()
+
+
+def write_json(path, entities):
+    path.write_text(json.dumps(entities), encoding="utf-8")
+    return path
+
+
+def person_entities(*names):
+    return {"model": "tests.models.Person", "data": [{"name": name} for name in names]}
+
+
+def test_seed_json_file(tmp_path, db_url):
+    data_file = write_json(tmp_path / "people.json", person_entities("Alice", "Bob"))
+
+    assert cli.main([str(data_file), "--url", db_url]) == 0
+    assert count_persons(db_url) == 2
+
+
+def test_seed_yaml_file(tmp_path, db_url):
+    yaml_file = tmp_path / "people.yaml"
+    yaml_file.write_text(
+        "model: tests.models.Person\ndata:\n  - name: Carol\n", encoding="utf-8"
+    )
+
+    assert cli.main([str(yaml_file), "--url", db_url]) == 0
+    assert count_persons(db_url) == 1
+
+
+def test_seed_csv_file_requires_model(tmp_path, db_url):
+    csv_file = tmp_path / "people.csv"
+    csv_file.write_text("name\nDave\nErin\n", encoding="utf-8")
+
+    exit_code = cli.main(
+        [str(csv_file), "--url", db_url, "--model", "tests.models.Person"]
+    )
+
+    assert exit_code == 0
+    assert count_persons(db_url) == 2
+
+
+def test_csv_without_model_fails(tmp_path, db_url, capsys):
+    csv_file = tmp_path / "people.csv"
+    csv_file.write_text("name\nDave\n", encoding="utf-8")
+
+    assert cli.main([str(csv_file), "--url", db_url]) == 1
+    assert "requires --model" in capsys.readouterr().err
+    assert count_persons(db_url) == 0
+
+
+def test_seed_directory(tmp_path, db_url):
+    seeds = tmp_path / "seeds"
+    seeds.mkdir()
+    write_json(seeds / "01_first.json", person_entities("Alice"))
+    write_json(seeds / "02_second.json", person_entities("Bob", "Carol"))
+
+    assert cli.main([str(seeds), "--url", db_url]) == 0
+    assert count_persons(db_url) == 3
+
+
+def test_multiple_paths(tmp_path, db_url):
+    first = write_json(tmp_path / "a.json", person_entities("Alice"))
+    second = write_json(tmp_path / "b.json", person_entities("Bob"))
+
+    assert cli.main([str(first), str(second), "--url", db_url]) == 0
+    assert count_persons(db_url) == 2
+
+
+def test_dry_run_rolls_back(tmp_path, db_url, capsys):
+    data_file = write_json(tmp_path / "people.json", person_entities("Alice", "Bob"))
+
+    assert cli.main([str(data_file), "--url", db_url, "--dry-run"]) == 0
+    assert "Dry run" in capsys.readouterr().out
+    assert count_persons(db_url) == 0
+
+
+def test_hybrid_seeder(tmp_path, db_url):
+    data_file = write_json(tmp_path / "people.json", person_entities("Alice"))
+
+    assert cli.main([str(data_file), "--url", db_url, "--seeder", "hybrid"]) == 0
+    assert count_persons(db_url) == 1
+
+
+def test_url_from_environment(tmp_path, db_url, monkeypatch):
+    monkeypatch.setenv("DATABASE_URL", db_url)
+    data_file = write_json(tmp_path / "people.json", person_entities("Alice"))
+
+    assert cli.main([str(data_file)]) == 0
+    assert count_persons(db_url) == 1
+
+
+def test_missing_url_errors(tmp_path, monkeypatch):
+    monkeypatch.delenv("DATABASE_URL", raising=False)
+    data_file = write_json(tmp_path / "people.json", person_entities("Alice"))
+
+    with pytest.raises(SystemExit):
+        cli.main([str(data_file)])
+
+
+def test_nonexistent_path_errors(db_url):
+    with pytest.raises(SystemExit):
+        cli.main(["does_not_exist.json", "--url", db_url])
+
+
+def test_unsupported_file_type(tmp_path, db_url):
+    bad_file = tmp_path / "people.txt"
+    bad_file.write_text("nope", encoding="utf-8")
+
+    assert cli.main([str(bad_file), "--url", db_url]) == 1

sqlalchemyseed-2.0.0/README.md

@@ -1,114 +0,0 @@
-# sqlalchemyseed
-
-[![PyPI](https://img.shields.io/pypi/v/sqlalchemyseed)](https://pypi.org/project/sqlalchemyseed)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/sqlalchemyseed)](https://pypi.org/project/sqlalchemyseed)
-[![PyPI - License](https://img.shields.io/pypi/l/sqlalchemyseed)](https://github.com/jedymatt/sqlalchemyseed/blob/main/LICENSE)
-[![Python package](https://github.com/jedymatt/sqlalchemyseed/actions/workflows/python-package.yml/badge.svg)](https://github.com/jedymatt/sqlalchemyseed/actions/workflows/python-package.yml)
-[![Maintainability](https://api.codeclimate.com/v1/badges/2ca97c98929b614658ea/maintainability)](https://codeclimate.com/github/jedymatt/sqlalchemyseed/maintainability)
-[![codecov](https://codecov.io/gh/jedymatt/sqlalchemyseed/branch/main/graph/badge.svg?token=W03MFZ2FAG)](https://codecov.io/gh/jedymatt/sqlalchemyseed)
-[![Documentation Status](https://readthedocs.org/projects/sqlalchemyseed/badge/?version=latest)](https://sqlalchemyseed.readthedocs.io/en/latest/?badge=latest)
-
-Sqlalchemy seeder that supports nested relationships.
-
-Supported file types
-
-- json
-- yaml
-- csv
-
-## Installation
-
-Default installation
-
-```shell
-pip install sqlalchemyseed
-```
-
-## Quickstart
-
-main.py
-
-```python
-from sqlalchemyseed import load_entities_from_json
-from sqlalchemyseed import Seeder
-from db import session
-
-# load entities
-entities = load_entities_from_json('data.json')
-
-# Initializing Seeder
-seeder = Seeder(session)
-
-# Seeding
-seeder.seed(entities)
-
-# Committing
-session.commit()  # or seeder.session.commit()
-```
-
-data.json
-
-```json
-{
-    "model": "models.Person",
-    "data": [
-        {
-            "name": "John March",
-            "age": 23
-        },
-        {
-            "name": "Juan Dela Cruz",
-            "age": 21
-        }
-    ]
-}
-```
-
-## Documentation
-
-<https://sqlalchemyseed.readthedocs.io/>
-
-## Found Bug?
-
-Report here in this link:
-<https://github.com/jedymatt/sqlalchemyseed/issues>
-
-## Want to contribute?
-
-First, Clone this [repository](https://github.com/jedymatt/sqlalchemyseed).
-
-### Install dev dependencies
-
-Inside the folder, paste this in the terminal to install necessary dependencies:
-
-```shell
-pip install -r requirements.txt -r docs/requirements.txt
-```
-
-Note: make sure you have the virtual environment and enabled, or if you are using vs code and docker then you can simply re-open this as container.
-
-### Run tests
-
-Before running tests, make sure that the package is installed as editable:
-
-```shell
-python setup.py develop --user
-```
-
-Then run the test:
-
-```shell
-pytest tests
-```
-
-Run test with coverage
-
-```shell
-coverage run -m pytest
-```
-
-Autobuild documentation
-
-```shell
-sphinx-autobuild docs docs/_build/html
-```

sqlalchemyseed-2.0.0/pyproject.toml

@@ -1,6 +0,0 @@
-[build-system]
-requires = [
-    "setuptools>=42",
-    "wheel"
-]
-build-backend = "setuptools.build_meta"

sqlalchemyseed-2.0.0/setup.cfg

@@ -1,44 +0,0 @@
-[metadata]
-name = sqlalchemyseed
-version = attr: sqlalchemyseed.__version__
-description = SQLAlchemy Seeder
-long_description = file: README.md
-long_description_content_type = text/markdown
-url = https://github.com/jedymatt/sqlalchemyseed
-author = Jedy Matt Tabasco
-author_email = jedymatt@gmail.com
-license = MIT
-license_files = 
-	LICENSE
-classifiers = 
-	License :: OSI Approved :: MIT License
-	Programming Language :: Python :: 3.7
-	Programming Language :: Python :: 3.8
-	Programming Language :: Python :: 3.9
-	Programming Language :: Python :: 3.10
-	Programming Language :: Python :: 3.11
-project_urls = 
-	Documentation = https://sqlalchemyseed.readthedocs.io/
-	Source = https://github.com/jedymatt/sqlalchemyseed
-	Tracker = https://github.com/jedymatt/sqlalchemyseed/issues
-keywords = sqlalchemy, orm, seed, seeder, json, yaml
-
-[options]
-packages = find:
-package_dir = 
-	=src
-install_requires = 
-	SQLAlchemy>=2.0
-python_requires = >=3.7
-
-[options.packages.find]
-where = src
-
-[options.extras_require]
-yaml = 
-	PyYAML>=5.4
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

sqlalchemyseed-2.0.0/setup.py

@@ -1,4 +0,0 @@
-from setuptools import setup
-
-
-setup()