etlplus 0.9.2__tar.gz → 0.10.2__tar.gz

{etlplus-0.9.2 → etlplus-0.10.2}/CONTRIBUTING.md

@@ -119,7 +119,7 @@ Use these guidelines to decide whether a test belongs in the unit or integration
   - Can use temporary files/directories, and stub network with fakes/mocks.
   - Examples in this repo: CLI end-to-end, pipeline smoke tests, pagination strategy, runner defaults for pagination/rate limits, target URL composition.
 
-If a test calls `etlplus.cli.main()` or `etlplus.ops.run.run()`, it is integration by default.
+If a test calls `etlplus.cli.main()` or `etlplus.run.run()`, it is integration by default.
 
 ### Where to put tests
 

{etlplus-0.9.2 → etlplus-0.10.2}/DEMO.md

@@ -196,7 +196,7 @@ $ etlplus load transformed.json file final_output.csv
 ## Demo 6: Using Python API
 
 ```python
-from etlplus.ops import extract, validate, transform, load
+from etlplus import extract, validate, transform, load
 
 # Extract
 data = extract("file", "data.csv", format="csv")

{etlplus-0.9.2/etlplus.egg-info → etlplus-0.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etlplus
-Version: 0.9.2
+Version: 0.10.2
 Summary: A Swiss Army knife for simple ETL operations
 Home-page: https://github.com/Dagitali/ETLPlus
 Author: ETLPlus Team
@@ -17,11 +17,8 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.13,<3.15
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastavro>=1.12.1
 Requires-Dist: jinja2>=3.1.6
-Requires-Dist: openpyxl>=3.1.5
 Requires-Dist: pyodbc>=5.3.0
-Requires-Dist: pyarrow>=22.0.0
 Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: pandas>=2.3.3
 Requires-Dist: pydantic>=2.12.5
@@ -29,8 +26,6 @@ Requires-Dist: PyYAML>=6.0.3
 Requires-Dist: requests>=2.32.5
 Requires-Dist: SQLAlchemy>=2.0.45
 Requires-Dist: typer>=0.21.0
-Requires-Dist: xlrd>=2.0.2
-Requires-Dist: xlwt>=1.3.0
 Provides-Extra: dev
 Requires-Dist: black>=25.9.0; extra == "dev"
 Requires-Dist: build>=1.2.2; extra == "dev"
@@ -64,25 +59,9 @@ ETLPlus is a veritable Swiss Army knife for enabling simple ETL operations, offe
 package and command-line interface for data extraction, validation, transformation, and loading.
 
 - [ETLPlus](#etlplus)
-  - [Getting Started](#getting-started)
   - [Features](#features)
   - [Installation](#installation)
   - [Quickstart](#quickstart)
-  - [Data Connectors](#data-connectors)
-    - [REST APIs (`api`)](#rest-apis-api)
-    - [Databases (`database`)](#databases-database)
-    - [Files (`file`)](#files-file)
-      - [Stubbed / Placeholder](#stubbed--placeholder)
-      - [Tabular \& Delimited Text](#tabular--delimited-text)
-      - [Semi-Structured Text](#semi-structured-text)
-      - [Columnar / Analytics-Friendly](#columnar--analytics-friendly)
-      - [Binary Serialization and Interchange](#binary-serialization-and-interchange)
-      - [Databases and Embedded Storage](#databases-and-embedded-storage)
-      - [Spreadsheets](#spreadsheets)
-      - [Statistical / Scientific / Numeric Computing](#statistical--scientific--numeric-computing)
-      - [Logs and Event Streams](#logs-and-event-streams)
-      - [Data Archives](#data-archives)
-      - [Templates](#templates)
   - [Usage](#usage)
     - [Command Line Interface](#command-line-interface)
       - [Argument Order and Required Options](#argument-order-and-required-options)
@@ -108,27 +87,11 @@ package and command-line interface for data extraction, validation, transformati
     - [Linting](#linting)
     - [Updating Demo Snippets](#updating-demo-snippets)
     - [Releasing to PyPI](#releasing-to-pypi)
+  - [Links](#links)
   - [License](#license)
   - [Contributing](#contributing)
-  - [Documentation](#documentation)
-    - [Python Packages/Subpackage](#python-packagessubpackage)
-    - [Community Health](#community-health)
-    - [Other](#other)
   - [Acknowledgments](#acknowledgments)
 
-## Getting Started
-
-ETLPlus helps you extract, validate, transform, and load data from files, databases, and APIs, either
-as a Python library or from the command line.
-
-To get started:
-
-- See [Installation](#installation) for setup instructions.
-- Try the [Quickstart](#quickstart) for a minimal working example (CLI and Python).
-- Explore [Usage](#usage) for more detailed options and workflows.
-
-ETLPlus supports Python 3.13 and above.
-
 ## Features
 
 - **Check** data pipeline definitions before running them:
@@ -196,7 +159,7 @@ etlplus extract file examples/data/sample.csv \
 [Python API](#python-api):
 
 ```python
-from etlplus.ops import extract, transform, validate, load
+from etlplus import extract, transform, validate, load
 
 data = extract("file", "input.csv")
 ops = {"filter": {"field": "age", "op": "gt", "value": 25}, "select": ["name", "email"]}
@@ -206,140 +169,6 @@ assert validate(filtered, rules)["valid"]
 load(filtered, "file", "temp/sample_output.json", file_format="json")
 ```
 
-## Data Connectors
-
-Data connectors abstract sources from which to extract data and targets to which to load data. They
-are differentiated by their types, each of which is represented in the subsections below.
-
-### REST APIs (`api`)
-
-ETLPlus can extract from REST APIs and load results via common HTTP methods. Supported operations
-include GET for extract and PATCH/POST/PUT for load.
-
-### Databases (`database`)
-
-Database connectors use connection strings for extraction and loading, and
-DDL can be rendered from table specs for migrations or schema checks.
-
-### Files (`file`)
-
-Recognized file formats are listed in the tables below. Support for reading to or writing from a recognized file format is marked as:
-
-- **Y**: implemented (may require optional dependencies)
-- **N**: stubbed or not yet implemented
-
-#### Stubbed / Placeholder
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `stub` | N | Placeholder format for tests and future connectors. |
-
-#### Tabular & Delimited Text
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `csv` | Y | Y | Comma-Separated Values |
-| `dat` | N | N | Generic data file, often delimited or fixed-width |
-| `fwf` | N | N | Fixed-Width Fields |
-| `psv` | N | N | Pipe-Separated Values |
-| `tab` | N | N | Often synonymous with TSV |
-| `tsv` | Y | Y | Tab-Separated Values |
-| `txt` | Y | Y | Plain text, often delimited or fixed-width |
-
-#### Semi-Structured Text
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `cfg` | N | N | Config-style key-value pairs |
-| `conf` | N | N | Config-style key-value pairs |
-| `ini` | N | N | Config-style key-value pairs |
-| `json` | Y | Y | JavaScript Object Notation |
-| `ndjson` | Y | Y | Newline-Delimited JSON |
-| `properties` | N | N | Java-style key-value pairs |
-| `toml` | N | N | Tom's Obvious Minimal Language |
-| `xml` | Y | Y | Extensible Markup Language |
-| `yaml` | Y | Y | YAML Ain't Markup Language |
-
-#### Columnar / Analytics-Friendly
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `arrow` | N | N | Apache Arrow IPC |
-| `feather` | Y | Y | Apache Arrow Feather |
-| `orc` | Y | Y | Optimized Row Columnar; common in Hadoop |
-| `parquet` | Y | Y | Apache Parquet; common in Big Data |
-
-#### Binary Serialization and Interchange
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `avro` | Y | Y | Apache Avro |
-| `bson` | N | N | Binary JSON; common with MongoDB exports/dumps |
-| `cbor` | N | N | Concise Binary Object Representation |
-| `ion` | N | N | Amazon Ion |
-| `msgpack` | N | N | MessagePack |
-| `pb` | N | N | Protocol Buffers (Google Protobuf) |
-| `pbf` | N | N | Protocolbuffer Binary Format; often for GIS data |
-| `proto` | N | N | Protocol Buffers schema; often in .pb / .bin |
-
-#### Databases and Embedded Storage
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `accdb` | N | N | Microsoft Access (newer format) |
-| `duckdb` | N | N | DuckDB |
-| `mdb` | N | N | Microsoft Access (older format) |
-| `sqlite` | N | N | SQLite |
-
-#### Spreadsheets
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `numbers` | N | N | Apple Numbers |
-| `ods` | N | N | OpenDocument |
-| `wks` | N | N | Lotus 1-2-3  |
-| `xls` | Y | Y | Microsoft Excel (BIFF) |
-| `xlsm` | N | N | Microsoft Excel Macro-Enabled (Open XML) |
-| `xlsx` | Y | Y | Microsoft Excel (Open XML) |
-
-#### Statistical / Scientific / Numeric Computing
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `dta` | N | N | Stata |
-| `hdf5` | N | N | Hierarchical Data Format |
-| `mat` | N | N | MATLAB |
-| `nc` | N | N | NetCDF |
-| `rda` | N | N | RData workspace/object |
-| `rds` | N | N | R data |
-| `sas7bdat` | N | N | SAS data |
-| `sav` | N | N | SPSS data |
-| `sylk` | N | N | Symbolic Link |
-| `xpt` | N | N | SAS Transport |
-| `zsav` | N | N | Compressed SPSS data |
-
-#### Logs and Event Streams
-
-| Format | Supported | Description |
-| --- | --- | --- |
-| `log` | N | N | Generic log file |
-
-#### Data Archives
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `gz` | Y | Y | Gzip-compressed file |
-| `zip` | Y | Y | ZIP archive |
-
-#### Templates
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `hbs` | N | N | Handlebars |
-| `jinja2` | N | N | Jinja2 |
-| `mustache` | N | N | Mustache |
-| `vm` | N | N | Apache Velocity |
-
 ## Usage
 
 ### Command Line Interface
@@ -531,7 +360,7 @@ cat examples/data/sample.json \
 Use ETLPlus as a Python library:
 
 ```python
-from etlplus.ops import extract, validate, transform, load
+from etlplus import extract, validate, transform, load
 
 # Extract data
 data = extract("file", "data.json")
@@ -587,7 +416,7 @@ etlplus transform \
 # 3. Validate transformed data
 etlplus validate \
   --rules '{"name": {"type": "string", "required": true}, "email": {"type": "string", "required": true}}' \
-  temp/sample_transformed.json
+  temo/sample_transformed.json
 
 # 4. Load to CSV
 cat temp/sample_transformed.json \
@@ -726,7 +555,7 @@ We split tests into two layers:
   pagination + rate limit defaults, file/API connector interactions) may touch temp files and use
   fake clients.
 
-If a test calls `etlplus.cli.main()` or `etlplus.ops.run.run()` it’s integration by default. Full
+If a test calls `etlplus.cli.main()` or `etlplus.run.run()` it’s integration by default.  Full
 criteria: [`CONTRIBUTING.md#testing`](CONTRIBUTING.md#testing).
 
 ### Code Coverage
@@ -774,6 +603,17 @@ git push origin v1.4.0
 If you want an extra smoke-test before tagging, run `make dist && pip install dist/*.whl` locally;
 this exercises the same build path the workflow uses.
 
+## Links
+
+- API client docs: [`etlplus/api/README.md`](etlplus/api/README.md)
+- Examples: [`examples/README.md`](examples/README.md)
+- Pipeline authoring guide: [`docs/pipeline-guide.md`](docs/pipeline-guide.md)
+- Runner internals: [`docs/run-module.md`](docs/run-module.md)
+- Design notes (Mapping inputs, dict outputs): [`docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs`](docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs)
+- Typing philosophy: [`CONTRIBUTING.md#typing-philosophy`](CONTRIBUTING.md#typing-philosophy)
+- Demo and walkthrough: [`DEMO.md`](DEMO.md)
+- Additional references: [`REFERENCES.md`](`REFERENCES.md)
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).
@@ -797,39 +637,6 @@ If you choose to be a code contributor, please first refer these documents:
 - Typing philosophy (TypedDicts as editor hints, permissive runtime):
   [`CONTRIBUTING.md#typing-philosophy`](CONTRIBUTING.md#typing-philosophy)
 
-## Documentation
-
-### Python Packages/Subpackage
-
-Navigate to detailed documentation for each subpackage:
-
-- [etlplus.api](etlplus/api/README.md): Lightweight HTTP client and paginated REST helpers
-- [etlplus.file](etlplus/file/README.md): Unified file format support and helpers
-- [etlplus.cli](etlplus/cli/README.md): Command-line interface definitions for `etlplus`
-- [etlplus.database](etlplus/database/README.md): Database engine, schema, and ORM helpers
-- [etlplus.templates](etlplus/templates/README.md): SQL and DDL template helpers
-- [etlplus.validation](etlplus/validation/README.md): Data validation utilities and helpers
-- [etlplus.workflow](etlplus/workflow/README.md): Helpers for data connectors, pipelines, jobs, and
-  profiles
-
-### Community Health
-
-- [Contributing Guidelines](CONTRIBUTING.md): How to contribute, report issues, and submit PRs
-- [Code of Conduct](CODE_OF_CONDUCT.md): Community standards and expectations
-- [Security Policy](SECURITY.md): Responsible disclosure and vulnerability reporting
-- [Support](SUPPORT.md): Where to get help
-
-### Other
-
-- API client docs: [`etlplus/api/README.md`](etlplus/api/README.md)
-- Examples: [`examples/README.md`](examples/README.md)
-- Pipeline authoring guide: [`docs/pipeline-guide.md`](docs/pipeline-guide.md)
-- Runner internals: [`docs/run-module.md`](docs/run-module.md)
-- Design notes (Mapping inputs, dict outputs): [`docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs`](docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs)
-- Typing philosophy: [`CONTRIBUTING.md#typing-philosophy`](CONTRIBUTING.md#typing-philosophy)
-- Demo and walkthrough: [`DEMO.md`](DEMO.md)
-- Additional references: [`REFERENCES.md`](REFERENCES.md)
-
 ## Acknowledgments
 
 ETLPlus is inspired by common work patterns in data engineering and software engineering patterns in

{etlplus-0.9.2 → etlplus-0.10.2}/README.md

@@ -14,25 +14,9 @@ ETLPlus is a veritable Swiss Army knife for enabling simple ETL operations, offe
 package and command-line interface for data extraction, validation, transformation, and loading.
 
 - [ETLPlus](#etlplus)
-  - [Getting Started](#getting-started)
   - [Features](#features)
   - [Installation](#installation)
   - [Quickstart](#quickstart)
-  - [Data Connectors](#data-connectors)
-    - [REST APIs (`api`)](#rest-apis-api)
-    - [Databases (`database`)](#databases-database)
-    - [Files (`file`)](#files-file)
-      - [Stubbed / Placeholder](#stubbed--placeholder)
-      - [Tabular \& Delimited Text](#tabular--delimited-text)
-      - [Semi-Structured Text](#semi-structured-text)
-      - [Columnar / Analytics-Friendly](#columnar--analytics-friendly)
-      - [Binary Serialization and Interchange](#binary-serialization-and-interchange)
-      - [Databases and Embedded Storage](#databases-and-embedded-storage)
-      - [Spreadsheets](#spreadsheets)
-      - [Statistical / Scientific / Numeric Computing](#statistical--scientific--numeric-computing)
-      - [Logs and Event Streams](#logs-and-event-streams)
-      - [Data Archives](#data-archives)
-      - [Templates](#templates)
   - [Usage](#usage)
     - [Command Line Interface](#command-line-interface)
       - [Argument Order and Required Options](#argument-order-and-required-options)
@@ -58,27 +42,11 @@ package and command-line interface for data extraction, validation, transformati
     - [Linting](#linting)
     - [Updating Demo Snippets](#updating-demo-snippets)
     - [Releasing to PyPI](#releasing-to-pypi)
+  - [Links](#links)
   - [License](#license)
   - [Contributing](#contributing)
-  - [Documentation](#documentation)
-    - [Python Packages/Subpackage](#python-packagessubpackage)
-    - [Community Health](#community-health)
-    - [Other](#other)
   - [Acknowledgments](#acknowledgments)
 
-## Getting Started
-
-ETLPlus helps you extract, validate, transform, and load data from files, databases, and APIs, either
-as a Python library or from the command line.
-
-To get started:
-
-- See [Installation](#installation) for setup instructions.
-- Try the [Quickstart](#quickstart) for a minimal working example (CLI and Python).
-- Explore [Usage](#usage) for more detailed options and workflows.
-
-ETLPlus supports Python 3.13 and above.
-
 ## Features
 
 - **Check** data pipeline definitions before running them:
@@ -146,7 +114,7 @@ etlplus extract file examples/data/sample.csv \
 [Python API](#python-api):
 
 ```python
-from etlplus.ops import extract, transform, validate, load
+from etlplus import extract, transform, validate, load
 
 data = extract("file", "input.csv")
 ops = {"filter": {"field": "age", "op": "gt", "value": 25}, "select": ["name", "email"]}
@@ -156,140 +124,6 @@ assert validate(filtered, rules)["valid"]
 load(filtered, "file", "temp/sample_output.json", file_format="json")
 ```
 
-## Data Connectors
-
-Data connectors abstract sources from which to extract data and targets to which to load data. They
-are differentiated by their types, each of which is represented in the subsections below.
-
-### REST APIs (`api`)
-
-ETLPlus can extract from REST APIs and load results via common HTTP methods. Supported operations
-include GET for extract and PATCH/POST/PUT for load.
-
-### Databases (`database`)
-
-Database connectors use connection strings for extraction and loading, and
-DDL can be rendered from table specs for migrations or schema checks.
-
-### Files (`file`)
-
-Recognized file formats are listed in the tables below. Support for reading to or writing from a recognized file format is marked as:
-
-- **Y**: implemented (may require optional dependencies)
-- **N**: stubbed or not yet implemented
-
-#### Stubbed / Placeholder
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `stub` | N | Placeholder format for tests and future connectors. |
-
-#### Tabular & Delimited Text
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `csv` | Y | Y | Comma-Separated Values |
-| `dat` | N | N | Generic data file, often delimited or fixed-width |
-| `fwf` | N | N | Fixed-Width Fields |
-| `psv` | N | N | Pipe-Separated Values |
-| `tab` | N | N | Often synonymous with TSV |
-| `tsv` | Y | Y | Tab-Separated Values |
-| `txt` | Y | Y | Plain text, often delimited or fixed-width |
-
-#### Semi-Structured Text
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `cfg` | N | N | Config-style key-value pairs |
-| `conf` | N | N | Config-style key-value pairs |
-| `ini` | N | N | Config-style key-value pairs |
-| `json` | Y | Y | JavaScript Object Notation |
-| `ndjson` | Y | Y | Newline-Delimited JSON |
-| `properties` | N | N | Java-style key-value pairs |
-| `toml` | N | N | Tom's Obvious Minimal Language |
-| `xml` | Y | Y | Extensible Markup Language |
-| `yaml` | Y | Y | YAML Ain't Markup Language |
-
-#### Columnar / Analytics-Friendly
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `arrow` | N | N | Apache Arrow IPC |
-| `feather` | Y | Y | Apache Arrow Feather |
-| `orc` | Y | Y | Optimized Row Columnar; common in Hadoop |
-| `parquet` | Y | Y | Apache Parquet; common in Big Data |
-
-#### Binary Serialization and Interchange
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `avro` | Y | Y | Apache Avro |
-| `bson` | N | N | Binary JSON; common with MongoDB exports/dumps |
-| `cbor` | N | N | Concise Binary Object Representation |
-| `ion` | N | N | Amazon Ion |
-| `msgpack` | N | N | MessagePack |
-| `pb` | N | N | Protocol Buffers (Google Protobuf) |
-| `pbf` | N | N | Protocolbuffer Binary Format; often for GIS data |
-| `proto` | N | N | Protocol Buffers schema; often in .pb / .bin |
-
-#### Databases and Embedded Storage
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `accdb` | N | N | Microsoft Access (newer format) |
-| `duckdb` | N | N | DuckDB |
-| `mdb` | N | N | Microsoft Access (older format) |
-| `sqlite` | N | N | SQLite |
-
-#### Spreadsheets
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `numbers` | N | N | Apple Numbers |
-| `ods` | N | N | OpenDocument |
-| `wks` | N | N | Lotus 1-2-3  |
-| `xls` | Y | Y | Microsoft Excel (BIFF) |
-| `xlsm` | N | N | Microsoft Excel Macro-Enabled (Open XML) |
-| `xlsx` | Y | Y | Microsoft Excel (Open XML) |
-
-#### Statistical / Scientific / Numeric Computing
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `dta` | N | N | Stata |
-| `hdf5` | N | N | Hierarchical Data Format |
-| `mat` | N | N | MATLAB |
-| `nc` | N | N | NetCDF |
-| `rda` | N | N | RData workspace/object |
-| `rds` | N | N | R data |
-| `sas7bdat` | N | N | SAS data |
-| `sav` | N | N | SPSS data |
-| `sylk` | N | N | Symbolic Link |
-| `xpt` | N | N | SAS Transport |
-| `zsav` | N | N | Compressed SPSS data |
-
-#### Logs and Event Streams
-
-| Format | Supported | Description |
-| --- | --- | --- |
-| `log` | N | N | Generic log file |
-
-#### Data Archives
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `gz` | Y | Y | Gzip-compressed file |
-| `zip` | Y | Y | ZIP archive |
-
-#### Templates
-
-| Format | Read | Write | Description |
-| --- | --- | --- | --- |
-| `hbs` | N | N | Handlebars |
-| `jinja2` | N | N | Jinja2 |
-| `mustache` | N | N | Mustache |
-| `vm` | N | N | Apache Velocity |
-
 ## Usage
 
 ### Command Line Interface
@@ -481,7 +315,7 @@ cat examples/data/sample.json \
 Use ETLPlus as a Python library:
 
 ```python
-from etlplus.ops import extract, validate, transform, load
+from etlplus import extract, validate, transform, load
 
 # Extract data
 data = extract("file", "data.json")
@@ -537,7 +371,7 @@ etlplus transform \
 # 3. Validate transformed data
 etlplus validate \
   --rules '{"name": {"type": "string", "required": true}, "email": {"type": "string", "required": true}}' \
-  temp/sample_transformed.json
+  temo/sample_transformed.json
 
 # 4. Load to CSV
 cat temp/sample_transformed.json \
@@ -676,7 +510,7 @@ We split tests into two layers:
   pagination + rate limit defaults, file/API connector interactions) may touch temp files and use
   fake clients.
 
-If a test calls `etlplus.cli.main()` or `etlplus.ops.run.run()` it’s integration by default. Full
+If a test calls `etlplus.cli.main()` or `etlplus.run.run()` it’s integration by default.  Full
 criteria: [`CONTRIBUTING.md#testing`](CONTRIBUTING.md#testing).
 
 ### Code Coverage
@@ -724,6 +558,17 @@ git push origin v1.4.0
 If you want an extra smoke-test before tagging, run `make dist && pip install dist/*.whl` locally;
 this exercises the same build path the workflow uses.
 
+## Links
+
+- API client docs: [`etlplus/api/README.md`](etlplus/api/README.md)
+- Examples: [`examples/README.md`](examples/README.md)
+- Pipeline authoring guide: [`docs/pipeline-guide.md`](docs/pipeline-guide.md)
+- Runner internals: [`docs/run-module.md`](docs/run-module.md)
+- Design notes (Mapping inputs, dict outputs): [`docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs`](docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs)
+- Typing philosophy: [`CONTRIBUTING.md#typing-philosophy`](CONTRIBUTING.md#typing-philosophy)
+- Demo and walkthrough: [`DEMO.md`](DEMO.md)
+- Additional references: [`REFERENCES.md`](`REFERENCES.md)
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).
@@ -747,39 +592,6 @@ If you choose to be a code contributor, please first refer these documents:
 - Typing philosophy (TypedDicts as editor hints, permissive runtime):
   [`CONTRIBUTING.md#typing-philosophy`](CONTRIBUTING.md#typing-philosophy)
 
-## Documentation
-
-### Python Packages/Subpackage
-
-Navigate to detailed documentation for each subpackage:
-
-- [etlplus.api](etlplus/api/README.md): Lightweight HTTP client and paginated REST helpers
-- [etlplus.file](etlplus/file/README.md): Unified file format support and helpers
-- [etlplus.cli](etlplus/cli/README.md): Command-line interface definitions for `etlplus`
-- [etlplus.database](etlplus/database/README.md): Database engine, schema, and ORM helpers
-- [etlplus.templates](etlplus/templates/README.md): SQL and DDL template helpers
-- [etlplus.validation](etlplus/validation/README.md): Data validation utilities and helpers
-- [etlplus.workflow](etlplus/workflow/README.md): Helpers for data connectors, pipelines, jobs, and
-  profiles
-
-### Community Health
-
-- [Contributing Guidelines](CONTRIBUTING.md): How to contribute, report issues, and submit PRs
-- [Code of Conduct](CODE_OF_CONDUCT.md): Community standards and expectations
-- [Security Policy](SECURITY.md): Responsible disclosure and vulnerability reporting
-- [Support](SUPPORT.md): Where to get help
-
-### Other
-
-- API client docs: [`etlplus/api/README.md`](etlplus/api/README.md)
-- Examples: [`examples/README.md`](examples/README.md)
-- Pipeline authoring guide: [`docs/pipeline-guide.md`](docs/pipeline-guide.md)
-- Runner internals: [`docs/run-module.md`](docs/run-module.md)
-- Design notes (Mapping inputs, dict outputs): [`docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs`](docs/pipeline-guide.md#design-notes-mapping-inputs-dict-outputs)
-- Typing philosophy: [`CONTRIBUTING.md#typing-philosophy`](CONTRIBUTING.md#typing-philosophy)
-- Demo and walkthrough: [`DEMO.md`](DEMO.md)
-- Additional references: [`REFERENCES.md`](REFERENCES.md)
-
 ## Acknowledgments
 
 ETLPlus is inspired by common work patterns in data engineering and software engineering patterns in

{etlplus-0.9.2 → etlplus-0.10.2}/docs/pipeline-guide.md

@@ -281,7 +281,7 @@ section.
 
 ## Validations
 
-Validation rule sets map field names to rules, mirroring `etlplus.ops.validate.FieldRules`:
+Validation rule sets map field names to rules, mirroring `etlplus.validate.FieldRules`:
 
 ```yaml
 validations:
@@ -297,7 +297,7 @@ validations:
 
 ## Transforms
 
-Transformation pipelines follow `etlplus.ops.transform` shapes exactly:
+Transformation pipelines follow `etlplus.transform` shapes exactly:
 
 ```yaml
 transforms:
@@ -377,9 +377,9 @@ Details:
 - Unknown or malformed entries are skipped rather than failing the whole load (keeping pipeline
   authoring permissive).
 - The connector kind is also available as a type-safe literal in code as
-  `etlplus.workflow.ConnectorType` (values: `"file" | "database" | "api"`).
+  `etlplus.config.ConnectorType` (values: `"file" | "database" | "api"`).
 
-To add new connector kinds in the future, implement a new dataclass in `etlplus.workflow.connector`
+To add new connector kinds in the future, implement a new dataclass in `etlplus.config.connector`
 and extend the internal parser to handle its `type` value.
 
 ## Jobs
@@ -390,20 +390,10 @@ target:
 ```yaml
 jobs:
   - name: file_to_file_customers
-    depends_on: [seed_customers]
     extract: { source: customers_csv }
     validate: { ruleset: customers_basic }
     transform: { pipeline: clean_customers }
     load: { target: customers_json_out }
-  - name: seed_customers
-    extract: { source: seed_customers_csv }
-    load: { target: customers_db_out }
-```
-
-Notes:
-
-- `depends_on` is optional and can be a string or list of job names.
-- Jobs without dependencies run first when ordered as a DAG.
 
 ## Running pipelines (CLI and Python)
 
@@ -431,14 +421,14 @@ Notes:
 - Environment-variable substitution (e.g. `${GITHUB_TOKEN}`) is applied the same way as when loading
   configs via the Python API.
 - For more details on the orchestration implementation, see
-  [Runner internals: etlplus.ops.run](run-module.md).
+  [Runner internals: etlplus.run](run-module.md).
 
-### Python: `etlplus.ops.run.run`
+### Python: `etlplus.run.run`
 
 To trigger a job programmatically, use the high-level runner function exposed by the package:
 
 ```python
-from etlplus.ops.run import run as run_job
+from etlplus.run import run as run_job
 
 result = run_job(
     job="file_to_file_customers",