diffai-python 0.3.5__tar.gz → 0.5.0__tar.gz

diffai_python-0.5.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: diffai-python
+Version: 0.5.0
+Summary: DEPRECATED: Use 'diffai' instead. This package is a compatibility shim.
+Author: kako-jun
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kako-jun/diffai-python
+Classifier: Development Status :: 7 - Inactive
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: diffai>=0.5.0
+
+# diffai-python (DEPRECATED)
+
+**This package has been renamed to [`diffai`](https://pypi.org/project/diffai/).**
+
+## Migration
+
+```bash
+pip uninstall diffai-python
+pip install diffai
+```
+
+Update your imports:
+
+```python
+# Old (deprecated)
+import diffai_python
+
+# New
+import diffai
+```
+
+## Why the change?
+
+The package has been renamed to provide a cleaner import experience that matches the package name.

diffai_python-0.5.0/README.md

@@ -0,0 +1,24 @@
+# diffai-python (DEPRECATED)
+
+**This package has been renamed to [`diffai`](https://pypi.org/project/diffai/).**
+
+## Migration
+
+```bash
+pip uninstall diffai-python
+pip install diffai
+```
+
+Update your imports:
+
+```python
+# Old (deprecated)
+import diffai_python
+
+# New
+import diffai
+```
+
+## Why the change?
+
+The package has been renamed to provide a cleaner import experience that matches the package name.

diffai_python-0.5.0/diffai_python/__init__.py

@@ -0,0 +1,28 @@
+"""
+DEPRECATED: This package has been renamed to 'diffai'.
+
+Please update your dependencies:
+    pip install diffai
+
+And update your imports:
+    # Old (deprecated)
+    import diffai_python
+
+    # New
+    import diffai
+"""
+
+import warnings
+
+warnings.warn(
+    "The 'diffai-python' package is deprecated and will be removed in a future release. "
+    "Please use 'diffai' instead:\n"
+    "    pip install diffai\n"
+    "    import diffai",
+    DeprecationWarning,
+    stacklevel=2
+)
+
+# Re-export everything from the new package
+from diffai import *
+from diffai import __version__

diffai_python-0.5.0/diffai_python.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: diffai-python
+Version: 0.5.0
+Summary: DEPRECATED: Use 'diffai' instead. This package is a compatibility shim.
+Author: kako-jun
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kako-jun/diffai-python
+Classifier: Development Status :: 7 - Inactive
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: diffai>=0.5.0
+
+# diffai-python (DEPRECATED)
+
+**This package has been renamed to [`diffai`](https://pypi.org/project/diffai/).**
+
+## Migration
+
+```bash
+pip uninstall diffai-python
+pip install diffai
+```
+
+Update your imports:
+
+```python
+# Old (deprecated)
+import diffai_python
+
+# New
+import diffai
+```
+
+## Why the change?
+
+The package has been renamed to provide a cleaner import experience that matches the package name.

diffai_python-0.5.0/diffai_python.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+diffai_python/__init__.py
+diffai_python.egg-info/PKG-INFO
+diffai_python.egg-info/SOURCES.txt
+diffai_python.egg-info/dependency_links.txt
+diffai_python.egg-info/requires.txt
+diffai_python.egg-info/top_level.txt

diffai_python-0.5.0/diffai_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

diffai_python-0.5.0/diffai_python.egg-info/requires.txt

@@ -0,0 +1 @@
+diffai>=0.5.0

diffai_python-0.5.0/diffai_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+diffai_python

diffai_python-0.5.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "diffai-python"
+version = "0.5.0"
+description = "DEPRECATED: Use 'diffai' instead. This package is a compatibility shim."
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "kako-jun" }
+]
+classifiers = [
+    "Development Status :: 7 - Inactive",
+    "Programming Language :: Python :: 3",
+]
+requires-python = ">=3.8"
+dependencies = ["diffai>=0.5.0"]
+
+[project.urls]
+Homepage = "https://github.com/kako-jun/diffai-python"

diffai_python-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

diffai_python-0.3.5/Cargo.toml

@@ -1,63 +0,0 @@
-[workspace]
-resolver = "2"
-members = [
-    "diffai-core",
-    "diffai-cli"
-]
-
-[workspace.package]
-version = "0.3.5"
-edition = "2021"
-authors = ["kako-jun"]
-license = "MIT"
-description = "🤖 AI/ML specialized diff tool for deep learning models - PyTorch, Safetensors, tensor analysis, model comparison, experiment tracking"
-homepage = "https://github.com/kako-jun/diffai"
-repository = "https://github.com/kako-jun/diffai"
-documentation = "https://github.com/kako-jun/diffai/tree/main/docs"
-readme = "README.md"
-keywords = ["diff", "ai", "ml", "pytorch", "safetensors"]
-categories = ["command-line-utilities", "development-tools", "algorithms", "science"]
-exclude = [
-    ".github/",
-    "target/"
-]
-rust-version = "1.75"
-
-[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"] }
-# AI/ML dependencies
-candle-core = "0.8"
-candle-nn = "0.8"
-safetensors = "0.4"
-bytemuck = "1.14"
-# Scientific data dependencies
-ndarray = "0.16"
-# numpy = "0.21"  # Removed: only needed for Python bindings, causes PyO3 issues
-# hdf5 = "0.8"  # Requires system HDF5 libraries
-zip = "2.2"
-matfile = "0.1"  # MATLAB .mat file support
-# Python bindings (removed - now using binary distribution)
-# Cross-project integration  
-diffx-core = "0.1"
-
-[profile.release]
-lto = true
-codegen-units = 1
-panic = "abort"

diffai_python-0.3.5/PKG-INFO

@@ -1,374 +0,0 @@
-Metadata-Version: 2.4
-Name: diffai-python
-Version: 0.3.5
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Text Processing :: General
-Classifier: Topic :: Utilities
-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
-Summary: AI/ML specialized diff tool for deep tensor comparison and analysis
-Keywords: ai,ml,machine-learning,diff,tensor,pytorch,safetensors,numpy,matlab,model-comparison,diffai,artificial-intelligence
-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/diffai
-Project-URL: Documentation, https://github.com/kako-jun/diffai/blob/main/docs/
-Project-URL: Repository, https://github.com/kako-jun/diffai.git
-Project-URL: Issues, https://github.com/kako-jun/diffai/issues
-Project-URL: Changelog, https://github.com/kako-jun/diffai/blob/main/CHANGELOG.md
-
-# diffai-python
-
-AI/ML specialized diff tool for deep tensor comparison and analysis - Python Package
-
-[![PyPI version](https://badge.fury.io/py/diffai-python.svg)](https://badge.fury.io/py/diffai-python)
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## Overview
-
-**diffai-python** provides Python bindings for [diffai](https://github.com/kako-jun/diffai), an AI/ML specialized diff tool. This package bundles the high-performance Rust binary and provides a clean Python API for integration into ML workflows, notebooks, and automation scripts.
-
-Following the same distribution pattern as [ruff](https://github.com/astral-sh/ruff), this package distributes a pre-compiled binary for maximum performance while providing a convenient Python interface.
-
-## Features
-
-- **High Performance**: Uses the native diffai Rust binary for maximum speed
-- **Zero Dependencies**: Self-contained package with bundled binary
-- **ML-Focused**: Specialized analysis for PyTorch, Safetensors, NumPy, and MATLAB files
-- **Scientific Computing**: Full support for NumPy arrays and MATLAB .mat files
-- **Multiple Output Formats**: CLI, JSON, and YAML outputs for different use cases
-- **Python Integration**: Clean API for programmatic use in ML pipelines
-
-## Installation
-
-```bash
-pip install diffai-python
-```
-
-## Quick Start
-
-### Command Line Usage
-
-After installation, the `diffai` command is available:
-
-```bash
-# Compare ML models (30+ analysis features automatic)
-diffai model_v1.safetensors model_v2.safetensors
-
-# Compare NumPy arrays
-diffai data_v1.npy data_v2.npy
-
-# JSON output for automation (all ML features included)
-diffai model_v1.pt model_v2.pt --output json
-```
-
-### Python API Usage
-
-```python
-import diffai
-
-# Basic comparison
-result = diffai.diff("model_v1.safetensors", "model_v2.safetensors")
-print(result.raw_output)
-
-# With options
-options = diffai.DiffOptions(
-    output_format=diffai.OutputFormat.JSON
-)
-result = diffai.diff("model_v1.pt", "model_v2.pt", options)
-
-# Access structured data
-if result.is_json:
-    data = result.data
-    print(f"Found {len(data)} differences")
-```
-
-### Advanced ML Analysis
-
-```python
-# Comprehensive ML model analysis (automatic for ML models)
-result = diffai.diff(
-    "baseline.safetensors", 
-    "improved.safetensors",
-    stats=True  # Enable statistical analysis
-)
-
-print(result.raw_output)
-
-# ML-specific analysis features (automatic for ML models)
-# - architecture_comparison: Model architecture and structural changes
-# - memory_analysis: Memory usage and optimization opportunities
-# - anomaly_detection: Numerical anomalies and training issues
-# - convergence_analysis: Training convergence patterns
-# - gradient_analysis: Gradient flow health assessment
-# - quantization_analysis: Quantization effect analysis
-```
-
-## Supported Formats
-
-### Input Formats
-- **ML Models**: `.safetensors`, `.pt`, `.pth`, `.bin` (PyTorch)
-- **Scientific Data**: `.npy`, `.npz` (NumPy), `.mat` (MATLAB)  
-- **Structured Data**: `.json`, `.yaml`, `.toml`, `.xml`, `.ini`, `.csv`
-
-### Output Formats
-- **CLI**: Colored terminal output (default)
-- **JSON**: Machine-readable format for automation
-- **YAML**: Human-readable structured format
-
-## ML Analysis Features (Automatic)
-
-The package provides 30+ specialized ML analysis features that run automatically for PyTorch and Safetensors files:
-
-- **Detailed tensor statistics**: Mean, std, min, max, shape, dtype
-- **Model structure comparison**: Architecture and structural changes
-- **Memory usage analysis**: Memory optimization opportunities
-- **Numerical anomaly detection**: Training issues and anomalies
-- **Training convergence analysis**: Convergence patterns
-- **Gradient information analysis**: Gradient flow health
-- **Layer similarity comparison**: Inter-layer analysis
-- **Detailed change summary**: Comprehensive change patterns
-- **Quantization impact analysis**: Quantization effects
-- **Change magnitude sorting**: Priority-sorted differences
-- **Plus 20+ additional specialized features**
-
-## API Reference
-
-### Main Functions
-
-```python
-# Compare two files
-def diff(input1: str, input2: str, options: Optional[DiffOptions] = None, **kwargs) -> DiffResult
-
-# Main CLI entry point
-def main() -> None
-```
-
-### Configuration
-
-```python
-@dataclass
-class DiffOptions:
-    # Basic options
-    input_format: Optional[str] = None
-    output_format: Optional[OutputFormat] = None
-    recursive: bool = False
-    verbose: bool = False
-    
-    # For scientific data (NumPy/MATLAB)
-    stats: bool = False  # Only used for NumPy/MATLAB files
-    # Note: ML analysis runs automatically for PyTorch/Safetensors
-```
-
-### Results
-
-```python
-class DiffResult:
-    raw_output: str           # Raw output from diffai
-    format_type: str          # Output format used
-    return_code: int          # Process return code
-    
-    @property
-    def data(self) -> Any     # Parsed data (JSON when applicable)
-    
-    @property  
-    def is_json(self) -> bool # True if JSON format
-```
-
-## Use Cases
-
-### Research & Development
-```python
-# Compare fine-tuning results
-before = "model_baseline.safetensors"
-after = "model_finetuned.safetensors"
-
-result = diffai.diff(before, after)
-```
-
-### MLOps Integration
-```python
-# Automated model validation in CI/CD
-def validate_model_changes(old_model, new_model):
-    result = diffai.diff(old_model, new_model,
-                        output_format=diffai.OutputFormat.JSON)
-    
-    if result.is_json:
-        # Check for critical issues
-        for item in result.data:
-            if 'AnomalyDetection' in item and 'critical' in str(item):
-                raise ValueError("Critical model anomaly detected")
-    
-    return result
-
-### MLflow Integration
-```python
-import mlflow
-import diffai
-
-def log_model_comparison(run_id1, run_id2):
-    """Compare models between MLflow runs"""
-    
-    # Download models from MLflow
-    model1_path = mlflow.artifacts.download_artifacts(
-        run_id=run_id1, artifact_path="model/model.pt"
-    )
-    model2_path = mlflow.artifacts.download_artifacts(
-        run_id=run_id2, artifact_path="model/model.pt"
-    )
-    
-    # Compare with diffai
-    result = diffai.diff(model1_path, model2_path,
-                        output_format=diffai.OutputFormat.JSON)
-    
-    # Log results to MLflow
-    with mlflow.start_run():
-        mlflow.log_dict(result.data, "model_comparison.json")
-        if result.is_json:
-            # Extract metrics for logging
-            for item in result.data:
-                if 'TensorStatsChanged' in item:
-                    mlflow.log_metric("tensor_changes", len(result.data))
-                    break
-                    
-    return result
-
-### Weights & Biases Integration  
-```python
-import wandb
-import diffai
-
-def log_model_comparison_wandb(model1_path, model2_path):
-    """Log model comparison to Weights & Biases"""
-    
-    result = diffai.diff(model1_path, model2_path,
-                        output_format=diffai.OutputFormat.JSON)
-    
-    # Log to wandb
-    wandb.log({"model_comparison": result.data})
-    
-    if result.is_json:
-        # Log specific metrics
-        memory_changes = [item for item in result.data if 'MemoryAnalysis' in item]
-        if memory_changes:
-            wandb.log({"memory_impact_detected": len(memory_changes)})
-            
-    return result
-```
-
-### Jupyter Notebooks
-```python
-# Interactive analysis in notebooks
-result = diffai.diff("checkpoint_100.pt", "checkpoint_200.pt")
-
-# Display results
-if result.is_json:
-    from IPython.display import display, JSON
-    display(JSON(result.data))
-else:
-    print(result.raw_output)
-```
-
-## Binary Distribution
-
-This package follows the same pattern as [ruff](https://github.com/astral-sh/ruff):
-
-- Pre-compiled `diffai` binary is bundled with the Python package
-- No external dependencies or system requirements
-- Cross-platform compatibility (Windows, macOS, Linux)
-- Maximum performance through native Rust implementation
-
-## Testing
-
-Run the integration tests:
-
-```bash
-cd diffai-python
-python test_integration.py
-```
-
-The test suite includes:
-- Binary availability verification
-- Basic diff functionality
-- JSON output parsing
-- ML analysis options
-- Error handling
-
-## Contributing
-
-This package is part of the [diffai](https://github.com/kako-jun/diffai) project. Please see the main repository for contribution guidelines.
-
-## License
-
-MIT License - see [LICENSE](../LICENSE) for details.
-
-## Related Projects
-
-- **[diffai](https://github.com/kako-jun/diffai)**: Main Rust CLI tool
-- **[diffx](https://github.com/kako-jun/diffx)**: Generic structured data diff tool
-- **[ruff](https://github.com/astral-sh/ruff)**: Inspiration for Python packaging approach
-
-## Error Handling
-
-The diffai-python package provides comprehensive error handling for various failure scenarios:
-
-### DiffaiError
-The base exception class for all diffai-related errors:
-
-```python
-import diffai
-
-try:
-    result = diffai.diff("model1.pt", "model2.pt")
-except diffai.DiffaiError as e:
-    print(f"Diffai error: {e}")
-```
-
-### BinaryNotFoundError
-Raised when the diffai binary cannot be found:
-
-```python
-import diffai
-
-try:
-    result = diffai.diff("model1.pt", "model2.pt")
-except diffai.DiffaiError as e:
-    if "binary not found" in str(e):
-        print("Please install diffai binary or ensure it's in PATH")
-        # Fallback or installation logic here
-```
-
-### Binary Installation
-If the binary is not found, you can install it manually:
-
-```bash
-# Install via pip (includes binary)
-pip install diffai-python
-
-# Or install Rust version globally
-cargo install diffai-cli
-```
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.