parseforge 0.2.3__tar.gz → 0.2.4__tar.gz

{parseforge-0.2.3/parseforge.egg-info → parseforge-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: parseforge
-Version: 0.2.3
+Version: 0.2.4
 Summary: LLM-driven pipeline that forges, validates, and promotes TextFSM templates from network CLI output
 Author-email: Tuyen Mathew Duong <tuyen@geekstrident.com>
 Maintainer-email: Tuyen Mathew Duong <tuyen@geekstrident.com>
@@ -26,9 +26,13 @@ License-File: LICENSE
 Requires-Dist: click>=8.1
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: textfsm>=1.1.0
-Requires-Dist: anthropic>=0.40.0
-Requires-Dist: openai>=1.0.0
-Requires-Dist: textfsm-ai>=0.5.1
+Requires-Dist: textfsm-ai>=0.6.1
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40.0; extra == "anthropic"
+Requires-Dist: textfsm-ai[anthropic]>=0.6.1; extra == "anthropic"
+Provides-Extra: deepseek
+Requires-Dist: openai>=1.0.0; extra == "deepseek"
+Requires-Dist: textfsm-ai[deepseek]>=0.6.1; extra == "deepseek"
 Provides-Extra: sampling
 Requires-Dist: netmiko>=4.0; extra == "sampling"
 Provides-Extra: dev
@@ -37,6 +41,11 @@ Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
 Requires-Dist: ruff>=0.4.0; extra == "dev"
 Requires-Dist: black>=24.0.0; extra == "dev"
 Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: anthropic>=0.40.0; extra == "dev"
+Requires-Dist: openai>=1.0.0; extra == "dev"
+Provides-Extra: release
+Requires-Dist: bump2version; extra == "release"
+Requires-Dist: build; extra == "release"
 Dynamic: license-file
 
 # ParseForge
@@ -65,12 +74,35 @@ wired into the CLI below. A few things are intentionally not there yet:
 - **One sampling connector** (Netmiko/SSH). The CLI's `--connector` registry
   is built to hold more without a redesign, but nothing else is wired in yet.
 
+## Installation
+
+```
+pip install parseforge[anthropic]
+```
+`pip install parseforge` alone installs no AI-provider SDK at all — every
+command that's pure local processing (`canonical`/`readable`/`recognizers`,
+`integration`, `promotion`) works with nothing further. Anything that calls an
+LLM (`name`, `check --provider`, `run`, `generate-template`, `trial`) needs the
+extra for whichever provider it uses: `anthropic` or `deepseek`. `--provider`
+defaults to `anthropic` wherever it isn't required, so that's the one most
+setups need. `pip install parseforge[sampling]` adds Netmiko for live device
+sampling; combine extras as needed, e.g.
+`pip install parseforge[anthropic,deepseek,sampling]`.
+
 ## Development
 
 ```
 pip install -e ".[dev,sampling]"
 pytest
 ```
+`dev` already includes both `anthropic` and `openai` (tests exercise both
+providers, never silently skip) — add `,anthropic`/`,deepseek` explicitly only
+if installing outside of `dev`.
+
+Linting/formatting/type-checking/docs run through tox instead of extras — see
+`tox.ini` (`tox -e lint`/`format`/`typecheck`/`docs`), each installing its own
+tools in an isolated env. Cutting a release needs `pip install -e ".[release]"`
+(`bump2version`, `build`) — see `scripts/release.ps1`.
 
 ## CLI
 

{parseforge-0.2.3 → parseforge-0.2.4}/README.md

@@ -24,12 +24,35 @@ wired into the CLI below. A few things are intentionally not there yet:
 - **One sampling connector** (Netmiko/SSH). The CLI's `--connector` registry
   is built to hold more without a redesign, but nothing else is wired in yet.
 
+## Installation
+
+```
+pip install parseforge[anthropic]
+```
+`pip install parseforge` alone installs no AI-provider SDK at all — every
+command that's pure local processing (`canonical`/`readable`/`recognizers`,
+`integration`, `promotion`) works with nothing further. Anything that calls an
+LLM (`name`, `check --provider`, `run`, `generate-template`, `trial`) needs the
+extra for whichever provider it uses: `anthropic` or `deepseek`. `--provider`
+defaults to `anthropic` wherever it isn't required, so that's the one most
+setups need. `pip install parseforge[sampling]` adds Netmiko for live device
+sampling; combine extras as needed, e.g.
+`pip install parseforge[anthropic,deepseek,sampling]`.
+
 ## Development
 
 ```
 pip install -e ".[dev,sampling]"
 pytest
 ```
+`dev` already includes both `anthropic` and `openai` (tests exercise both
+providers, never silently skip) — add `,anthropic`/`,deepseek` explicitly only
+if installing outside of `dev`.
+
+Linting/formatting/type-checking/docs run through tox instead of extras — see
+`tox.ini` (`tox -e lint`/`format`/`typecheck`/`docs`), each installing its own
+tools in an isolated env. Cutting a release needs `pip install -e ".[release]"`
+(`bump2version`, `build`) — see `scripts/release.ps1`.
 
 ## CLI
 

parseforge-0.2.4/parseforge/__init__.py

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

{parseforge-0.2.3 → parseforge-0.2.4}/parseforge/generation.py

@@ -78,7 +78,12 @@ def generate(
     forwards to ``run_pipeline()`` for everything else (``endpoint``,
     ``region``, ``max_tries``, ...).
 
-    Never raises for a failed generation — check ``.ready``.
+    Never raises for a failed *generation* (a bad/truncated LLM response) —
+    check ``.ready`` for that. Does raise ``ImportError`` if ``provider``'s
+    SDK isn't installed (textfsm-ai's own lazy provider registry, pointing
+    at the right ``pip install textfsm-ai[<provider>]`` extra) — a missing
+    package is an environment problem, not a generation outcome, and is
+    treated the same way here as in :mod:`parseforge.naming.providers`.
     """
     result = run_pipeline(
         sample, provider, api_key, model, mode="debug", as_json=True, **kwargs

{parseforge-0.2.3 → parseforge-0.2.4}/parseforge/naming/providers/anthropic.py

@@ -3,9 +3,7 @@
 from __future__ import annotations
 
 import time
-from typing import Any
-
-from anthropic import Anthropic, AnthropicError
+from typing import TYPE_CHECKING, Any
 
 from ..llm import CliContext, LLMCLIResponse, TokenUsage, build_prompt
 from .cost import estimate_cost
@@ -13,6 +11,9 @@ from .errors import format_llm_error_reason, is_retryable
 from .models import default_model
 from .text import extract_pattern
 
+if TYPE_CHECKING:
+    import anthropic as anthropic_sdk
+
 DEFAULT_MODEL = default_model("anthropic")
 
 # Headroom in case a future/opt-in extended-thinking model burns part of
@@ -21,6 +22,21 @@ DEFAULT_MODEL = default_model("anthropic")
 _DEFAULT_MAX_TOKENS = 1024
 
 
+def _import_anthropic() -> Any:
+    """Deferred import — anthropic is an optional extra (parseforge[anthropic]);
+    nothing else in this module (or a cache-hit lookup, which never reaches
+    build_pattern at all — see resolver.cli_name) should require it to be
+    installed."""
+    try:
+        import anthropic
+    except ImportError as exc:
+        raise ImportError(
+            "the anthropic package is required to use AnthropicRegexBuilder — "
+            "install it via `pip install parseforge[anthropic]`"
+        ) from exc
+    return anthropic
+
+
 class AnthropicRegexBuilder:
     """Builds a cli-name regex pattern by prompting a Claude model.
 
@@ -38,18 +54,22 @@ class AnthropicRegexBuilder:
     def __init__(self, model: str = DEFAULT_MODEL, api_key: str | None = None) -> None:
         self.model = model
         self._api_key = api_key
-        self._client: Anthropic | None = None
+        self._client: anthropic_sdk.Anthropic | None = None
 
-    def _get_client(self) -> Anthropic:
+    def _get_client(self) -> anthropic_sdk.Anthropic:
         if self._client is None:
+            anthropic = _import_anthropic()
             self._client = (
-                Anthropic(api_key=self._api_key) if self._api_key else Anthropic()
+                anthropic.Anthropic(api_key=self._api_key)
+                if self._api_key
+                else anthropic.Anthropic()
             )
         return self._client
 
     def build_pattern(
         self, command: str, context: CliContext, **kwargs: Any
     ) -> LLMCLIResponse:
+        anthropic = _import_anthropic()
         prompt = build_prompt(command, context)
         max_tokens = kwargs.pop("max_tokens", None) or _DEFAULT_MAX_TOKENS
 
@@ -61,7 +81,7 @@ class AnthropicRegexBuilder:
                 messages=[{"role": "user", "content": prompt}],
                 **kwargs,
             )
-        except AnthropicError as exc:
+        except anthropic.AnthropicError as exc:
             if not is_retryable(exc):
                 # Same request would fail the same way again — stop rather
                 # than let a caller burn another attempt on it.

{parseforge-0.2.3 → parseforge-0.2.4}/parseforge/naming/providers/deepseek.py

@@ -9,9 +9,7 @@ from __future__ import annotations
 
 import os
 import time
-from typing import Any
-
-from openai import OpenAI, OpenAIError
+from typing import TYPE_CHECKING, Any
 
 from ..llm import CliContext, LLMCLIResponse, TokenUsage, build_prompt
 from .cost import estimate_cost
@@ -19,6 +17,9 @@ from .errors import format_llm_error_reason, is_retryable
 from .models import default_model
 from .text import extract_pattern
 
+if TYPE_CHECKING:
+    import openai as openai_sdk
+
 DEFAULT_MODEL = default_model("deepseek")
 
 _BASE_URL = "https://api.deepseek.com"
@@ -34,6 +35,21 @@ _DEFAULT_MAX_TOKENS = 1024
 _THINKING_DISABLED = {"thinking": {"type": "disabled"}}
 
 
+def _import_openai() -> Any:
+    """Deferred import — openai is an optional extra (parseforge[deepseek]);
+    nothing else in this module (or a cache-hit lookup, which never reaches
+    build_pattern at all — see resolver.cli_name) should require it to be
+    installed."""
+    try:
+        import openai
+    except ImportError as exc:
+        raise ImportError(
+            "the openai package is required to use DeepSeekRegexBuilder — "
+            "install it via `pip install parseforge[deepseek]`"
+        ) from exc
+    return openai
+
+
 class DeepSeekRegexBuilder:
     """Builds a cli-name regex pattern by prompting a DeepSeek model.
 
@@ -53,21 +69,23 @@ class DeepSeekRegexBuilder:
     def __init__(self, model: str = DEFAULT_MODEL, api_key: str | None = None) -> None:
         self.model = model
         self._api_key = api_key
-        self._client: OpenAI | None = None
+        self._client: openai_sdk.OpenAI | None = None
 
-    def _get_client(self) -> OpenAI:
+    def _get_client(self) -> openai_sdk.OpenAI:
         if self._client is None:
+            openai = _import_openai()
             api_key = self._api_key or os.environ.get("DEEPSEEK_API_KEY")
             if not api_key:
                 raise RuntimeError(
                     "no DeepSeek API key — pass api_key or set DEEPSEEK_API_KEY"
                 )
-            self._client = OpenAI(api_key=api_key, base_url=_BASE_URL)
+            self._client = openai.OpenAI(api_key=api_key, base_url=_BASE_URL)
         return self._client
 
     def build_pattern(
         self, command: str, context: CliContext, **kwargs: Any
     ) -> LLMCLIResponse:
+        openai = _import_openai()
         prompt = build_prompt(command, context)
         # Callers can override either of these per-call (e.g. re-enable
         # thinking mode, raise max_tokens further); anything else in
@@ -84,7 +102,7 @@ class DeepSeekRegexBuilder:
                 extra_body=extra_body,
                 **kwargs,
             )
-        except OpenAIError as exc:
+        except openai.OpenAIError as exc:
             if not is_retryable(exc):
                 # Same request would fail the same way again — stop rather
                 # than let a caller burn another attempt on it.

{parseforge-0.2.3 → parseforge-0.2.4/parseforge.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: parseforge
-Version: 0.2.3
+Version: 0.2.4
 Summary: LLM-driven pipeline that forges, validates, and promotes TextFSM templates from network CLI output
 Author-email: Tuyen Mathew Duong <tuyen@geekstrident.com>
 Maintainer-email: Tuyen Mathew Duong <tuyen@geekstrident.com>
@@ -26,9 +26,13 @@ License-File: LICENSE
 Requires-Dist: click>=8.1
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: textfsm>=1.1.0
-Requires-Dist: anthropic>=0.40.0
-Requires-Dist: openai>=1.0.0
-Requires-Dist: textfsm-ai>=0.5.1
+Requires-Dist: textfsm-ai>=0.6.1
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40.0; extra == "anthropic"
+Requires-Dist: textfsm-ai[anthropic]>=0.6.1; extra == "anthropic"
+Provides-Extra: deepseek
+Requires-Dist: openai>=1.0.0; extra == "deepseek"
+Requires-Dist: textfsm-ai[deepseek]>=0.6.1; extra == "deepseek"
 Provides-Extra: sampling
 Requires-Dist: netmiko>=4.0; extra == "sampling"
 Provides-Extra: dev
@@ -37,6 +41,11 @@ Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
 Requires-Dist: ruff>=0.4.0; extra == "dev"
 Requires-Dist: black>=24.0.0; extra == "dev"
 Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: anthropic>=0.40.0; extra == "dev"
+Requires-Dist: openai>=1.0.0; extra == "dev"
+Provides-Extra: release
+Requires-Dist: bump2version; extra == "release"
+Requires-Dist: build; extra == "release"
 Dynamic: license-file
 
 # ParseForge
@@ -65,12 +74,35 @@ wired into the CLI below. A few things are intentionally not there yet:
 - **One sampling connector** (Netmiko/SSH). The CLI's `--connector` registry
   is built to hold more without a redesign, but nothing else is wired in yet.
 
+## Installation
+
+```
+pip install parseforge[anthropic]
+```
+`pip install parseforge` alone installs no AI-provider SDK at all — every
+command that's pure local processing (`canonical`/`readable`/`recognizers`,
+`integration`, `promotion`) works with nothing further. Anything that calls an
+LLM (`name`, `check --provider`, `run`, `generate-template`, `trial`) needs the
+extra for whichever provider it uses: `anthropic` or `deepseek`. `--provider`
+defaults to `anthropic` wherever it isn't required, so that's the one most
+setups need. `pip install parseforge[sampling]` adds Netmiko for live device
+sampling; combine extras as needed, e.g.
+`pip install parseforge[anthropic,deepseek,sampling]`.
+
 ## Development
 
 ```
 pip install -e ".[dev,sampling]"
 pytest
 ```
+`dev` already includes both `anthropic` and `openai` (tests exercise both
+providers, never silently skip) — add `,anthropic`/`,deepseek` explicitly only
+if installing outside of `dev`.
+
+Linting/formatting/type-checking/docs run through tox instead of extras — see
+`tox.ini` (`tox -e lint`/`format`/`typecheck`/`docs`), each installing its own
+tools in an isolated env. Cutting a release needs `pip install -e ".[release]"`
+(`bump2version`, `build`) — see `scripts/release.ps1`.
 
 ## CLI
 

{parseforge-0.2.3 → parseforge-0.2.4}/parseforge.egg-info/requires.txt

@@ -1,9 +1,15 @@
 click>=8.1
 PyYAML>=6.0
 textfsm>=1.1.0
+textfsm-ai>=0.6.1
+
+[anthropic]
 anthropic>=0.40.0
+textfsm-ai[anthropic]>=0.6.1
+
+[deepseek]
 openai>=1.0.0
-textfsm-ai>=0.5.1
+textfsm-ai[deepseek]>=0.6.1
 
 [dev]
 pytest>=8.0.0
@@ -11,6 +17,12 @@ pytest-cov>=5.0.0
 ruff>=0.4.0
 black>=24.0.0
 mypy>=1.10.0
+anthropic>=0.40.0
+openai>=1.0.0
+
+[release]
+bump2version
+build
 
 [sampling]
 netmiko>=4.0

{parseforge-0.2.3 → parseforge-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "parseforge"
-version = "0.2.3"
+version = "0.2.4"
 description = "LLM-driven pipeline that forges, validates, and promotes TextFSM templates from network CLI output"
 readme = "README.md"
 license = { text = "MIT" }
@@ -22,9 +22,7 @@ dependencies = [
     "click>=8.1",
     "PyYAML>=6.0",
     "textfsm>=1.1.0",
-    "anthropic>=0.40.0",
-    "openai>=1.0.0",
-    "textfsm-ai>=0.5.1",
+    "textfsm-ai>=0.6.1",
 ]
 
 classifiers = [
@@ -59,6 +57,13 @@ keywords = [
 ]
 
 [project.optional-dependencies]
+# textfsm-ai v0.6.0+ made every provider SDK an optional extra (lazy
+# import; a clear ImportError only when that provider is actually used).
+# parseforge mirrors that per-provider: `pip install parseforge` alone
+# now installs no AI-provider SDK at all -- add the extra(s) for the
+# provider(s) you actually use.
+anthropic = ["anthropic>=0.40.0", "textfsm-ai[anthropic]>=0.6.1"]
+deepseek = ["openai>=1.0.0", "textfsm-ai[deepseek]>=0.6.1"]
 sampling = ["netmiko>=4.0"]
 dev = [
     "pytest>=8.0.0",
@@ -66,6 +71,19 @@ dev = [
     "ruff>=0.4.0",
     "black>=24.0.0",
     "mypy>=1.10.0",
+    # anthropic/openai are optional at runtime (see the extras above), but
+    # both providers are exercised by the CLI/tests, which should never
+    # silently skip -- so dev always pulls both in.
+    "anthropic>=0.40.0",
+    "openai>=1.0.0",
+]
+# Tooling for scripts/release.ps1 and CI's own package-build step.
+# bump2version isn't otherwise installed anywhere -- release.ps1 assumes
+# it's already on PATH. twine is deliberately not here: the actual PyPI
+# publish goes through pypa/gh-action-pypi-publish, not `twine upload`.
+release = [
+    "bump2version",
+    "build",
 ]
 
 [project.scripts]

parseforge-0.2.3/parseforge/__init__.py

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