optforge 0.2.0__tar.gz → 0.3.0__tar.gz

{optforge-0.2.0 → optforge-0.3.0}/.gitignore

@@ -7,6 +7,10 @@ wheels/
 *.egg-info
 .ruff_cache
 .mypy_cache
+.pytest_cache
+.coverage
+htmlcov/
 # Virtual environments
 .venv
 .vscode/
+.idea/

optforge-0.3.0/Makefile

@@ -0,0 +1,41 @@
+.PHONY: help install lint format format-check typecheck test check build clean
+
+UV ?= uv
+
+help:
+	@echo "OptForge targets"
+	@echo "  install      Sync the virtual environment (uv sync --all-extras)"
+	@echo "  lint         Run ruff"
+	@echo "  format       Format with ruff"
+	@echo "  format-check Verify formatting without changing files"
+	@echo "  typecheck    Run mypy"
+	@echo "  test         Run pytest"
+	@echo "  check        lint + format-check + typecheck + test"
+	@echo "  build        Build sdist and wheel"
+	@echo "  clean        Remove caches and build artifacts"
+
+install:
+	$(UV) sync --all-extras
+
+lint:
+	$(UV) run ruff check .
+
+format:
+	$(UV) run ruff format .
+
+format-check:
+	$(UV) run ruff format --check .
+
+typecheck:
+	$(UV) run mypy src
+
+test:
+	$(UV) run pytest
+
+check: lint format-check typecheck test
+
+build:
+	$(UV) build
+
+clean:
+	$(UV) run python -c "import pathlib, shutil; [shutil.rmtree(p, ignore_errors=True) for p in pathlib.Path('.').rglob('__pycache__')]; [shutil.rmtree(pathlib.Path(p), ignore_errors=True) for p in ('.mypy_cache', '.ruff_cache', '.pytest_cache', 'dist', 'build', 'htmlcov')]; [pathlib.Path(p).unlink(missing_ok=True) for p in ('.coverage',)]"

{optforge-0.2.0 → optforge-0.3.0}/PKG-INFO

@@ -1,46 +1,24 @@
 Metadata-Version: 2.5
 Name: optforge
-Version: 0.2.0
+Version: 0.3.0
 Summary: Cross-platform developer CLI tools for ports, environment variables, disk usage, and Python cache cleanup.
 Project-URL: Homepage, https://github.com/cmd-3324/OptForge
 Project-URL: Repository, https://github.com/cmd-3324/OptForge
 Project-URL: Issues, https://github.com/cmd-3324/OptForge/issues
 Author-email: Max Miller <ali.alipour4576@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2026 OptForge contributors
-        
-        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.
+License-Expression: MIT
 License-File: LICENSE
 Keywords: cli,developer-tools,disk,environment,ports,pycache
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Systems Administration
 Classifier: Typing :: Typed
-Requires-Python: >=3.13
+Requires-Python: >=3.14.7
 Requires-Dist: psutil>=6.0.0
 Requires-Dist: pycaw>=20240210; sys_platform == 'win32'
 Requires-Dist: rich>=13.7.0
@@ -50,6 +28,7 @@ Requires-Dist: mypy>=1.10.0; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Requires-Dist: types-psutil>=6.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # OptForge
@@ -126,50 +105,43 @@ Most tools are designed to be simple, fast, and cross-platform; `killNotif` is W
 
 ## Installation
 
-### Install with pipx
+Python 3.14.7 or newer is required.
+
+### Install from PyPI with pipx
 
 The recommended installation method is pipx:
 
 ```bash
-pipx install git+https://github.com/cmd-3324/OptForge.git
+pipx install optforge
 ```
 
-If you are working from a local clone:
+### Install from PyPI with pip
 
 ```bash
-cd OptForge
-pipx install --editable .
+python -m pip install optforge
 ```
 
-### Install with pip
+### Install from a local clone
 
 ```bash
 git clone https://github.com/cmd-3324/OptForge.git
 cd OptForge
-python -m pip install .
-```
-
-### Download the latest Windows executable
-
-You can download the latest Windows `.exe` release directly from GitHub Releases:
-
-```text
-https://github.com/cmd-3324/OptForge/releases/latest
+pipx install --editable .
 ```
 
-This is useful if you want to run OptForge without installing Python dependencies manually.
-
 ## Quick start
 
 After installation, the package exposes the following commands:
 
 ```bash
+optforge --help
 portcheck --help
 envcheck --help
 diskcheck --help
 pycache-clean --help
 vol --help
 killNotif --help   # Windows 10/11 only
+optforge killNotif --help
 ```
 
 ## Platform support
@@ -293,7 +265,7 @@ make test
 
 ## Requirements
 
-- Python 3.13+
+- Python 3.14.7+
 - Typer
 - Rich
 - psutil

{optforge-0.2.0 → optforge-0.3.0}/README.md

@@ -72,50 +72,43 @@ Most tools are designed to be simple, fast, and cross-platform; `killNotif` is W
 
 ## Installation
 
-### Install with pipx
+Python 3.14.7 or newer is required.
+
+### Install from PyPI with pipx
 
 The recommended installation method is pipx:
 
 ```bash
-pipx install git+https://github.com/cmd-3324/OptForge.git
+pipx install optforge
 ```
 
-If you are working from a local clone:
+### Install from PyPI with pip
 
 ```bash
-cd OptForge
-pipx install --editable .
+python -m pip install optforge
 ```
 
-### Install with pip
+### Install from a local clone
 
 ```bash
 git clone https://github.com/cmd-3324/OptForge.git
 cd OptForge
-python -m pip install .
-```
-
-### Download the latest Windows executable
-
-You can download the latest Windows `.exe` release directly from GitHub Releases:
-
-```text
-https://github.com/cmd-3324/OptForge/releases/latest
+pipx install --editable .
 ```
 
-This is useful if you want to run OptForge without installing Python dependencies manually.
-
 ## Quick start
 
 After installation, the package exposes the following commands:
 
 ```bash
+optforge --help
 portcheck --help
 envcheck --help
 diskcheck --help
 pycache-clean --help
 vol --help
 killNotif --help   # Windows 10/11 only
+optforge killNotif --help
 ```
 
 ## Platform support
@@ -239,7 +232,7 @@ make test
 
 ## Requirements
 
-- Python 3.13+
+- Python 3.14.7+
 - Typer
 - Rich
 - psutil

{optforge-0.2.0 → optforge-0.3.0}/pyproject.toml

@@ -1,23 +1,22 @@
 [project]
 name = "optforge"
-version = "0.2.0"
+dynamic = ["version"]
 description = "Cross-platform developer CLI tools for ports, environment variables, disk usage, and Python cache cleanup."
 readme = "README.md"
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [
     { name = "Max Miller", email = "ali.alipour4576@gmail.com" },
 ]
 
-requires-python = ">=3.13"
+requires-python = ">=3.14.7"
 keywords = ["cli", "developer-tools", "ports", "environment", "disk", "pycache"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: System :: Systems Administration",
@@ -36,6 +35,7 @@ dev = [
     "pytest>=8.0.0",
     "pytest-cov>=5.0.0",
     "ruff>=0.6.0",
+    "types-psutil>=6.0.0",
 ]
 
 [project.scripts]
@@ -54,9 +54,12 @@ Repository = "https://github.com/cmd-3324/OptForge"
 Issues = "https://github.com/cmd-3324/OptForge/issues"
 
 [build-system]
-requires = ["hatchling>=1.24.0"]
+requires = ["hatchling>=1.33.0"]
 build-backend = "hatchling.build"
 
+[tool.hatch.version]
+path = "src/optforge/_version.py"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/optforge"]
 
@@ -72,18 +75,14 @@ include = [
 
 [tool.ruff]
 line-length = 120
-target-version = "py313"
+target-version = "py314"
 src = ["src", "tests"]
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B", "SIM", "C4", "PIE", "RUF"]
-ignore = ["B008"]
-
-[tool.ruff.lint.per-file-ignores]
-"tests/*" = ["S101"]
 
 [tool.mypy]
-python_version = "3.13"
+python_version = "3.14"
 files = ["src"]
 check_untyped_defs = true
 disallow_untyped_defs = true

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/__init__.py

@@ -2,9 +2,7 @@
 
 from __future__ import annotations
 
-from optforge.core.version import get_version
-
-__version__ = get_version()
+from optforge._version import __version__
 
 
 def main() -> None:

optforge-0.3.0/src/optforge/_version.py

@@ -0,0 +1,5 @@
+"""Single source of truth for the package version."""
+
+from __future__ import annotations
+
+__version__ = "0.3.0"

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/cli.py

@@ -9,6 +9,7 @@ import typer
 from optforge.core.version import get_version
 from optforge.diskcheck.cli import app as diskcheck_app
 from optforge.envcheck.cli import app as envcheck_app
+from optforge.killNotif.cli import app as killnotif_app
 from optforge.portcheck.cli import app as portcheck_app
 from optforge.pycacheclean.cli import app as pycacheclean_app
 from optforge.volume.cli import app as volume_app
@@ -49,6 +50,7 @@ app.add_typer(envcheck_app, name="envcheck")
 app.add_typer(diskcheck_app, name="diskcheck")
 app.add_typer(pycacheclean_app, name="pycache-clean")
 app.add_typer(pycacheclean_app, name="pycacheClean", hidden=True)
+app.add_typer(killnotif_app, name="killNotif")
 app.add_typer(volume_app, name="vol")
 
 

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/core/cli.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from enum import IntEnum
 from types import TracebackType
-from typing import Self
+from typing import Literal, Self
 
 import typer
 
@@ -42,7 +42,7 @@ class ErrorBoundary:
         exc_type: type[BaseException] | None,
         exc: BaseException | None,
         traceback: TracebackType | None,
-    ) -> bool:
+    ) -> Literal[False]:
         if exc is None:
             return False
         if isinstance(exc, PermissionDenied):

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/core/console.py

@@ -38,16 +38,18 @@ class ConsoleIO:
         self.out.print(Text(str(value)))
 
     def success(self, message: str) -> None:
-        self.out.print(f"[green]{message}[/green]")
+        self.out.print(Text(message, style="green"))
 
     def warning(self, message: str) -> None:
-        self.err.print(f"[yellow]{message}[/yellow]")
+        self.err.print(Text(message, style="yellow"))
 
     def error(self, message: str) -> None:
-        self.err.print(f"[red]error:[/red] {message}")
+        line = Text("error: ", style="bold red")
+        line.append(str(message))
+        self.err.print(line)
 
     def hint(self, message: str) -> None:
-        self.err.print(f"[dim]{message}[/dim]")
+        self.err.print(Text(message, style="dim"))
 
     def json(self, data: Any) -> None:
         """Emit exact, machine-parseable JSON on stdout."""

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/core/net.py

@@ -9,8 +9,7 @@ each returned endpoint with the remaining time.
 from __future__ import annotations
 
 import socket
-from concurrent.futures import ThreadPoolExecutor
-from concurrent.futures import TimeoutError as FuturesTimeoutError
+import threading
 from dataclasses import dataclass
 from typing import Any
 
@@ -74,14 +73,25 @@ def resolve_endpoints(host: str, port: int, *, passive: bool = False) -> list[En
 
 
 def resolve_endpoints_with_timeout(host: str, port: int, timeout: float) -> list[Endpoint]:
-    """Resolve ``host`` while enforcing ``timeout`` on the DNS lookup."""
-    executor = ThreadPoolExecutor(max_workers=1, thread_name_prefix="optforge-dns")
-    future = executor.submit(resolve_endpoints, host, port)
-    try:
-        return future.result(timeout=timeout)
-    except FuturesTimeoutError as exc:
-        raise OperationFailed(
-            f"Timed out after {timeout:g}s while resolving {host!r}."
-        ) from exc
-    finally:
-        executor.shutdown(wait=False, cancel_futures=True)
+    """Resolve ``host`` while enforcing ``timeout`` on the DNS lookup.
+
+    The lookup runs in a daemon thread so a resolver that ignores its own
+    deadline cannot block interpreter shutdown.
+    """
+    endpoints: list[Endpoint] = []
+    failures: list[BaseException] = []
+
+    def worker() -> None:
+        try:
+            endpoints.extend(resolve_endpoints(host, port))
+        except BaseException as exc:
+            failures.append(exc)
+
+    thread = threading.Thread(target=worker, name="optforge-dns", daemon=True)
+    thread.start()
+    thread.join(timeout)
+    if thread.is_alive():
+        raise OperationFailed(f"Timed out after {timeout:g}s while resolving {host!r}.")
+    if failures:
+        raise failures[0]
+    return endpoints

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/core/processes.py

@@ -29,7 +29,7 @@ class ProcessNameResolver:
             return cached
         try:
             resolved = self._factory(pid).name()
-        except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
+        except psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess:
             resolved = _UNKNOWN
         self._cache[pid] = resolved
         return resolved

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/core/version.py

@@ -4,12 +4,12 @@ from __future__ import annotations
 
 from importlib.metadata import PackageNotFoundError, version
 
-FALLBACK_VERSION = "0.2.0"
+from optforge._version import __version__
 
 
 def get_version(distribution: str = "optforge") -> str:
-    """Return the installed distribution version, or the source-tree fallback."""
+    """Return the installed distribution version, or the source-tree version."""
     try:
         return version(distribution)
     except PackageNotFoundError:
-        return FALLBACK_VERSION
+        return __version__

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/diskcheck/cli.py

@@ -19,7 +19,7 @@ app = typer.Typer(
     help="Inspect disk usage and warn when storage pressure crosses a threshold.",
     no_args_is_help=False,
     rich_markup_mode="rich",
-    context_settings={"help_option_names": ["-h", "--help"]},
+    context_settings={"help_option_names": ["-h", "--help"], "allow_interspersed_args": True},
 )
 console = ConsoleIO()
 
@@ -102,9 +102,7 @@ def main(
     over_threshold = warn_at is not None and any(info.percent_used >= warn_at for info in infos)
     if over_threshold:
         if not as_json:
-            console.warning(
-                f"Storage pressure: at least one volume is at or above {warn_at:g}% used."
-            )
+            console.warning(f"Storage pressure: at least one volume is at or above {warn_at:g}% used.")
         raise typer.Exit(ExitCode.NO)
     raise typer.Exit(ExitCode.OK)
 

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/envcheck/cli.py

@@ -18,7 +18,7 @@ app = typer.Typer(
     help="Inspect environment variables and runtime configuration. Secrets are redacted by default.",
     no_args_is_help=False,
     rich_markup_mode="rich",
-    context_settings={"help_option_names": ["-h", "--help"]},
+    context_settings={"help_option_names": ["-h", "--help"], "allow_interspersed_args": True},
 )
 console = ConsoleIO()
 
@@ -67,9 +67,7 @@ def main(
         OutputFormat,
         typer.Option("--format", "-f", case_sensitive=False, help="Output format."),
     ] = OutputFormat.table,
-    as_json: Annotated[
-        bool, typer.Option("--json", help="Alias for --format json.")
-    ] = False,
+    as_json: Annotated[bool, typer.Option("--json", help="Alias for --format json.")] = False,
     version: Annotated[
         bool | None,
         typer.Option(

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/envcheck/models.py

@@ -3,11 +3,11 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from enum import Enum
+from enum import StrEnum
 from typing import Any
 
 
-class OutputFormat(str, Enum):
+class OutputFormat(StrEnum):
     """Supported ``envcheck`` output formats."""
 
     table = "table"

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/envcheck/service.py

@@ -8,7 +8,7 @@ from collections.abc import Mapping
 from optforge.core.redaction import SecretRedactor
 from optforge.envcheck.models import EnvEntry
 
-_QUOTE_TRIGGERS = frozenset(' \t\n#"\'')
+_QUOTE_TRIGGERS = frozenset(" \t\n#\"'")
 
 
 class EnvironmentService:
@@ -43,9 +43,7 @@ class EnvironmentService:
             redacted = False
             if redact and sensitive:
                 value, redacted = self._redactor.redact(key, raw)
-            entries.append(
-                EnvEntry(key=key, value=value, sensitive=sensitive, redacted=redacted)
-            )
+            entries.append(EnvEntry(key=key, value=value, sensitive=sensitive, redacted=redacted))
         return entries
 
     @staticmethod
@@ -57,10 +55,5 @@ class EnvironmentService:
 def _dotenv_line(entry: EnvEntry) -> str:
     if not entry.value or not (set(entry.value) & _QUOTE_TRIGGERS):
         return f"{entry.key}={entry.value}"
-    escaped = (
-        entry.value.replace("\\", "\\\\")
-        .replace('"', '\\"')
-        .replace("\n", "\\n")
-        .replace("\t", "\\t")
-    )
+    escaped = entry.value.replace("\\", "\\\\").replace('"', '\\"').replace("\n", "\\n").replace("\t", "\\t")
     return f'{entry.key}="{escaped}"'

optforge-0.3.0/src/optforge/killNotif/__init__.py

@@ -0,0 +1,7 @@
+"""Windows toast notification cleanup."""
+
+from __future__ import annotations
+
+from optforge.killNotif.core import clear_notifications
+
+__all__ = ["clear_notifications"]

{optforge-0.2.0 → optforge-0.3.0}/src/optforge/killNotif/cli.py

@@ -38,9 +38,7 @@ AumidOpt = Annotated[
         help="Only clear notifications from this AppUserModelID.",
     ),
 ]
-QuietOpt = Annotated[
-    bool, typer.Option("--quiet", "-q", help="Print nothing; use the exit code only.")
-]
+QuietOpt = Annotated[bool, typer.Option("--quiet", "-q", help="Print nothing; use the exit code only.")]
 JsonOpt = Annotated[bool, typer.Option("--json", help="Print machine-readable JSON.")]
 
 
@@ -71,7 +69,7 @@ def _run(aumid: str | None) -> int:
         raise OperationFailed(f"unexpected helper output: {exc}") from exc
 
 
-@app.command()
+@app.callback(invoke_without_command=True)
 def main(
     aumid: AumidOpt = None,
     json_output: JsonOpt = False,

optforge-0.3.0/src/optforge/killNotif/core.py

@@ -0,0 +1,43 @@
+"""Run the bundled PowerShell helper that clears Windows toast history."""
+
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+JOB = Path(__file__).with_name("job.ps1")
+POWERSHELL_TIMEOUT_SECONDS = 30
+
+
+def clear_notifications(aumid: str | None = None) -> int:
+    """Clear all notifications (or one sender's). Returns senders cleared."""
+    if not JOB.exists():
+        raise FileNotFoundError(f"helper script missing: {JOB}")
+
+    cmd = [
+        "powershell",
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "RemoteSigned",
+        "-File",
+        str(JOB),
+    ]
+    if aumid:
+        cmd += ["-Aumid", aumid]
+
+    try:
+        res = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=POWERSHELL_TIMEOUT_SECONDS,
+        )
+    except subprocess.TimeoutExpired as exc:
+        raise RuntimeError(f"PowerShell timed out after {POWERSHELL_TIMEOUT_SECONDS}s.") from exc
+
+    if res.returncode != 0:
+        raise RuntimeError((res.stderr or res.stdout).strip() or "job.ps1 failed")
+
+    out = res.stdout.strip().splitlines()[-1] if res.stdout.strip() else "0"
+    return int(out)