pydantic-settings-manager 0.1.1__tar.gz → 0.2.0__tar.gz

pydantic_settings_manager-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,55 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  release:
+    types: [created]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: uv sync --dev
+    - name: Run tests
+      run: uv run make test
+    - name: Run format check
+      run: uv run ruff check .
+    - name: Run linters
+      run: uv run make lint
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release' && github.event.action == 'created'
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+    - name: Set up Python
+      run: uv python install 3.9
+    - name: Install dependencies
+      run: uv sync --dev
+    - name: Build and publish
+      env:
+        UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+      run: |
+        uv build
+        uv publish

pydantic_settings_manager-0.2.0/.gitignore

@@ -0,0 +1,14 @@
+.DS_Store
+
+__pycache__/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+
+.coverage
+.dmypy.json
+
+dist/
+build/
+*.egg-info/

pydantic_settings_manager-0.2.0/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2025-06-28
+
+### Changed
+- **BREAKING**: Migrated from Poetry to uv for dependency management
+- Modernized development toolchain with unified linting using ruff
+- Updated to use PEP 621 compliant project metadata format
+- Introduced PEP 735 dependency groups for flexible development environments
+- Enhanced CI/CD pipeline to use uv instead of Poetry
+- Improved type checking configuration with stricter MyPy settings
+- Updated all development dependencies to latest versions
+
+### Added
+- Comprehensive development documentation in README
+- Support for modular dependency groups (test, lint, dev)
+- Enhanced linting rules including pyupgrade and flake8-comprehensions
+- Migration guide for developers updating their local environment
+
+### Removed
+- Poetry configuration files (poetry.lock, pyproject.toml Poetry sections)
+- Separate black, isort, and flake8 configurations (replaced by ruff)
+
+## [0.1.2] - 2024-03-12
+
+### Added
+- Added py.typed file for better type checking support
+- Improved package configuration and build process
+
+## [0.1.1] - 2024-03-12
+
+### Added
+- Added detailed documentation in README.md
+- Added example code for both SingleSettingsManager and MappedSettingsManager
+
+### Fixed
+- Improved type hints and documentation
+
+## [0.1.0] - 2024-03-11
+
+### Added
+- Initial release
+- Implemented SingleSettingsManager for managing single settings object
+- Implemented MappedSettingsManager for managing multiple settings objects
+- Support for loading settings from multiple sources
+- Command line argument overrides
+- Settings validation through Pydantic

pydantic_settings_manager-0.2.0/Makefile

@@ -0,0 +1,30 @@
+.PHONY: format lint test clean build publish
+.DEFAULT_GOAL := build
+
+format:
+	uv run ruff check --fix .
+
+lint:
+	uv run ruff check .
+	uv run mypy .
+
+test:
+	uv run pytest --cov=pydantic_settings_manager tests/
+
+clean:
+	rm -rf dist/
+	rm -rf *.egg-info/
+	find . -type d -name __pycache__ -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+	find . -type f -name "*.pyo" -delete
+	find . -type f -name "*.pyd" -delete
+	find . -type f -name ".coverage" -delete
+	find . -type d -name ".pytest_cache" -exec rm -rf {} +
+	find . -type d -name ".mypy_cache" -exec rm -rf {} +
+	find . -type d -name ".ruff_cache" -exec rm -rf {} +
+
+build: format lint test clean
+	uv build
+
+publish: build
+	uv publish

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/PKG-INFO

@@ -1,29 +1,27 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pydantic-settings-manager
-Version: 0.1.1
+Version: 0.2.0
 Summary: A library for managing Pydantic settings objects
-Home-page: https://github.com/kiarina/pydantic-settings-manager
+Project-URL: homepage, https://github.com/kiarina/pydantic-settings-manager
+Project-URL: repository, https://github.com/kiarina/pydantic-settings-manager
+Project-URL: documentation, https://github.com/kiarina/pydantic-settings-manager
+Author-email: kiarina <kiarinadawa@gmail.com>
 License: MIT
-Keywords: pydantic,settings,configuration
-Author: kiarina
-Author-email: kiarinadawa@gmail.com
-Requires-Python: >=3.8,<4.0
+License-File: LICENSE
+Keywords: configuration,pydantic,settings
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: pydantic (>=2.0.0,<3.0.0)
-Requires-Dist: pydantic-settings (>=2.0.0,<3.0.0)
-Project-URL: Documentation, https://github.com/kiarina/pydantic-settings-manager
-Project-URL: Repository, https://github.com/kiarina/pydantic-settings-manager
+Requires-Python: >=3.9
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
 Description-Content-Type: text/markdown
 
 # pydantic-settings-manager
@@ -109,6 +107,55 @@ assert settings.name == "production"
 assert settings.value == 100
 ```
 
+## Development
+
+This project uses modern Python development tools with flexible dependency groups:
+
+- **ruff**: Fast linter and formatter (replaces black, isort, and flake8)
+- **mypy**: Static type checking
+- **pytest**: Testing framework with coverage reporting
+- **uv**: Fast Python package manager with PEP 735 dependency groups support
+
+### Setup
+
+```bash
+# Install all development dependencies
+uv sync --group dev
+
+# Or install specific dependency groups
+uv sync --group test    # Testing tools only
+uv sync --group lint    # Linting tools only
+
+# Format code
+uv run ruff check --fix .
+
+# Run linting
+uv run ruff check .
+uv run mypy .
+
+# Run tests
+uv run pytest --cov=pydantic_settings_manager tests/
+
+# Build and test everything
+make build
+```
+
+### Development Workflow
+
+```bash
+# Quick setup for testing
+uv sync --group test
+make test
+
+# Quick setup for linting
+uv sync --group lint
+make lint
+
+# Full development environment
+uv sync --group dev
+make build
+```
+
 ## Documentation
 
 For more detailed documentation, please see the [GitHub repository](https://github.com/kiarina/pydantic-settings-manager).
@@ -116,4 +163,3 @@ For more detailed documentation, please see the [GitHub repository](https://gith
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/README.md

@@ -81,6 +81,55 @@ assert settings.name == "production"
 assert settings.value == 100
 ```
 
+## Development
+
+This project uses modern Python development tools with flexible dependency groups:
+
+- **ruff**: Fast linter and formatter (replaces black, isort, and flake8)
+- **mypy**: Static type checking
+- **pytest**: Testing framework with coverage reporting
+- **uv**: Fast Python package manager with PEP 735 dependency groups support
+
+### Setup
+
+```bash
+# Install all development dependencies
+uv sync --group dev
+
+# Or install specific dependency groups
+uv sync --group test    # Testing tools only
+uv sync --group lint    # Linting tools only
+
+# Format code
+uv run ruff check --fix .
+
+# Run linting
+uv run ruff check .
+uv run mypy .
+
+# Run tests
+uv run pytest --cov=pydantic_settings_manager tests/
+
+# Build and test everything
+make build
+```
+
+### Development Workflow
+
+```bash
+# Quick setup for testing
+uv sync --group test
+make test
+
+# Quick setup for linting
+uv sync --group lint
+make lint
+
+# Full development environment
+uv sync --group dev
+make build
+```
+
 ## Documentation
 
 For more detailed documentation, please see the [GitHub repository](https://github.com/kiarina/pydantic-settings-manager).

pydantic_settings_manager-0.2.0/mypy.ini

@@ -0,0 +1,9 @@
+[mypy]
+# Perform type checking on functions and methods without type hints
+check_untyped_defs = True
+
+# Do not check imported modules
+follow_imports = silent
+
+# Perform incremental checking (only check changed files for faster execution)
+incremental = True

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/pydantic_settings_manager/__init__.py

@@ -21,17 +21,17 @@ from .base import BaseSettingsManager
 from .mapped import MappedSettingsManager, SettingsMap
 from .single import SingleSettingsManager
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 
 __all__ = [
     # Re-exports from pydantic_settings
     "BaseSettings",
-    "SettingsConfigDict",
     # Base manager
     "BaseSettingsManager",
-    # Single settings manager
-    "SingleSettingsManager",
     # Mapped settings manager
     "MappedSettingsManager",
+    "SettingsConfigDict",
     "SettingsMap",
+    # Single settings manager
+    "SingleSettingsManager",
 ]

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/pydantic_settings_manager/base.py

@@ -2,7 +2,7 @@
 Base classes for settings managers.
 """
 from abc import ABC, abstractmethod
-from typing import Any, Dict, Generic, Type, TypeVar
+from typing import Any, Generic, TypeVar
 
 from pydantic_settings import BaseSettings
 
@@ -21,7 +21,7 @@ class BaseSettingsManager(ABC, Generic[T]):
     """
 
     @abstractmethod
-    def __init__(self, settings_cls: Type[T]):
+    def __init__(self, settings_cls: type[T]):
         """
         Initialize the settings manager.
 
@@ -31,7 +31,7 @@ class BaseSettingsManager(ABC, Generic[T]):
         self.settings_cls = settings_cls
         """The settings class being managed"""
 
-        self.user_config: Dict[str, Any] = {}
+        self.user_config: dict[str, Any] = {}
         """User configuration dictionary"""
 
     @property

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/pydantic_settings_manager/mapped.py

@@ -3,7 +3,7 @@ Mapped settings manager implementation.
 """
 from __future__ import annotations
 
-from typing import Any, Dict, Generic, Type
+from typing import Any, Generic
 
 from pydantic import BaseModel, Field
 from pydantic.main import create_model
@@ -30,7 +30,7 @@ class SettingsMap(BaseModel, Generic[T]):
     key: str = ""
     """The key of the currently active settings"""
 
-    map: Dict[str, T] = Field(default_factory=dict)
+    map: dict[str, T] = Field(default_factory=dict)
     """A dictionary mapping keys to settings objects"""
 
 
@@ -80,20 +80,20 @@ class MappedSettingsManager(BaseSettingsManager[T]):
         ```
     """
 
-    def __init__(self, settings_cls: Type[T]):
+    def __init__(self, settings_cls: type[T]):
         """
         Initialize the settings manager.
 
         Args:
             settings_cls: The settings class to manage
         """
-        self.settings_cls: Type[T] = settings_cls
+        self.settings_cls: type[T] = settings_cls
         """The settings class being managed"""
 
         self.cli_args: SettingsMap[T] = SettingsMap[T]()
         """Command line arguments"""
 
-        self.user_config: Dict[str, Any] = {}
+        self.user_config: dict[str, Any] = {}
         """User configuration"""
 
         self.system_settings: T = settings_cls()
@@ -128,7 +128,7 @@ class MappedSettingsManager(BaseSettingsManager[T]):
         self.clear()
 
     @property
-    def _cli_args_config(self) -> Dict[str, Any]:
+    def _cli_args_config(self) -> dict[str, Any]:
         """
         Get the command line arguments as a dictionary.
 
@@ -146,7 +146,7 @@ class MappedSettingsManager(BaseSettingsManager[T]):
         return diff_dict(base, target)
 
     @property
-    def _system_settings_config(self) -> Dict[str, Any]:
+    def _system_settings_config(self) -> dict[str, Any]:
         """
         Get the system settings as a dictionary.
 
@@ -180,7 +180,7 @@ class MappedSettingsManager(BaseSettingsManager[T]):
         DynamicMapSettings = create_model(
             "DynamicMapSettings",
             key=(str, ""),
-            map=(Dict[str, self.settings_cls], {}),  # type: ignore[name-defined]
+            map=(dict[str, self.settings_cls], {}),  # type: ignore[name-defined]
             __base__=SettingsMap[T],
         )
 
@@ -215,7 +215,7 @@ class MappedSettingsManager(BaseSettingsManager[T]):
             if not self.map_settings.map:
                 settings = self.settings_cls(**self.system_settings.model_dump())
             else:
-                key = list(self.map_settings.map.keys())[0]
+                key = next(iter(self.map_settings.map.keys()))
                 settings = self.map_settings.map[key]
         else:
             if self.map_settings.key not in self.map_settings.map:
@@ -272,7 +272,7 @@ class MappedSettingsManager(BaseSettingsManager[T]):
         return self.map_settings.key
 
     @property
-    def all_settings(self) -> Dict[str, T]:
+    def all_settings(self) -> dict[str, T]:
         """
         Get all settings.
 

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/pydantic_settings_manager/single.py

@@ -1,7 +1,7 @@
 """
 Single settings manager implementation.
 """
-from typing import Any, Dict, Type, Union
+from typing import Any, Union
 
 from .base import BaseSettingsManager, T
 from .utils import NestedDict, nested_dict, update_dict
@@ -42,20 +42,20 @@ class SingleSettingsManager(BaseSettingsManager[T]):
         ```
     """
 
-    def __init__(self, settings_cls: Type[T]):
+    def __init__(self, settings_cls: type[T]):
         """
         Initialize the settings manager.
 
         Args:
             settings_cls: The settings class to manage
         """
-        self.settings_cls: Type[T] = settings_cls
+        self.settings_cls: type[T] = settings_cls
         """The settings class being managed"""
 
         self.cli_args: NestedDict = nested_dict()
         """Command line arguments"""
 
-        self.user_config: Dict[str, Any] = {}
+        self.user_config: dict[str, Any] = {}
         """User configuration"""
 
         self._settings: Union[T, None] = None

pydantic_settings_manager-0.2.0/pydantic_settings_manager/types.py

@@ -0,0 +1,7 @@
+from collections import defaultdict
+from typing import Any, Union
+
+NestedDict = defaultdict[str, Union["NestedDict", Any]]
+"""
+ネストした辞書型
+"""

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/pydantic_settings_manager/utils.py

@@ -2,12 +2,12 @@
 Utility functions for dictionary operations.
 """
 from collections import defaultdict
-from typing import Any, Dict
+from typing import Any
 
 from .types import NestedDict
 
 
-def diff_dict(base: Dict[str, Any], target: Dict[str, Any]) -> Dict[str, Any]:
+def diff_dict(base: dict[str, Any], target: dict[str, Any]) -> dict[str, Any]:
     """
     Get the difference between two dictionaries.
     Only includes keys where the values are different.
@@ -27,7 +27,7 @@ def diff_dict(base: Dict[str, Any], target: Dict[str, Any]) -> Dict[str, Any]:
     return result
 
 
-def update_dict(base: Dict[str, Any], update: Dict[str, Any]) -> Dict[str, Any]:
+def update_dict(base: dict[str, Any], update: dict[str, Any]) -> dict[str, Any]:
     """
     Update a dictionary with another dictionary.
     Performs a deep update.

{pydantic_settings_manager-0.1.1 → pydantic_settings_manager-0.2.0}/pyproject.toml

@@ -1,13 +1,12 @@
-[tool.poetry]
+[project]
 name = "pydantic-settings-manager"
-version = "0.1.1"
+version = "0.2.0"
 description = "A library for managing Pydantic settings objects"
-authors = ["kiarina <kiarinadawa@gmail.com>"]
-license = "MIT"
+authors = [
+    { name = "kiarina", email = "kiarinadawa@gmail.com" }
+]
+license = { text = "MIT" }
 readme = "README.md"
-homepage = "https://github.com/kiarina/pydantic-settings-manager"
-repository = "https://github.com/kiarina/pydantic-settings-manager"
-documentation = "https://github.com/kiarina/pydantic-settings-manager"
 keywords = ["pydantic", "settings", "configuration"]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -15,44 +14,32 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
-packages = [
-    { include = "pydantic_settings_manager" }
+requires-python = ">=3.9"
+dependencies = [
+    "pydantic>=2.0.0",
+    "pydantic-settings>=2.0.0",
 ]
 
-[tool.poetry.dependencies]
-python = "^3.8"
-pydantic = "^2.0.0"
-pydantic-settings = "^2.0.0"
-
-[tool.poetry.group.dev.dependencies]
-pytest = "^7.4.0"
-pytest-cov = "^4.1.0"
-black = "^23.7.0"
-isort = "^5.12.0"
-mypy = "^1.5.0"
-ruff = "^0.0.284"
+[project.urls]
+homepage = "https://github.com/kiarina/pydantic-settings-manager"
+repository = "https://github.com/kiarina/pydantic-settings-manager"
+documentation = "https://github.com/kiarina/pydantic-settings-manager"
 
 [build-system]
-requires = ["poetry-core"]
-build-backend = "poetry.core.masonry.api"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
-[tool.black]
-line-length = 100
-target-version = ["py38"]
-
-[tool.isort]
-profile = "black"
-line_length = 100
-multi_line_output = 3
+[tool.setuptools.package-data]
+pydantic_settings_manager = ["py.typed"]
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.9"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
@@ -67,5 +54,37 @@ warn_unreachable = true
 
 [tool.ruff]
 line-length = 100
-target-version = "py38"
-select = ["E", "F", "B", "I"]
+target-version = "py39"
+fix = true
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "RUF", # ruff-specific rules
+]
+ignore = []
+
+[tool.ruff.lint.isort]
+known-first-party = ["pydantic_settings_manager"]
+
+[dependency-groups]
+test = [
+    "pytest>=8.3.5",
+    "pytest-cov>=5.0.0",
+]
+lint = [
+    "mypy>=1.14.1",
+    "ruff>=0.12.1",
+]
+dev = [
+    "pytest>=8.3.5",
+    "pytest-cov>=5.0.0",
+    "mypy>=1.14.1",
+    "ruff>=0.12.1",
+]