{"id":23296,"library":"autosemver","title":"AutoSemVer","description":"Tools to handle automatic semantic versioning in Python. Current version 1.0.0. Release cadence is low; no recent updates.","status":"active","version":"1.0.0","language":"python","source_language":"en","source_url":"https://github.com/david-caro/python-autosemver","tags":["semantic versioning","versioning","automation","git"],"install":[{"cmd":"pip install autosemver","lang":"bash","label":"pip"}],"dependencies":[],"imports":[{"note":"direct class import for automatic versioning","symbol":"AutoSemVer","correct":"from autosemver import AutoSemVer"},{"note":"class for semantic version operations","symbol":"SemVer","correct":"from autosemver import SemVer"},{"note":"function to bump version string","symbol":"bump_version","correct":"from autosemver import bump_version"}],"quickstart":{"code":"from autosemver import AutoSemVer\n\n# Create an AutoSemVer instance\nautoversion = AutoSemVer()\n\n# Get the current version from git\nversion = autoversion.current_version()\nprint(f\"Current version: {version}\")\n\n# Bump the version\nnew_version = autoversion.bump_version('patch')\nprint(f\"New version: {new_version}\")","lang":"python","description":"Basic usage: initialize AutoSemVer and bump patch version."},"warnings":[{"fix":"Ensure your repository has at least one git tag (e.g., v0.1.0) before using autosemver.","message":"AutoSemVer relies on Git tags for versioning; if no tags are present, it may fail or return an initial version.","severity":"gotcha","affected_versions":"all"},{"fix":"Use bump_version only when you intend to create a release; consider using dry-run or manual versioning in CI.","message":"bump_version modifies the working tree by creating a new commit and tag, which may be unintended in CI or read-only environments.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'from autosemver import AutoSemVer' directly.","cause":"Importing incorrectly, e.g., 'import autosemver' alone and then calling autosemver.AutoSemVer","error":"AttributeError: module 'autosemver' has no attribute 'AutoSemVer'"},{"fix":"Ensure you are in a Git repository with initialized tags (e.g., 'git init && git tag v0.1.0').","cause":"Running autosemver in a directory that is not a Git repository or has no tags.","error":"UserWarning: Not a git repository or no tags found"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}