Metadata-Version: 2.4
Name: additory
Version: 0.1.3a1
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Rust
Requires-Dist: polars>=0.19.0
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: pandas>=1.5.0 ; extra == 'dev'
Provides-Extra: dev
Summary: Elegant data operations for DataFrames - add.to(), add.transform(), add.synthetic()
Keywords: dataframe,data,pandas,polars,rust
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# additory - Rust Core

Elegant data operations for DataFrames.

## Three Functions Only

- `add.to()` - Add data FROM external source
- `add.transform()` - Transform data WITHIN DataFrame
- `add.synthetic()` - Create or augment with synthetic data

## Project Structure

```
rust-core/
├── src/
│   ├── lib.rs              # Main library entry
│   ├── core/               # Core functionality
│   │   ├── dataframe.rs    # DataFrame abstraction
│   │   ├── types.rs        # Type definitions
│   │   └── errors.rs       # Error types
│   ├── utils/              # Utilities
│   │   ├── validation.rs   # Input validation
│   │   ├── logging.rs      # Logging system
│   │   └── type_detection.rs
│   ├── to/                 # add.to() implementation
│   ├── transform/          # add.transform() implementation
│   └── synthetic/          # add.synthetic() implementation
├── Cargo.toml
└── README.md
```

## Building

```bash
cargo build
cargo test
cargo build --release
```

## Status

**Phase 1: Core Infrastructure** - ✅ Complete  
**Phase 2: Initial Features** - In Progress

### Core Infrastructure (Complete)
- ✅ Project structure
- ✅ Error types
- ✅ Core types (Mode, FetchColumn, UniversalParams)
- ✅ DataFrame abstraction
- ✅ Validation utilities
- ✅ Logging utilities
- ✅ Type detection utilities

### Implemented Features
- ✅ **add.to() LOOKUP mode** - Add columns from reference DataFrame (5 tests passing)
- ✅ **add.to() @merge mode** - Merge multiple DataFrames (9 tests passing)
- ✅ **add.transform() @filter mode** - Filter rows and select columns (10 tests passing)
- ✅ **add.transform() @sort mode** - Sort rows by column(s) (8 tests passing)
- ✅ **add.transform() @transpose mode** - Transpose DataFrame (6 tests passing)
- ✅ **add.transform() @aggregate mode** - Group and aggregate data (10 tests passing)
- ✅ **add.transform() @split mode** - Split text column into multiple columns (7 tests passing)
- ✅ **add.transform() @calc mode** - Calculate new columns from expressions (8 tests passing)
- ✅ **add.transform() @extract mode** - Extract datetime components (9 tests passing)
- ✅ **add.transform() @onehot mode** - One-hot encoding for categorical columns (7 tests passing)
- ✅ **add.transform() @label mode** - Label encoding for categorical columns (6 tests passing)
- ✅ **add.transform() @harmonize mode** - Unit conversions (8 tests passing)
- ✅ **add.transform() @knn mode** - K-Nearest Neighbors imputation (27 tests passing, pure Python)
- ✅ **add.synthetic() @new mode** - Create synthetic DataFrames with 7 distributions + date/time + patterns (18 tests passing)

### Test Status
- **Total Tests:** 163 passing
- **Core Tests:** 25 passing
- **LOOKUP Tests:** 5 passing
- **@merge Tests:** 9 passing
- **@filter Tests:** 10 passing
- **@sort Tests:** 8 passing
- **@transpose Tests:** 6 passing
- **@aggregate Tests:** 10 passing
- **@split Tests:** 7 passing
- **@calc Tests:** 8 passing
- **@extract Tests:** 9 passing
- **@onehot Tests:** 7 passing
- **@label Tests:** 6 passing
- **@harmonize Tests:** 8 passing
- **@knn Tests:** 27 passing (pure Python)
- **@new (synthetic) Tests:** 18 passing

## Next Steps

1. ✅ ~~Implement add.to() LOOKUP mode~~
2. ✅ ~~Implement add.to() @merge mode~~
3. ✅ ~~Implement add.transform() @filter mode~~
4. ✅ ~~Implement add.transform() @sort mode~~
5. ✅ ~~Implement add.transform() @transpose mode~~
6. ✅ ~~Implement add.transform() @aggregate mode~~
7. ✅ ~~Implement add.transform() @split mode~~
8. ✅ ~~Implement add.transform() @calc mode (basic version)~~
9. ✅ ~~Implement add.transform() @extract mode (datetime only)~~
10. ✅ ~~Implement add.transform() @onehot mode~~
11. ✅ ~~Implement add.transform() @label mode~~
12. ✅ ~~Implement add.transform() @harmonize mode~~
13. ✅ ~~Implement add.transform() @knn mode (pure Python)~~
14. ✅ ~~Implement add.synthetic() @new mode (basic version)~~
15. Expand add.synthetic() @new mode (more distributions, patterns, dates)
16. Implement add.synthetic() augment mode
17. Implement add.synthetic() @analyze mode
18. Add Python bindings (PyO3)
19. Enhance @calc with expression namespaces
20. Add text extraction to @extract mode

## Documentation

See `shadow_library/` for comprehensive documentation of all modules.

## License

MIT

