DataExcept 0.2.1__tar.gz → 0.3.0__tar.gz

{dataexcept-0.2.1 → dataexcept-0.3.0}/CHANGELOG.md

@@ -7,6 +7,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-08-24
+
+### Added
+
+- **Every exception the package defines is now importable from `dataexcept`
+  directly.** All 98 classes are exported at the top level, so callers no
+  longer need to know which domain module a class lives in. The domain modules
+  export the same objects, so `from dataexcept import ValidationError` and
+  `from dataexcept.exceptions import ValidationError` are interchangeable and
+  `except` behaves identically either way.
+
+  This was only safe because 0.2.0 removed the two hazards that make a flat
+  namespace dangerous: there are no duplicate class names left, and nothing
+  shadows a Python builtin. Imports are explicit rather than generated at
+  runtime, so type checkers and IDEs see the full surface — the package ships
+  `py.typed`.
+- `dataexcept.exceptions` and `dataexcept.logging_helpers` are now named in
+  `__all__` alongside the other domain modules; the stability policy already
+  described them as public.
+- Tests covering the public surface: every exception the package defines must
+  be exported and resolve, each top-level export must be the *same object* as
+  the submodule one, no exported name may shadow a builtin, no two exceptions
+  may share a name, and `from dataexcept import *` must expose the documented
+  surface. Verified these fail when an unexported exception is introduced.
+- Tests that `poetry.lock` is committed, and that `docs/requirements.txt`
+  agrees with the Poetry `docs` group — the two list the same packages and
+  could drift apart silently.
+
+### Changed
+
+- `poetry.lock` is committed, and CI installs from it. Every job previously ran
+  `pip install black flake8 isort mypy ruff` unpinned, so a new release of any
+  linter could turn the build red with no commit to point at. `poetry check
+  --lock` now fails the build if the lock and `pyproject.toml` disagree.
+- The coverage badge is generated by `scripts/coverage_badge.py` instead of
+  the `coverage-badge` package. That package still imports `pkg_resources`,
+  removed in setuptools 81, so using it required pinning `setuptools<81` — and
+  dependency review flagged a moderate-severity advisory against the version
+  that pin selected. Its last release was August 2024. Generating the SVG
+  directly removes the dependency, the pin and the advisory together; the
+  output is byte-identical to the published badge apart from the percentage.
+
 ## [0.2.1] - 2026-08-24
 
 Documentation and CLI fixes. 0.2.0's README is what PyPI renders as the
@@ -126,7 +168,8 @@ First public release.
 - Published to PyPI via OIDC trusted publishing; no long-lived API token is
   involved in a release.
 
-[Unreleased]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.2.1...HEAD
+[Unreleased]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.2.1...v0.3.0
 [0.2.1]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/DiogoRibeiro7/DataExcept/releases/tag/v0.1.0

{dataexcept-0.2.1 → dataexcept-0.3.0}/CITATION.cff

@@ -1,7 +1,7 @@
 cff-version: 1.2.0
 message: "If you use this software, please cite it using the following metadata."
 title: "DataExcept"
-version: "0.2.1"
+version: "0.3.0"
 authors:
   - family-names: "Ribeiro"
     given-names: "Diogo"

{dataexcept-0.2.1 → dataexcept-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DataExcept
-Version: 0.2.1
+Version: 0.3.0
 Summary: A Python package providing structured, easily-extendable custom exception types.
 License-Expression: MIT
 License-File: LICENSE
@@ -42,6 +42,7 @@ Description-Content-Type: text/markdown
 ## 🎯 Key Features
 
 - **🏗️ Hierarchical Structure**: Catch specific errors or broad categories
+- **📦 One Import**: Every exception is available from `dataexcept` directly, or from its domain module — same objects either way
 - **📊 Data Science Focused**: 98 exception classes covering ML pipelines, feature engineering, model training
 - **🔧 Production Ready**: Comprehensive logging helpers and error context
 - **📚 Academic Quality**: Proper documentation, type hints, and citation support
@@ -67,8 +68,7 @@ poetry install
 ### Basic Usage
 
 ```python
-from dataexcept import ValidationError
-from dataexcept.datascience_exceptions import DataLoadingError, ModelTrainingError
+from dataexcept import DataLoadingError, ModelTrainingError, ValidationError
 import pandas as pd
 
 # Data validation with context
@@ -225,7 +225,7 @@ BiasDetectionError
 
 # Check version
 $ dataexcept --version
-dataexcept 0.2.1
+dataexcept 0.3.0
 ```
 
 ## 🎯 Use Cases
@@ -375,7 +375,7 @@ If you use DataExcept in your research, please cite it:
   author = {Ribeiro, Diogo},
   title = {DataExcept: Structured Exception Handling for Data Science},
   url = {https://github.com/DiogoRibeiro7/DataExcept},
-  version = {0.2.1},
+  version = {0.3.0},
   year = {2026},
   publisher = {GitHub}
 }

{dataexcept-0.2.1 → dataexcept-0.3.0}/README.md

@@ -16,6 +16,7 @@
 ## 🎯 Key Features
 
 - **🏗️ Hierarchical Structure**: Catch specific errors or broad categories
+- **📦 One Import**: Every exception is available from `dataexcept` directly, or from its domain module — same objects either way
 - **📊 Data Science Focused**: 98 exception classes covering ML pipelines, feature engineering, model training
 - **🔧 Production Ready**: Comprehensive logging helpers and error context
 - **📚 Academic Quality**: Proper documentation, type hints, and citation support
@@ -41,8 +42,7 @@ poetry install
 ### Basic Usage
 
 ```python
-from dataexcept import ValidationError
-from dataexcept.datascience_exceptions import DataLoadingError, ModelTrainingError
+from dataexcept import DataLoadingError, ModelTrainingError, ValidationError
 import pandas as pd
 
 # Data validation with context
@@ -199,7 +199,7 @@ BiasDetectionError
 
 # Check version
 $ dataexcept --version
-dataexcept 0.2.1
+dataexcept 0.3.0
 ```
 
 ## 🎯 Use Cases
@@ -349,7 +349,7 @@ If you use DataExcept in your research, please cite it:
   author = {Ribeiro, Diogo},
   title = {DataExcept: Structured Exception Handling for Data Science},
   url = {https://github.com/DiogoRibeiro7/DataExcept},
-  version = {0.2.1},
+  version = {0.3.0},
   year = {2026},
   publisher = {GitHub}
 }

dataexcept-0.3.0/dataexcept/__init__.py

@@ -0,0 +1,298 @@
+"""Top-level package for DataExcept.
+
+Every exception the package defines is importable straight from here::
+
+    from dataexcept import ValidationError, ModelTrainingError
+
+The domain modules (``datascience_exceptions``, ``pipeline_exceptions`` and so
+on) remain importable and export the same objects, so both spellings work and
+refer to the same classes.
+"""
+
+from pathlib import Path
+
+try:  # Python >=3.11
+    import tomllib  # type: ignore
+except ModuleNotFoundError:  # pragma: no cover - fallback for Python <3.11
+    import tomli as tomllib  # type: ignore
+
+from importlib import import_module, metadata
+from typing import Any
+
+from . import (  # noqa: F401
+    database_exceptions,
+    dataengineering_exceptions,
+    datascience_exceptions,
+    exceptions,
+    io_exceptions,
+    logging_helpers,
+    network_exceptions,
+    pandas_exceptions,
+    pipeline_exceptions,
+    security_exceptions,
+)
+from ._deprecation import resolve_deprecated
+from .database_exceptions import (
+    DatabaseConnectionError,
+    DatabaseError,
+    QueryExecutionError,
+    TransactionError,
+)
+from .dataengineering_exceptions import (
+    BatchProcessingError,
+    DataEngineeringError,
+    DataTransformationError,
+    DataWarehouseConnectionError,
+    ETLJobError,
+    MissingPartitionError,
+    SchemaEvolutionError,
+)
+from .datascience_exceptions import (
+    BiasDetectionError,
+    ConvergenceError,
+    CrossValidationError,
+    DataAugmentationError,
+    DataDriftError,
+    DataExportError,
+    DataFormatError,
+    DataImbalanceError,
+    DataLeakageError,
+    DataLoadingError,
+    DataNormalizationError,
+    DataScienceError,
+    DataValidationError,
+    DeploymentError,
+    DimensionalityReductionError,
+    EarlyStoppingError,
+    ExperimentTrackingError,
+    ExplainabilityError,
+    FeatureEngineeringError,
+    FeatureScalingError,
+    FeatureSelectionError,
+    GPUOutOfMemoryError,
+    HyperparameterError,
+    HyperparameterTuningError,
+    MissingDataError,
+    ModelCompatibilityError,
+    ModelEvaluationError,
+    ModelInferenceError,
+    ModelSerializationError,
+    ModelTrainingError,
+    OutlierDetectionError,
+    OverfittingError,
+    PredictionError,
+    ResourceLimitError,
+    SchemaMismatchError,
+    TrainingTimeoutError,
+    UnderfittingError,
+)
+from .exceptions import (
+    AuthenticationError,
+    AuthorizationError,
+    ConfigurationError,
+    CronExpressionError,
+    DependencyError,
+    DeserializationError,
+    EmailError,
+    JobCancellationError,
+    JobError,
+    NotificationError,
+    OperationTimeoutError,
+    ParsingError,
+    ResourceNotFoundError,
+    ScheduleConflictError,
+    SerializationError,
+    ServiceConnectionError,
+    ValidationError,
+    WebhookError,
+)
+from .io_exceptions import (
+    CustomIOError,
+    FileLockError,
+    FileReadError,
+    FileWriteError,
+)
+from .logging_helpers import (
+    Context,
+    log_and_raise,
+    log_exception,
+    log_then_raise,
+)
+from .network_exceptions import (
+    ConnectionTimeoutError,
+    HostUnreachableError,
+    NetworkError,
+    ProtocolError,
+)
+from .pandas_exceptions import (
+    DtypeMismatchError,
+    IndexAlignmentError,
+    MergeKeyError,
+    MissingColumnError,
+    PandasError,
+    PandasIOError,
+)
+from .pipeline_exceptions import (
+    ApiError,
+    DataFetchError,
+    ExternalServiceError,
+    FeaturePreprocessingError,
+    PipelineError,
+    PipelineNotificationError,
+    PreprocessingError,
+    RetryLimitExceededError,
+    ServiceAuthenticationError,
+    ServiceAuthorizationError,
+    ServiceTimeoutError,
+    StorageError,
+    TimeDeltaTooLargeError,
+    TypeCheckError,
+)
+from .security_exceptions import (
+    DecryptionError,
+    EncryptionError,
+    InvalidTokenError,
+    SecurityError,
+)
+
+__all__ = [
+    # Every exception class the package defines.
+    "ApiError",
+    "AuthenticationError",
+    "AuthorizationError",
+    "BatchProcessingError",
+    "BiasDetectionError",
+    "ConfigurationError",
+    "ConnectionTimeoutError",
+    "ConvergenceError",
+    "CronExpressionError",
+    "CrossValidationError",
+    "CustomIOError",
+    "DataAugmentationError",
+    "DataDriftError",
+    "DataEngineeringError",
+    "DataExportError",
+    "DataFetchError",
+    "DataFormatError",
+    "DataImbalanceError",
+    "DataLeakageError",
+    "DataLoadingError",
+    "DataNormalizationError",
+    "DataScienceError",
+    "DataTransformationError",
+    "DataValidationError",
+    "DataWarehouseConnectionError",
+    "DatabaseConnectionError",
+    "DatabaseError",
+    "DecryptionError",
+    "DependencyError",
+    "DeploymentError",
+    "DeserializationError",
+    "DimensionalityReductionError",
+    "DtypeMismatchError",
+    "ETLJobError",
+    "EarlyStoppingError",
+    "EmailError",
+    "EncryptionError",
+    "ExperimentTrackingError",
+    "ExplainabilityError",
+    "ExternalServiceError",
+    "FeatureEngineeringError",
+    "FeaturePreprocessingError",
+    "FeatureScalingError",
+    "FeatureSelectionError",
+    "FileLockError",
+    "FileReadError",
+    "FileWriteError",
+    "GPUOutOfMemoryError",
+    "HostUnreachableError",
+    "HyperparameterError",
+    "HyperparameterTuningError",
+    "IndexAlignmentError",
+    "InvalidTokenError",
+    "JobCancellationError",
+    "JobError",
+    "MergeKeyError",
+    "MissingColumnError",
+    "MissingDataError",
+    "MissingPartitionError",
+    "ModelCompatibilityError",
+    "ModelEvaluationError",
+    "ModelInferenceError",
+    "ModelSerializationError",
+    "ModelTrainingError",
+    "NetworkError",
+    "NotificationError",
+    "OperationTimeoutError",
+    "OutlierDetectionError",
+    "OverfittingError",
+    "PandasError",
+    "PandasIOError",
+    "ParsingError",
+    "PipelineError",
+    "PipelineNotificationError",
+    "PredictionError",
+    "PreprocessingError",
+    "ProtocolError",
+    "QueryExecutionError",
+    "ResourceLimitError",
+    "ResourceNotFoundError",
+    "RetryLimitExceededError",
+    "ScheduleConflictError",
+    "SchemaEvolutionError",
+    "SchemaMismatchError",
+    "SecurityError",
+    "SerializationError",
+    "ServiceAuthenticationError",
+    "ServiceAuthorizationError",
+    "ServiceConnectionError",
+    "ServiceTimeoutError",
+    "StorageError",
+    "TimeDeltaTooLargeError",
+    "TrainingTimeoutError",
+    "TransactionError",
+    "TypeCheckError",
+    "UnderfittingError",
+    "ValidationError",
+    "WebhookError",
+    # Logging helpers.
+    "Context",
+    "log_and_raise",
+    "log_exception",
+    "log_then_raise",
+    # Domain modules, for callers who prefer a qualified import.
+    "database_exceptions",
+    "dataengineering_exceptions",
+    "datascience_exceptions",
+    "exceptions",
+    "io_exceptions",
+    "job_exceptions",
+    "logging_helpers",
+    "network_exceptions",
+    "pandas_exceptions",
+    "pipeline_exceptions",
+    "security_exceptions",
+]
+
+try:
+    __version__ = metadata.version("DataExcept")
+except metadata.PackageNotFoundError:  # pragma: no cover - fallback during dev
+    _root = Path(__file__).resolve().parents[1]
+    with open(_root / "pyproject.toml", "rb") as _f:
+        __version__ = tomllib.load(_f)["project"]["version"]
+
+
+#: Renamed in 0.2.0 because they shadowed Python builtins without inheriting
+#: from them. Each alias is the same class object as its replacement.
+_DEPRECATED_ALIASES = {
+    "ConnectionError": ServiceConnectionError,
+    "TimeoutError": OperationTimeoutError,
+}
+
+
+def __getattr__(name: str) -> Any:
+    if name == "job_exceptions":
+        module = import_module("dataexcept.job_exceptions")
+        globals()[name] = module
+        return module
+    return resolve_deprecated(__name__, _DEPRECATED_ALIASES, name)

{dataexcept-0.2.1 → dataexcept-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "DataExcept"
-version = "0.2.1"
+version = "0.3.0"
 description = "A Python package providing structured, easily-extendable custom exception types."
 readme = "README.md"
 license = "MIT"

dataexcept-0.2.1/dataexcept/__init__.py

@@ -1,94 +0,0 @@
-"""Top-level package for DataExcept.
-
-Exposes the common job-related exceptions directly and also provides
-access to data science specific exceptions via the ``datascience_exceptions``
-module.
-"""
-
-from pathlib import Path
-
-try:  # Python >=3.11
-    import tomllib  # type: ignore
-except ModuleNotFoundError:  # pragma: no cover - fallback for Python <3.11
-    import tomli as tomllib  # type: ignore
-
-from importlib import import_module, metadata
-from typing import Any
-
-from . import (
-    database_exceptions,
-    dataengineering_exceptions,
-    datascience_exceptions,
-)
-from . import exceptions as _exceptions
-from . import (
-    io_exceptions,
-    network_exceptions,
-    pandas_exceptions,
-    pipeline_exceptions,
-    security_exceptions,
-)
-from ._deprecation import resolve_deprecated
-from .exceptions import (  # noqa: F401
-    AuthenticationError,
-    AuthorizationError,
-    ConfigurationError,
-    CronExpressionError,
-    DependencyError,
-    DeserializationError,
-    EmailError,
-    JobCancellationError,
-    JobError,
-    NotificationError,
-    OperationTimeoutError,
-    ParsingError,
-    ResourceNotFoundError,
-    ScheduleConflictError,
-    SerializationError,
-    ServiceConnectionError,
-    ValidationError,
-    WebhookError,
-)
-from .logging_helpers import (
-    log_and_raise,
-    log_exception,
-    log_then_raise,
-)
-
-try:
-    __version__ = metadata.version("DataExcept")
-except metadata.PackageNotFoundError:  # pragma: no cover - fallback during dev
-    _root = Path(__file__).resolve().parents[1]
-    with open(_root / "pyproject.toml", "rb") as _f:
-        __version__ = tomllib.load(_f)["project"]["version"]
-
-__all__ = list(_exceptions.__all__) + [
-    "datascience_exceptions",
-    "job_exceptions",
-    "pipeline_exceptions",
-    "dataengineering_exceptions",
-    "network_exceptions",
-    "io_exceptions",
-    "database_exceptions",
-    "security_exceptions",
-    "pandas_exceptions",
-    "log_exception",
-    "log_and_raise",
-    "log_then_raise",
-]
-
-
-#: Renamed in 0.2.0 because they shadowed Python builtins without inheriting
-#: from them. Each alias is the same class object as its replacement.
-_DEPRECATED_ALIASES = {
-    "ConnectionError": ServiceConnectionError,
-    "TimeoutError": OperationTimeoutError,
-}
-
-
-def __getattr__(name: str) -> Any:
-    if name == "job_exceptions":
-        module = import_module("dataexcept.job_exceptions")
-        globals()[name] = module
-        return module
-    return resolve_deprecated(__name__, _DEPRECATED_ALIASES, name)