venver 0.0.0__tar.gz

venver-0.0.0/LICENSE

@@ -0,0 +1,15 @@
+Automatically activate, and deactivate virutal environments when entering or leaving directories.
+Copyright (C) 2026  Narvin Singh
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

venver-0.0.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.3
+Name: venver
+Version: 0.0.0
+Summary: Automatically activate, and deactivate virutal environments when entering or leaving directories.
+Author: Narvin Singh
+Author-email: Narvin Singh <Narvin.A.Singh@gmail.com>
+License: Automatically activate, and deactivate virutal environments when entering or leaving directories.
+         Copyright (C) 2026  Narvin Singh
+         
+         This program is free software: you can redistribute it and/or modify
+         it under the terms of the GNU General Public License as published by
+         the Free Software Foundation, either version 3 of the License, or
+         (at your option) any later version.
+         
+         This program is distributed in the hope that it will be useful,
+         but WITHOUT ANY WARRANTY; without even the implied warranty of
+         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+         GNU General Public License for more details.
+         
+         You should have received a copy of the GNU General Public License
+         along with this program.  If not, see <https://www.gnu.org/licenses/>.
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Requires-Dist: python-docs-theme~=2025.12 ; extra == 'doc'
+Requires-Dist: sphinx~=9.1 ; extra == 'doc'
+Requires-Python: >=3.12
+Project-URL: Homepage, https://codeberg.org/venver
+Project-URL: Repository, https://codeberg.org/venver
+Project-URL: Bug Tracker, https://codeberg.org/venver/issues
+Provides-Extra: doc
+Description-Content-Type: text/x-rst
+
+Venver
+######
+
+Automatically activate, and deactivate virutal environments when entering or
+leaving directories.
+

venver-0.0.0/README.rst

@@ -0,0 +1,6 @@
+Venver
+######
+
+Automatically activate, and deactivate virutal environments when entering or
+leaving directories.
+

venver-0.0.0/pyproject.toml

@@ -0,0 +1,107 @@
+[project]
+name = "venver"
+version = "0.0.0"
+authors = [
+    {name = "Narvin Singh", email = "Narvin.A.Singh@gmail.com"}
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+    "Operating System :: OS Independent"
+]
+description = "Automatically activate, and deactivate virutal environments when entering or leaving directories."
+readme = "README.rst"
+license = {file = "LICENSE"}
+requires-python = ">=3.12"
+
+dependencies = []
+
+[project.optional-dependencies]
+doc = [
+    "python-docs-theme~=2025.12",
+    "sphinx~=9.1",
+]
+
+[dependency-groups]
+dev = [
+    "coverage~=7.13",
+    "mypy~=1.19",
+    "pre-commit~=4.5",
+    "pytest~=9.0",
+    "ruff~=0.15.1",
+    "sphinx-lint~=1.0",
+    "yamllint~=1.38",
+]
+
+[project.urls]
+Homepage = "https://codeberg.org/venver"
+Repository = "https://codeberg.org/venver"
+"Bug Tracker" = "https://codeberg.org/venver/issues"
+
+[build-system]
+requires = ["uv_build>=0.10.2,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.mypy]
+python_version = "3.14"
+strict = true
+
+[tool.ruff]
+line-length = 100
+target-version = "py314"
+
+[tool.ruff.format]
+skip-magic-trailing-comma = true
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    # flake8-commas
+    "COM812",  # Trailing comma missing
+
+    # pydocstyle
+    "D203",    # 1 blank line required before class docstring
+    "D205",    # 1 blank line required between summary line and description
+    "D212",    # Multi-line docstring summary should start at the first line
+    "D400",    # First line should end with a period
+    "D415",    # First line should end with a period, question mark, or exclamation point
+
+    # Error
+    "E501",    # Line too long ({width} > {limit})
+    "E731",    # Do not assign a lambda expression, use a def
+
+    # eradicate
+    "ERA001",  # Found commented-out code
+
+    # flake8-fixme
+    "FIX002",  # Line contains TODO, consider resolving the issue
+
+    # flake8-implicit-str-concat
+    "ISC001",  # Implicitly concatenated string literals on one line
+
+    # flake8-pytest-style
+    "PT009",   # Use a regular assert instead of unittest-style {assertion}
+    "PT027",   # Use pytest.raises instead of unittest-style {assertion}
+
+    # flake8-todos
+    "TD003",   # Missing issue link on the line following this TODO
+]
+fixable = [
+    "F401",     # unused import
+    "F541",     # f-string without any placeholders
+
+    # isort
+    "I001",    # Import block is un-sorted or un-formatted
+
+    # Ruff-specific rules
+    "RUF022",  # `__all__` is not sorted
+    "RUF100",  # Unused noqa directive
+]
+isort.split-on-trailing-comma = false
+pydocstyle.convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"test/*" = [
+    "INP001",  # File is part of an implicit namespace package
+    "S101",  # Use of `assert` detected
+]

venver-0.0.0/src/venver/__init__.py

@@ -0,0 +1,8 @@
+"""The main package."""
+
+from importlib import metadata
+
+__project__ = "Venver"
+__distribution__ = "venver"
+__version__ = metadata.version("venver")
+__authors__ = ["Narvin Singh"]

venver-0.0.0/src/venver/__main__.py

@@ -0,0 +1,74 @@
+"""The package entry point."""
+
+import argparse
+import logging
+
+import venver as pkg
+
+from . import venver
+
+
+def apply_name(
+    name: str, desc: str, url: str, author: list[str] | None, *, unsafe: bool
+) -> None:  # pragma: no cover
+    """Stub for apply"""
+    logging.getLogger(__name__).debug("applying name: %s and description: %s", name, desc)
+    venver.apply(name, description=desc, url=url, authors=author, unsafe=unsafe)
+
+
+def revert_apply_name(*, unsafe: bool) -> None:  # pragma: no cover
+    """Stub for revert_apply_name"""
+    logging.getLogger(__name__).debug("restoring project")
+    venver.restore(unsafe=unsafe)
+
+
+def main(*, argv: list[str] | None = None, namespace: argparse.Namespace | None = None) -> int:
+    """The entry point function."""
+    parser = argparse.ArgumentParser(
+        prog="venver",
+        description="Automatically activate, and deactivate virutal environments when entering or leaving directories",
+    )
+    parser.add_argument("-v", "--version", action="version", version=f"venver {pkg.__version__}")
+    parser_common = argparse.ArgumentParser(add_help=False)
+    parser_common.add_argument(
+        "-l",
+        "--log-level",
+        choices=logging.getLevelNamesMapping().keys(),
+        default="DEBUG",
+        help="set the logging level",
+    )
+    parser_common.add_argument(
+        "--unsafe",
+        action="store_true",
+        help="if not set, then environment variables with tool paths must be defined",
+    )
+    subparsers = parser.add_subparsers(title="commands")
+    parser_apply = subparsers.add_parser(
+        "apply", parents=[parser_common], help="apply data to the project"
+    )
+    parser_apply.add_argument("-n", "--name", required=True, help="the project name to apply")
+    parser_apply.add_argument(
+        "-d", "--desc", required=True, help="the project description to apply"
+    )
+    parser_apply.add_argument("-a", "--author", action="append", help="a project author to apply")
+    parser_apply.add_argument(
+        "-u",
+        "--url",
+        default="https://codeberg.org",
+        help="the base URL of the project's remote repository to apply",
+    )
+    parser_apply.set_defaults(func=apply_name)
+    parser_restore = subparsers.add_parser(
+        "restore", parents=[parser_common], help="restore the project to its original state"
+    )
+    parser_restore.set_defaults(func=revert_apply_name)
+    args = parser.parse_args(argv, namespace)
+    logging.basicConfig(level=args.log_level)
+    logger = logging.getLogger(__name__)
+    logger.debug("args: %s", args)
+    args.func(**{k: v for k, v in args.__dict__.items() if k not in {"func", "log_level"}})
+    return 0
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())

venver-0.0.0/src/venver/venver.py

@@ -0,0 +1,150 @@
+"""The main module."""
+
+import configparser
+import functools
+import json
+import os
+import pathlib
+import shutil
+import subprocess
+import tomllib
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from collections.abc import Mapping
+
+
+@functools.lru_cache(1)
+def _projroot() -> pathlib.Path:  # pragma: no cover
+    return pathlib.Path(__file__).parent.parent.parent
+
+
+@functools.lru_cache(1)
+def _load_env() -> configparser.ConfigParser:  # pragma: no cover
+    parser = configparser.ConfigParser(allow_unnamed_section=True)
+    parser.read(_projroot() / ".env")
+    return parser
+
+
+def _tool_path(tool: str, default: str | None) -> str:  # pragma: no cover
+    _load_env()
+    key = f"{tool.upper()}_PATH"
+    msg = f"set the environment variable `{key}`, or add it to your `.env` file"
+    path = os.getenv(key)
+    if not path:
+        parser = _load_env()
+        try:
+            path = parser.get(configparser.UNNAMED_SECTION, key)
+        except configparser.NoOptionError as exc:
+            raise RuntimeError(msg) from exc
+    if path:
+        return path
+    if default is None:
+        raise RuntimeError(msg)
+    return default
+
+
+@functools.lru_cache(2)
+def _git_path(*, unsafe: bool) -> str:  # pragma: no cover
+    return _tool_path("git", "git" if unsafe else None)
+
+
+@functools.lru_cache(2)
+def _uv_path(*, unsafe: bool) -> str:  # pragma: no cover
+    return _tool_path("uv", "uv" if unsafe else None)
+
+
+def _replace_file(path: pathlib.Path, content: str) -> None:  # pragma: no cover
+    with path.open("w") as f:
+        f.write(content)
+
+
+def _update_file_raw(path: pathlib.Path, spec: Mapping[str, str]) -> None:  # pragma: no cover
+    with path.open("r+") as f:
+        template = f.read()
+        f.seek(0)
+        content = functools.reduce(
+            lambda acc, curr: acc.replace(curr[0], curr[1]), spec.items(), template
+        )
+        f.write(content)
+        f.truncate()
+
+
+def _update_file(path: pathlib.Path, spec: Mapping[str, str]) -> None:  # pragma: no cover
+    _update_file_raw(path, {f"{{{{{k.upper()}}}}}": v for k, v in spec.items()})
+
+
+def _rename_file(path: pathlib.Path, name: str) -> None:  # pragma: no cover
+    path.rename(path.parent / name)
+
+
+def _get_authors_str(authors: list[str] | None, *, unsafe: bool) -> str | None:  # pragma: no cover
+    match authors:
+        case [] | None:
+            git = _git_path(unsafe=unsafe)
+            res = subprocess.run(  # noqa: S603
+                [git, "config", "get", "user.name"], capture_output=True, check=False
+            )
+            author = res.stdout.decode().strip()
+            return json.dumps([author]) or None
+        case _:
+            return json.dumps(authors)
+
+
+def apply(  # pragma: no cover
+    name: str, *, description: str, url: str, authors: list[str] | None = None, unsafe: bool = False
+) -> None:
+    """Apply data to the project."""
+    uv = _uv_path(unsafe=unsafe)
+    authors_str = _get_authors_str(authors, unsafe=unsafe)
+    projroot = _projroot()
+    proper_name = name.title()
+    _update_file(projroot / "LICENSE", {"description": description})
+    _update_file(
+        projroot / "pyproject.toml", {"project": name, "description": description, "url": url}
+    )
+    _update_file_raw(projroot / "pyproject.toml", {"pypireg": name})
+    _replace_file(
+        projroot / "README.rst", f"{proper_name}\n{'#' * len(proper_name)}\n\n{description}.\n\n"
+    )
+    _update_file(projroot / "doc" / "conf.py", {"project": name})
+    _update_file(projroot / "doc" / "index.rst", {"project": name})
+    _update_file(
+        projroot / "src" / "pypireg" / "__init__.py",
+        {
+            "project": proper_name,
+            "distribution": name,
+            "authors": json.dumps(authors) if authors is not None else "None",
+        },
+    )
+    _update_file_raw(
+        projroot / "src" / "pypireg" / "__init__.py",
+        {"pypireg": name, "__authors__ = None": f"__authors__ = {authors_str}"},
+    )
+    _update_file(
+        projroot / "src" / "pypireg" / "__main__.py", {"project": name, "description": description}
+    )
+    _update_file_raw(projroot / "src" / "pypireg" / "__main__.py", {"pypireg": name})
+    _update_file_raw(projroot / "test" / "pypireg" / "test_main.py", {"pypireg": name})
+    _rename_file(projroot / "src" / "pypireg" / "pypireg.py", f"{name}.py")
+    _rename_file(projroot / "src" / "pypireg", name)
+    _rename_file(projroot / "test" / "pypireg", name)
+    shutil.rmtree(projroot / ".venv")
+    subprocess.run([uv, "sync"], cwd=projroot, check=False)  # noqa: S603
+    subprocess.run([uv, "run", "ruff", "format"], cwd=projroot, check=False)  # noqa: S603
+
+
+def restore(*, unsafe: bool = False) -> None:  # pragma: no cover
+    """Restore the project to its original state."""
+    git = _git_path(unsafe=unsafe)
+    uv = _uv_path(unsafe=unsafe)
+    projroot = _projroot()
+    with pathlib.Path(projroot / "pyproject.toml").open("rb") as f:
+        pyproj = tomllib.load(f)
+        name = pyproj["project"]["name"]
+    _rename_file(projroot / "src" / name / f"{name}.py", "pypireg.py")
+    _rename_file(projroot / "src" / name, "pypireg")
+    _rename_file(projroot / "test" / name, "pypireg")
+    subprocess.run([git, "restore", "."], cwd=projroot, check=False)  # noqa: S603
+    shutil.rmtree(projroot / ".venv")
+    subprocess.run([uv, "sync"], cwd=projroot, check=False)  # noqa: S603