ebump 0.1.0__tar.gz

ebump-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jorge Morgado Vega
+
+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.

ebump-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: ebump
+Version: 0.1.0
+Summary: Easy version bumping
+Author-email: Jorge Morgado Vega <jorge.morgadov@gmail.com>
+License: MIT
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bumpver>=2025.1131
+Requires-Dist: click>=8.3.1
+Dynamic: license-file
+
+# ebump
+
+Easy version bumping CLI for python projects.
+
+`ebump` is a simple (opinionated) wrapper around the
+[`bumpver`](https://github.com/mbarkhau/bumpver) library that provides an
+easy-to-use CLI for version bumping in Python projects. It focuses on simplicity
+and ease of use, making it ideal for developers and CI/CD pipelines and scripts.
+
+## Quick showcase
+
+```bash
+# Bump patch/minor/major versions
+ebump patch   # Example: 1.0.0 -> 1.0.1
+ebump minor   # Example: 1.0.1 -> 1.1.0
+ebump major   # Example: 1.5.4 -> 2.0.0
+
+# Bumping (major/minor/patch) resets pre-release tag to final
+ebump minor   # Example: 1.0.0-beta2 -> 1.1.0
+
+# Bump pre-release tags
+ebump alpha   # Example: 1.0.0-alpha4 -> 1.0.0-alpha5
+ebump beta    # Example: 1.0.0-alpha5 -> 1.0.0-beta0
+ebump rc      # Example: 1.0.0-beta3 -> 1.0.0-rc2
+
+# Combined bump
+ebump minor beta  # Example: 1.0.0 -> 1.1.0-beta0
+
+# Bump the current pre-release tag number
+ebump tag    # Example: 1.0.0-beta0 -> 1.0.0-beta1
+
+# Make/ensure final version
+ebump final  # Example: 1.0.0-rc2 -> 1.0.0
+
+# Running in dry mode (no file changes)
+ebump patch --dry
+```
+
+## Instalation / Usage
+
+You can use `ebump` directly via `uvx` (recommended):
+
+```bash
+uvx ebump [PARAMS ...]
+```
+
+Or install it via `pip`:
+
+```bash
+pip install ebump
+```
+
+## Why `ebump`?
+
+Design differences with `bumpver` CLI:
+
+- Bumping `final` tag doesn't throw errors if the version is already final.
+
+  > Useful for CI/CD pipelines where you want to ensure the version is final without worrying about its current state.
+
+- Bumping one of the main version parts (`patch`, `minor`, `major`) automatically resets any pre-release tag to `final`.
+
+  > If you bump the `minor` version from `1.0.0-beta2`, it will become `1.1.0` instead of `1.1.0-final`.
+    You can still set a pre-release tag in the same command (e.g., `ebump minor beta` to get `1.1.0-beta0`).
+
+- `show` action to print the raw current version without any other text (useful for scripts).
+- Simplified CLI with fewer options, focusing on the most common use cases.
+
+## What `ebump` is NOT
+
+- It is not a replacement for `bumpver` library. It is a wrapper around it.
+  You can still use `bumpver` library directly for more complex use cases.
+- It does not aim to cover all use cases. It focuses on simplicity and ease of use.
+
+## 🤝 Contributing
+
+Contributions are welcome!
+Please ensure all QA checks and tests pass before opening a pull request.
+
+---
+
+<sub>🚀 Project starter provided by [Cookie Pyrate](https://github.com/gvieralopez/cookie-pyrate)</sub>

ebump-0.1.0/README.md

@@ -0,0 +1,82 @@
+# ebump
+
+Easy version bumping CLI for python projects.
+
+`ebump` is a simple (opinionated) wrapper around the
+[`bumpver`](https://github.com/mbarkhau/bumpver) library that provides an
+easy-to-use CLI for version bumping in Python projects. It focuses on simplicity
+and ease of use, making it ideal for developers and CI/CD pipelines and scripts.
+
+## Quick showcase
+
+```bash
+# Bump patch/minor/major versions
+ebump patch   # Example: 1.0.0 -> 1.0.1
+ebump minor   # Example: 1.0.1 -> 1.1.0
+ebump major   # Example: 1.5.4 -> 2.0.0
+
+# Bumping (major/minor/patch) resets pre-release tag to final
+ebump minor   # Example: 1.0.0-beta2 -> 1.1.0
+
+# Bump pre-release tags
+ebump alpha   # Example: 1.0.0-alpha4 -> 1.0.0-alpha5
+ebump beta    # Example: 1.0.0-alpha5 -> 1.0.0-beta0
+ebump rc      # Example: 1.0.0-beta3 -> 1.0.0-rc2
+
+# Combined bump
+ebump minor beta  # Example: 1.0.0 -> 1.1.0-beta0
+
+# Bump the current pre-release tag number
+ebump tag    # Example: 1.0.0-beta0 -> 1.0.0-beta1
+
+# Make/ensure final version
+ebump final  # Example: 1.0.0-rc2 -> 1.0.0
+
+# Running in dry mode (no file changes)
+ebump patch --dry
+```
+
+## Instalation / Usage
+
+You can use `ebump` directly via `uvx` (recommended):
+
+```bash
+uvx ebump [PARAMS ...]
+```
+
+Or install it via `pip`:
+
+```bash
+pip install ebump
+```
+
+## Why `ebump`?
+
+Design differences with `bumpver` CLI:
+
+- Bumping `final` tag doesn't throw errors if the version is already final.
+
+  > Useful for CI/CD pipelines where you want to ensure the version is final without worrying about its current state.
+
+- Bumping one of the main version parts (`patch`, `minor`, `major`) automatically resets any pre-release tag to `final`.
+
+  > If you bump the `minor` version from `1.0.0-beta2`, it will become `1.1.0` instead of `1.1.0-final`.
+    You can still set a pre-release tag in the same command (e.g., `ebump minor beta` to get `1.1.0-beta0`).
+
+- `show` action to print the raw current version without any other text (useful for scripts).
+- Simplified CLI with fewer options, focusing on the most common use cases.
+
+## What `ebump` is NOT
+
+- It is not a replacement for `bumpver` library. It is a wrapper around it.
+  You can still use `bumpver` library directly for more complex use cases.
+- It does not aim to cover all use cases. It focuses on simplicity and ease of use.
+
+## 🤝 Contributing
+
+Contributions are welcome!
+Please ensure all QA checks and tests pass before opening a pull request.
+
+---
+
+<sub>🚀 Project starter provided by [Cookie Pyrate](https://github.com/gvieralopez/cookie-pyrate)</sub>

ebump-0.1.0/pyproject.toml

@@ -0,0 +1,113 @@
+[project]
+name = "ebump"
+version = "0.1.0"
+description = "Easy version bumping"
+readme = "README.md"
+requires-python = ">= 3.13"
+authors = [{ name = "Jorge Morgado Vega", email = "jorge.morgadov@gmail.com" }]
+license = { text = "MIT" }
+
+dependencies = ["bumpver>=2025.1131", "click>=8.3.1"]
+
+[dependency-groups]
+dev = [
+    "bumpver",
+    "mypy",
+
+    "pytest",
+    "pytest-cov",
+    "pytest-dotenv",
+    "pytest-mock",
+    "ruff",
+]
+
+docs = ["mkdocs", "mkdocs-material", "pygments"]
+
+build = ["build"]
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[project.scripts]
+ebump = "ebump.main:main"
+
+[tool.ruff]
+line-length = 88
+indent-width = 4
+target-version = "py313"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+docstring-code-format = true
+docstring-code-line-length = "dynamic"
+
+[tool.ruff.lint]
+select = [
+    "A",      # flake8-builtins: Check variables shadowing
+    "B",      # flake8-bugbear: Finds likely bugs and design problems
+    "C",      # McCabe: Complexity checker to ensure maintainable code
+    "DJ",     # flake8-django: Checks on Django code
+    "E4",     # Pycodestyle: Line length, indentation, etc.
+    "E7",     # Pycodestyle: Miscellaneous checks
+    "E9",     # Pycodestyle: Syntax errors
+    "F",      # Pyflakes: Unused imports, undefined variables, etc.
+    "FIX",    # Avoid lines containing TODO tags
+    "G",      # flake8-logging-format: Ensure logging messages follow best practices.
+    "I",      # Isort: Import sorting
+    "LOG",    # flake8-logging: Use the logging module correctly
+    "N",      # pep8-naming: Enforce naming conventions
+    "PGH004", # Enforce specify the rule to avoid on noqa tags
+    "PTH",    # flake8-use-pathlib: Enforces pathlib usage
+    "RUF",    # Ruff-specific rules: Mostly for handling noqa tags and general stuff
+    "S",      # flake8-bandit: Identifies common security issues in code
+    "T20",    # flake8-print: Avoids print in the code
+]
+ignore = [
+    "S101", # Use of assert function
+]
+fixable = ["ALL"]
+unfixable = []
+
+[tool.ruff.lint.per-file-ignores]
+"scripts/**" = ["T20"] # Allow print statements on the scripts
+
+
+[tool.mypy]
+python_version = "3.13"
+files = ["src", "scripts", "tests"]
+warn_unused_configs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+strict_equality = true
+check_untyped_defs = true
+disallow_subclassing_any = true
+disallow_untyped_decorators = true
+disallow_any_generics = true
+disallow_untyped_calls = true
+disallow_incomplete_defs = true
+disallow_untyped_defs = true
+no_implicit_reexport = true
+warn_return_any = true
+extra_checks = true
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = "-ra -q --cov=src --cov-report=term-missing --cov-fail-under=80"
+python_files = "tests.py test_*.py *_test.py"
+pythonpath = "./src"
+env_override_existing_values = 1
+env_files = [".env.test"]
+
+[tool.bumpver]
+current_version = "0.1.0"
+version_pattern = "MAJOR.MINOR.PATCH[-TAGNUM]"
+
+[tool.bumpver.file_patterns]
+"pyproject.toml" = ['^version = "{version}"', '^current_version = "{version}"']
+"src/ebump/__init__.py" = ['^__version__ = "{version}"$']

ebump-0.1.0/setup.cfg

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

ebump-0.1.0/src/ebump/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

ebump-0.1.0/src/ebump/main.py

@@ -0,0 +1,163 @@
+"""
+ebump - Easy version bumping CLI tool
+"""
+
+import argparse
+import logging
+import os
+import sys
+from pathlib import Path
+
+import bumpver
+import bumpver.cli
+import bumpver.config
+import bumpver.v1patterns
+import bumpver.v1version
+import bumpver.v2version
+import click
+import click.testing
+from bumpver.cli import cli
+
+logger = logging.getLogger(__name__)
+
+
+ROOT_IDENTIFIERS = ["pyproject.toml", ".git"]
+
+
+def project_root() -> Path:
+    """
+    Get the project root directory
+    """
+
+    current_dir = Path.cwd()
+    while current_dir != current_dir.parent:
+        if any((current_dir / identifier).exists() for identifier in ROOT_IDENTIFIERS):
+            return current_dir
+        current_dir = current_dir.parent
+    return Path.cwd()
+
+
+def run(version: str) -> None:
+    """
+    Write the new version to your version file/config
+    """
+    bumpver.cli.update(set_version=version, project_path=".")
+
+
+def main() -> None:
+    """
+    Main entry point for the ebump CLI tool
+    """
+    parser = argparse.ArgumentParser(
+        prog="ebump",
+        description="Easy version bumping tool",
+        epilog="""
+Basic:
+
+> ebump show           # Show current version
+> ebump --help         # Show help message
+
+Bump version parts:
+
+> ebump patch          # 1.0.0 -> 1.0.1
+> ebump minor          # 1.0.1 -> 1.1.0
+> ebump major          # 1.5.4 -> 2.0.0
+
+Bump part with tag:
+
+> ebump minor beta     # 1.0.0 -> 1.1.0-beta0
+
+Bump tags:
+
+> ebump alpha          # 1.0.0-alpha4 -> 1.0.0-alpha5
+> ebump beta           # 1.0.0-alpha5 -> 1.0.0-beta0
+
+Bump current tag number:
+
+> ebump tag            # 1.0.0-beta0 -> 1.0.0-beta1
+
+Make/ensure final release (no pre-release tag):
+
+> ebump final          # 1.0.0-rc2 -> 1.0.0
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+
+    parser.add_argument(
+        "action",
+        nargs="?",
+        default=None,
+        help="Version part to bump (patch/minor/major/tag), or specific pre-release tag (alpha/beta/dev/rc/final)",
+    )
+
+    parser.add_argument(
+        "tag",
+        nargs="?",
+        default=None,
+        help="Optional pre-release tag when bumping version parts",
+    )
+
+    parser.add_argument(
+        "--dry",
+        default=False,
+        action="store_true",
+        help="Perform a dry run without modifying any files",
+    )
+
+    args = parser.parse_args()
+    os.chdir(project_root())
+
+    _, cfg = bumpver.config.init(project_path=".")
+    raw_pattern = cfg.version_pattern
+    v1_parts = list(bumpver.v1patterns.PART_PATTERNS) + list(
+        bumpver.v1patterns.FULL_PART_FORMATS
+    )
+    has_v1_part = any("{" + part + "}" in raw_pattern for part in v1_parts)
+    vinfo: bumpver.v1version.VersionInfo | bumpver.v2version.VersionInfo
+    current_version = cfg.current_version
+    if has_v1_part:
+        vinfo = bumpver.v1version.parse_version_info(current_version, raw_pattern)
+    else:
+        vinfo = bumpver.v2version.parse_version_info(current_version, raw_pattern)
+
+    if not args.action:
+        parser.print_help()
+        sys.exit(1)
+
+    if args.action.lower() == "show":
+        sys.stdout.write(f"{current_version}\n")
+        return
+
+    action = args.action.lower()
+    tag = args.tag.lower() if args.tag else None
+    dry = args.dry
+
+    cmd = ["update"]
+    if action in {"patch", "minor", "major"}:
+        cmd += ["--" + action, "--tag", tag or "final"]
+    elif action == "tag":
+        if not cfg.tag:
+            sys.stderr.write("No pre-release tag found to bump.\n")
+            sys.exit(1)
+        cmd += ["--tag-num", "-n"]
+    elif action in {"alpha", "beta", "dev", "rc", "post", "final"}:
+        if action == "final" and not vinfo.tag:
+            sys.stdout.write("Already at final version.\n")
+            return
+        if action == vinfo.tag:
+            cmd += ["--tag-num", "-n"]
+        else:
+            cmd += ["--tag", action]
+
+    if dry:
+        cmd.append("--dry")
+    runner = click.testing.CliRunner(catch_exceptions=False)
+    result = runner.invoke(cli, cmd, color=True, catch_exceptions=False)
+
+    sys.stdout.write(result.output)
+    if result.exit_code != 0:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: ebump
+Version: 0.1.0
+Summary: Easy version bumping
+Author-email: Jorge Morgado Vega <jorge.morgadov@gmail.com>
+License: MIT
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bumpver>=2025.1131
+Requires-Dist: click>=8.3.1
+Dynamic: license-file
+
+# ebump
+
+Easy version bumping CLI for python projects.
+
+`ebump` is a simple (opinionated) wrapper around the
+[`bumpver`](https://github.com/mbarkhau/bumpver) library that provides an
+easy-to-use CLI for version bumping in Python projects. It focuses on simplicity
+and ease of use, making it ideal for developers and CI/CD pipelines and scripts.
+
+## Quick showcase
+
+```bash
+# Bump patch/minor/major versions
+ebump patch   # Example: 1.0.0 -> 1.0.1
+ebump minor   # Example: 1.0.1 -> 1.1.0
+ebump major   # Example: 1.5.4 -> 2.0.0
+
+# Bumping (major/minor/patch) resets pre-release tag to final
+ebump minor   # Example: 1.0.0-beta2 -> 1.1.0
+
+# Bump pre-release tags
+ebump alpha   # Example: 1.0.0-alpha4 -> 1.0.0-alpha5
+ebump beta    # Example: 1.0.0-alpha5 -> 1.0.0-beta0
+ebump rc      # Example: 1.0.0-beta3 -> 1.0.0-rc2
+
+# Combined bump
+ebump minor beta  # Example: 1.0.0 -> 1.1.0-beta0
+
+# Bump the current pre-release tag number
+ebump tag    # Example: 1.0.0-beta0 -> 1.0.0-beta1
+
+# Make/ensure final version
+ebump final  # Example: 1.0.0-rc2 -> 1.0.0
+
+# Running in dry mode (no file changes)
+ebump patch --dry
+```
+
+## Instalation / Usage
+
+You can use `ebump` directly via `uvx` (recommended):
+
+```bash
+uvx ebump [PARAMS ...]
+```
+
+Or install it via `pip`:
+
+```bash
+pip install ebump
+```
+
+## Why `ebump`?
+
+Design differences with `bumpver` CLI:
+
+- Bumping `final` tag doesn't throw errors if the version is already final.
+
+  > Useful for CI/CD pipelines where you want to ensure the version is final without worrying about its current state.
+
+- Bumping one of the main version parts (`patch`, `minor`, `major`) automatically resets any pre-release tag to `final`.
+
+  > If you bump the `minor` version from `1.0.0-beta2`, it will become `1.1.0` instead of `1.1.0-final`.
+    You can still set a pre-release tag in the same command (e.g., `ebump minor beta` to get `1.1.0-beta0`).
+
+- `show` action to print the raw current version without any other text (useful for scripts).
+- Simplified CLI with fewer options, focusing on the most common use cases.
+
+## What `ebump` is NOT
+
+- It is not a replacement for `bumpver` library. It is a wrapper around it.
+  You can still use `bumpver` library directly for more complex use cases.
+- It does not aim to cover all use cases. It focuses on simplicity and ease of use.
+
+## 🤝 Contributing
+
+Contributions are welcome!
+Please ensure all QA checks and tests pass before opening a pull request.
+
+---
+
+<sub>🚀 Project starter provided by [Cookie Pyrate](https://github.com/gvieralopez/cookie-pyrate)</sub>

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

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/ebump/__init__.py
+src/ebump/main.py
+src/ebump/py.typed
+src/ebump.egg-info/PKG-INFO
+src/ebump.egg-info/SOURCES.txt
+src/ebump.egg-info/dependency_links.txt
+src/ebump.egg-info/entry_points.txt
+src/ebump.egg-info/requires.txt
+src/ebump.egg-info/top_level.txt
+tests/test_main.py

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

@@ -0,0 +1 @@
+

ebump-0.1.0/src/ebump.egg-info/entry_points.txt

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

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

@@ -0,0 +1,2 @@
+bumpver>=2025.1131
+click>=8.3.1

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

@@ -0,0 +1 @@
+ebump