error-translator-cli-v2 1.0.8__tar.gz → 1.0.9__tar.gz

error_translator_cli_v2-1.0.9/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: error-translator-cli-v2
+Version: 1.0.9
+Summary: A CLI tool that explains Python errors in simple human language.
+Author-email: Gourabananda Datta <gourabanandadatta@zohomail.com>
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# Error Translator
+
+Error Translator is a Python toolkit that converts raw tracebacks into clear, actionable guidance. The project is designed for local use, deterministic output, and easy extension by contributors.
+
+It can be used as:
+
+- A CLI (`explain-error`) for direct translation and script execution.
+- An import hook (`error_translator.auto`) for automatic translation of unhandled exceptions.
+- A small FastAPI service (`error_translator.server`) for integrations.
+
+## Why this project exists
+
+Python's default tracebacks are precise but can be difficult for beginners and occasional Python users to act on quickly. Error Translator narrows that gap by matching final traceback lines against a curated set of regex rules and returning:
+
+- A plain-language explanation.
+- A concrete suggested fix.
+- Location/context metadata when available (`file`, `line`, `code`).
+- Optional AST-based hints for selected error families.
+
+## Key capabilities
+
+- **Local and deterministic**: no external API is required for normal translation.
+- **Structured output**: returns a predictable dictionary for CLI, library, and API consumers.
+- **Multiple entry points**: CLI, import hook, and HTTP API share the same core engine.
+- **Contributor-friendly rule model**: behavior is primarily driven by `error_translator/rules.json`.
+
+## Installation
+
+### Install from package
+
+```bash
+pip install error-translator-cli-v2
+```
+
+### Install for local development
+
+```bash
+pip install -r requirements.txt
+```
+
+## Usage
+
+### 1) Automatic crash interception
+
+```python
+import error_translator.auto
+
+maximum_user_connections = 100
+print(maximum_user_connectons)
+```
+
+Importing `error_translator.auto` installs a custom `sys.excepthook`, so unhandled exceptions are translated automatically in that process.
+
+### 2) CLI mode
+
+Run a script and translate any failure from `stderr`:
+
+```bash
+explain-error run script.py
+```
+
+Translate a single raw error string:
+
+```bash
+explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+```
+
+Pipe traceback text from a file:
+
+```bash
+cat error.log | explain-error
+```
+
+PowerShell:
+
+```bash
+Get-Content error.log | explain-error
+```
+
+### 3) Programmatic usage
+
+```python
+from error_translator.core import translate_error
+
+result = translate_error(traceback_text)
+print(result["explanation"])
+```
+
+### 4) HTTP API
+
+Start the API:
+
+```bash
+uvicorn error_translator.server:app --reload
+```
+
+`POST /translate` expects:
+
+```json
+{
+  "traceback_setting": "Traceback (most recent call last): ..."
+}
+```
+
+## Response contract
+
+`translate_error()` returns a dictionary with these fields when available:
+
+- `explanation`
+- `fix`
+- `matched_error`
+- `file`
+- `line`
+- `code`
+- `ast_insight`
+
+## Repository structure
+
+- `error_translator/core.py`: translation pipeline and rule matching.
+- `error_translator/cli.py`: terminal interface (`explain-error`).
+- `error_translator/auto.py`: automatic exception-hook integration.
+- `error_translator/server.py`: FastAPI surface.
+- `error_translator/ast_handlers.py`: optional contextual heuristics.
+- `error_translator/rules.json`: primary rule database.
+- `tests/test_core.py`: regression tests for translation behavior.
+
+## Contributing
+
+We welcome contributions of all sizes. If you are new to the project:
+
+1. Start with one narrowly scoped improvement.
+2. Add or update tests for behavior changes.
+3. Run `pytest` before submitting.
+4. Keep user-facing docs aligned with implementation.
+
+See `docs/CONTRIBUTING.md` for full contributor workflow and review standards.
+
+---
+
+Maintained by Gourabananda Datta and contributors.

error_translator_cli_v2-1.0.9/README.md

@@ -0,0 +1,140 @@
+# Error Translator
+
+Error Translator is a Python toolkit that converts raw tracebacks into clear, actionable guidance. The project is designed for local use, deterministic output, and easy extension by contributors.
+
+It can be used as:
+
+- A CLI (`explain-error`) for direct translation and script execution.
+- An import hook (`error_translator.auto`) for automatic translation of unhandled exceptions.
+- A small FastAPI service (`error_translator.server`) for integrations.
+
+## Why this project exists
+
+Python's default tracebacks are precise but can be difficult for beginners and occasional Python users to act on quickly. Error Translator narrows that gap by matching final traceback lines against a curated set of regex rules and returning:
+
+- A plain-language explanation.
+- A concrete suggested fix.
+- Location/context metadata when available (`file`, `line`, `code`).
+- Optional AST-based hints for selected error families.
+
+## Key capabilities
+
+- **Local and deterministic**: no external API is required for normal translation.
+- **Structured output**: returns a predictable dictionary for CLI, library, and API consumers.
+- **Multiple entry points**: CLI, import hook, and HTTP API share the same core engine.
+- **Contributor-friendly rule model**: behavior is primarily driven by `error_translator/rules.json`.
+
+## Installation
+
+### Install from package
+
+```bash
+pip install error-translator-cli-v2
+```
+
+### Install for local development
+
+```bash
+pip install -r requirements.txt
+```
+
+## Usage
+
+### 1) Automatic crash interception
+
+```python
+import error_translator.auto
+
+maximum_user_connections = 100
+print(maximum_user_connectons)
+```
+
+Importing `error_translator.auto` installs a custom `sys.excepthook`, so unhandled exceptions are translated automatically in that process.
+
+### 2) CLI mode
+
+Run a script and translate any failure from `stderr`:
+
+```bash
+explain-error run script.py
+```
+
+Translate a single raw error string:
+
+```bash
+explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+```
+
+Pipe traceback text from a file:
+
+```bash
+cat error.log | explain-error
+```
+
+PowerShell:
+
+```bash
+Get-Content error.log | explain-error
+```
+
+### 3) Programmatic usage
+
+```python
+from error_translator.core import translate_error
+
+result = translate_error(traceback_text)
+print(result["explanation"])
+```
+
+### 4) HTTP API
+
+Start the API:
+
+```bash
+uvicorn error_translator.server:app --reload
+```
+
+`POST /translate` expects:
+
+```json
+{
+  "traceback_setting": "Traceback (most recent call last): ..."
+}
+```
+
+## Response contract
+
+`translate_error()` returns a dictionary with these fields when available:
+
+- `explanation`
+- `fix`
+- `matched_error`
+- `file`
+- `line`
+- `code`
+- `ast_insight`
+
+## Repository structure
+
+- `error_translator/core.py`: translation pipeline and rule matching.
+- `error_translator/cli.py`: terminal interface (`explain-error`).
+- `error_translator/auto.py`: automatic exception-hook integration.
+- `error_translator/server.py`: FastAPI surface.
+- `error_translator/ast_handlers.py`: optional contextual heuristics.
+- `error_translator/rules.json`: primary rule database.
+- `tests/test_core.py`: regression tests for translation behavior.
+
+## Contributing
+
+We welcome contributions of all sizes. If you are new to the project:
+
+1. Start with one narrowly scoped improvement.
+2. Add or update tests for behavior changes.
+3. Run `pytest` before submitting.
+4. Keep user-facing docs aligned with implementation.
+
+See `docs/CONTRIBUTING.md` for full contributor workflow and review standards.
+
+---
+
+Maintained by Gourabananda Datta and contributors.

error_translator_cli_v2-1.0.9/error_translator_cli_v2.egg-info/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: error-translator-cli-v2
+Version: 1.0.9
+Summary: A CLI tool that explains Python errors in simple human language.
+Author-email: Gourabananda Datta <gourabanandadatta@zohomail.com>
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# Error Translator
+
+Error Translator is a Python toolkit that converts raw tracebacks into clear, actionable guidance. The project is designed for local use, deterministic output, and easy extension by contributors.
+
+It can be used as:
+
+- A CLI (`explain-error`) for direct translation and script execution.
+- An import hook (`error_translator.auto`) for automatic translation of unhandled exceptions.
+- A small FastAPI service (`error_translator.server`) for integrations.
+
+## Why this project exists
+
+Python's default tracebacks are precise but can be difficult for beginners and occasional Python users to act on quickly. Error Translator narrows that gap by matching final traceback lines against a curated set of regex rules and returning:
+
+- A plain-language explanation.
+- A concrete suggested fix.
+- Location/context metadata when available (`file`, `line`, `code`).
+- Optional AST-based hints for selected error families.
+
+## Key capabilities
+
+- **Local and deterministic**: no external API is required for normal translation.
+- **Structured output**: returns a predictable dictionary for CLI, library, and API consumers.
+- **Multiple entry points**: CLI, import hook, and HTTP API share the same core engine.
+- **Contributor-friendly rule model**: behavior is primarily driven by `error_translator/rules.json`.
+
+## Installation
+
+### Install from package
+
+```bash
+pip install error-translator-cli-v2
+```
+
+### Install for local development
+
+```bash
+pip install -r requirements.txt
+```
+
+## Usage
+
+### 1) Automatic crash interception
+
+```python
+import error_translator.auto
+
+maximum_user_connections = 100
+print(maximum_user_connectons)
+```
+
+Importing `error_translator.auto` installs a custom `sys.excepthook`, so unhandled exceptions are translated automatically in that process.
+
+### 2) CLI mode
+
+Run a script and translate any failure from `stderr`:
+
+```bash
+explain-error run script.py
+```
+
+Translate a single raw error string:
+
+```bash
+explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
+```
+
+Pipe traceback text from a file:
+
+```bash
+cat error.log | explain-error
+```
+
+PowerShell:
+
+```bash
+Get-Content error.log | explain-error
+```
+
+### 3) Programmatic usage
+
+```python
+from error_translator.core import translate_error
+
+result = translate_error(traceback_text)
+print(result["explanation"])
+```
+
+### 4) HTTP API
+
+Start the API:
+
+```bash
+uvicorn error_translator.server:app --reload
+```
+
+`POST /translate` expects:
+
+```json
+{
+  "traceback_setting": "Traceback (most recent call last): ..."
+}
+```
+
+## Response contract
+
+`translate_error()` returns a dictionary with these fields when available:
+
+- `explanation`
+- `fix`
+- `matched_error`
+- `file`
+- `line`
+- `code`
+- `ast_insight`
+
+## Repository structure
+
+- `error_translator/core.py`: translation pipeline and rule matching.
+- `error_translator/cli.py`: terminal interface (`explain-error`).
+- `error_translator/auto.py`: automatic exception-hook integration.
+- `error_translator/server.py`: FastAPI surface.
+- `error_translator/ast_handlers.py`: optional contextual heuristics.
+- `error_translator/rules.json`: primary rule database.
+- `tests/test_core.py`: regression tests for translation behavior.
+
+## Contributing
+
+We welcome contributions of all sizes. If you are new to the project:
+
+1. Start with one narrowly scoped improvement.
+2. Add or update tests for behavior changes.
+3. Run `pytest` before submitting.
+4. Keep user-facing docs aligned with implementation.
+
+See `docs/CONTRIBUTING.md` for full contributor workflow and review standards.
+
+---
+
+Maintained by Gourabananda Datta and contributors.

{error_translator_cli_v2-1.0.8 → error_translator_cli_v2-1.0.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "error-translator-cli-v2"
-version = "1.0.8"
+version = "1.0.9"
 description = "A CLI tool that explains Python errors in simple human language."
 readme = "README.md"
 requires-python = ">=3.7"

error_translator_cli_v2-1.0.8/PKG-INFO

@@ -1,132 +0,0 @@
-Metadata-Version: 2.4
-Name: error-translator-cli-v2
-Version: 1.0.8
-Summary: A CLI tool that explains Python errors in simple human language.
-Author-email: Gourabananda Datta <gourabanandadatta@zohomail.com>
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-
-# Error Translator CLI
-
-Error Translator CLI turns Python tracebacks into clear, actionable explanations. It is a local, rule-based tool that reads the final error line, matches it against a curated regex rule set, and returns a structured translation with the original file, line number, code context, and a suggested fix.
-
-## Highlights
-
-- Runs locally with no model inference or external API calls during normal translation.
-- Supports three entry points: automatic crash interception, CLI execution, and direct traceback translation.
-- Extracts file and line information from standard Python tracebacks when available.
-- Includes optional AST-based insight hooks for a few error families.
-- Provides both machine-readable results and colorized terminal output.
-
-## Installation
-
-Install the published package with pip:
-
-```bash
-pip install error-translator-cli-v2
-```
-
-For local development or running the project from source, install the repository dependencies instead:
-
-```bash
-pip install -r requirements.txt
-```
-
-## Usage
-
-### 1. Automatic crash interception
-
-Import `error_translator.auto` at the top of a script to replace Python's default exception hook with the translated output.
-
-This is the project's magic import: once imported, any unhandled exception in that process is intercepted and formatted by the translator before Python prints the default traceback.
-
-```python
-import error_translator.auto
-
-maximum_user_connections = 100
-print(maximum_user_connectons)
-```
-
-Use this when you want the translation to happen automatically without wrapping your code in a custom try/except block.
-
-### 2. CLI execution
-
-Run a script through the CLI and let the tool translate crashes from `stderr`.
-
-```bash
-explain-error run script.py
-```
-
-You can also translate a raw traceback or error string directly:
-
-```bash
-explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
-```
-
-If you want to pipe a saved traceback into the tool, use the shell syntax for your terminal:
-
-```bash
-Get-Content error.log | explain-error
-```
-
-```bash
-cat error.log | explain-error
-```
-
-### 3. Programmatic use
-
-```python
-from error_translator.core import translate_error
-
-result = translate_error(traceback_text)
-print(result["explanation"])
-```
-
-### 4. HTTP API
-
-Start the FastAPI app with Uvicorn:
-
-```bash
-uvicorn error_translator.server:app --reload
-```
-
-`POST /translate` expects JSON in the form:
-
-```json
-{
-	"traceback_setting": "Traceback (most recent call last): ..."
-}
-```
-
-## What the translator returns
-
-The translation engine returns a dictionary with these fields when available:
-
-- `explanation`
-- `fix`
-- `matched_error`
-- `file`
-- `line`
-- `code`
-- `ast_insight`
-
-## Supported errors
-
-The bundled rule set covers many common Python runtime, syntax, indentation, import, OS, encoding, and networking errors. The full list lives in `error_translator/rules.json` and can be expanded over time without changing the runtime engine.
-
-## Project layout
-
-- `error_translator/core.py` loads the rule set and performs the translation.
-- `error_translator/cli.py` provides the `explain-error` command.
-- `error_translator/auto.py` installs the automatic exception hook.
-- `error_translator/server.py` exposes the HTTP API.
-- `error_translator/ast_handlers.py` contains contextual suggestion hooks.
-- `error_translator/rules.json` stores the rule database.
-
-## Development notes
-
-- `builder.py` can generate new rule drafts with Gemini when `GEMINI_API_KEY` is set.
-- `scraper.py` refreshes the scraped exception dataset from the official Python documentation.
-- `tests/test_core.py` contains the current regression coverage for the translation engine.
-
-Built by Gourabananda Datta.

error_translator_cli_v2-1.0.8/README.md

@@ -1,124 +0,0 @@
-# Error Translator CLI
-
-Error Translator CLI turns Python tracebacks into clear, actionable explanations. It is a local, rule-based tool that reads the final error line, matches it against a curated regex rule set, and returns a structured translation with the original file, line number, code context, and a suggested fix.
-
-## Highlights
-
-- Runs locally with no model inference or external API calls during normal translation.
-- Supports three entry points: automatic crash interception, CLI execution, and direct traceback translation.
-- Extracts file and line information from standard Python tracebacks when available.
-- Includes optional AST-based insight hooks for a few error families.
-- Provides both machine-readable results and colorized terminal output.
-
-## Installation
-
-Install the published package with pip:
-
-```bash
-pip install error-translator-cli-v2
-```
-
-For local development or running the project from source, install the repository dependencies instead:
-
-```bash
-pip install -r requirements.txt
-```
-
-## Usage
-
-### 1. Automatic crash interception
-
-Import `error_translator.auto` at the top of a script to replace Python's default exception hook with the translated output.
-
-This is the project's magic import: once imported, any unhandled exception in that process is intercepted and formatted by the translator before Python prints the default traceback.
-
-```python
-import error_translator.auto
-
-maximum_user_connections = 100
-print(maximum_user_connectons)
-```
-
-Use this when you want the translation to happen automatically without wrapping your code in a custom try/except block.
-
-### 2. CLI execution
-
-Run a script through the CLI and let the tool translate crashes from `stderr`.
-
-```bash
-explain-error run script.py
-```
-
-You can also translate a raw traceback or error string directly:
-
-```bash
-explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
-```
-
-If you want to pipe a saved traceback into the tool, use the shell syntax for your terminal:
-
-```bash
-Get-Content error.log | explain-error
-```
-
-```bash
-cat error.log | explain-error
-```
-
-### 3. Programmatic use
-
-```python
-from error_translator.core import translate_error
-
-result = translate_error(traceback_text)
-print(result["explanation"])
-```
-
-### 4. HTTP API
-
-Start the FastAPI app with Uvicorn:
-
-```bash
-uvicorn error_translator.server:app --reload
-```
-
-`POST /translate` expects JSON in the form:
-
-```json
-{
-	"traceback_setting": "Traceback (most recent call last): ..."
-}
-```
-
-## What the translator returns
-
-The translation engine returns a dictionary with these fields when available:
-
-- `explanation`
-- `fix`
-- `matched_error`
-- `file`
-- `line`
-- `code`
-- `ast_insight`
-
-## Supported errors
-
-The bundled rule set covers many common Python runtime, syntax, indentation, import, OS, encoding, and networking errors. The full list lives in `error_translator/rules.json` and can be expanded over time without changing the runtime engine.
-
-## Project layout
-
-- `error_translator/core.py` loads the rule set and performs the translation.
-- `error_translator/cli.py` provides the `explain-error` command.
-- `error_translator/auto.py` installs the automatic exception hook.
-- `error_translator/server.py` exposes the HTTP API.
-- `error_translator/ast_handlers.py` contains contextual suggestion hooks.
-- `error_translator/rules.json` stores the rule database.
-
-## Development notes
-
-- `builder.py` can generate new rule drafts with Gemini when `GEMINI_API_KEY` is set.
-- `scraper.py` refreshes the scraped exception dataset from the official Python documentation.
-- `tests/test_core.py` contains the current regression coverage for the translation engine.
-
-Built by Gourabananda Datta.

error_translator_cli_v2-1.0.8/error_translator_cli_v2.egg-info/PKG-INFO

@@ -1,132 +0,0 @@
-Metadata-Version: 2.4
-Name: error-translator-cli-v2
-Version: 1.0.8
-Summary: A CLI tool that explains Python errors in simple human language.
-Author-email: Gourabananda Datta <gourabanandadatta@zohomail.com>
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-
-# Error Translator CLI
-
-Error Translator CLI turns Python tracebacks into clear, actionable explanations. It is a local, rule-based tool that reads the final error line, matches it against a curated regex rule set, and returns a structured translation with the original file, line number, code context, and a suggested fix.
-
-## Highlights
-
-- Runs locally with no model inference or external API calls during normal translation.
-- Supports three entry points: automatic crash interception, CLI execution, and direct traceback translation.
-- Extracts file and line information from standard Python tracebacks when available.
-- Includes optional AST-based insight hooks for a few error families.
-- Provides both machine-readable results and colorized terminal output.
-
-## Installation
-
-Install the published package with pip:
-
-```bash
-pip install error-translator-cli-v2
-```
-
-For local development or running the project from source, install the repository dependencies instead:
-
-```bash
-pip install -r requirements.txt
-```
-
-## Usage
-
-### 1. Automatic crash interception
-
-Import `error_translator.auto` at the top of a script to replace Python's default exception hook with the translated output.
-
-This is the project's magic import: once imported, any unhandled exception in that process is intercepted and formatted by the translator before Python prints the default traceback.
-
-```python
-import error_translator.auto
-
-maximum_user_connections = 100
-print(maximum_user_connectons)
-```
-
-Use this when you want the translation to happen automatically without wrapping your code in a custom try/except block.
-
-### 2. CLI execution
-
-Run a script through the CLI and let the tool translate crashes from `stderr`.
-
-```bash
-explain-error run script.py
-```
-
-You can also translate a raw traceback or error string directly:
-
-```bash
-explain-error "TypeError: unsupported operand type(s) for +: 'int' and 'str'"
-```
-
-If you want to pipe a saved traceback into the tool, use the shell syntax for your terminal:
-
-```bash
-Get-Content error.log | explain-error
-```
-
-```bash
-cat error.log | explain-error
-```
-
-### 3. Programmatic use
-
-```python
-from error_translator.core import translate_error
-
-result = translate_error(traceback_text)
-print(result["explanation"])
-```
-
-### 4. HTTP API
-
-Start the FastAPI app with Uvicorn:
-
-```bash
-uvicorn error_translator.server:app --reload
-```
-
-`POST /translate` expects JSON in the form:
-
-```json
-{
-	"traceback_setting": "Traceback (most recent call last): ..."
-}
-```
-
-## What the translator returns
-
-The translation engine returns a dictionary with these fields when available:
-
-- `explanation`
-- `fix`
-- `matched_error`
-- `file`
-- `line`
-- `code`
-- `ast_insight`
-
-## Supported errors
-
-The bundled rule set covers many common Python runtime, syntax, indentation, import, OS, encoding, and networking errors. The full list lives in `error_translator/rules.json` and can be expanded over time without changing the runtime engine.
-
-## Project layout
-
-- `error_translator/core.py` loads the rule set and performs the translation.
-- `error_translator/cli.py` provides the `explain-error` command.
-- `error_translator/auto.py` installs the automatic exception hook.
-- `error_translator/server.py` exposes the HTTP API.
-- `error_translator/ast_handlers.py` contains contextual suggestion hooks.
-- `error_translator/rules.json` stores the rule database.
-
-## Development notes
-
-- `builder.py` can generate new rule drafts with Gemini when `GEMINI_API_KEY` is set.
-- `scraper.py` refreshes the scraped exception dataset from the official Python documentation.
-- `tests/test_core.py` contains the current regression coverage for the translation engine.
-
-Built by Gourabananda Datta.