diffx-python 0.4.4__tar.gz → 0.5.2__tar.gz

diffx_python-0.5.2/Cargo.toml

@@ -0,0 +1,56 @@
+[workspace]
+resolver = "2"
+members = [
+    "diffx-core",
+    "diffx-cli"
+]
+
+[workspace.package]
+version = "0.5.2"
+edition = "2021"
+authors = ["kako-jun"]
+license = "MIT"
+description = "Blazing fast semantic diff for JSON/YAML/TOML/XML/INI/CSV. Features: array tracking, regex filters, float tolerance, directory compare, UNIX-compatible options"
+homepage = "https://github.com/kako-jun/diffx"
+repository = "https://github.com/kako-jun/diffx"
+documentation = "https://docs.rs/diffx"
+readme = "README.md"
+keywords = ["diff", "json", "yaml", "toml", "semantic-diff"]
+categories = ["command-line-utilities", "development-tools", "text-processing", "parsing", "data-structures"]
+exclude = [
+    ".github/",
+    "target/"
+]
+rust-version = "1.75"
+
+[workspace.metadata.docs.rs.badges]
+maintenance = { status = "actively-developed" }
+
+[workspace.metadata.docs.rs]
+all-features = true
+rustdoc-args = ["--cfg", "docsrs"]
+
+[workspace.dependencies]
+anyhow = "1.0"
+clap = { version = "4.0", features = ["derive", "cargo"] }
+colored = "3.0"
+csv = "1.3"
+configparser = "3.0"
+quick-xml = { version = "0.31", features = ["serialize"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+serde_yml = "0.0.12"
+toml = "0.8"
+walkdir = "2.5"
+dirs = "5.0"
+regex = "1.0"
+similar = "2.7"
+tempfile = "3.0"
+assert_cmd = "2.0"
+predicates = "3.1"
+criterion = { version = "0.5", features = ["html_reports"] }
+
+[profile.release]
+lto = true
+codegen-units = 1
+panic = "abort"

{diffx_python-0.4.4 → diffx_python-0.5.2}/PKG-INFO

@@ -1,14 +1,6 @@
 Metadata-Version: 2.4
 Name: diffx-python
-Version: 0.4.4
-Summary: Python wrapper for diffx - semantic diffing of JSON, YAML, TOML, XML, INI, and CSV files. Focuses on structural meaning rather than formatting.
-Project-URL: Homepage, https://github.com/kako-jun/diffx
-Project-URL: Repository, https://github.com/kako-jun/diffx
-Project-URL: Issues, https://github.com/kako-jun/diffx/issues
-Project-URL: Documentation, https://github.com/kako-jun/diffx/tree/main/docs
-Author: kako-jun
-License-Expression: MIT
-Keywords: automation,ci-cd,comparison,configuration,csv,data-analysis,devops,diff,ini,json,semantic,structured-data,toml,xml,yaml
+Version: 0.5.2
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -22,15 +14,23 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Text Processing
 Classifier: Topic :: Utilities
-Requires-Python: >=3.8
+Requires-Dist: pytest>=6.0 ; extra == 'dev'
+Requires-Dist: pytest-cov ; extra == 'dev'
+Requires-Dist: black ; extra == 'dev'
+Requires-Dist: isort ; extra == 'dev'
+Requires-Dist: mypy ; extra == 'dev'
+Requires-Dist: ruff ; extra == 'dev'
 Provides-Extra: dev
-Requires-Dist: black; extra == 'dev'
-Requires-Dist: isort; extra == 'dev'
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: pytest>=6.0; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Description-Content-Type: text/markdown
+Summary: Python wrapper for diffx - semantic diffing of JSON, YAML, TOML, XML, INI, and CSV files. Focuses on structural meaning rather than formatting.
+Keywords: diff,semantic,json,yaml,toml,xml,ini,csv,structured-data,comparison,devops,ci-cd,automation,data-analysis,configuration
+Author: kako-jun
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/kako-jun/diffx
+Project-URL: Repository, https://github.com/kako-jun/diffx
+Project-URL: Issues, https://github.com/kako-jun/diffx/issues
+Project-URL: Documentation, https://github.com/kako-jun/diffx/tree/main/docs
 
 # diffx-python
 
@@ -42,7 +42,7 @@ Python wrapper for the `diffx` CLI tool - semantic diff for structured data.
 pip install diffx-python
 ```
 
-This will automatically download the appropriate `diffx` binary for your system from GitHub Releases.
+The `diffx` binary is automatically included in the wheel - no additional downloads required! This package uses [maturin](https://github.com/PyO3/maturin) to embed the native binary directly in the Python wheel, similar to tools like `ruff`.
 
 ## Usage
 
@@ -93,26 +93,35 @@ string_result = diffx.diff_string(
   - Floating-point tolerance
   - Array element identification
   - Path-based filtering
-- **Cross-platform**: Automatically downloads the right binary
+- **Cross-platform**: Native binary embedded in platform-specific wheels
+
+## Key Benefits
+
+- **🚀 Zero setup**: No external downloads or binary management
+- **📦 Self-contained**: Everything needed is in the wheel
+- **⚡ Fast installation**: No network dependencies after `pip install`
+- **🔒 Secure**: No runtime downloads from external sources
+- **🌐 Offline-ready**: Works in air-gapped environments
 
 ## Development
 
-To install in development mode with uv:
+To install in development mode:
 
 ```bash
-uv venv
-source .venv/bin/activate
-uv pip install -e .[dev]
+pip install -e .[dev]
 ```
 
-## Manual Binary Installation
+## Verification
 
-If automatic download fails:
+Verify the installation:
 
-```bash
-diffx-download-binary
+```python
+import diffx
+print("diffx available:", diffx.is_diffx_available())
+print("Version:", diffx.__version__)
 ```
 
 ## License
 
 This project is licensed under the MIT License.
+

{diffx_python-0.4.4 → diffx_python-0.5.2}/README.md

@@ -8,7 +8,7 @@ Python wrapper for the `diffx` CLI tool - semantic diff for structured data.
 pip install diffx-python
 ```
 
-This will automatically download the appropriate `diffx` binary for your system from GitHub Releases.
+The `diffx` binary is automatically included in the wheel - no additional downloads required! This package uses [maturin](https://github.com/PyO3/maturin) to embed the native binary directly in the Python wheel, similar to tools like `ruff`.
 
 ## Usage
 
@@ -59,24 +59,32 @@ string_result = diffx.diff_string(
   - Floating-point tolerance
   - Array element identification
   - Path-based filtering
-- **Cross-platform**: Automatically downloads the right binary
+- **Cross-platform**: Native binary embedded in platform-specific wheels
+
+## Key Benefits
+
+- **🚀 Zero setup**: No external downloads or binary management
+- **📦 Self-contained**: Everything needed is in the wheel
+- **⚡ Fast installation**: No network dependencies after `pip install`
+- **🔒 Secure**: No runtime downloads from external sources
+- **🌐 Offline-ready**: Works in air-gapped environments
 
 ## Development
 
-To install in development mode with uv:
+To install in development mode:
 
 ```bash
-uv venv
-source .venv/bin/activate
-uv pip install -e .[dev]
+pip install -e .[dev]
 ```
 
-## Manual Binary Installation
+## Verification
 
-If automatic download fails:
+Verify the installation:
 
-```bash
-diffx-download-binary
+```python
+import diffx
+print("diffx available:", diffx.is_diffx_available())
+print("Version:", diffx.__version__)
 ```
 
 ## License

diffx_python-0.5.2/diffx-core/Cargo.toml

@@ -0,0 +1,34 @@
+[package]
+name = "diffx-core"
+version.workspace = true
+edition.workspace = true
+authors.workspace = true
+license.workspace = true
+description = "Core library for diffx - blazing fast semantic diff engine for structured data. Zero-copy parsing, streaming support, memory-efficient algorithms"
+homepage.workspace = true
+repository.workspace = true
+documentation.workspace = true
+readme = "README.md"
+keywords = ["diff", "json", "yaml", "toml", "parser"]
+categories = ["data-structures", "parsing", "algorithms", "text-processing"]
+exclude.workspace = true
+rust-version.workspace = true
+
+[dependencies]
+anyhow = { workspace = true }
+csv = { workspace = true }
+configparser = { workspace = true }
+quick-xml = { workspace = true }
+serde = { workspace = true }
+serde_json = { workspace = true }
+serde_yml = { workspace = true }
+toml = { workspace = true }
+regex = { workspace = true }
+
+[dev-dependencies]
+criterion = { workspace = true }
+tempfile = { workspace = true }
+
+[[bench]]
+name = "diff_benchmark"
+harness = false

diffx_python-0.5.2/diffx-core/README.md

@@ -0,0 +1,317 @@
+# diffx
+
+> **🚀 Semantic diff for structured data - Focus on what matters, not formatting**
+
+[English README](README.md) | [日本語版 README](README_ja.md) | [中文版 README](README_zh.md)
+
+[![CI](https://github.com/kako-jun/diffx/actions/workflows/ci.yml/badge.svg)](https://github.com/kako-jun/diffx/actions/workflows/ci.yml)
+[![Crates.io CLI](https://img.shields.io/crates/v/diffx.svg?label=diffx-cli)](https://crates.io/crates/diffx)
+[![Docs.rs Core](https://docs.rs/diffx-core/badge.svg)](https://docs.rs/diffx-core)
+[![npm](https://img.shields.io/npm/v/diffx-js.svg?label=diffx-js)](https://www.npmjs.com/package/diffx-js)
+[![PyPI](https://img.shields.io/pypi/v/diffx-python.svg?label=diffx-python)](https://pypi.org/project/diffx-python/)
+[![Documentation](https://img.shields.io/badge/📚%20User%20Guide-Documentation-green)](https://github.com/kako-jun/diffx/tree/main/docs/index.md)
+[![API Reference](https://img.shields.io/badge/🔧%20API%20Reference-docs.rs-blue)](https://docs.rs/diffx-core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+A next-generation diff tool that understands the **structure** and **meaning** of your data, not just text changes. Perfect for JSON, YAML, TOML, XML, INI, and CSV files.
+
+```bash
+# Traditional diff shows formatting noise (key order, trailing commas)
+$ diff config_v1.json config_v2.json
+< {
+<   "name": "myapp",
+<   "version": "1.0"
+< }
+> {
+>   "version": "1.1",
+>   "name": "myapp"
+> }
+
+# diffx shows only semantic changes
+$ diffx config_v1.json config_v2.json
+~ version: "1.0" -> "1.1"
+```
+
+## ✨ Key Features
+
+- **🎯 Semantic Awareness**: Ignores formatting, key order, whitespace, and trailing commas
+- **🔧 Multiple Formats**: JSON, YAML, TOML, XML, INI, CSV support
+- **🤖 AI-Friendly**: Clean CLI output perfect for automation and AI analysis
+- **⚡ Fast**: Built in Rust for maximum performance
+- **🔗 Meta-Chaining**: Compare diff reports to track change evolution
+
+## 📊 Performance
+
+Real benchmark results on AMD Ryzen 5 PRO 4650U:
+
+```bash
+# Test files: ~600 bytes JSON with nested config
+$ time diff large_test1.json large_test2.json  # Shows 15+ lines of noise
+$ time diffx large_test1.json large_test2.json # Shows 3 semantic changes
+
+# Results:
+Traditional diff: ~0.002s (but with formatting noise)
+diffx:           ~0.005s (clean semantic output)
+```
+
+**Why CLI matters for the AI era**: As AI tools become essential in development workflows, having structured, machine-readable diff output becomes crucial. `diffx` provides clean, parseable results that AI can understand and reason about, making it perfect for automated code review, configuration management, and intelligent deployment pipelines.
+
+## Why diffx?
+
+Traditional `diff` tools show you formatting noise. `diffx` shows you what actually changed.
+
+- **Focus on meaning**: Ignores key order, whitespace, and formatting
+- **Multiple formats**: Works with JSON, YAML, TOML, XML, INI, CSV
+- **Clean output**: Perfect for humans, scripts, and AI analysis
+
+## Specification
+
+### Supported Formats
+
+- JSON
+- YAML
+- TOML
+- XML
+- INI
+- CSV
+
+### Types of Differences
+
+- Key addition/deletion
+- Value change
+- Array insertion/deletion/modification
+- Nested structure differences
+- Value type change
+
+### Output Formats
+
+`diffx` outputs differences in the **diffx format** by default - a semantic diff representation designed specifically for structured data. The diffx format provides the richest expression of structural differences and can be complemented with machine-readable formats for integration:
+
+- **diffx Format (Default)**
+
+  - The **diffx format** is a human-readable, semantic diff representation that clearly displays structural differences (additions, changes, deletions, type changes, etc.) using intuitive symbols and hierarchical paths.
+  - Differences are represented by `+` (addition), `-` (deletion), `~` (change), `!` (type change) symbols with full path context (e.g., `database.connection.host`).
+  - **Core Feature**: Focuses on semantic changes in data, ignoring changes in key order, whitespace, and formatting. This semantic focus is the fundamental value of both the tool and the diffx format.
+
+- **JSON Format**
+
+  - Machine-readable format. Used for CI/CD and integration with other programs.
+  - Differences detected by `diffx` are output as a JSON array.
+
+- **YAML Format**
+
+  - Machine-readable format. Used for CI/CD and integration with other programs, similar to JSON.
+  - Differences detected by `diffx` are output as a YAML array.
+
+- **diff-compatible Format (Unified Format)**
+  - Provided with the `--output unified` option.
+  - Intended for integration with `git` and existing merge tools.
+  - **Note**: This format only shows the semantic differences detected by `diffx` in traditional diff format. Changes that are not semantic differences (e.g., key order changes, whitespace changes) are not displayed. This is purely for compatibility with existing tools.
+
+## 🏗️ Architecture
+
+### System Overview
+
+```mermaid
+graph TB
+    subgraph Core["diffx-core"]
+        B[Format Parsers]
+        C[Semantic Diff Engine]
+        D[Output Formatters]
+        B --> C --> D
+    end
+
+    E[CLI Tool] --> Core
+    F[NPM Package] --> E
+    G[Python Package] --> E
+
+    H[JSON] --> B
+    I[YAML] --> B
+    J[TOML] --> B
+    K[XML] --> B
+    L[INI] --> B
+    M[CSV] --> B
+
+    D --> N[CLI Display]
+    D --> O[JSON Output]
+    D --> P[YAML Output]
+    D --> Q[Unified Diff]
+```
+
+### Project Structure
+
+```
+diffx/
+├── diffx-core/      # Diff extraction library (Crate)
+├── diffx-cli/       # CLI wrapper
+├── tests/           # All test-related files
+│   ├── fixtures/    # Test input data
+│   ├── integration/ # CLI integration tests
+│   ├── unit/        # Core library unit tests
+│   └── output/      # Test intermediate files
+├── docs/            # Documentation and specifications
+└── ...
+```
+
+### Technology Stack
+
+- **Rust** (Fast, safe, cross-platform)
+- `serde_json`, `serde_yml`, `toml`, `configparser`, `quick-xml`, `csv` parsers
+- `clap` (CLI argument parsing)
+- `colored` (CLI output coloring)
+- `similar` (Unified Format output)
+
+## 🔗 Meta-Chaining
+
+Compare diff reports to track how changes evolve over time:
+
+```mermaid
+graph LR
+    A[config_v1.json] --> D1[diffx]
+    B[config_v2.json] --> D1
+    D1 --> R1[diff_report_v1.json]
+
+    B --> D2[diffx]
+    C[config_v3.json] --> D2
+    D2 --> R2[diff_report_v2.json]
+
+    R1 --> D3[diffx]
+    R2 --> D3
+    D3 --> M[Meta-Diff Report]
+```
+
+```bash
+$ diffx config_v1.json config_v2.json --output json > report1.json
+$ diffx config_v2.json config_v3.json --output json > report2.json
+$ diffx report1.json report2.json  # Compare the changes themselves!
+```
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Rust (recommended - native performance)
+cargo install diffx
+
+# Node.js ecosystem
+npm install diffx-js
+
+# Python ecosystem (🆕 self-contained wheel with embedded binary)
+pip install diffx-python
+
+# Or download pre-built binaries from GitHub Releases
+```
+
+For detailed usage and examples, see the [documentation](docs/index.md).
+
+### Quick Documentation Links
+
+- **[Getting Started](docs/user-guide/getting-started.md)** - Learn the basics
+- **[Installation Guide](docs/user-guide/installation.md)** - Platform-specific setup
+- **[CLI Reference](docs/reference/cli-reference.md)** - Complete command reference
+- **[Real-World Examples](docs/user-guide/examples.md)** - Industry use cases
+- **[Integration Guide](docs/guides/integrations.md)** - CI/CD and automation
+
+### Basic Usage
+
+```bash
+# Compare JSON files
+diffx file1.json file2.json
+
+# Compare with different output formats
+diffx config.yaml config_new.yaml --output json
+diffx data.toml data_updated.toml --output yaml
+
+# Advanced filtering options
+diffx large.json large_v2.json --ignore-keys-regex "^timestamp$|^_.*"
+diffx users.json users_v2.json --array-id-key "id"
+diffx metrics.json metrics_v2.json --epsilon 0.001
+
+# High-demand practical options
+diffx config.yaml config_new.yaml --ignore-case          # Ignore case differences
+diffx api.json api_formatted.json --ignore-whitespace    # Ignore whitespace changes
+diffx large.json large_v2.json --context 3 --output unified  # Show 3 lines of context
+diffx file1.json file2.json --quiet && echo "Files identical"  # Script automation
+diffx dir1/ dir2/ --recursive --brief                    # Quick file change check
+
+# Performance optimization for large files
+diffx huge_dataset.json huge_dataset_v2.json
+# Directory comparison
+diffx config_dir1/ config_dir2/ --recursive
+
+# Meta-chaining for change tracking
+diffx config_v1.json config_v2.json --output json > diff1.json
+diffx config_v2.json config_v3.json --output json > diff2.json
+diffx diff1.json diff2.json  # Compare the changes themselves!
+```
+
+### Integration Examples
+
+**CI/CD Pipeline:**
+
+```yaml
+- name: Check configuration changes
+  run: |
+    diffx config/prod.yaml config/staging.yaml --output json > changes.json
+    # Process changes.json for deployment validation
+
+- name: Quick file change detection
+  run: |
+    if ! diffx config/current.json config/new.json --quiet; then
+      echo "Configuration changed, triggering deployment"
+    fi
+
+- name: Compare with ignore options for cleaner diffs
+  run: |
+    diffx api_old.json api_new.json --ignore-case --ignore-whitespace --output json > api_changes.json
+    # Focus on semantic changes, ignore formatting
+
+- name: Compare large datasets efficiently  
+  run: |
+    diffx large_prod_data.json large_staging_data.json --output json > data_changes.json
+    # Optimized processing for large files in CI
+```
+
+**Git Hook:**
+
+```bash
+#!/bin/bash
+# pre-commit hook
+if diffx package.json HEAD~1:package.json --output json | jq -e '.[] | select(.Added)' > /dev/null; then
+  echo "New dependencies detected, running security audit..."
+fi
+```
+
+## 🌍 Multi-Language Support
+
+diffx is available across multiple ecosystems:
+
+```bash
+# Rust (native CLI)
+cargo install diffx
+
+# Node.js wrapper
+npm install diffx-js
+
+# Python wrapper  
+pip install diffx-python
+```
+
+All packages provide the same semantic diff capabilities with automatic binary download.
+
+## 🔮 Future Plans
+
+- **Interactive TUI (`diffx-tui`)**: A powerful viewer showcasing diffx capabilities with side-by-side data display
+- **AI agent integration**: Automated diff summarization and explanation
+- **Web UI version** (`diffx-web`)
+- **VSCode extension** (`diffx-vscode`)
+- **Advanced CI/CD templates**: Pre-built workflows for common use cases
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.