venv-init 1.1.1__tar.gz

venv_init-1.1.1/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [main]
+    tags:
+      - "v*"
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Save package files
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package
+          path: dist/
+
+  publish:
+    needs: build
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/venv-init
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Get package files
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package
+          path: dist/
+
+      - name: Upload to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+    

venv_init-1.1.1/.gitignore

@@ -0,0 +1,2 @@
+tests
+dist

venv_init-1.1.1/LICENSE

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

venv_init-1.1.1/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: venv-init
+Version: 1.1.1
+Summary: Create and activate Python virtual environments from a simple CLI.
+Project-URL: Homepage, https://github.com/HaloMaster6482/venv-init
+Author: HaloMaster6482
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# venv-init
+
+`venv-init` is a small command-line utility for creating and activating Python
+virtual environments. On Windows, activation starts a PowerShell session that
+sets a process-only execution policy before loading the environment's activation
+script—no machine-wide policy change is made.
+
+## Install from PyPI
+
+```powershell
+py -m pip install venv-init
+```
+
+Upgrade an existing installation with:
+
+```powershell
+venv-init --update
+```
+
+## Usage
+
+```text
+venv-init --help
+venv-init --version
+venv-init --create [PATH]
+venv-init --activate [PATH]
+venv-init --update
+```
+
+`PATH` defaults to `.venv` in the current directory. Create it first:
+
+```powershell
+venv-init --create
+```
+
+The command asks which installed Python version to use. Press Enter to use the
+same interpreter that is running `venv-init`, or enter a version such as `3.11`.
+It shows a success message after creation and clear errors if the requested
+Python or environment cannot be found.
+
+Then activate it:
+
+```powershell
+venv-init --activate
+```
+
+On Windows, `--activate` opens a child PowerShell session and runs
+`Set-ExecutionPolicy -Scope Process Bypass` before it runs `Activate.ps1`.
+The virtual environment stays active until you run `deactivate` or close that
+session. The execution-policy setting disappears when the session ends.
+The PowerShell session also confirms when activation succeeds. `--update`
+prints a confirmation when the upgrade completes.
+
+On macOS and Linux, `--activate` prints the shell command to run, because a
+program cannot activate an environment in its parent shell.
+
+## License
+
+MIT

venv_init-1.1.1/README.md

@@ -0,0 +1,59 @@
+# venv-init
+
+`venv-init` is a small command-line utility for creating and activating Python
+virtual environments. On Windows, activation starts a PowerShell session that
+sets a process-only execution policy before loading the environment's activation
+script—no machine-wide policy change is made.
+
+## Install from PyPI
+
+```powershell
+py -m pip install venv-init
+```
+
+Upgrade an existing installation with:
+
+```powershell
+venv-init --update
+```
+
+## Usage
+
+```text
+venv-init --help
+venv-init --version
+venv-init --create [PATH]
+venv-init --activate [PATH]
+venv-init --update
+```
+
+`PATH` defaults to `.venv` in the current directory. Create it first:
+
+```powershell
+venv-init --create
+```
+
+The command asks which installed Python version to use. Press Enter to use the
+same interpreter that is running `venv-init`, or enter a version such as `3.11`.
+It shows a success message after creation and clear errors if the requested
+Python or environment cannot be found.
+
+Then activate it:
+
+```powershell
+venv-init --activate
+```
+
+On Windows, `--activate` opens a child PowerShell session and runs
+`Set-ExecutionPolicy -Scope Process Bypass` before it runs `Activate.ps1`.
+The virtual environment stays active until you run `deactivate` or close that
+session. The execution-policy setting disappears when the session ends.
+The PowerShell session also confirms when activation succeeds. `--update`
+prints a confirmation when the upgrade completes.
+
+On macOS and Linux, `--activate` prints the shell command to run, because a
+program cannot activate an environment in its parent shell.
+
+## License
+
+MIT

venv_init-1.1.1/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling >= 1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "venv-init"
+version = "1.1.1"
+description = "Create and activate Python virtual environments from a simple CLI."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+authors = [{name = "HaloMaster6482"}]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Environment :: Console",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: Microsoft :: Windows"
+]
+
+[project.scripts]
+venv-init = "venv_init.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/HaloMaster6482/venv-init"
+
+[tool.setuptools.packages.find]
+include = ["venv_init*"]

venv_init-1.1.1/src/venv_init/__init__.py

@@ -0,0 +1,3 @@
+"""Tools for creating and activating Python virtual environments."""
+
+__version__ = "1.1.1"

venv_init-1.1.1/src/venv_init/cli.py

@@ -0,0 +1,169 @@
+"""Command-line interface for venv-init."""
+
+from __future__ import annotations
+
+import argparse
+import os
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+
+from . import __version__
+
+
+def _environment_path(value: str | None) -> Path:
+    """Return the requested environment location, defaulting to .venv."""
+    return Path(value or ".venv").expanduser().resolve()
+
+
+def _choose_python() -> list[str] | None:
+    """Prompt for a Python version and return its command invocation."""
+    current_version = f"{sys.version_info.major}.{sys.version_info.minor}"
+    try:
+        requested = input(f"Python version to use [current: {current_version}]: ").strip()
+    except (EOFError, KeyboardInterrupt):
+        print("\nCreation cancelled: no Python version was selected.", file=sys.stderr)
+        return None
+
+    if not requested:
+        return [sys.executable]
+
+    if os.name == "nt":
+        candidate = ["py", f"-{requested}"]
+    else:
+        executable = shutil.which(f"python{requested}")
+        candidate = [executable] if executable else []
+
+    if not candidate:
+        print(f"Python {requested} was not found on PATH.", file=sys.stderr)
+        return None
+
+    try:
+        check = subprocess.run(
+            [*candidate, "--version"], capture_output=True, text=True, check=False
+        )
+    except OSError as error:
+        print(f"Could not start Python {requested}: {error}", file=sys.stderr)
+        return None
+    if check.returncode != 0:
+        detail = (check.stderr or check.stdout).strip()
+        print(f"Python {requested} is unavailable. {detail}", file=sys.stderr)
+        return None
+    return candidate
+
+
+def create_environment(path: Path) -> int:
+    """Ask for a Python version, then create a virtual environment with it."""
+    if path.exists() and any(path.iterdir()):
+        print(f"Refusing to replace existing non-empty directory: {path}", file=sys.stderr)
+        return 1
+
+    python_command = _choose_python()
+    if python_command is None:
+        return 1
+
+    print(f"Creating virtual environment: {path}")
+    try:
+        result = subprocess.run([*python_command, "-m", "venv", str(path)], check=False)
+    except OSError as error:
+        print(f"Could not create virtual environment: {error}", file=sys.stderr)
+        return 1
+    if result.returncode != 0:
+        print("Virtual environment creation failed.", file=sys.stderr)
+        return result.returncode or 1
+
+    print(f"Virtual environment created successfully: {path}")
+    return 0
+
+
+def activate_environment(path: Path) -> int:
+    """Activate *path* on Windows, or show the portable shell command."""
+    if not path.is_dir():
+        print(f"Virtual environment not found: {path}. Run --create first.", file=sys.stderr)
+        return 1
+
+    if os.name == "nt":
+        script = path / "Scripts" / "Activate.ps1"
+        if not script.is_file():
+            print(f"Activation script not found: {script}", file=sys.stderr)
+            return 1
+
+        # A child PowerShell is necessary: a CLI cannot modify its caller's shell.
+        escaped_script = str(script).replace("'", "''")
+        command = (
+            "$ErrorActionPreference = 'Stop'; "
+            "Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; "
+            f". '{escaped_script}'; "
+            "Write-Host 'Virtual environment activated successfully. "
+            "Type deactivate when finished.'"
+        )
+        print("Starting an activated PowerShell session...")
+        try:
+            result = subprocess.call([
+                "powershell", "-NoExit", "-NoProfile", "-Command", command
+            ])
+        except OSError as error:
+            print(f"Could not start PowerShell: {error}", file=sys.stderr)
+            return 1
+        if result:
+            print("Virtual environment activation failed.", file=sys.stderr)
+        return result
+
+    script = path / "bin" / "activate"
+    if not script.is_file():
+        print(f"Activation script not found: {script}", file=sys.stderr)
+        return 1
+    print(f"Activation command ready. Run this in your current shell:\n  . '{script}'")
+    return 0
+
+
+def update_package() -> int:
+    """Upgrade this package through the current Python interpreter."""
+    try:
+        result = subprocess.call([
+            sys.executable, "-m", "pip", "install", "--upgrade", "venv-init"
+        ])
+    except OSError as error:
+        print(f"Could not update venv-init: {error}", file=sys.stderr)
+        return 1
+    if result:
+        print("venv-init update failed.", file=sys.stderr)
+        return result
+    print("venv-init updated successfully.")
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="venv-init",
+        description="Create and activate Python virtual environments.",
+    )
+    actions = parser.add_mutually_exclusive_group()
+    actions.add_argument("--create", metavar="PATH", nargs="?", const=".venv",
+                         help="create a virtual environment (default: .venv)")
+    actions.add_argument("--activate", metavar="PATH", nargs="?", const=".venv",
+                         help="activate a virtual environment (default: .venv)")
+    actions.add_argument("--update", action="store_true",
+                         help="upgrade venv-init from PyPI")
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if args.create is not None:
+        return create_environment(_environment_path(args.create))
+    if args.activate is not None:
+        return activate_environment(_environment_path(args.activate))
+    if args.update:
+        return update_package()
+
+    parser.print_help()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())