parseforge 0.2.3__tar.gz → 0.2.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: parseforge
-Version: 0.2.3
+Version: 0.2.5
 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,16 @@ 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: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Requires-Dist: textfsm-ai[openai]>=0.6.1; extra == "openai"
 Provides-Extra: sampling
 Requires-Dist: netmiko>=4.0; extra == "sampling"
 Provides-Extra: dev
@@ -37,6 +44,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 +77,36 @@ 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`, `openai`, 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,openai,deepseek,sampling]`.
+
 ## Development
 
 ```
 pip install -e ".[dev,sampling]"
 pytest
 ```
+`dev` already includes both the `anthropic` and `openai` SDKs (tests exercise
+all three providers — `anthropic`, `openai`, `deepseek` share just those two
+packages — and never silently skip) — add `,anthropic`/`,openai`/`,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
 
@@ -87,8 +123,8 @@ parseforge name --vendor cisco --family catalyst9200 --os ios-xe --version 17.9.
 ```
 Still needs an LLM provider on a cache miss — `--provider` defaults to `anthropic`,
 and `--api-key` falls back to that provider's own env var (`ANTHROPIC_API_KEY`/
-`DEEPSEEK_API_KEY`). A cache hit (a command already seen before) never touches the
-LLM, so no key is needed at all in that case.
+`OPENAI_API_KEY`/`DEEPSEEK_API_KEY`). A cache hit (a command already seen before)
+never touches the LLM, so no key is needed at all in that case.
 
 **`check`** — validate a connector or provider before spending time/tokens on a real
 run. With neither `--env` nor explicit connection flags, prints what a connector needs

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

@@ -24,12 +24,36 @@ 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`, `openai`, 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,openai,deepseek,sampling]`.
+
 ## Development
 
 ```
 pip install -e ".[dev,sampling]"
 pytest
 ```
+`dev` already includes both the `anthropic` and `openai` SDKs (tests exercise
+all three providers — `anthropic`, `openai`, `deepseek` share just those two
+packages — and never silently skip) — add `,anthropic`/`,openai`/`,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
 
@@ -46,8 +70,8 @@ parseforge name --vendor cisco --family catalyst9200 --os ios-xe --version 17.9.
 ```
 Still needs an LLM provider on a cache miss — `--provider` defaults to `anthropic`,
 and `--api-key` falls back to that provider's own env var (`ANTHROPIC_API_KEY`/
-`DEEPSEEK_API_KEY`). A cache hit (a command already seen before) never touches the
-LLM, so no key is needed at all in that case.
+`OPENAI_API_KEY`/`DEEPSEEK_API_KEY`). A cache hit (a command already seen before)
+never touches the LLM, so no key is needed at all in that case.
 
 **`check`** — validate a connector or provider before spending time/tokens on a real
 run. With neither `--env` nor explicit connection flags, prints what a connector needs

parseforge-0.2.5/parseforge/__init__.py

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

{parseforge-0.2.3 → parseforge-0.2.5}/parseforge/cli/main.py

@@ -24,6 +24,7 @@ from parseforge.cli import config as cli_config
 _BUILDERS: dict[str, type[naming.RegexBuilder]] = {
     "anthropic": naming.AnthropicRegexBuilder,
     "deepseek": naming.DeepSeekRegexBuilder,
+    "openai": naming.OpenAIRegexBuilder,
 }
 
 _CONNECTORS = ("netmiko",)
@@ -198,7 +199,8 @@ def main() -> None:
     "--api-key",
     default=None,
     help="Provider API key. Defaults to that provider's own API key environment "
-    "variable (ANTHROPIC_API_KEY, DEEPSEEK_API_KEY); only needed on a cache miss.",
+    "variable (ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY); only needed "
+    "on a cache miss.",
 )
 @click.option(
     "--model",
@@ -266,7 +268,7 @@ def name_cmd(
     "--provider",
     required=True,
     help="LLM provider for template generation (textfsm-ai's own registry, "
-    'e.g. "anthropic", "deepseek"). Naming uses its own separate '
+    'e.g. "anthropic", "openai", "deepseek"). Naming uses its own separate '
     "--naming-provider, not this one.",
 )
 @click.option("--api-key", required=True, help="API key for the generation LLM call.")

{parseforge-0.2.3 → parseforge-0.2.5}/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.5}/parseforge/naming/__init__.py

@@ -8,7 +8,7 @@ from .llm import (
     UnimplementedRegexBuilder,
     build_prompt,
 )
-from .providers import AnthropicRegexBuilder, DeepSeekRegexBuilder
+from .providers import AnthropicRegexBuilder, DeepSeekRegexBuilder, OpenAIRegexBuilder
 from .resolver import NamingResolution, cli_name, resolve_cli_name
 
 __all__ = [
@@ -20,6 +20,7 @@ __all__ = [
     "UnimplementedRegexBuilder",
     "AnthropicRegexBuilder",
     "DeepSeekRegexBuilder",
+    "OpenAIRegexBuilder",
     "LLMCLIResponse",
     "TokenUsage",
     "build_prompt",

parseforge-0.2.5/parseforge/naming/providers/__init__.py

@@ -0,0 +1,5 @@
+from .anthropic import AnthropicRegexBuilder
+from .deepseek import DeepSeekRegexBuilder
+from .openai import OpenAIRegexBuilder
+
+__all__ = ["AnthropicRegexBuilder", "DeepSeekRegexBuilder", "OpenAIRegexBuilder"]

{parseforge-0.2.3 → parseforge-0.2.5}/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.5}/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.5}/parseforge/naming/providers/models.yaml

@@ -22,3 +22,12 @@ deepseek:
     - deepseek-v4-flash
     - deepseek-v4-pro
   deprecated: []
+
+openai:
+  default: gpt-5.4-mini
+  supported:
+    - gpt-5.4-mini
+    - gpt-5.4
+    - gpt-5.4-nano
+    - gpt-5.5
+  deprecated: []

parseforge-0.2.5/parseforge/naming/providers/openai.py

@@ -0,0 +1,117 @@
+"""OpenAI-backed RegexBuilder implementation."""
+
+from __future__ import annotations
+
+import time
+from typing import TYPE_CHECKING, Any
+
+from ..llm import CliContext, LLMCLIResponse, TokenUsage, build_prompt
+from .cost import estimate_cost
+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("openai")
+
+_DEFAULT_MAX_TOKENS = 1024
+
+
+def _import_openai() -> Any:
+    """Deferred import — openai is an optional extra (parseforge[openai]);
+    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 OpenAIRegexBuilder — "
+            "install it via `pip install parseforge[openai]`"
+        ) from exc
+    return openai
+
+
+class OpenAIRegexBuilder:
+    """Builds a cli-name regex pattern by prompting an OpenAI model.
+
+    The client is constructed lazily, on the first actual call — not in
+    ``__init__`` — so this can be used as a default RegexBuilder without
+    requiring ``OPENAI_API_KEY`` to be set for cache-hit lookups, which
+    never reach the LLM at all (see resolver.cli_name).
+
+    API key resolves from the ``api_key`` argument if given, otherwise the
+    ``OPENAI_API_KEY`` environment variable (the SDK's own default).
+    """
+
+    provider = "openai"
+
+    def __init__(self, model: str = DEFAULT_MODEL, api_key: str | None = None) -> None:
+        self.model = model
+        self._api_key = api_key
+        self._client: openai_sdk.OpenAI | None = None
+
+    def _get_client(self) -> openai_sdk.OpenAI:
+        if self._client is None:
+            openai = _import_openai()
+            self._client = (
+                openai.OpenAI(api_key=self._api_key)
+                if self._api_key
+                else openai.OpenAI()
+            )
+        return self._client
+
+    def build_pattern(
+        self, command: str, context: CliContext, **kwargs: Any
+    ) -> LLMCLIResponse:
+        openai = _import_openai()
+        prompt = build_prompt(command, context)
+        max_tokens = kwargs.pop("max_tokens", None) or _DEFAULT_MAX_TOKENS
+
+        start = time.monotonic()
+        try:
+            response = self._get_client().chat.completions.create(
+                model=self.model,
+                max_tokens=max_tokens,
+                messages=[{"role": "user", "content": prompt}],
+                **kwargs,
+            )
+        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.
+                raise
+            return LLMCLIResponse(
+                content="",
+                raw=exc,
+                usage=TokenUsage(
+                    input_tokens=0, output_tokens=0, total_tokens=0, estimated_cost=0.0
+                ),
+                duration_ms=(time.monotonic() - start) * 1000,
+                reason=format_llm_error_reason(exc),
+                ready=False,
+            )
+        duration_ms = (time.monotonic() - start) * 1000
+
+        choice = response.choices[0]
+        return LLMCLIResponse(
+            content=extract_pattern(choice.message.content or ""),
+            raw=response,
+            usage=TokenUsage(
+                input_tokens=response.usage.prompt_tokens,
+                output_tokens=response.usage.completion_tokens,
+                total_tokens=response.usage.total_tokens,
+                estimated_cost=estimate_cost(
+                    input_tokens=response.usage.prompt_tokens,
+                    output_tokens=response.usage.completion_tokens,
+                    total_tokens=response.usage.total_tokens,
+                    provider=self.provider,
+                    model=self.model,
+                ),
+            ),
+            duration_ms=duration_ms,
+            reason=choice.finish_reason or "",
+            ready=choice.finish_reason == "stop",
+        )

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: parseforge
-Version: 0.2.3
+Version: 0.2.5
 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,16 @@ 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: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Requires-Dist: textfsm-ai[openai]>=0.6.1; extra == "openai"
 Provides-Extra: sampling
 Requires-Dist: netmiko>=4.0; extra == "sampling"
 Provides-Extra: dev
@@ -37,6 +44,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 +77,36 @@ 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`, `openai`, 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,openai,deepseek,sampling]`.
+
 ## Development
 
 ```
 pip install -e ".[dev,sampling]"
 pytest
 ```
+`dev` already includes both the `anthropic` and `openai` SDKs (tests exercise
+all three providers — `anthropic`, `openai`, `deepseek` share just those two
+packages — and never silently skip) — add `,anthropic`/`,openai`/`,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
 
@@ -87,8 +123,8 @@ parseforge name --vendor cisco --family catalyst9200 --os ios-xe --version 17.9.
 ```
 Still needs an LLM provider on a cache miss — `--provider` defaults to `anthropic`,
 and `--api-key` falls back to that provider's own env var (`ANTHROPIC_API_KEY`/
-`DEEPSEEK_API_KEY`). A cache hit (a command already seen before) never touches the
-LLM, so no key is needed at all in that case.
+`OPENAI_API_KEY`/`DEEPSEEK_API_KEY`). A cache hit (a command already seen before)
+never touches the LLM, so no key is needed at all in that case.
 
 **`check`** — validate a connector or provider before spending time/tokens on a real
 run. With neither `--env` nor explicit connection flags, prints what a connector needs

{parseforge-0.2.3 → parseforge-0.2.5}/parseforge.egg-info/SOURCES.txt

@@ -34,6 +34,7 @@ parseforge/naming/providers/deepseek.py
 parseforge/naming/providers/errors.py
 parseforge/naming/providers/models.py
 parseforge/naming/providers/models.yaml
+parseforge/naming/providers/openai.py
 parseforge/naming/providers/text.py
 parseforge/sampling/__init__.py
 parseforge/sampling/core.py

parseforge-0.2.5/parseforge.egg-info/requires.txt

@@ -0,0 +1,32 @@
+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[deepseek]>=0.6.1
+
+[dev]
+pytest>=8.0.0
+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
+
+[openai]
+openai>=1.0.0
+textfsm-ai[openai]>=0.6.1
+
+[release]
+bump2version
+build
+
+[sampling]
+netmiko>=4.0

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "parseforge"
-version = "0.2.3"
+version = "0.2.5"
 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,14 @@ 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"]
+openai = ["openai>=1.0.0", "textfsm-ai[openai]>=0.6.1"]
 sampling = ["netmiko>=4.0"]
 dev = [
     "pytest>=8.0.0",
@@ -66,6 +72,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"

parseforge-0.2.3/parseforge/naming/providers/__init__.py

@@ -1,4 +0,0 @@
-from .anthropic import AnthropicRegexBuilder
-from .deepseek import DeepSeekRegexBuilder
-
-__all__ = ["AnthropicRegexBuilder", "DeepSeekRegexBuilder"]

parseforge-0.2.3/parseforge.egg-info/requires.txt

@@ -1,16 +0,0 @@
-click>=8.1
-PyYAML>=6.0
-textfsm>=1.1.0
-anthropic>=0.40.0
-openai>=1.0.0
-textfsm-ai>=0.5.1
-
-[dev]
-pytest>=8.0.0
-pytest-cov>=5.0.0
-ruff>=0.4.0
-black>=24.0.0
-mypy>=1.10.0
-
-[sampling]
-netmiko>=4.0