lss4py 0.2.0__tar.gz → 0.2.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {lss4py-0.2.0 → lss4py-0.2.2}/PKG-INFO +51 -18
- {lss4py-0.2.0 → lss4py-0.2.2}/README.md +46 -16
- {lss4py-0.2.0 → lss4py-0.2.2}/pyproject.toml +44 -43
- {lss4py-0.2.0 → lss4py-0.2.2}/pyproject.toml.orig +29 -34
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/__init__.py +13 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_bundle_schema.py +296 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_data_quality.py +105 -97
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_event_log.py +39 -44
- lss4py-0.2.2/src/lss4py/_frames.py +155 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/_calendar.py +4 -4
- lss4py-0.2.2/src/lss4py/_kernels/_contracts.py +37 -0
- lss4py-0.2.2/src/lss4py/_kernels/_distribution.py +64 -0
- lss4py-0.2.2/src/lss4py/_kernels/_helpers.py +134 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/capability.py +7 -6
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/defect_yield.py +20 -10
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/descriptive.py +23 -27
- lss4py-0.2.2/src/lss4py/_kernels/distribution.py +408 -0
- lss4py-0.2.2/src/lss4py/_kernels/inference.py +212 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/orders.py +8 -5
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/reconstruction.py +11 -9
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/timing.py +70 -41
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/yield_.py +90 -41
- lss4py-0.2.2/src/lss4py/_pandera_validation.py +452 -0
- lss4py-0.2.2/src/lss4py/_polars_extract.py +135 -0
- lss4py-0.2.2/src/lss4py/_units.py +139 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_version.py +1 -1
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/__init__.py +1 -2
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/contracts.py +13 -20
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/event_log.py +1 -1
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/__init__.py +6 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/_result_io.py +36 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/data_quality.py +2 -3
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/results.py +171 -0
- lss4py-0.2.2/src/lss4py/domain/units.py +30 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/integration/__init__.py +14 -1
- lss4py-0.2.2/src/lss4py/integration/_process_schema.py +281 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/integration/evidence.py +6 -3
- lss4py-0.2.2/src/lss4py/integration/policy.py +155 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/integration/process.py +79 -89
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/observability/logging.py +2 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/observability/telemetry.py +2 -0
- lss4py-0.2.2/src/lss4py/reporting/__init__.py +20 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/reporting/bundles.py +1 -0
- lss4py-0.2.2/src/lss4py/reporting/visualization.py +177 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/bottleneck.py +1 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/comparison.py +1 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/simulation.py +1 -0
- lss4py-0.2.0/src/lss4py/_frames.py +0 -41
- lss4py-0.2.0/src/lss4py/_kernels/_contracts.py +0 -80
- lss4py-0.2.0/src/lss4py/_kernels/_helpers.py +0 -277
- lss4py-0.2.0/src/lss4py/reporting/__init__.py +0 -3
- lss4py-0.2.0/src/lss4py/reporting/visualization.py +0 -47
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/__init__.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/data_quality.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_numeric_log.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/numeric_log.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/tabular.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/cli.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/bundles.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/interval_event_log.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/models.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/numeric_log.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/order_summary.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/reconstruction.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/specification.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/validation.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/errors.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/guidance/__init__.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/observability/__init__.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/__init__.py +0 -0
- {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/process_map.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: lss4py
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.2
|
|
4
4
|
Summary: Python-first Lean Six Sigma analytics for telemetry-rich process improvement
|
|
5
5
|
Author: shanewilkins
|
|
6
6
|
Author-email: shanewilkins <shane@wilkinsadvisors.com>
|
|
@@ -11,11 +11,14 @@ Requires-Dist: numpy>=2.2.0
|
|
|
11
11
|
Requires-Dist: opentelemetry-api>=1.31.0
|
|
12
12
|
Requires-Dist: opentelemetry-exporter-otlp>=1.31.0
|
|
13
13
|
Requires-Dist: opentelemetry-sdk>=1.31.0
|
|
14
|
+
Requires-Dist: pandera[polars]>=0.35,<0.36
|
|
15
|
+
Requires-Dist: pint>=0.25,<1
|
|
14
16
|
Requires-Dist: polars>=1.0.0
|
|
17
|
+
Requires-Dist: pydantic>=2.12,<3
|
|
15
18
|
Requires-Dist: rich>=13.9.0
|
|
16
19
|
Requires-Dist: scipy>=1.15.0
|
|
17
20
|
Requires-Dist: structlog>=24.4.0
|
|
18
|
-
Requires-Dist: flo-lang==0.
|
|
21
|
+
Requires-Dist: flo-lang==0.5.0 ; extra == 'integration'
|
|
19
22
|
Requires-Dist: pulp>=2.9.0 ; extra == 'optimization'
|
|
20
23
|
Requires-Dist: pyomo>=6.8.0 ; extra == 'optimization'
|
|
21
24
|
Requires-Dist: pandas>=2.2.0 ; extra == 'pandas'
|
|
@@ -45,11 +48,12 @@ It is not yet a full SPC, capability, simulation, or deliverables platform.
|
|
|
45
48
|
|
|
46
49
|
## Release status
|
|
47
50
|
|
|
48
|
-
The working tree prepares the unreleased **0.2.
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
51
|
+
The working tree prepares the unreleased **0.2.2 candidate**. Version 0.2.1 is
|
|
52
|
+
published and verified from PyPI; the new candidate adds the accepted canonical
|
|
53
|
+
Polars analytical boundary without changing governed results. See the
|
|
54
|
+
[draft 0.2.2 release notes](docs/releases/v0.2.2.md), [canonicalization
|
|
55
|
+
evidence](docs/assessments/v022-canonicalization-evidence.md), and
|
|
56
|
+
[migration guide](docs/migration-v0.2.md).
|
|
53
57
|
|
|
54
58
|
## Stable Today
|
|
55
59
|
|
|
@@ -66,6 +70,8 @@ It includes these public functions:
|
|
|
66
70
|
- `rolled_yield`
|
|
67
71
|
- `process_yield` (defect/rework counts, opportunity Yield/FTY/RTY, and DPMO)
|
|
68
72
|
- `describe` (typed descriptive statistics, optionally grouped)
|
|
73
|
+
- `mean_confidence_interval` (mean estimate, t/z interval, and Shapiro-Wilk diagnostic)
|
|
74
|
+
- `distribution_profile` (histogram, ECDF, Q-Q, IQR, shape and optional KDE evidence)
|
|
69
75
|
- `capability_indices` (Cp/Cpk/components/intervals and explicit specification Z)
|
|
70
76
|
- `reconstruct_orders` (declared numeric activity-to-order accounting policy)
|
|
71
77
|
- `validate_order_summary` (prepared numeric order contract and consistency checks)
|
|
@@ -77,8 +83,10 @@ supports explicit nearest-rank percentiles and measurement sums;
|
|
|
77
83
|
`process_cycle_efficiency(aggregation="cohort")` returns a ratio of sums with
|
|
78
84
|
cohort identities and denominator evidence.
|
|
79
85
|
|
|
80
|
-
See the [descriptive statistics guide](docs/descriptive-statistics.md)
|
|
81
|
-
|
|
86
|
+
See the [descriptive statistics guide](docs/descriptive-statistics.md) and
|
|
87
|
+
[mean confidence interval guide](docs/mean-confidence-interval.md) for examples
|
|
88
|
+
and statistical conventions. The [distribution profile guide](docs/distribution-profile.md)
|
|
89
|
+
documents prepared diagnostic evidence and optional Matplotlib renderers.
|
|
82
90
|
|
|
83
91
|
It also includes a process-model IR for integrating FLO-derived process structure with observed tabular data:
|
|
84
92
|
|
|
@@ -125,6 +133,11 @@ explicit `DataContract`. `normalize_data` prepares declared columns with auditab
|
|
|
125
133
|
opt-in row exclusions. See the [data-quality guide](docs/data-quality.md) for
|
|
126
134
|
schema, key, timestamp, unit, missingness and duplicate policies.
|
|
127
135
|
|
|
136
|
+
`convert_duration_columns` explicitly prepares seconds/minutes/hours using Pint,
|
|
137
|
+
preserving the native backend and recording conversion evidence on an unchanged
|
|
138
|
+
declared clock. See [duration units](docs/duration-units.md); normalization and
|
|
139
|
+
analytical methods retain their existing unit behavior.
|
|
140
|
+
|
|
128
141
|
`AnalysisBundle.capture` saves typed analyses with source hashes, selections,
|
|
129
142
|
software versions and linked specifications. Bundles restore without recalculation;
|
|
130
143
|
a standalone standard-library validator supports reviewers without analytical
|
|
@@ -136,7 +149,10 @@ LSS4PY works from two inputs.
|
|
|
136
149
|
|
|
137
150
|
The FLO side supplies a normalized process model IR.
|
|
138
151
|
|
|
139
|
-
The observed-data side
|
|
152
|
+
The observed-data side recognizes supported eager dataframe inputs through a
|
|
153
|
+
private Narwhals boundary and executes selected analytical columns on detached
|
|
154
|
+
canonical Polars frames under
|
|
155
|
+
[ADR-0028](docs/adr/0028-canonicalize-supported-eager-analytical-inputs-to-polars.md).
|
|
140
156
|
Core file ingestion materializes validated Polars frames by default, as recorded in
|
|
141
157
|
[ADR-0018](docs/adr/0018-use-polars-as-the-canonical-ingestion-backend.md). pandas
|
|
142
158
|
remains an optional analytical-input backend rather than the package's canonical
|
|
@@ -376,13 +392,15 @@ tests use only the Python environment.
|
|
|
376
392
|
The repository is currently validated with:
|
|
377
393
|
|
|
378
394
|
- `uv lock --check`
|
|
379
|
-
- `uv
|
|
380
|
-
- `uv sync`
|
|
395
|
+
- `uv sync --locked --group dev --extra storage`
|
|
381
396
|
- `uv run --locked ruff check .`
|
|
397
|
+
- `uv run --locked ruff format --check .`
|
|
398
|
+
- `uv run --locked pre-commit validate-config`
|
|
382
399
|
- `uv run --locked ty check`
|
|
383
|
-
- `uv run --locked
|
|
384
|
-
- `uv run --locked pytest`
|
|
400
|
+
- `uv run --locked import-linter lint --config lint_imports_config.ini`
|
|
401
|
+
- `uv run --locked --extra storage pytest --require-pyarrow --cov=src/lss4py --cov-fail-under=90`
|
|
385
402
|
- `uv run --locked vulture src tests --min-confidence 80`
|
|
403
|
+
- `uv run --locked pip-audit --desc`
|
|
386
404
|
|
|
387
405
|
Install both local hook stages with:
|
|
388
406
|
|
|
@@ -390,19 +408,30 @@ Install both local hook stages with:
|
|
|
390
408
|
uv run pre-commit install --install-hooks --hook-type pre-commit --hook-type pre-push
|
|
391
409
|
```
|
|
392
410
|
|
|
393
|
-
The `pre-commit` stage runs Ruff on changed files
|
|
411
|
+
The `pre-commit` stage runs locked Ruff lint/format on changed files. It does not
|
|
412
|
+
run the test suite; full tests run at pre-push and in CI.
|
|
394
413
|
|
|
395
414
|
The `pre-push` stage and CI run the full locked repository-wide gates.
|
|
396
|
-
|
|
397
|
-
|
|
415
|
+
Pre-push runs the suite once with coverage and requires the Arrow backend;
|
|
416
|
+
Ruff includes production-source security checks; CI and release builds additionally
|
|
417
|
+
require the dependency vulnerability audit.
|
|
418
|
+
Ruff and Vulture hooks use the project's locked tools rather than separate hook
|
|
419
|
+
environments. See [toolchain policy](docs/toolchain.md) for rule selection and
|
|
420
|
+
the distinct checks retained alongside Ruff.
|
|
421
|
+
|
|
422
|
+
CI enforces 90% statement coverage across the full package and runs
|
|
398
423
|
[installed-wheel end-to-end studies](e2e/README.md) outside the source tree.
|
|
399
424
|
These exercise CSV ingestion, timing/yield analyses, capability studies, JSON
|
|
400
425
|
exports, and failure scenarios in base and pandas-extra installations. Run them
|
|
401
426
|
locally with `uv run --locked python tools/check_wheel.py`.
|
|
402
427
|
CI and the release build also require the
|
|
403
|
-
[FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.
|
|
428
|
+
[FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.5.0
|
|
404
429
|
and the candidate LSS4PY wheel. Run it with
|
|
405
430
|
`uv run --locked python tools/check_wheel.py --ecosystem`.
|
|
431
|
+
To verify an already built release artifact without rebuilding it, pass
|
|
432
|
+
`--wheel dist/lss4py-0.2.2-py3-none-any.whl`. Add `--artifacts-dir artifacts/ecosystem`
|
|
433
|
+
to retain per-installation JUnit reports, the tested wheel's SHA-256 and ecosystem
|
|
434
|
+
evidence. CI retains source JUnit/coverage XML and installed-wheel reports for 14 days.
|
|
406
435
|
|
|
407
436
|
## Roadmap
|
|
408
437
|
|
|
@@ -426,3 +455,7 @@ now reconstructs all 39 pinned orders through public numeric contracts, retainin
|
|
|
426
455
|
load/pass/classification and correction evidence. See the
|
|
427
456
|
[reconstruction guide](docs/order-reconstruction.md) and saved
|
|
428
457
|
[audited bundle](examples/white_belt/reconstruction-bundle.json).
|
|
458
|
+
|
|
459
|
+
The [FLO-backed book workflow](docs/flo-book-workflow.md) runs the actual book
|
|
460
|
+
model and observed CSV through model-derived classifications, reconstruction,
|
|
461
|
+
metrics and saved audit evidence using installed packages.
|
|
@@ -8,11 +8,12 @@ It is not yet a full SPC, capability, simulation, or deliverables platform.
|
|
|
8
8
|
|
|
9
9
|
## Release status
|
|
10
10
|
|
|
11
|
-
The working tree prepares the unreleased **0.2.
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
11
|
+
The working tree prepares the unreleased **0.2.2 candidate**. Version 0.2.1 is
|
|
12
|
+
published and verified from PyPI; the new candidate adds the accepted canonical
|
|
13
|
+
Polars analytical boundary without changing governed results. See the
|
|
14
|
+
[draft 0.2.2 release notes](docs/releases/v0.2.2.md), [canonicalization
|
|
15
|
+
evidence](docs/assessments/v022-canonicalization-evidence.md), and
|
|
16
|
+
[migration guide](docs/migration-v0.2.md).
|
|
16
17
|
|
|
17
18
|
## Stable Today
|
|
18
19
|
|
|
@@ -29,6 +30,8 @@ It includes these public functions:
|
|
|
29
30
|
- `rolled_yield`
|
|
30
31
|
- `process_yield` (defect/rework counts, opportunity Yield/FTY/RTY, and DPMO)
|
|
31
32
|
- `describe` (typed descriptive statistics, optionally grouped)
|
|
33
|
+
- `mean_confidence_interval` (mean estimate, t/z interval, and Shapiro-Wilk diagnostic)
|
|
34
|
+
- `distribution_profile` (histogram, ECDF, Q-Q, IQR, shape and optional KDE evidence)
|
|
32
35
|
- `capability_indices` (Cp/Cpk/components/intervals and explicit specification Z)
|
|
33
36
|
- `reconstruct_orders` (declared numeric activity-to-order accounting policy)
|
|
34
37
|
- `validate_order_summary` (prepared numeric order contract and consistency checks)
|
|
@@ -40,8 +43,10 @@ supports explicit nearest-rank percentiles and measurement sums;
|
|
|
40
43
|
`process_cycle_efficiency(aggregation="cohort")` returns a ratio of sums with
|
|
41
44
|
cohort identities and denominator evidence.
|
|
42
45
|
|
|
43
|
-
See the [descriptive statistics guide](docs/descriptive-statistics.md)
|
|
44
|
-
|
|
46
|
+
See the [descriptive statistics guide](docs/descriptive-statistics.md) and
|
|
47
|
+
[mean confidence interval guide](docs/mean-confidence-interval.md) for examples
|
|
48
|
+
and statistical conventions. The [distribution profile guide](docs/distribution-profile.md)
|
|
49
|
+
documents prepared diagnostic evidence and optional Matplotlib renderers.
|
|
45
50
|
|
|
46
51
|
It also includes a process-model IR for integrating FLO-derived process structure with observed tabular data:
|
|
47
52
|
|
|
@@ -88,6 +93,11 @@ explicit `DataContract`. `normalize_data` prepares declared columns with auditab
|
|
|
88
93
|
opt-in row exclusions. See the [data-quality guide](docs/data-quality.md) for
|
|
89
94
|
schema, key, timestamp, unit, missingness and duplicate policies.
|
|
90
95
|
|
|
96
|
+
`convert_duration_columns` explicitly prepares seconds/minutes/hours using Pint,
|
|
97
|
+
preserving the native backend and recording conversion evidence on an unchanged
|
|
98
|
+
declared clock. See [duration units](docs/duration-units.md); normalization and
|
|
99
|
+
analytical methods retain their existing unit behavior.
|
|
100
|
+
|
|
91
101
|
`AnalysisBundle.capture` saves typed analyses with source hashes, selections,
|
|
92
102
|
software versions and linked specifications. Bundles restore without recalculation;
|
|
93
103
|
a standalone standard-library validator supports reviewers without analytical
|
|
@@ -99,7 +109,10 @@ LSS4PY works from two inputs.
|
|
|
99
109
|
|
|
100
110
|
The FLO side supplies a normalized process model IR.
|
|
101
111
|
|
|
102
|
-
The observed-data side
|
|
112
|
+
The observed-data side recognizes supported eager dataframe inputs through a
|
|
113
|
+
private Narwhals boundary and executes selected analytical columns on detached
|
|
114
|
+
canonical Polars frames under
|
|
115
|
+
[ADR-0028](docs/adr/0028-canonicalize-supported-eager-analytical-inputs-to-polars.md).
|
|
103
116
|
Core file ingestion materializes validated Polars frames by default, as recorded in
|
|
104
117
|
[ADR-0018](docs/adr/0018-use-polars-as-the-canonical-ingestion-backend.md). pandas
|
|
105
118
|
remains an optional analytical-input backend rather than the package's canonical
|
|
@@ -339,13 +352,15 @@ tests use only the Python environment.
|
|
|
339
352
|
The repository is currently validated with:
|
|
340
353
|
|
|
341
354
|
- `uv lock --check`
|
|
342
|
-
- `uv
|
|
343
|
-
- `uv sync`
|
|
355
|
+
- `uv sync --locked --group dev --extra storage`
|
|
344
356
|
- `uv run --locked ruff check .`
|
|
357
|
+
- `uv run --locked ruff format --check .`
|
|
358
|
+
- `uv run --locked pre-commit validate-config`
|
|
345
359
|
- `uv run --locked ty check`
|
|
346
|
-
- `uv run --locked
|
|
347
|
-
- `uv run --locked pytest`
|
|
360
|
+
- `uv run --locked import-linter lint --config lint_imports_config.ini`
|
|
361
|
+
- `uv run --locked --extra storage pytest --require-pyarrow --cov=src/lss4py --cov-fail-under=90`
|
|
348
362
|
- `uv run --locked vulture src tests --min-confidence 80`
|
|
363
|
+
- `uv run --locked pip-audit --desc`
|
|
349
364
|
|
|
350
365
|
Install both local hook stages with:
|
|
351
366
|
|
|
@@ -353,19 +368,30 @@ Install both local hook stages with:
|
|
|
353
368
|
uv run pre-commit install --install-hooks --hook-type pre-commit --hook-type pre-push
|
|
354
369
|
```
|
|
355
370
|
|
|
356
|
-
The `pre-commit` stage runs Ruff on changed files
|
|
371
|
+
The `pre-commit` stage runs locked Ruff lint/format on changed files. It does not
|
|
372
|
+
run the test suite; full tests run at pre-push and in CI.
|
|
357
373
|
|
|
358
374
|
The `pre-push` stage and CI run the full locked repository-wide gates.
|
|
359
|
-
|
|
360
|
-
|
|
375
|
+
Pre-push runs the suite once with coverage and requires the Arrow backend;
|
|
376
|
+
Ruff includes production-source security checks; CI and release builds additionally
|
|
377
|
+
require the dependency vulnerability audit.
|
|
378
|
+
Ruff and Vulture hooks use the project's locked tools rather than separate hook
|
|
379
|
+
environments. See [toolchain policy](docs/toolchain.md) for rule selection and
|
|
380
|
+
the distinct checks retained alongside Ruff.
|
|
381
|
+
|
|
382
|
+
CI enforces 90% statement coverage across the full package and runs
|
|
361
383
|
[installed-wheel end-to-end studies](e2e/README.md) outside the source tree.
|
|
362
384
|
These exercise CSV ingestion, timing/yield analyses, capability studies, JSON
|
|
363
385
|
exports, and failure scenarios in base and pandas-extra installations. Run them
|
|
364
386
|
locally with `uv run --locked python tools/check_wheel.py`.
|
|
365
387
|
CI and the release build also require the
|
|
366
|
-
[FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.
|
|
388
|
+
[FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.5.0
|
|
367
389
|
and the candidate LSS4PY wheel. Run it with
|
|
368
390
|
`uv run --locked python tools/check_wheel.py --ecosystem`.
|
|
391
|
+
To verify an already built release artifact without rebuilding it, pass
|
|
392
|
+
`--wheel dist/lss4py-0.2.2-py3-none-any.whl`. Add `--artifacts-dir artifacts/ecosystem`
|
|
393
|
+
to retain per-installation JUnit reports, the tested wheel's SHA-256 and ecosystem
|
|
394
|
+
evidence. CI retains source JUnit/coverage XML and installed-wheel reports for 14 days.
|
|
369
395
|
|
|
370
396
|
## Roadmap
|
|
371
397
|
|
|
@@ -389,3 +415,7 @@ now reconstructs all 39 pinned orders through public numeric contracts, retainin
|
|
|
389
415
|
load/pass/classification and correction evidence. See the
|
|
390
416
|
[reconstruction guide](docs/order-reconstruction.md) and saved
|
|
391
417
|
[audited bundle](examples/white_belt/reconstruction-bundle.json).
|
|
418
|
+
|
|
419
|
+
The [FLO-backed book workflow](docs/flo-book-workflow.md) runs the actual book
|
|
420
|
+
model and observed CSV through model-derived classifications, reconstruction,
|
|
421
|
+
metrics and saved audit evidence using installed packages.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "lss4py"
|
|
3
|
-
version = "0.2.
|
|
3
|
+
version = "0.2.2"
|
|
4
4
|
description = "Python-first Lean Six Sigma analytics for telemetry-rich process improvement"
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
license = "MIT"
|
|
@@ -12,7 +12,10 @@ dependencies = [
|
|
|
12
12
|
"opentelemetry-api>=1.31.0",
|
|
13
13
|
"opentelemetry-exporter-otlp>=1.31.0",
|
|
14
14
|
"opentelemetry-sdk>=1.31.0",
|
|
15
|
+
"pandera[polars]>=0.35,<0.36",
|
|
16
|
+
"pint>=0.25,<1",
|
|
15
17
|
"polars>=1.0.0",
|
|
18
|
+
"pydantic>=2.12,<3",
|
|
16
19
|
"rich>=13.9.0",
|
|
17
20
|
"scipy>=1.15.0",
|
|
18
21
|
"structlog>=24.4.0",
|
|
@@ -23,7 +26,7 @@ name = "shanewilkins"
|
|
|
23
26
|
email = "shane@wilkinsadvisors.com"
|
|
24
27
|
|
|
25
28
|
[project.optional-dependencies]
|
|
26
|
-
integration = ["flo-lang==0.
|
|
29
|
+
integration = ["flo-lang==0.5.0"]
|
|
27
30
|
pandas = ["pandas>=2.2.0"]
|
|
28
31
|
process-mining = ["pm4py>=2.7.0"]
|
|
29
32
|
simulation = ["simpy>=4.1.0"]
|
|
@@ -44,28 +47,24 @@ storage = [
|
|
|
44
47
|
lss4py = "lss4py.cli:main"
|
|
45
48
|
|
|
46
49
|
[build-system]
|
|
47
|
-
requires = ["uv_build>=0.
|
|
50
|
+
requires = ["uv_build>=0.13.5,<0.14.0"]
|
|
48
51
|
build-backend = "uv_build"
|
|
49
52
|
|
|
50
53
|
[dependency-groups]
|
|
51
54
|
dev = [
|
|
52
|
-
"bandit>=1.8.0",
|
|
53
55
|
"import-linter>=2.1",
|
|
54
56
|
"matplotlib>=3.10.0",
|
|
55
|
-
"interrogate>=1.5.0",
|
|
56
57
|
"pandas>=2.2.0",
|
|
57
58
|
"pip-audit>=2.6.0",
|
|
58
59
|
"pre-commit>=4.1.0",
|
|
59
|
-
"pydocstyle>=6.3.0",
|
|
60
60
|
"pyarrow>=19.0.0",
|
|
61
61
|
"pytest>=8.3.0",
|
|
62
62
|
"pytest-cov>=6.0.0",
|
|
63
|
-
"ruff>=0.
|
|
63
|
+
"ruff>=0.17.2",
|
|
64
64
|
"seaborn>=0.13.0",
|
|
65
65
|
"twine>=6.0.0",
|
|
66
66
|
"ty>=0.0.77",
|
|
67
67
|
"vulture>=2.13",
|
|
68
|
-
"xenon>=0.9.3",
|
|
69
68
|
]
|
|
70
69
|
|
|
71
70
|
[tool.ruff]
|
|
@@ -79,54 +78,56 @@ select = [
|
|
|
79
78
|
"I",
|
|
80
79
|
"UP",
|
|
81
80
|
"B",
|
|
81
|
+
"C901",
|
|
82
|
+
"D",
|
|
83
|
+
"C4",
|
|
84
|
+
"PIE",
|
|
85
|
+
"RUF100",
|
|
86
|
+
"RUF043",
|
|
87
|
+
"PT012",
|
|
88
|
+
"SIM102",
|
|
89
|
+
"SIM114",
|
|
90
|
+
"S",
|
|
91
|
+
"PLE2502",
|
|
82
92
|
]
|
|
93
|
+
ignore = [
|
|
94
|
+
"D100",
|
|
95
|
+
"D101",
|
|
96
|
+
"D104",
|
|
97
|
+
"S101",
|
|
98
|
+
]
|
|
99
|
+
|
|
100
|
+
[tool.ruff.lint.mccabe]
|
|
101
|
+
max-complexity = 10
|
|
102
|
+
|
|
103
|
+
[tool.ruff.lint.pydocstyle]
|
|
104
|
+
convention = "google"
|
|
105
|
+
|
|
106
|
+
[tool.ruff.lint.per-file-ignores]
|
|
107
|
+
"tests/**" = [
|
|
108
|
+
"D",
|
|
109
|
+
"S",
|
|
110
|
+
]
|
|
111
|
+
"e2e/**" = [
|
|
112
|
+
"D",
|
|
113
|
+
"S",
|
|
114
|
+
]
|
|
115
|
+
"tools/**" = ["S"]
|
|
116
|
+
"examples/**" = ["S"]
|
|
83
117
|
|
|
84
118
|
[tool.pytest.ini_options]
|
|
85
119
|
testpaths = ["tests"]
|
|
86
|
-
addopts = "-q"
|
|
120
|
+
addopts = "-q --strict-config --strict-markers"
|
|
121
|
+
xfail_strict = true
|
|
87
122
|
|
|
88
123
|
[tool.coverage.run]
|
|
89
124
|
source = ["src/lss4py"]
|
|
90
|
-
omit = [
|
|
91
|
-
"src/lss4py/_event_log.py",
|
|
92
|
-
"src/lss4py/adapters/*",
|
|
93
|
-
"src/lss4py/cli.py",
|
|
94
|
-
"src/lss4py/observability/*",
|
|
95
|
-
"src/lss4py/reporting/*",
|
|
96
|
-
"src/lss4py/workflows/bottleneck.py",
|
|
97
|
-
"src/lss4py/workflows/comparison.py",
|
|
98
|
-
"src/lss4py/workflows/simulation.py",
|
|
99
|
-
]
|
|
100
125
|
|
|
101
126
|
[tool.coverage.report]
|
|
102
127
|
fail_under = 90
|
|
103
128
|
show_missing = true
|
|
104
129
|
skip_covered = true
|
|
105
130
|
|
|
106
|
-
[tool.pydocstyle]
|
|
107
|
-
convention = "google"
|
|
108
|
-
add-ignore = [
|
|
109
|
-
"D100",
|
|
110
|
-
"D101",
|
|
111
|
-
"D104",
|
|
112
|
-
]
|
|
113
|
-
|
|
114
|
-
[tool.interrogate]
|
|
115
|
-
ignore-init-method = true
|
|
116
|
-
ignore-init-module = true
|
|
117
|
-
ignore-magic = true
|
|
118
|
-
ignore-semiprivate = false
|
|
119
|
-
ignore-private = false
|
|
120
|
-
fail-under = 80
|
|
121
|
-
verbose = 2
|
|
122
|
-
exclude = [
|
|
123
|
-
"src/lss4py/adapters",
|
|
124
|
-
"src/lss4py/observability",
|
|
125
|
-
"src/lss4py/reporting",
|
|
126
|
-
"src/lss4py/workflows",
|
|
127
|
-
"tests",
|
|
128
|
-
]
|
|
129
|
-
|
|
130
131
|
[tool.vulture]
|
|
131
132
|
paths = [
|
|
132
133
|
"src",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "lss4py"
|
|
3
|
-
version = "0.2.
|
|
3
|
+
version = "0.2.2"
|
|
4
4
|
description = "Python-first Lean Six Sigma analytics for telemetry-rich process improvement"
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
license = "MIT"
|
|
@@ -15,7 +15,10 @@ dependencies = [
|
|
|
15
15
|
"opentelemetry-api>=1.31.0",
|
|
16
16
|
"opentelemetry-exporter-otlp>=1.31.0",
|
|
17
17
|
"opentelemetry-sdk>=1.31.0",
|
|
18
|
+
"pandera[polars]>=0.35,<0.36", # Private structural validation on canonical Polars only
|
|
19
|
+
"pint>=0.25,<1", # Explicit duration conversion; registry stays private
|
|
18
20
|
"polars>=1.0.0",
|
|
21
|
+
"pydantic>=2.12,<3", # Portable exchange validation; FLO remains optional
|
|
19
22
|
"rich>=13.9.0",
|
|
20
23
|
"scipy>=1.15.0",
|
|
21
24
|
"structlog>=24.4.0",
|
|
@@ -23,7 +26,7 @@ dependencies = [
|
|
|
23
26
|
|
|
24
27
|
[project.optional-dependencies]
|
|
25
28
|
integration = [
|
|
26
|
-
"flo-lang==0.
|
|
29
|
+
"flo-lang==0.5.0",
|
|
27
30
|
]
|
|
28
31
|
pandas = [
|
|
29
32
|
"pandas>=2.2.0",
|
|
@@ -51,28 +54,24 @@ storage = [
|
|
|
51
54
|
lss4py = "lss4py.cli:main"
|
|
52
55
|
|
|
53
56
|
[build-system]
|
|
54
|
-
requires = ["uv_build>=0.
|
|
57
|
+
requires = ["uv_build>=0.13.5,<0.14.0"]
|
|
55
58
|
build-backend = "uv_build"
|
|
56
59
|
|
|
57
60
|
[dependency-groups]
|
|
58
61
|
dev = [
|
|
59
|
-
"bandit>=1.8.0", # Security scanning
|
|
60
62
|
"import-linter>=2.1",
|
|
61
63
|
"matplotlib>=3.10.0", # Optional plotting contract development and typing
|
|
62
|
-
"interrogate>=1.5.0", # Docstring coverage
|
|
63
64
|
"pandas>=2.2.0", # Backend parity tests
|
|
64
65
|
"pip-audit>=2.6.0", # Dependency vulnerabilities
|
|
65
66
|
"pre-commit>=4.1.0",
|
|
66
|
-
"pydocstyle>=6.3.0", # Docstring formatting
|
|
67
67
|
"pyarrow>=19.0.0", # Type and contract checks for every supported backend
|
|
68
68
|
"pytest>=8.3.0",
|
|
69
69
|
"pytest-cov>=6.0.0",
|
|
70
|
-
"ruff>=0.
|
|
70
|
+
"ruff>=0.17.2", # Lint, formatting, docstrings and function complexity
|
|
71
71
|
"seaborn>=0.13.0", # Optional plotting contract development and typing
|
|
72
72
|
"twine>=6.0.0", # Distribution metadata validation
|
|
73
73
|
"ty>=0.0.77", # Astral type checker
|
|
74
74
|
"vulture>=2.13",
|
|
75
|
-
"xenon>=0.9.3",
|
|
76
75
|
]
|
|
77
76
|
|
|
78
77
|
[tool.ruff]
|
|
@@ -80,44 +79,40 @@ line-length = 100
|
|
|
80
79
|
target-version = "py314"
|
|
81
80
|
|
|
82
81
|
[tool.ruff.lint]
|
|
83
|
-
select = [
|
|
82
|
+
select = [
|
|
83
|
+
"E", "F", "I", "UP", "B",
|
|
84
|
+
"C901", "D", "C4", "PIE",
|
|
85
|
+
"RUF100", "RUF043", "PT012", "SIM102", "SIM114",
|
|
86
|
+
"S", "PLE2502", # Security and bidirectional Unicode source checks
|
|
87
|
+
]
|
|
88
|
+
ignore = ["D100", "D101", "D104", "S101"] # Preserve the former Bandit B101 exemption
|
|
89
|
+
|
|
90
|
+
[tool.ruff.lint.mccabe]
|
|
91
|
+
max-complexity = 10
|
|
92
|
+
|
|
93
|
+
[tool.ruff.lint.pydocstyle]
|
|
94
|
+
convention = "google"
|
|
95
|
+
|
|
96
|
+
[tool.ruff.lint.per-file-ignores]
|
|
97
|
+
"tests/**" = ["D", "S"]
|
|
98
|
+
"e2e/**" = ["D", "S"]
|
|
99
|
+
# Match the former security scan's production-source scope.
|
|
100
|
+
"tools/**" = ["S"]
|
|
101
|
+
"examples/**" = ["S"]
|
|
84
102
|
|
|
85
103
|
[tool.pytest.ini_options]
|
|
86
104
|
testpaths = ["tests"]
|
|
87
|
-
addopts = "-q"
|
|
105
|
+
addopts = "-q --strict-config --strict-markers"
|
|
106
|
+
xfail_strict = true
|
|
88
107
|
|
|
89
108
|
[tool.coverage.run]
|
|
90
109
|
source = ["src/lss4py"]
|
|
91
|
-
omit = [
|
|
92
|
-
"src/lss4py/_event_log.py", # v0.3 refactor
|
|
93
|
-
"src/lss4py/adapters/*",
|
|
94
|
-
"src/lss4py/cli.py",
|
|
95
|
-
"src/lss4py/observability/*",
|
|
96
|
-
"src/lss4py/reporting/*",
|
|
97
|
-
"src/lss4py/workflows/bottleneck.py",
|
|
98
|
-
"src/lss4py/workflows/comparison.py",
|
|
99
|
-
"src/lss4py/workflows/simulation.py",
|
|
100
|
-
]
|
|
101
110
|
|
|
102
111
|
[tool.coverage.report]
|
|
103
112
|
fail_under = 90
|
|
104
113
|
show_missing = true
|
|
105
114
|
skip_covered = true
|
|
106
115
|
|
|
107
|
-
[tool.pydocstyle]
|
|
108
|
-
convention = "google"
|
|
109
|
-
add-ignore = ["D100", "D101", "D104"] # Ignore module, class, and package docstrings (will enforce later)
|
|
110
|
-
|
|
111
|
-
[tool.interrogate]
|
|
112
|
-
ignore-init-method = true
|
|
113
|
-
ignore-init-module = true
|
|
114
|
-
ignore-magic = true
|
|
115
|
-
ignore-semiprivate = false
|
|
116
|
-
ignore-private = false
|
|
117
|
-
fail-under = 80
|
|
118
|
-
verbose = 2
|
|
119
|
-
exclude = ["src/lss4py/adapters", "src/lss4py/observability", "src/lss4py/reporting", "src/lss4py/workflows", "tests"]
|
|
120
|
-
|
|
121
116
|
[tool.vulture]
|
|
122
117
|
paths = ["src", "tests"]
|
|
123
118
|
min_confidence = 80
|
|
@@ -2,6 +2,8 @@ from lss4py._kernels.capability import capability_indices
|
|
|
2
2
|
from lss4py._kernels.data_quality import normalize_data, validate_data
|
|
3
3
|
from lss4py._kernels.defect_yield import process_yield
|
|
4
4
|
from lss4py._kernels.descriptive import describe
|
|
5
|
+
from lss4py._kernels.distribution import distribution_profile
|
|
6
|
+
from lss4py._kernels.inference import mean_confidence_interval
|
|
5
7
|
from lss4py._kernels.orders import deadline_performance, validate_order_summary
|
|
6
8
|
from lss4py._kernels.reconstruction import reconstruct_orders
|
|
7
9
|
from lss4py._kernels.timing import (
|
|
@@ -15,6 +17,7 @@ from lss4py._kernels.yield_ import (
|
|
|
15
17
|
created_to_booked_yield,
|
|
16
18
|
rolled_yield,
|
|
17
19
|
)
|
|
20
|
+
from lss4py._units import convert_duration_columns
|
|
18
21
|
from lss4py._version import __version__
|
|
19
22
|
from lss4py.adapters import AdapterSchema, EventLogCSVAdapter, load_event_log
|
|
20
23
|
from lss4py.adapters.numeric_log import NumericEventLogCSVAdapter, load_numeric_event_log
|
|
@@ -30,12 +33,14 @@ from lss4py.domain import (
|
|
|
30
33
|
DataValidationReport,
|
|
31
34
|
DefectYieldResult,
|
|
32
35
|
DescriptiveResult,
|
|
36
|
+
DistributionProfileResult,
|
|
33
37
|
EventLog,
|
|
34
38
|
EventLogBindingsIR,
|
|
35
39
|
EventStream,
|
|
36
40
|
InputReference,
|
|
37
41
|
IntervalEventLog,
|
|
38
42
|
LeadTimeBindingIR,
|
|
43
|
+
MeanCIResult,
|
|
39
44
|
MetricBindingsIR,
|
|
40
45
|
MetricSemanticsIR,
|
|
41
46
|
NormalizedData,
|
|
@@ -54,6 +59,7 @@ from lss4py.domain import (
|
|
|
54
59
|
)
|
|
55
60
|
from lss4py.domain.reconstruction import OrderReconstructionPolicy
|
|
56
61
|
from lss4py.domain.results import OrderReconstructionResult, ProcessMapResult
|
|
62
|
+
from lss4py.domain.units import DurationConversion
|
|
57
63
|
from lss4py.errors import (
|
|
58
64
|
AdapterError,
|
|
59
65
|
LSS4PyError,
|
|
@@ -71,6 +77,8 @@ from lss4py.guidance import (
|
|
|
71
77
|
from lss4py.workflows import map_process
|
|
72
78
|
|
|
73
79
|
__all__ = [
|
|
80
|
+
"DurationConversion",
|
|
81
|
+
"convert_duration_columns",
|
|
74
82
|
"UnsupportedInputError",
|
|
75
83
|
"ProcessMapResult",
|
|
76
84
|
"AnalysisSelection",
|
|
@@ -110,8 +118,12 @@ __all__ = [
|
|
|
110
118
|
"CapabilityResult",
|
|
111
119
|
"capability_indices",
|
|
112
120
|
"DescriptiveResult",
|
|
121
|
+
"DistributionProfileResult",
|
|
122
|
+
"MeanCIResult",
|
|
113
123
|
"DefectYieldResult",
|
|
114
124
|
"describe",
|
|
125
|
+
"distribution_profile",
|
|
126
|
+
"mean_confidence_interval",
|
|
115
127
|
"EventLogBindingsIR",
|
|
116
128
|
"EventLog",
|
|
117
129
|
"EventLogCSVAdapter",
|
|
@@ -144,4 +156,5 @@ __all__ = [
|
|
|
144
156
|
|
|
145
157
|
|
|
146
158
|
def main() -> None:
|
|
159
|
+
"""Print the package's lightweight readiness message."""
|
|
147
160
|
print("lss4py scaffold ready")
|