preflight-kit 0.2.0__py3-none-any.whl

preflight_kit-0.2.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: preflight-kit
+Version: 0.2.0
+Summary: Preflight Kit — preflight validator for Shopify product CSV, catches import-breaking mistakes before you upload (formerly csv-preflight)
+Project-URL: Homepage, https://preflight-kit.pages.dev/
+Project-URL: Repository, https://github.com/q00tar00/preflight-kit
+Project-URL: Issues, https://github.com/q00tar00/preflight-kit/issues
+Project-URL: Changelog, https://github.com/q00tar00/preflight-kit/blob/main/CHANGELOG.md
+Author: q00tar00
+License: LicenseRef-Source-Available
+License-File: LICENSE
+Keywords: csv,ecommerce,preflight,product-import,shopify,validator
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Preflight Kit — product CSV preflight validator for Shopify
+
+[![PyPI version](https://img.shields.io/pypi/v/preflight-kit.svg)](https://pypi.org/project/preflight-kit/)
+[![Source-available license](https://img.shields.io/badge/license-source--available-blue.svg)](LICENSE)
+[![CI](https://github.com/q00tar00/preflight-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/q00tar00/preflight-kit/actions/workflows/ci.yml)
+
+Validate a Shopify **product** CSV before uploading it. `preflight-kit` runs locally, never connects to a Shopify store, and needs no API key. It reports import-risk findings and produces reviewable output files without changing the input CSV.
+
+> **Status:** Beta CLI, version 0.2.0 (formerly published as `csv-preflight`). This is a local, file-processing tool for product CSVs only. It has no Admin API integration, store-write capability, or user account system.
+
+## Project links
+
+- Web checker: [preflight-kit.pages.dev](https://preflight-kit.pages.dev/) (no upload or login)
+- Package: [PyPI — preflight-kit](https://pypi.org/project/preflight-kit/)
+- Source and issue tracker: [q00tar00/preflight-kit](https://github.com/q00tar00/preflight-kit)
+- Change history: [CHANGELOG.md](CHANGELOG.md)
+
+## What it checks
+
+The validator checks Shopify product-CSV structure and row-level risks, including:
+
+- UTF-8 encoding, BOMs, control characters, headers, file size, and column alignment.
+- Missing or duplicate product handles, required-column gaps, and variant parent linkage.
+- Duplicate option combinations and option dependency or position problems.
+- SKU gaps, reused SKUs, and Excel-style scientific notation.
+- Inventory, fulfillment, price, image URL, and image-alt-text consistency.
+- Product CSVs that appear to be order or customer exports: these are refused before row-level processing to avoid handling buyer PII.
+
+It supports current Shopify product-CSV headers and documented legacy aliases. The complete, versioned rule reference is [docs/shopify-product-csv-rules.md](docs/shopify-product-csv-rules.md).
+
+## Install
+
+Requires Python 3.11 or later.
+
+With [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install preflight-kit
+```
+
+With pip:
+
+```bash
+python -m pip install preflight-kit
+```
+
+## Usage
+
+```bash
+preflight check products.csv --out-dir ./out --lang en --intent new
+```
+
+Each run writes the following to `--out-dir`:
+
+- `fixed_products.csv` — a copy with only unambiguous mechanical fixes applied (currently UTF-8 BOM removal and case-only header normalization).
+- `errors.csv` — machine-readable findings with row, rule, severity, and suggested-fix fields.
+- `report.md` — a human-readable summary.
+
+Useful options:
+
+- `--out-dir DIR` — output directory (default: `./out`).
+- `--lang en|ja` — report language (default: `ja`).
+- `--no-fix` — report findings without writing `fixed_products.csv`.
+- `--intent new|update|mixed` — choose the import context used for handle and title severity.
+
+The command exits with status `1` when it finds a critical issue; otherwise it exits with `0`. A zero exit status means no critical finding was detected within the implemented checks, not that Shopify will necessarily accept or apply the import as intended.
+
+For a reproducible example, see the [deliberately messy sample report](examples/reports/preflight-kit-messy-report.md) and its [input CSV](examples/inputs/messy-product-import-sample.csv).
+
+## Boundaries and privacy
+
+The CLI reads a local file and does not upload it or access a Shopify store. It does not verify live-store behavior. In particular, it cannot check image URL reachability, conflicts with existing store handles, metafield product-reference resolution, or option-position consistency with existing products; every report identifies these limits.
+
+Auto-fixes are deliberately limited to proven, unambiguous transformations. Findings that require a business decision are reported but not silently rewritten.
+
+## Documentation
+
+- [Inspection rules](docs/shopify-product-csv-rules.md)
+- [Change history](CHANGELOG.md)
+- [Contributing guide](CONTRIBUTING.md)
+- [Security policy](SECURITY.md)
+
+## Maintenance and support
+
+This project is maintained by the GitHub user [q00tar00](https://github.com/q00tar00). The public GitHub repository and its issue tracker are the project’s canonical communication channels.
+
+For questions, bug reports, feature requests, or examples of a product-CSV import that went wrong, use [GitHub Issues](https://github.com/q00tar00/preflight-kit/issues). Please use a small redacted reproduction and never post customer, order, access-token, or other sensitive data. Support is provided on a best-effort basis; no response-time commitment is made.
+
+## Contributing
+
+Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the supported scope, local setup, test command, and pull-request expectations.
+
+## Security
+
+Please follow [SECURITY.md](SECURITY.md) for vulnerability reporting. Do not disclose exploitable security details or sensitive CSV data in a public issue.
+
+## License
+
+This project is source-available, not open source. See [LICENSE](LICENSE) for permitted use and redistribution terms.

preflight_kit-0.2.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+preflight_kit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+preflight_kit/cli.py,sha256=728CH06hE7uQEuWQA4fTOtTrjU2HEqT3Pz7BvBEff9w,2991
+preflight_kit/engine.py,sha256=YH8fQux93n9ruFbFfIuBDqpGwK4VF5WLvfFVD78axj4,3723
+preflight_kit/fixer.py,sha256=-BmTEmBWtqowoeTHFXWl0-tcPx7nes23G8ZK8lpEc1Q,1920
+preflight_kit/header_registry.py,sha256=hcBDBgPW-cKHXGjLRfgAoEiU7CTQFGKzHU7Ie4Q6MkA,6198
+preflight_kit/json_dump.py,sha256=fF9DsSXO7LAlPxz3SgXdghbpMJLl5CRb4zK3Z1hkVb4,2877
+preflight_kit/loader.py,sha256=12UbZ7vgLODonURlvcSgKs6OZ2xKTjHd_-1S_rOLCeI,11898
+preflight_kit/models.py,sha256=7BX4M0phNTBMz_t9owS1AcMhgcogDUWMQJTE1BdROU4,1848
+preflight_kit/reporters.py,sha256=KvZAOJUgs0c-ckQCALlwYJIh6mfgSu_Ur2TxxfJD8dU,4838
+preflight_kit/rules/__init__.py,sha256=jO8ZwTNJr-OM4tdgMc5--3ZF9KR8o_uIkiUwaRjXe-M,123
+preflight_kit/rules/file_rules.py,sha256=7_6iKFDnWB3R8PqGRvMrCtHZ9t3W_kdCYVzRvtY8pbQ,6935
+preflight_kit/rules/row_rules.py,sha256=hkX4TvBGsz4cLm8LzeHkZjHZzvZ_4zuGLkbagLCPpKY,15941
+preflight_kit-0.2.0.dist-info/METADATA,sha256=5TKraT2dSa6UOUNTrm5Y613S5VjNvppy1hE55OCRJjw,6293
+preflight_kit-0.2.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+preflight_kit-0.2.0.dist-info/entry_points.txt,sha256=_ieCkASN30mnC6EF6Mha5fJVyg30kGOmweeSls2wK0Y,53
+preflight_kit-0.2.0.dist-info/licenses/LICENSE,sha256=6cGI6pIalg6r-jFdDfxXdYbqFX9Gjk_6Rz5o3UhmH-c,1840
+preflight_kit-0.2.0.dist-info/RECORD,,

preflight_kit-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

preflight_kit-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+preflight = preflight_kit.cli:main

preflight_kit-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,33 @@
+Shopify Product CSV Preflight Validator — Source-Available License
+Copyright (c) 2026 q00tar00
+
+This software is source-available, not open source. The source code is published
+so that you can read it, audit it, and evaluate the tool. It is NOT placed in the
+public domain and no broad license is granted beyond the terms below.
+
+1. Permitted use (no charge)
+   You may download, build, run, and evaluate this software for your own personal
+   or internal business use — for example, to validate your own Shopify product CSV
+   files. You may modify your own copy for that purpose.
+
+2. Reservation of rights
+   All rights not expressly granted above are reserved by the copyright holder.
+
+3. Restrictions (require prior written permission)
+   Without the copyright holder's prior written permission you may NOT:
+   (a) redistribute, resell, sublicense, or publish this software or a derivative
+       of it, in source or binary form, whether or not for a fee;
+   (b) offer this software (or a derivative) as a hosted or managed service; or
+   (c) remove or alter this license or the copyright notice in redistributed copies.
+
+4. No warranty
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+   FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. A clean report does NOT guarantee
+   a successful Shopify import; the tool reads a file and cannot verify live-store
+   behavior. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+   CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH
+   THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For permissions beyond this license, contact the copyright holder via the project's
+GitHub repository: https://github.com/q00tar00/shopify