winipedia-utils 0.6.8__tar.gz → 0.7.8__tar.gz

{winipedia_utils-0.6.8 → winipedia_utils-0.7.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: winipedia-utils
-Version: 0.6.8
+Version: 0.7.8
 Summary: A package with many utility functions
 License-Expression: MIT
 License-File: LICENSE
@@ -16,6 +16,7 @@ Requires-Dist: defusedxml
 Requires-Dist: dotenv
 Requires-Dist: keyring
 Requires-Dist: networkx
+Requires-Dist: packaging
 Requires-Dist: pathspec
 Requires-Dist: polars
 Requires-Dist: pygithub
@@ -86,10 +87,11 @@ poetry init # or poetry new
 poetry add winipedia-utils
 
 # 6: Run the automated setup
-poetry run python -m winipedia_utils.setup
+poetry run python -m winipedia_utils.dev.setup
 ```
 
 The setup script will automatically configure your project with all necessary files and standards.
+If you wish to use winipedia_utils without its dev framework then just skip the setup step and you can access the utils via `winipedia_utils.utils`
 
 ## Setup Process
 
@@ -126,8 +128,14 @@ The health check and release workflows test your code across:
 
 This matrix strategy ensures your code works reliably across different environments before merging or releasing.
 
+#### Configuration File Structure
+Config Files are autogenerated via ConfigFile non-abstract subclasses.
+All nonabstract subclasses of ConfigFile are automatically created and managed when you commit or run pytest. winipedia_utils automatically discovers the pkg your_pkg.dev.configs and calls them. This way you can adjust or add some settings by subclassing. It is however important the parent class stays a subset of the child class according to the description in the function `nested_structure_is_subset` in `winipedia_utils.iterating.iterate` bc parents are still initialized and the order is not guaranteed.
+
 #### Workflow Structure
 
+Worklfows are a type of ConfigFile.
+
 The health check workflow consists of two jobs:
 
 1. **Matrix Job** (`health_check_matrix`) - Runs all checks in parallel across the matrix of OS and Python versions:
@@ -145,7 +153,7 @@ The health check workflow consists of two jobs:
    - Provides a single status check that can be marked as required in branch protection rules
 
 The release workflow extends the health check workflow and adds a release job that runs after all health checks pass.
-A build job is added before the release job if a script src/artifacts/build.py exists. This script is created by the setup command and can be modified to create build artifacts for your project. This script then just needs to create artifacts in a folder called artifacts and those will be uploaded as artifacts to the release.
+A build job is added before the release job if a src/dev/artifacts/builder exists with Builder subclasses. This script is created by the setup command and can be modified to create build artifacts for your project. Winipedia Utils automatically discovers all subclasses of Builder (dev.artifacts.builder.base.base) and calls them if the artifacts folder contains any files.
 
 ### Pre-commit Hook Workflow
 
@@ -162,7 +170,7 @@ Hooks run in the following order:
 - Update packages (poetry update --with dev (winipedia_utils forces all dependencies with * to be updated to latest compatible version))
 - Lock dependencies (poetry lock)
 - Check package manager configs (poetry check --strict)
-- Create tests (python -m winipedia_utils.testing.create_tests)
+- Create tests (python -m winipedia_utils.dev.testing.create_tests)
 - Lint code (ruff check --fix)
 - Format code (ruff format)
 - Check static types (mypy)
@@ -203,7 +211,7 @@ Configuration files are managed automatically by the setup system:
 
 ## Branch Protection
 
-As soon as you push to `main` on GitHub (provided the `REPO_TOKEN` secret is set up correctly), the `health_check.yaml` workflow will run and execute `winipedia_utils.git.github.repo.protect`, which uses PyGithub to protect the repository.
+As soon as you push to `main` on GitHub (provided the `REPO_TOKEN` secret is set up correctly), the `health_check.yaml` workflow will run and execute `winipedia_utils.dev.git.github.repo.protect`, which uses PyGithub to protect the repository.
 
 ### Repository Settings
 
@@ -249,8 +257,8 @@ Winipedia Utils provides comprehensive utility modules for common development ta
 Unified interface for multiprocessing and multithreading:
 
 ```python
-from winipedia_utils.concurrent.multiprocessing import multiprocess_loop
-from winipedia_utils.concurrent.multithreading import multithread_loop
+from winipedia_utils.utils.iterating.concurrent.multiprocessing import multiprocess_loop
+from winipedia_utils.utils.iterating.concurrent.multithreading import multithread_loop
 ```
 
 ### Data Cleaning & Handling
@@ -258,7 +266,7 @@ from winipedia_utils.concurrent.multithreading import multithread_loop
 Build data cleaning pipelines using Polars:
 
 ```python
-from winipedia_utils.data.dataframe.cleaning import CleaningDF
+from winipedia_utils.utils.data.dataframe.cleaning import CleaningDF
 import polars as pl
 ```
 
@@ -267,7 +275,7 @@ import polars as pl
 Simple, standardized logging setup with automatic method instrumentation:
 
 ```python
-from winipedia_utils.logging.logger import get_logger
+from winipedia_utils.utils.logging.logger import get_logger
 
 logger = get_logger(__name__)
 logger.info("Application started")
@@ -285,7 +293,7 @@ logger.error("An error occurred")
 Advanced metaclasses and mixins for class composition and behavior extension:
 
 ```python
-from winipedia_utils.oop.mixins.mixin import ABCLoggingMixin, StrictABCLoggingMixin
+from winipedia_utils.utils.oop.mixins.mixin import ABCLoggingMixin, StrictABCLoggingMixin
 ```
 
 ### Security Utilities
@@ -293,7 +301,7 @@ from winipedia_utils.oop.mixins.mixin import ABCLoggingMixin, StrictABCLoggingMi
 Encryption and secure credential storage using keyring:
 
 ```python
-from winipedia_utils.security.keyring import (
+from winipedia_utils.utils.security.keyring import (
     get_or_create_fernet,
     get_or_create_aes_gcm
 )
@@ -304,8 +312,8 @@ from winipedia_utils.security.keyring import (
 Comprehensive testing framework with automatic test generation:
 
 ```python
-from winipedia_utils.testing.assertions import assert_with_msg
-from winipedia_utils.testing.convention import (
+from winipedia_utils.utils.testing.assertions import assert_with_msg
+from winipedia_utils.dev.testing.convention import (
     make_test_obj_name,
     get_test_obj_from_obj,
     make_test_obj_importpath_from_obj
@@ -335,10 +343,10 @@ test_path = make_test_obj_importpath_from_obj(my_function)
 Tools for working with Python modules, packages, classes, and functions:
 
 ```python
-from winipedia_utils.modules.package import find_packages, walk_package
-from winipedia_utils.modules.module import create_module, import_obj_from_importpath
-from winipedia_utils.modules.class_ import get_all_cls_from_module, get_all_methods_from_cls
-from winipedia_utils.modules.function import get_all_functions_from_module
+from winipedia_utils.utils.modules.package import find_packages, walk_package
+from winipedia_utils.utils.modules.module import create_module, import_obj_from_importpath
+from winipedia_utils.utils.modules.class_ import get_all_cls_from_module, get_all_methods_from_cls
+from winipedia_utils.utils.modules.function import get_all_functions_from_module
 ```
 
 ### Text and String Utilities
@@ -346,7 +354,7 @@ from winipedia_utils.modules.function import get_all_functions_from_module
 String manipulation and configuration file handling:
 
 ```python
-from winipedia_utils.text.string import value_to_truncated_string
+from winipedia_utils.utils.data.structures.text.string import value_to_truncated_string
 ```
 
 ### OS and System Utilities
@@ -354,7 +362,7 @@ from winipedia_utils.text.string import value_to_truncated_string
 Operating system and subprocess utilities:
 
 ```python
-from winipedia_utils.os.os import run_subprocess
+from winipedia_utils.utils.os.os import run_subprocess
 ```
 
 ### Iteration Utilities
@@ -362,7 +370,7 @@ from winipedia_utils.os.os import run_subprocess
 Utilities for working with iterables and nested structures:
 
 ```python
-from winipedia_utils.iterating.iterate import get_len_with_default, nested_structure_is_subset
+from winipedia_utils.utils.iterating.iterate import get_len_with_default, nested_structure_is_subset
 ```
 
 ### Philosophy

{winipedia_utils-0.6.8 → winipedia_utils-0.7.8}/README.md

@@ -59,10 +59,11 @@ poetry init # or poetry new
 poetry add winipedia-utils
 
 # 6: Run the automated setup
-poetry run python -m winipedia_utils.setup
+poetry run python -m winipedia_utils.dev.setup
 ```
 
 The setup script will automatically configure your project with all necessary files and standards.
+If you wish to use winipedia_utils without its dev framework then just skip the setup step and you can access the utils via `winipedia_utils.utils`
 
 ## Setup Process
 
@@ -99,8 +100,14 @@ The health check and release workflows test your code across:
 
 This matrix strategy ensures your code works reliably across different environments before merging or releasing.
 
+#### Configuration File Structure
+Config Files are autogenerated via ConfigFile non-abstract subclasses.
+All nonabstract subclasses of ConfigFile are automatically created and managed when you commit or run pytest. winipedia_utils automatically discovers the pkg your_pkg.dev.configs and calls them. This way you can adjust or add some settings by subclassing. It is however important the parent class stays a subset of the child class according to the description in the function `nested_structure_is_subset` in `winipedia_utils.iterating.iterate` bc parents are still initialized and the order is not guaranteed.
+
 #### Workflow Structure
 
+Worklfows are a type of ConfigFile.
+
 The health check workflow consists of two jobs:
 
 1. **Matrix Job** (`health_check_matrix`) - Runs all checks in parallel across the matrix of OS and Python versions:
@@ -118,7 +125,7 @@ The health check workflow consists of two jobs:
    - Provides a single status check that can be marked as required in branch protection rules
 
 The release workflow extends the health check workflow and adds a release job that runs after all health checks pass.
-A build job is added before the release job if a script src/artifacts/build.py exists. This script is created by the setup command and can be modified to create build artifacts for your project. This script then just needs to create artifacts in a folder called artifacts and those will be uploaded as artifacts to the release.
+A build job is added before the release job if a src/dev/artifacts/builder exists with Builder subclasses. This script is created by the setup command and can be modified to create build artifacts for your project. Winipedia Utils automatically discovers all subclasses of Builder (dev.artifacts.builder.base.base) and calls them if the artifacts folder contains any files.
 
 ### Pre-commit Hook Workflow
 
@@ -135,7 +142,7 @@ Hooks run in the following order:
 - Update packages (poetry update --with dev (winipedia_utils forces all dependencies with * to be updated to latest compatible version))
 - Lock dependencies (poetry lock)
 - Check package manager configs (poetry check --strict)
-- Create tests (python -m winipedia_utils.testing.create_tests)
+- Create tests (python -m winipedia_utils.dev.testing.create_tests)
 - Lint code (ruff check --fix)
 - Format code (ruff format)
 - Check static types (mypy)
@@ -176,7 +183,7 @@ Configuration files are managed automatically by the setup system:
 
 ## Branch Protection
 
-As soon as you push to `main` on GitHub (provided the `REPO_TOKEN` secret is set up correctly), the `health_check.yaml` workflow will run and execute `winipedia_utils.git.github.repo.protect`, which uses PyGithub to protect the repository.
+As soon as you push to `main` on GitHub (provided the `REPO_TOKEN` secret is set up correctly), the `health_check.yaml` workflow will run and execute `winipedia_utils.dev.git.github.repo.protect`, which uses PyGithub to protect the repository.
 
 ### Repository Settings
 
@@ -222,8 +229,8 @@ Winipedia Utils provides comprehensive utility modules for common development ta
 Unified interface for multiprocessing and multithreading:
 
 ```python
-from winipedia_utils.concurrent.multiprocessing import multiprocess_loop
-from winipedia_utils.concurrent.multithreading import multithread_loop
+from winipedia_utils.utils.iterating.concurrent.multiprocessing import multiprocess_loop
+from winipedia_utils.utils.iterating.concurrent.multithreading import multithread_loop
 ```
 
 ### Data Cleaning & Handling
@@ -231,7 +238,7 @@ from winipedia_utils.concurrent.multithreading import multithread_loop
 Build data cleaning pipelines using Polars:
 
 ```python
-from winipedia_utils.data.dataframe.cleaning import CleaningDF
+from winipedia_utils.utils.data.dataframe.cleaning import CleaningDF
 import polars as pl
 ```
 
@@ -240,7 +247,7 @@ import polars as pl
 Simple, standardized logging setup with automatic method instrumentation:
 
 ```python
-from winipedia_utils.logging.logger import get_logger
+from winipedia_utils.utils.logging.logger import get_logger
 
 logger = get_logger(__name__)
 logger.info("Application started")
@@ -258,7 +265,7 @@ logger.error("An error occurred")
 Advanced metaclasses and mixins for class composition and behavior extension:
 
 ```python
-from winipedia_utils.oop.mixins.mixin import ABCLoggingMixin, StrictABCLoggingMixin
+from winipedia_utils.utils.oop.mixins.mixin import ABCLoggingMixin, StrictABCLoggingMixin
 ```
 
 ### Security Utilities
@@ -266,7 +273,7 @@ from winipedia_utils.oop.mixins.mixin import ABCLoggingMixin, StrictABCLoggingMi
 Encryption and secure credential storage using keyring:
 
 ```python
-from winipedia_utils.security.keyring import (
+from winipedia_utils.utils.security.keyring import (
     get_or_create_fernet,
     get_or_create_aes_gcm
 )
@@ -277,8 +284,8 @@ from winipedia_utils.security.keyring import (
 Comprehensive testing framework with automatic test generation:
 
 ```python
-from winipedia_utils.testing.assertions import assert_with_msg
-from winipedia_utils.testing.convention import (
+from winipedia_utils.utils.testing.assertions import assert_with_msg
+from winipedia_utils.dev.testing.convention import (
     make_test_obj_name,
     get_test_obj_from_obj,
     make_test_obj_importpath_from_obj
@@ -308,10 +315,10 @@ test_path = make_test_obj_importpath_from_obj(my_function)
 Tools for working with Python modules, packages, classes, and functions:
 
 ```python
-from winipedia_utils.modules.package import find_packages, walk_package
-from winipedia_utils.modules.module import create_module, import_obj_from_importpath
-from winipedia_utils.modules.class_ import get_all_cls_from_module, get_all_methods_from_cls
-from winipedia_utils.modules.function import get_all_functions_from_module
+from winipedia_utils.utils.modules.package import find_packages, walk_package
+from winipedia_utils.utils.modules.module import create_module, import_obj_from_importpath
+from winipedia_utils.utils.modules.class_ import get_all_cls_from_module, get_all_methods_from_cls
+from winipedia_utils.utils.modules.function import get_all_functions_from_module
 ```
 
 ### Text and String Utilities
@@ -319,7 +326,7 @@ from winipedia_utils.modules.function import get_all_functions_from_module
 String manipulation and configuration file handling:
 
 ```python
-from winipedia_utils.text.string import value_to_truncated_string
+from winipedia_utils.utils.data.structures.text.string import value_to_truncated_string
 ```
 
 ### OS and System Utilities
@@ -327,7 +334,7 @@ from winipedia_utils.text.string import value_to_truncated_string
 Operating system and subprocess utilities:
 
 ```python
-from winipedia_utils.os.os import run_subprocess
+from winipedia_utils.utils.os.os import run_subprocess
 ```
 
 ### Iteration Utilities
@@ -335,7 +342,7 @@ from winipedia_utils.os.os import run_subprocess
 Utilities for working with iterables and nested structures:
 
 ```python
-from winipedia_utils.iterating.iterate import get_len_with_default, nested_structure_is_subset
+from winipedia_utils.utils.iterating.iterate import get_len_with_default, nested_structure_is_subset
 ```
 
 ### Philosophy

{winipedia_utils-0.6.8 → winipedia_utils-0.7.8}/pyproject.toml

@@ -1,7 +1,7 @@
 # Project section
 [project]
 name = "winipedia-utils"
-version = "0.6.8"
+version = "0.7.8"
 description = "A package with many utility functions"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -9,7 +9,7 @@ authors = [
     { name = "Winipedia", email = "win.steveker@gmx.de"}
 ]
 license = "MIT"
-dependencies = ["polars", "pyyaml", "keyring", "pygithub", "pathspec", "networkx", "setuptools", "tqdm", "defusedxml", "cryptography", "tomlkit", "dotenv"]
+dynamic = ["dependencies"]
 
 # Build system section[build-system]
 [build-system]
@@ -20,6 +20,21 @@ build-backend = "poetry.core.masonry.api"
 [[tool.poetry.packages]]
 include = "winipedia_utils"
 
+[tool.poetry.dependencies]
+networkx = "*"
+setuptools = "*"
+pyyaml = "*"
+packaging = "*"
+polars = "*"
+tomlkit = "*"
+cryptography = "*"
+tqdm = "*"
+pygithub = "*"
+dotenv = "*"
+pathspec = "*"
+defusedxml = "*"
+keyring = "*"
+
 [tool.poetry.group.dev.dependencies]
 ruff = "*"
 pre-commit = "*"

winipedia_utils-0.7.8/winipedia_utils/dev/artifacts/build.py

@@ -0,0 +1,6 @@
+"""Build artifacts for the project."""
+
+from winipedia_utils.dev.artifacts.builder.base.base import Builder
+
+if __name__ == "__main__":
+    Builder.init_all_non_abstract_subclasses()

winipedia_utils-0.6.8/winipedia_utils/artifacts/build.py → winipedia_utils-0.7.8/winipedia_utils/dev/artifacts/builder/base/base.py

@@ -8,13 +8,18 @@ distribution of project code.
 
 import platform
 from abc import abstractmethod
+from importlib import import_module
 from pathlib import Path
 
-from winipedia_utils.git.github.workflows.base.base import Workflow
-from winipedia_utils.oop.mixins.mixin import ABCLoggingMixin
+from winipedia_utils.dev.configs.builder import BuilderConfigFile
+from winipedia_utils.utils.modules.class_ import (
+    get_all_nonabstract_subclasses,
+)
+from winipedia_utils.utils.modules.module import to_module_name, to_path
+from winipedia_utils.utils.oop.mixins.mixin import ABCLoggingMixin
 
 
-class Build(ABCLoggingMixin):
+class Builder(ABCLoggingMixin):
     """Base class for build scripts.
 
     Subclass this class and implement the get_artifacts method to create
@@ -24,15 +29,18 @@ class Build(ABCLoggingMixin):
         YourBuildClass()
     """
 
-    ARTIFACTS_PATH = Workflow.ARTIFACTS_PATH
+    ARTIFACTS_DIR_NAME = "artifacts"
+    ARTIFACTS_PATH = Path(ARTIFACTS_DIR_NAME)
 
     @classmethod
     @abstractmethod
-    def get_artifacts(cls) -> list[Path]:
+    def create_artifacts(cls) -> None:
         """Build the project.
 
+        This method should create all artifacts in the ARTIFACTS_PATH folder.
+
         Returns:
-            list[Path]: List of paths to the built artifacts
+            None
         """
 
     @classmethod
@@ -49,6 +57,7 @@ class Build(ABCLoggingMixin):
         and puts them in the artifacts folder.
         """
         cls.ARTIFACTS_PATH.mkdir(parents=True, exist_ok=True)
+        cls.create_artifacts()
         artifacts = cls.get_artifacts()
         for artifact in artifacts:
             parent = artifact.parent
@@ -61,18 +70,27 @@ class Build(ABCLoggingMixin):
             new_path = cls.ARTIFACTS_PATH / new_name
             artifact.rename(new_path)
 
-
-class WinipediaUtilsBuild(Build):
-    """Build script for winipedia_utils."""
-
     @classmethod
     def get_artifacts(cls) -> list[Path]:
-        """Build the project."""
-        paths = [cls.ARTIFACTS_PATH / "build.txt"]
-        for path in paths:
-            path.write_text("Hello World!")
+        """Get the built artifacts."""
+        paths = list(cls.ARTIFACTS_PATH.glob("*"))
+        if not paths:
+            msg = f"Expected {cls.ARTIFACTS_PATH} to contain files"
+            raise FileNotFoundError(msg)
         return paths
 
+    @classmethod
+    def get_non_abstract_subclasses(cls) -> set[type["Builder"]]:
+        """Get all non-abstract subclasses of Builder."""
+        path = BuilderConfigFile.get_parent_path()
+        module_name = to_module_name(path)
+        if not to_path(module_name, is_package=True).exists():
+            return set()
+        builds_pkg = import_module(module_name)
+        return get_all_nonabstract_subclasses(cls, load_package_before=builds_pkg)
 
-if __name__ == "__main__":
-    WinipediaUtilsBuild()
+    @classmethod
+    def init_all_non_abstract_subclasses(cls) -> None:
+        """Build all artifacts."""
+        for builder in cls.get_non_abstract_subclasses():
+            builder()

winipedia_utils-0.7.8/winipedia_utils/dev/artifacts/builder/builder.py

@@ -0,0 +1,17 @@
+"""Build script.
+
+All subclasses of Builder in the builds package are automatically called.
+"""
+
+from winipedia_utils.dev.artifacts.builder.base.base import Builder
+
+
+class WinipediaUtilsBuilder(Builder):
+    """Build script for winipedia_utils."""
+
+    @classmethod
+    def create_artifacts(cls) -> None:
+        """Build the project."""
+        paths = [cls.ARTIFACTS_PATH / "build.txt"]
+        for path in paths:
+            path.write_text("Hello World!")

winipedia_utils-0.6.8/winipedia_utils/text/config.py → winipedia_utils-0.7.8/winipedia_utils/dev/configs/base/base.py

@@ -3,19 +3,23 @@
 import inspect
 from abc import ABC, abstractmethod
 from pathlib import Path
+from types import ModuleType
 from typing import Any
 
 import tomlkit
 import yaml
 from dotenv import dotenv_values
 
-from winipedia_utils.iterating.iterate import nested_structure_is_subset
-from winipedia_utils.modules.class_ import init_all_nonabstract_subclasses
-from winipedia_utils.modules.package import DependencyGraph, get_src_package
-from winipedia_utils.projects.poetry.poetry import (
+import winipedia_utils
+from winipedia_utils.dev import configs
+from winipedia_utils.dev.projects.poetry.poetry import (
     get_poetry_run_module_script,
 )
-from winipedia_utils.text.string import split_on_uppercase
+from winipedia_utils.utils.data.structures.text.string import split_on_uppercase
+from winipedia_utils.utils.iterating.iterate import nested_structure_is_subset
+from winipedia_utils.utils.modules.class_ import init_all_nonabstract_subclasses
+from winipedia_utils.utils.modules.module import import_module_with_default
+from winipedia_utils.utils.modules.package import DependencyGraph, get_src_package
 
 
 class ConfigFile(ABC):
@@ -153,14 +157,21 @@ class ConfigFile(ABC):
                 include_winipedia_utils=True
             )
         )
+
         pkgs_depending_on_winipedia_utils.add(get_src_package())
         for pkg in pkgs_depending_on_winipedia_utils:
-            init_all_nonabstract_subclasses(cls, load_package_before=pkg)
+            configs_pkg_name = configs.__name__.replace(
+                winipedia_utils.__name__, pkg.__name__, 1
+            )
+            configs_pkg = import_module_with_default(configs_pkg_name)
+            if not isinstance(configs_pkg, ModuleType):
+                continue
+            init_all_nonabstract_subclasses(cls, load_package_before=configs_pkg)
 
     @staticmethod
     def get_poetry_run_setup_script() -> str:
         """Get the poetry run setup script."""
-        from winipedia_utils import setup  # noqa: PLC0415  # avoid circular import
+        from winipedia_utils.dev import setup  # noqa: PLC0415  # avoid circular import
 
         return get_poetry_run_module_script(setup)
 
@@ -248,3 +259,53 @@ class DotEnvConfigFile(ConfigFile):
     def is_correct(cls) -> bool:
         """Check if the config is correct."""
         return super().is_correct() or cls.get_path().exists()
+
+
+class PythonConfigFile(ConfigFile):
+    """Base class for python config files."""
+
+    CONTENT_KEY = "content"
+
+    @classmethod
+    @abstractmethod
+    def get_content_str(cls) -> str:
+        """Get the content."""
+
+    @classmethod
+    def load(cls) -> dict[str, str]:
+        """Load the config file."""
+        return {cls.CONTENT_KEY: cls.get_path().read_text()}
+
+    @classmethod
+    def dump(cls, config: dict[str, Any] | list[Any]) -> None:
+        """Dump the config file."""
+        if not isinstance(config, dict):
+            msg = f"Cannot dump {config} to python file."
+            raise TypeError(msg)
+        cls.get_path().write_text(config[cls.CONTENT_KEY])
+
+    @classmethod
+    def get_file_extension(cls) -> str:
+        """Get the file extension of the config file."""
+        return "py"
+
+    @classmethod
+    def get_configs(cls) -> dict[str, Any]:
+        """Get the config."""
+        return {cls.CONTENT_KEY: cls.get_content_str()}
+
+    @classmethod
+    def get_file_content(cls) -> str:
+        """Get the file content."""
+        return cls.load()[cls.CONTENT_KEY]
+
+    @classmethod
+    def is_correct(cls) -> bool:
+        """Check if the config is correct.
+
+        Python files are correct if they exist and contain the correct content.
+        """
+        return (
+            super().is_correct()
+            or cls.get_content_str().strip() in cls.load()[cls.CONTENT_KEY]
+        )

winipedia_utils-0.7.8/winipedia_utils/dev/configs/builder.py

@@ -0,0 +1,30 @@
+"""Config File subclass that creates the builds dir and a build.py."""
+
+from pathlib import Path
+
+import winipedia_utils
+from winipedia_utils.dev.artifacts import builder
+from winipedia_utils.dev.configs.base.base import PythonConfigFile
+from winipedia_utils.dev.configs.pyproject import PyprojectConfigFile
+from winipedia_utils.utils.modules.module import to_path
+
+
+class BuilderConfigFile(PythonConfigFile):
+    """Config File subclass that creates the dirs folder."""
+
+    @classmethod
+    def get_parent_path(cls) -> Path:
+        """Get the path to the config file."""
+        src_package = PyprojectConfigFile.get_package_name()
+        builds_package = builder.__name__.replace(
+            winipedia_utils.__name__, src_package, 1
+        )
+        return to_path(builds_package, is_package=True)
+
+    @classmethod
+    def get_content_str(cls) -> str:
+        """Get the content."""
+        return '''"""Build script.
+
+All subclasses of Builder in the builds package are automatically called.
+"""'''

winipedia_utils-0.7.8/winipedia_utils/dev/configs/configs.py

@@ -0,0 +1,34 @@
+"""Configs for winipedia_utils.
+
+All subclasses of ConfigFile in the configs package are automatically called.
+"""
+
+from pathlib import Path
+
+import winipedia_utils
+from winipedia_utils.dev import configs
+from winipedia_utils.dev.configs.base.base import PythonConfigFile
+from winipedia_utils.dev.configs.pyproject import PyprojectConfigFile
+from winipedia_utils.utils.modules.module import to_path
+
+
+class ConfigsConfigFile(PythonConfigFile):
+    """Config file for configs.py."""
+
+    @classmethod
+    def get_parent_path(cls) -> Path:
+        """Get the path to the config file."""
+        src_package = PyprojectConfigFile.get_package_name()
+        builds_package = configs.__name__.replace(
+            winipedia_utils.__name__, src_package, 1
+        )
+        return to_path(builds_package, is_package=True)
+
+    @classmethod
+    def get_content_str(cls) -> str:
+        """Get the content."""
+        return '''"""Configs for winipedia_utils.
+
+All subclasses of ConfigFile in the configs package are automatically called.
+"""
+'''

winipedia_utils-0.6.8/winipedia_utils/git/gitignore/config.py → winipedia_utils-0.7.8/winipedia_utils/dev/configs/gitignore.py

@@ -5,8 +5,8 @@ from typing import Any
 
 import requests
 
-from winipedia_utils.testing.config import ExperimentConfigFile
-from winipedia_utils.text.config import ConfigFile, DotEnvConfigFile
+from winipedia_utils.dev.configs.base.base import ConfigFile, DotEnvConfigFile
+from winipedia_utils.dev.configs.testing import ExperimentConfigFile
 
 
 class GitIgnoreConfigFile(ConfigFile):