python-infrakit-dev 0.1.4__tar.gz → 0.1.6__tar.gz

{python_infrakit_dev-0.1.4 → python_infrakit_dev-0.1.6}/.gitignore

@@ -18,4 +18,5 @@ new_requirements.txt
 .env
 config.ini
 testing.ipynb
-api_key_dir
+api_key_dir
+.claude/

python_infrakit_dev-0.1.4/README.md → python_infrakit_dev-0.1.6/PKG-INFO

@@ -1,12 +1,90 @@
+Metadata-Version: 2.4
+Name: python-infrakit-dev
+Version: 0.1.6
+Summary: A comprehensive Python developer infrastructure toolkit
+Project-URL: Homepage, https://github.com/chiragg21/infrakit
+Project-URL: Repository, https://github.com/chiragg21/infrakit
+Requires-Python: >=3.10
+Requires-Dist: isort>=8.0.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: python-dotenv>=1.2.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: typer>=0.24.1
+Provides-Extra: all
+Requires-Dist: google-genai>=1.69.0; extra == 'all'
+Requires-Dist: groq>=0.9.0; extra == 'all'
+Requires-Dist: openai>=2.30.0; extra == 'all'
+Requires-Dist: tqdm>=4.67.3; extra == 'all'
+Provides-Extra: llm
+Requires-Dist: google-genai>=1.69.0; extra == 'llm'
+Requires-Dist: groq>=0.9.0; extra == 'llm'
+Requires-Dist: openai>=2.30.0; extra == 'llm'
+Requires-Dist: tqdm>=4.67.3; extra == 'llm'
+Description-Content-Type: text/markdown
+
 # Infrakit
 
 A modular developer toolkit for Python — project scaffolding, logging, config loading, a multi-provider LLM client, and dependency utilities.
 
+**Requires Python 3.10+**
+
+---
+
+## Installation
+
+**Core** — scaffolding, config, logging, deps, profiling, and CLI:
+
 ```bash
-pip install infrakit
+pip install python-infrakit-dev
 ```
 
-The CLI is available as `ik`.
+**With LLM support** — adds OpenAI and Gemini providers:
+
+```bash
+pip install python-infrakit-dev[llm]
+```
+
+**Everything:**
+
+```bash
+pip install python-infrakit-dev[all]
+```
+
+The CLI is available as both `infrakit` and `ik`.
+
+---
+
+## Quick Imports
+
+Most public symbols are available directly from the top-level package:
+
+```python
+# Logging
+from infrakit import setup, get_logger
+
+# Config
+from infrakit import load, load_env, validate, Schema, field
+
+# Config conversion / export
+from infrakit import convert_file, convert_dict, export_file, export_dict
+
+# LLM (requires infrakit[llm])
+from infrakit import LLMClient, Prompt, QuotaConfig
+
+# Subpackages
+from infrakit import deps, scaffolder, time
+```
+
+Or import from the specific subpackages:
+
+```python
+from infrakit.core.config import load, validate, convert_dict, export_file
+from infrakit.core.logger import setup, get_logger
+from infrakit.llm import LLMClient, Prompt
+from infrakit.deps import scan, export, check, clean, optimise
+from infrakit.scaffolder import scaffold_basic, scaffold_ai, scaffold_backend
+from infrakit.time import pipeline_profiler, track
+```
 
 ---
 
@@ -43,7 +121,7 @@ Every template generates a config file pre-populated with the variables its util
 ### Config loader
 
 ```python
-from infrakit.core.config.loader import load, load_env
+from infrakit.core.config import load, load_env
 
 cfg = load_env(".env", cast_values=True)   # "true" → bool, "42" → int
 cfg = load("config.yaml")
@@ -67,6 +145,49 @@ port = cfg.get("APP_PORT", 8000)
 
 ---
 
+### Config validation
+
+```python
+from infrakit.core.config import validate, Schema, field
+from pydantic import BaseModel
+
+# Pydantic model
+class AppConfig(BaseModel):
+    host: str
+    port: int
+    debug: bool = False
+
+result = validate({"host": "localhost", "port": 8080}, AppConfig)
+if result.ok:
+    cfg = result.data   # fully typed AppConfig instance
+
+# Lightweight dict schema (no Pydantic model needed)
+schema = Schema({
+    "host": field(str, required=True),
+    "port": field(int, required=True),
+    "debug": field(bool, required=False, default=False),
+})
+result = schema.validate({"host": "localhost", "port": 8080})
+```
+
+---
+
+### Config conversion and export
+
+```python
+from infrakit.core.config import convert_file, convert_dict, export_file, export_dict
+
+# Convert between formats
+convert_file("config.yaml", "config.ini")
+output, warnings = convert_dict(data, from_format="yaml", to_format="env")
+
+# Sanitize config for sharing (replaces all values with YOUR_VALUE_HERE)
+export_file("config.yaml", ".env.example", to_format="env")
+safe = export_dict({"PORT": 8080, "SECRET": "abc"}, to_format="env")
+```
+
+---
+
 ### Logger
 
 ```python
@@ -99,6 +220,8 @@ log.info("started on port %d", 8080)
 
 ## LLM Client
 
+> Requires `pip install python-infrakit-dev[llm]`
+
 A unified client for **OpenAI** and **Gemini** with key rotation, rate limiting, quota tracking, and async/batch generation.
 
 ```python

python_infrakit_dev-0.1.4/PKG-INFO → python_infrakit_dev-0.1.6/README.md

@@ -1,29 +1,66 @@
-Metadata-Version: 2.4
-Name: python-infrakit-dev
-Version: 0.1.4
-Summary: A comprehensive Python developer infrastructure toolkit
-Project-URL: Homepage, https://github.com/chiragg21/infrakit
-Project-URL: Repository, https://github.com/chiragg21/infrakit
-Requires-Python: >=3.13
-Requires-Dist: google-genai>=1.69.0
-Requires-Dist: isort>=8.0.1
-Requires-Dist: openai>=2.30.0
-Requires-Dist: pydantic>=2.12.5
-Requires-Dist: python-dotenv>=1.2.2
-Requires-Dist: pyyaml>=6.0.3
-Requires-Dist: tqdm>=4.67.3
-Requires-Dist: typer>=0.24.1
-Description-Content-Type: text/markdown
-
 # Infrakit
 
 A modular developer toolkit for Python — project scaffolding, logging, config loading, a multi-provider LLM client, and dependency utilities.
 
+**Requires Python 3.10+**
+
+---
+
+## Installation
+
+**Core** — scaffolding, config, logging, deps, profiling, and CLI:
+
 ```bash
-pip install infrakit
+pip install python-infrakit-dev
 ```
 
-The CLI is available as `ik`.
+**With LLM support** — adds OpenAI and Gemini providers:
+
+```bash
+pip install python-infrakit-dev[llm]
+```
+
+**Everything:**
+
+```bash
+pip install python-infrakit-dev[all]
+```
+
+The CLI is available as both `infrakit` and `ik`.
+
+---
+
+## Quick Imports
+
+Most public symbols are available directly from the top-level package:
+
+```python
+# Logging
+from infrakit import setup, get_logger
+
+# Config
+from infrakit import load, load_env, validate, Schema, field
+
+# Config conversion / export
+from infrakit import convert_file, convert_dict, export_file, export_dict
+
+# LLM (requires infrakit[llm])
+from infrakit import LLMClient, Prompt, QuotaConfig
+
+# Subpackages
+from infrakit import deps, scaffolder, time
+```
+
+Or import from the specific subpackages:
+
+```python
+from infrakit.core.config import load, validate, convert_dict, export_file
+from infrakit.core.logger import setup, get_logger
+from infrakit.llm import LLMClient, Prompt
+from infrakit.deps import scan, export, check, clean, optimise
+from infrakit.scaffolder import scaffold_basic, scaffold_ai, scaffold_backend
+from infrakit.time import pipeline_profiler, track
+```
 
 ---
 
@@ -60,7 +97,7 @@ Every template generates a config file pre-populated with the variables its util
 ### Config loader
 
 ```python
-from infrakit.core.config.loader import load, load_env
+from infrakit.core.config import load, load_env
 
 cfg = load_env(".env", cast_values=True)   # "true" → bool, "42" → int
 cfg = load("config.yaml")
@@ -84,6 +121,49 @@ port = cfg.get("APP_PORT", 8000)
 
 ---
 
+### Config validation
+
+```python
+from infrakit.core.config import validate, Schema, field
+from pydantic import BaseModel
+
+# Pydantic model
+class AppConfig(BaseModel):
+    host: str
+    port: int
+    debug: bool = False
+
+result = validate({"host": "localhost", "port": 8080}, AppConfig)
+if result.ok:
+    cfg = result.data   # fully typed AppConfig instance
+
+# Lightweight dict schema (no Pydantic model needed)
+schema = Schema({
+    "host": field(str, required=True),
+    "port": field(int, required=True),
+    "debug": field(bool, required=False, default=False),
+})
+result = schema.validate({"host": "localhost", "port": 8080})
+```
+
+---
+
+### Config conversion and export
+
+```python
+from infrakit.core.config import convert_file, convert_dict, export_file, export_dict
+
+# Convert between formats
+convert_file("config.yaml", "config.ini")
+output, warnings = convert_dict(data, from_format="yaml", to_format="env")
+
+# Sanitize config for sharing (replaces all values with YOUR_VALUE_HERE)
+export_file("config.yaml", ".env.example", to_format="env")
+safe = export_dict({"PORT": 8080, "SECRET": "abc"}, to_format="env")
+```
+
+---
+
 ### Logger
 
 ```python
@@ -116,6 +196,8 @@ log.info("started on port %d", 8080)
 
 ## LLM Client
 
+> Requires `pip install python-infrakit-dev[llm]`
+
 A unified client for **OpenAI** and **Gemini** with key rotation, rate limiting, quota tracking, and async/batch generation.
 
 ```python

python_infrakit_dev-0.1.6/infrakit/__init__.py

@@ -0,0 +1,74 @@
+"""
+infrakit
+~~~~~~~~
+A comprehensive Python developer infrastructure toolkit.
+
+Quick imports::
+
+    # Logging
+    from infrakit import setup, get_logger
+
+    # Config
+    from infrakit import load, validate
+
+    # LLM
+    from infrakit import LLMClient
+
+    # Dependencies
+    from infrakit import deps
+
+    # Scaffolding
+    from infrakit import scaffolder
+
+    # Profiling
+    from infrakit import time
+"""
+
+from infrakit.core.logger.setup import setup, get_logger, reset
+from infrakit.core.config import (
+    load,
+    load_env,
+    validate,
+    Schema,
+    field,
+    convert_file,
+    convert_dict,
+    export_file,
+    export_dict,
+    export_string,
+)
+from infrakit import deps, scaffolder, time
+
+try:
+    from infrakit.llm import LLMClient, LLMResponse, Prompt, QuotaConfig
+    _LLM_AVAILABLE = True
+except ImportError:
+    _LLM_AVAILABLE = False
+
+__version__ = "0.1.4"
+
+__all__ = [
+    "__version__",
+    # logging
+    "setup",
+    "get_logger",
+    "reset",
+    # config
+    "load",
+    "load_env",
+    "validate",
+    "Schema",
+    "field",
+    "convert_file",
+    "convert_dict",
+    "export_file",
+    "export_dict",
+    "export_string",
+    # subpackages
+    "deps",
+    "scaffolder",
+    "time",
+]
+
+if _LLM_AVAILABLE:
+    __all__ += ["LLMClient", "LLMResponse", "Prompt", "QuotaConfig"]

python_infrakit_dev-0.1.6/infrakit/cli/__init__.py

@@ -0,0 +1,5 @@
+"""infrakit.cli — command-line interface for infrakit."""
+
+from infrakit.cli.main import main
+
+__all__ = ["main"]

python_infrakit_dev-0.1.6/infrakit/cli/commands/__init__.py

@@ -0,0 +1,19 @@
+"""infrakit.cli.commands — subcommand groups."""
+
+from infrakit.cli.commands.config import config_app
+from infrakit.cli.commands.logger import logger_app
+from infrakit.cli.commands.module import module_app
+from infrakit.cli.commands.time import time_app
+from infrakit.cli.commands.deps import deps_app
+from infrakit.cli.commands.llm import app as llm_app
+from infrakit.cli.commands.init import cmd_init
+
+__all__ = [
+    "config_app",
+    "logger_app",
+    "module_app",
+    "time_app",
+    "deps_app",
+    "llm_app",
+    "cmd_init",
+]

python_infrakit_dev-0.1.6/infrakit/core/__init__.py

@@ -0,0 +1,46 @@
+"""
+infrakit.core
+~~~~~~~~~~~~~
+Core infrastructure: config management and structured logging.
+
+Quick imports::
+
+    from infrakit.core import setup, get_logger
+    from infrakit.core import load, validate
+"""
+
+from infrakit.core.logger.setup import setup, get_logger, reset
+from infrakit.core.config import (
+    load,
+    load_env,
+    cast_value,
+    detect_format,
+    validate,
+    Schema,
+    field,
+    convert_file,
+    convert_dict,
+    export_file,
+    export_dict,
+    export_string,
+)
+
+__all__ = [
+    # logger
+    "setup",
+    "get_logger",
+    "reset",
+    # config
+    "load",
+    "load_env",
+    "cast_value",
+    "detect_format",
+    "validate",
+    "Schema",
+    "field",
+    "convert_file",
+    "convert_dict",
+    "export_file",
+    "export_dict",
+    "export_string",
+]

python_infrakit_dev-0.1.6/infrakit/core/config/__init__.py

@@ -0,0 +1,71 @@
+"""
+infrakit.core.config
+~~~~~~~~~~~~~~~~~~~~~
+Configuration loading, validation, conversion, and export.
+
+Quick imports::
+
+    from infrakit.core.config import load, load_env, validate, Schema, field
+    from infrakit.core.config import convert_file, convert_dict
+    from infrakit.core.config import export_file, export_dict, export_string
+"""
+
+from infrakit.core.config.loader import (
+    load,
+    load_env,
+    cast_value,
+    cast_dict,
+    detect_format,
+    ConfigLoadError,
+    UnsupportedFormatError,
+    MissingDependencyError,
+)
+from infrakit.core.config.validator import (
+    validate,
+    Schema,
+    field,
+    FieldSpec,
+    FieldError,
+    ValidationResult,
+    ConfigValidationError,
+)
+from infrakit.core.config.converter import (
+    convert_file,
+    convert_dict,
+    ConversionError,
+    ConversionWarning,
+)
+from infrakit.core.config.exporter import (
+    export_file,
+    export_dict,
+    export_string,
+)
+
+__all__ = [
+    # loader
+    "load",
+    "load_env",
+    "cast_value",
+    "cast_dict",
+    "detect_format",
+    "ConfigLoadError",
+    "UnsupportedFormatError",
+    "MissingDependencyError",
+    # validator
+    "validate",
+    "Schema",
+    "field",
+    "FieldSpec",
+    "FieldError",
+    "ValidationResult",
+    "ConfigValidationError",
+    # converter
+    "convert_file",
+    "convert_dict",
+    "ConversionError",
+    "ConversionWarning",
+    # exporter
+    "export_file",
+    "export_dict",
+    "export_string",
+]

{python_infrakit_dev-0.1.4 → python_infrakit_dev-0.1.6}/infrakit/llm/__init__.py

@@ -20,7 +20,7 @@ from .models import (
     QuotaConfig,
     RequestMeta,
 )
-from .providers import GeminiProvider, OpenAIProvider
+from .providers import GeminiProvider, GroqProvider, OpenAIProvider
 
 __all__ = [
     "LLMClient",
@@ -32,4 +32,5 @@ __all__ = [
     "Provider",
     "OpenAIProvider",
     "GeminiProvider",
+    "GroqProvider",
 ]