Skip to content

README_DEV.md

Latest commit

 

History

History
46 lines (26 loc) · 1.79 KB

README_DEV.md

File metadata and controls

46 lines (26 loc) · 1.79 KB

Developer Notes For osxmetadata

These are notes to help me remember how to build and release osxmetadata. They may be useful for contributors.

Tooling

The build is managed by doit and uv.

Version management uses bump2version.

Documentation is updated with cog and mkdocs.

pytest is used for testing.

To bump the minor version, run bumpversion minor --verbose --dry-run to see what will happen then again without the --dru-run to implement the change. This updates the __version__ constant in the package as well as the pyproject.toml version.

Setup the environment

  • Change to the project directory
  • Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Create the virtual environment: uv venv or uv venv --python 3.13 to specify a specific version
  • Activate the virtual environment: source .venv/bin/activate
  • Install package dependencies: uv pip install -r pyproject.toml --extra dev or uv sync --extra dev

Testing

The doit test task (doit test) will run pytest to test the package.

Note that a couple of tests are currently failing on Ventura even though the same code works fine when run directly. I've not figured out why this is happening yet.

Building

To test and build the package, run doit. This will build the package and run the tests. Run doit list to see the available tasks. doit tasks are defined in dodo.py.

Docs

Uses mkdocs:

  • mkdocs build
  • mkdocs gh-deploy

Changelog

Use auto-changelog:

  • auto-changelog --ignore-commit-pattern CHANGELOG -l 5