python-infrakit-dev 0.1.4__py3-none-any.whl → 0.1.5__py3-none-any.whl

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"]

infrakit/cli/__init__.py

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

infrakit/cli/commands/__init__.py

@@ -1 +1,19 @@
-"""infrakit.cli.commands — subcommand groups."""
+"""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",
+]

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",
+]

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.dist-info → python_infrakit_dev-0.1.5.dist-info}/METADATA

@@ -1,29 +1,88 @@
 Metadata-Version: 2.4
 Name: python-infrakit-dev
-Version: 0.1.4
+Version: 0.1.5
 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-Python: >=3.10
 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
+Provides-Extra: all
+Requires-Dist: google-genai>=1.69.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: 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 python-infrakit-dev
+```
+
+**With LLM support** — adds OpenAI and Gemini providers:
+
+```bash
+pip install python-infrakit-dev[llm]
+```
+
+**Everything:**
+
 ```bash
-pip install infrakit
+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
 ```
 
-The CLI is available as `ik`.
+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 +119,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 +143,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 +218,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.dist-info → python_infrakit_dev-0.1.5.dist-info}/RECORD

@@ -1,7 +1,7 @@
-infrakit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-infrakit/cli/__init__.py,sha256=QZrDqdIn-8fH3wFO0YY-1K05g5PbF6q8-6BlTQcdC8Y,59
+infrakit/__init__.py,sha256=wh0Fo7g1X8CS70ijR-U3k_MFqENiaDqhwJ5HxORaeXE,1305
+infrakit/cli/__init__.py,sha256=Dn4nTZzNDgU1VaMaZ883OjeyemUsVqvzLkY6Xv1IB-8,116
 infrakit/cli/main.py,sha256=FDKAEMmtpujhGFz2mGGBchz9uas6VYMVdPsgTmZCnKE,1767
-infrakit/cli/commands/__init__.py,sha256=9UDid2MU1YFe48lm3zom-SYxMya5DhiRmM9-pqldT5o,50
+infrakit/cli/commands/__init__.py,sha256=v4FDWyO1-RZ6P0xl5Bhxzgar8REqpMnm__47UkBDKEo,537
 infrakit/cli/commands/config.py,sha256=TsEdKUyLbX7n7uo_Nj9pdkgejQ8KxQ7mcV7Hed7gMEE,5975
 infrakit/cli/commands/deps.py,sha256=JAYg7dLCVw9UKNInzUeB-RnXr7Uv_dFs1B41plGRVIo,21650
 infrakit/cli/commands/init.py,sha256=MQGr4kvKwezme2UditokVK8tbENjhtM2yBKgv8s2Ffw,5255
@@ -9,8 +9,8 @@ infrakit/cli/commands/llm.py,sha256=OSsGrUCHAU0Gi4YGFWyO42zlYz7PfQTZuQG0JeKFzOA,
 infrakit/cli/commands/logger.py,sha256=-OPvCg0x6j7LQ0XJBHQcFkzlG8dkKNCBmEzKNOvAyeA,6148
 infrakit/cli/commands/module.py,sha256=jsnEQxwBztKWxIj85tqmVpoMYQmYfYXFwzncOjH2xZo,11295
 infrakit/cli/commands/time.py,sha256=1Q1sFeqRP4GCFqcCxC0BcUDOdB6NjTSPJI_-hrS8DbI,2229
-infrakit/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-infrakit/core/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+infrakit/core/__init__.py,sha256=tTt7zxcWJjXbeflKgGA71aGxFnA_q4gbTvm5fqUvAnc,791
+infrakit/core/config/__init__.py,sha256=9QXqdrCkoKC0bSaBARLyxyhfoD8kLLOU-2H-l-HeQPs,1452
 infrakit/core/config/converter.py,sha256=5BEr6SWU_QGtCuukO0BBRbTJyT8S0T5tMVHEtbpolMY,15450
 infrakit/core/config/exporter.py,sha256=ffuEUzUAiWNq2_xQIarXhCNAL-Y_Mt7WDeFIcldogFM,9121
 infrakit/core/config/loader.py,sha256=gfd1HXVZD8AJAVeXy9QeTeB8M0YOggXh5N0E4CJEt84,23994
@@ -46,7 +46,7 @@ infrakit/scaffolder/pipeline.py,sha256=HeBkreiso0fYIHrObkaPKRB3XewU3UgQevrrcWHY_
 infrakit/scaffolder/registry.py,sha256=TqZetmDChmXD_oW6kl10A0SbN6ADm4xi7NdK2m9GNGI,3802
 infrakit/time/__init__.py,sha256=R-o_F3XkqaC-QWtfMJ8TCUKnCqLycFl2WQHs20e8ElI,1206
 infrakit/time/profiler.py,sha256=bfM-UCFULr1cA4Y6fgBWdQ7d4tNgdY_YJowohhVH-So,16075
-python_infrakit_dev-0.1.4.dist-info/METADATA,sha256=RdoayVeTCtHJmwJImyLOXnq3ITFLQb85_DMznw2Srnw,11484
-python_infrakit_dev-0.1.4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-python_infrakit_dev-0.1.4.dist-info/entry_points.txt,sha256=9uBSvx5accKf026gAQijwUkkN_eL37RBWlCO3e_9Iz4,80
-python_infrakit_dev-0.1.4.dist-info/RECORD,,
+python_infrakit_dev-0.1.5.dist-info/METADATA,sha256=3VPCCyEalSsmH_jIhhJjyjXEywPSkl7geuxCKyDKUnA,14106
+python_infrakit_dev-0.1.5.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_infrakit_dev-0.1.5.dist-info/entry_points.txt,sha256=9uBSvx5accKf026gAQijwUkkN_eL37RBWlCO3e_9Iz4,80
+python_infrakit_dev-0.1.5.dist-info/RECORD,,