pydanticonf 1.0.0__tar.gz

pydanticonf-1.0.0/.coveragerc

@@ -0,0 +1,14 @@
+[run]
+source =
+    pydanticonf/
+
+omit =
+    */__init__.py
+    */tests/*
+
+[report]
+fail_under = 80
+show_missing = True
+
+[html]
+directory = coverage_html_report

pydanticonf-1.0.0/.dockerignore

@@ -0,0 +1,51 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+venv/
+ENV/
+env/
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.ruff_cache/
+
+# Git
+.git/
+.github/
+.gitignore
+.gitattributes
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Documentation
+docs/
+*.md
+!README.md
+
+# Testing
+tests/
+test_*.py
+*_test.py
+conftest.py
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/

pydanticonf-1.0.0/.env.sample

@@ -0,0 +1,12 @@
+ENV=development
+DEBUG=true
+
+S3__ENDPOINT_URL=http://host.docker.internal:9000
+S3__AWS_ACCESS_KEY_ID=minioadmin
+S3__AWS_SECRET_ACCESS_KEY=minioadmin
+
+OPENAI__API_KEY=
+OPENAI__MODEL_NAME=gpt-4o-mini
+OPENAI__TEMPERATURE=0.0
+OPENAI__MAX_COMPLETION_TOKENS=1000
+OPENAI__LOGPROBS=false

pydanticonf-1.0.0/.gitattributes

@@ -0,0 +1 @@
+*.ipynb linguist-documentation

pydanticonf-1.0.0/.gitignore

@@ -0,0 +1,80 @@
+_build/
+.DS_Store
+.secrets
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+*.manifest
+*.spec
+pip-log.txt
+pip-delete-this-directory.txt
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+*.mo
+*.pot
+*.log
+instance/
+.webassets-cache
+.scrapy
+docs/_build/
+.pybuilder/
+target/
+.ipynb_checkpoints
+profile_default/
+ipython_config.py
+.pdm.toml
+__pypackages__/
+celerybeat-schedule
+celerybeat.pid
+*.sage.py
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.spyderproject
+.spyproject
+.ropeproject
+/site
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+cython_debug/
+.vscode/
+.env
+**/genai/**/*
+**/llm/**/*
+outputs/

pydanticonf-1.0.0/.markdownlint.json

@@ -0,0 +1,15 @@
+{
+    "default": true,
+    "MD007": {
+        "indent": 4
+    },
+    "MD013": {
+        "line_length": 10000
+    },
+    "MD024": {
+        "siblings_only": true
+    },
+    "MD033": false,
+    "no-hard-tabs": false,
+    "whitespace": false
+}

pydanticonf-1.0.0/.mypy.ini

@@ -0,0 +1,68 @@
+# Reference:
+# https://github.com/openai/openai-python/blob/main/mypy.ini
+# https://github.com/pytorch/pytorch/blob/main/mypy.ini
+[mypy]
+pretty=True
+show_error_codes=True
+python_version=3.12
+
+strict_equality=True
+implicit_reexport=True
+check_untyped_defs=True
+no_implicit_optional=True
+
+warn_return_any=True
+warn_unreachable=True
+warn_unused_configs=True
+
+warn_unused_ignores=False
+warn_redundant_casts=False
+
+disallow_any_generics=True
+disallow_untyped_defs=True
+disallow_untyped_calls=False
+disallow_subclassing_any=True
+disallow_incomplete_defs=True
+disallow_untyped_decorators=True
+cache_fine_grained=True
+disable_error_code=func-returns-value
+
+plugins = pydantic.mypy
+
+[pydantic-mypy]
+init_forbid_extra = True
+init_typed = True
+warn_required_dynamic_aliases = True
+
+# https://github.com/python/mypy/issues/12162
+[mypy.overrides]
+module="black.files.*"
+ignore_errors=true
+ignore_missing_imports=true
+
+[mypy-matplotlib.*]
+ignore_missing_imports=True
+
+[mypy-mpl_toolkits.*]
+ignore_missing_imports=True
+
+[mypy-seaborn.*]
+ignore_missing_imports=True
+
+[mypy-sklearn.*]
+ignore_missing_imports=True
+
+[mypy-transformers.*]
+ignore_missing_imports=True
+
+[mypy-datasets.*]
+ignore_missing_imports=True
+
+[mypy-accelerate.*]
+ignore_missing_imports=True
+
+[mypy-scipy.*]
+ignore_missing_imports=True
+
+[mypy-bitsandbytes.*]
+ignore_missing_imports=True

pydanticonf-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,69 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-ast
+      - id: check-builtin-literals
+      - id: check-case-conflict
+      - id: check-docstring-first
+      - id: check-executables-have-shebangs
+      - id: check-json
+      - id: check-shebang-scripts-are-executable
+      - id: check-symlinks
+      - id: check-toml
+      - id: check-vcs-permalinks
+      - id: check-xml
+      - id: check-yaml
+      - id: debug-statements
+      - id: destroyed-symlinks
+      - id: mixed-line-ending
+      - id: trailing-whitespace
+      - id: check-merge-conflict
+
+
+  - repo: local
+    hooks:
+      - id: security-bandit
+        name: Security Check (Bandit)
+        entry: make security
+        language: system
+        types: [python]
+        pass_filenames: false
+
+  - repo: local
+    hooks:
+      - id: lint-ruff
+        name: Lint and Format Check (Ruff)
+        entry: make lint
+        language: system
+        types: [python]
+        pass_filenames: false
+
+  - repo: local
+    hooks:
+      - id: type-mypy
+        name: Type Check (MyPy)
+        entry: make typecheck
+        language: system
+        types: [python]
+        pass_filenames: false
+
+  - repo: local
+    hooks:
+      - id: unit-test
+        name: Unit Tests (PyTest)
+        entry: make test
+        language: system
+        types: [python]
+        pass_filenames: false
+
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v4.8.3
+    hooks:
+      - id: commitizen
+        stages: [commit-msg]
+
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.7.19
+    hooks:
+      - id: uv-lock

pydanticonf-1.0.0/.prettierignore

@@ -0,0 +1,78 @@
+# Build artifacts
+build/
+dist/
+*.egg-info/
+__pycache__/
+*.pyc
+*.pyo
+.DS_Store
+
+# Coverage reports
+htmlcov/
+.coverage
+coverage.xml
+*.cover
+
+# Virtual environments
+venv/
+.venv/
+env/
+.env/
+
+# Cache directories
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.nox/
+.tox/
+
+# Node modules
+node_modules/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Documentation build
+docs/_build/
+docs/_static/
+docs/_templates/
+
+# Jupyter
+.ipynb_checkpoints/
+*.ipynb
+
+# Lock files (we want to format these)
+!package-lock.json
+!yarn.lock
+!pnpm-lock.yaml
+
+# Test artifacts
+.benchmarks/
+
+# Temporary files
+*.tmp
+*.temp
+*.log
+
+# Python files (handled by ruff)
+*.py
+
+# Generated files
+*.min.js
+*.min.css
+
+# Archives
+*.zip
+*.tar.gz
+*.tgz
+
+# OS files
+Thumbs.db
+
+# Git
+.git/
+.gitignore
+.gitattributes

pydanticonf-1.0.0/.prettierrc

@@ -0,0 +1,5 @@
+{
+    "proseWrap": "always",
+    "printWidth": 80,
+    "tabWidth": 4
+}

pydanticonf-1.0.0/.pytest.ini

@@ -0,0 +1,19 @@
+# Reference:
+# https://github.com/tiangolo/fastapi/blob/master/pyproject.toml
+# https://github.com/pydantic/pydantic/blob/main/pyproject.toml
+[pytest]
+minversion=6.0
+pythonpath=.
+addopts=
+    --strict-config
+    --strict-markers
+    --import-mode=importlib
+testpaths=
+    tests/pydanticonf/unit
+    tests/pydanticonf/integration
+xfail_strict=true
+filterwarnings=
+    error
+    ignore::DeprecationWarning
+markers =
+    asyncio: mark test as an async test

pydanticonf-1.0.0/.python-version

@@ -0,0 +1 @@
+3.12

pydanticonf-1.0.0/.ruff.toml

@@ -0,0 +1,96 @@
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+]
+
+line-length = 120
+indent-width = 4
+target-version = "py312"
+output-format = "grouped"
+
+[lint]
+exclude = ["*.ipynb"]
+select = [
+    "ARG",
+    "B",
+    "C4",
+    "G",
+    "E",
+    "EXE",
+    "F",
+    "I",
+    "SIM1",
+    "W",
+    "NPY",
+    "PERF",
+    "PGH004",
+    "PIE794",
+    "PIE800",
+    "PIE804",
+    "PIE807",
+    "PIE810",
+    "PLC0131",
+    "PLC0132",
+    "PLC0205",
+    "PLE",
+    "PLR0133",
+    "PLR0206",
+    "PLR1722",
+    "PLW0129",
+    "PLW0406",
+    "PLW0711",
+    "PLW1509",
+    "PLW3301",
+    "PT006",
+    "PT022",
+    "PT023",
+    "PT024",
+    "PT025",
+    "PT026",
+    "PYI",
+    "B904",
+    "TRY203",
+    "UP",
+]
+ignore = [
+    "E501",
+    "UP006",
+    "UP015",
+    "UP035",
+    "G004",
+    "UP007",
+    "UP040",
+    "UP046",
+    "UP047",
+]
+fixable = ["ALL"]
+unfixable = []
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[lint.isort]
+known-first-party = ["pydanticonf"]
+
+[format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"

pydanticonf-1.0.0/.secrets.sample

@@ -0,0 +1 @@
+POSTGRES__PASSWORD=

pydanticonf-1.0.0/Makefile

@@ -0,0 +1,86 @@
+.DEFAULT_GOAL := help
+
+PACKAGE_NAME := pydanticonf
+DOCS_DIR := playbook
+TEST_DIR := tests
+SOURCES := $(PACKAGE_NAME)
+
+.PHONY: .uv
+.uv:
+	@uv -V || echo 'Please install uv: https://docs.astral.sh/uv/getting-started/installation/'
+
+.PHONY: install
+install: .uv
+	uv sync --frozen --all-extras --all-packages --all-groups
+	uv run pre-commit install
+	uv run pre-commit install --hook-type commit-msg
+
+.PHONY: lock
+lock: .uv
+	uv lock --upgrade
+
+.PHONY: sync
+sync: .uv
+	uv sync --all-extras --all-packages --all-groups
+
+.PHONY: format
+format: .uv
+	uv run ruff check --fix --exit-zero $(SOURCES)
+	uv run ruff format $(SOURCES)
+
+.PHONY: lint
+lint: .uv
+	uv run ruff check $(SOURCES)
+	uv run ruff format --check $(SOURCES)
+
+.PHONY: security
+security: .uv
+	uv run bandit -r $(PACKAGE_NAME) -ll
+
+.PHONY: typecheck
+typecheck: .uv
+	uv run mypy $(SOURCES)
+	uv run pyright $(SOURCES)
+	# @echo "Running ty (experimental)..."
+	# uv run ty check $(SOURCES) || echo "ty check failed (expected for pre-release)"
+
+.PHONY: test
+test: .uv
+	uv run pytest $(TEST_DIR)
+
+.PHONY: coverage
+coverage: .uv
+	uv run coverage run -m pytest $(TEST_DIR)
+	uv run coverage html -d htmlcov
+	uv run coverage xml -o coverage.xml
+	uv run coverage report -m --fail-under=95
+
+.PHONY: docs
+docs: .uv
+	cd $(DOCS_DIR) && uv run jupyter book build .
+
+.PHONY: ci
+ci: lint security typecheck test
+
+.PHONY: clean
+clean:
+	@./scripts/clean.sh
+
+.PHONY: help
+help:
+	@echo "Development Commands:"
+	@echo "  install             Install all dependencies (all groups + extras)"
+	@echo "  lock                Update and regenerate lock file"
+	@echo "  sync                Sync dependencies (without --frozen)"
+	@echo "  format              Format code with ruff"
+	@echo "  lint                Lint code with ruff (includes format check)"
+	@echo "  security            Run security checks with bandit"
+	@echo "  typecheck           Run type checking with mypy, pyright"
+	@echo "  test                Run tests with pytest"
+	@echo "  coverage            Run tests with coverage reporting (95% minimum)"
+	@echo "  docs                Build Jupyter Book documentation"
+	@echo "  ci                  Run full CI pipeline (lint, security, typecheck, test, coverage)"
+	@echo ""
+	@echo "Utility Commands:"
+	@echo "  clean               Clean build artifacts and cache files"
+	@echo "  help                Show this help message"

pydanticonf-1.0.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: pydanticonf
+Version: 1.0.0
+Summary: Pydantic settings with YAML configuration support.
+Project-URL: Homepage, https://github.com/gao-hongnan/pydanticonf
+Project-URL: Documentation, https://github.com/gao-hongnan/pydanticonf/tree/main/playbook
+Project-URL: Repository, https://github.com/gao-hongnan/pydanticonf
+Project-URL: Issues, https://github.com/gao-hongnan/pydanticonf/issues
+Project-URL: Changelog, https://github.com/gao-hongnan/pydanticonf/releases
+Author-email: GAO Hongnan <hongnangao@gmail.com>
+Maintainer-email: GAO Hongnan <hongnangao@gmail.com>
+License: Apache-2.0
+Keywords: config,configuration,dotenv,environment,pydantic,settings,yaml
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: pydantic-settings>=2.10.1
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pyyaml>=6.0.2
+Provides-Extra: playground
+Requires-Dist: python-dotenv>=1.0.1; extra == 'playground'
+Requires-Dist: rich>=13.12.0; extra == 'playground'
+Requires-Dist: typer>=0.15.1; extra == 'playground'
+Description-Content-Type: text/markdown
+
+# Pydanticonf
+
+[![CI](https://github.com/gao-hongnan/pydanticonf/actions/workflows/ci.yml/badge.svg)](https://github.com/gao-hongnan/pydanticonf/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/badge/pypi-v22.0.0-blue.svg)](https://github.com/gao-hongnan/pydanticonf)
+[![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Mypy](https://img.shields.io/badge/typed-mypy-blue?style=flat-square&logo=python)](http://mypy-lang.org/)
+[![Pyright](https://img.shields.io/badge/typed-pyright-blue?style=flat-square&logo=python)](https://github.com/microsoft/pyright)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)

pydanticonf-1.0.0/README.md

@@ -0,0 +1,10 @@
+# Pydanticonf
+
+[![CI](https://github.com/gao-hongnan/pydanticonf/actions/workflows/ci.yml/badge.svg)](https://github.com/gao-hongnan/pydanticonf/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/badge/pypi-v22.0.0-blue.svg)](https://github.com/gao-hongnan/pydanticonf)
+[![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Mypy](https://img.shields.io/badge/typed-mypy-blue?style=flat-square&logo=python)](http://mypy-lang.org/)
+[![Pyright](https://img.shields.io/badge/typed-pyright-blue?style=flat-square&logo=python)](https://github.com/microsoft/pyright)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)

pydanticonf-1.0.0/pydanticonf/__init__.py

@@ -0,0 +1,7 @@
+"""Pydanticonf: Unified interfaces for LLM providers with YAML configuration support."""
+
+from pydanticonf.settings import BaseSettingsWithYaml
+
+__all__ = [
+    "BaseSettingsWithYaml",
+]