dissectml 0.1.0__tar.gz

dissectml-0.1.0/.gitattributes

@@ -0,0 +1,25 @@
+# Auto-detect text files and normalize line endings to LF on commit
+* text=auto eol=lf
+
+# Python files
+*.py text eol=lf
+*.pyi text eol=lf
+
+# Config / markup
+*.toml text eol=lf
+*.yaml text eol=lf
+*.yml text eol=lf
+*.md text eol=lf
+*.json text eol=lf
+*.html text eol=lf
+*.css text eol=lf
+*.js text eol=lf
+*.j2 text eol=lf
+
+# Binary files (never mangle)
+*.png binary
+*.jpg binary
+*.gif binary
+*.ico binary
+*.csv binary
+*.parquet binary

dissectml-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,46 @@
+---
+name: Bug Report
+about: Report a bug to help us improve InsightML
+title: "[BUG] "
+labels: bug
+assignees: ""
+---
+
+## Describe the Bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. Install dissectml version X
+2. Run this code:
+
+```python
+import dissectml as iml
+# minimal reproduction code here
+```
+
+3. See error
+
+## Expected Behavior
+
+A clear description of what you expected to happen.
+
+## Error Output
+
+```
+Paste the full traceback or error message here.
+```
+
+## Environment
+
+- OS: [e.g., Windows 11, Ubuntu 22.04, macOS 14]
+- Python version: [e.g., 3.11.3]
+- dissectml version: [e.g., 0.1.0]
+- Installation method: [e.g., pip install dissectml, pip install dissectml[full]]
+
+## Additional Context
+
+Add any other context about the problem here (screenshots, related issues, etc.).

dissectml-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,28 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement for InsightML
+title: "[FEATURE] "
+labels: enhancement
+assignees: ""
+---
+
+## Is your feature request related to a problem?
+
+A clear description of the problem. Example: "I'm always frustrated when [...]"
+
+## Describe the Solution You'd Like
+
+A clear description of what you want to happen. Include example API usage if possible:
+
+```python
+import dissectml as iml
+# How you'd like the feature to work
+```
+
+## Describe Alternatives You've Considered
+
+A description of any alternative solutions or features you've considered.
+
+## Additional Context
+
+Add any other context, screenshots, or references about the feature request here.

dissectml-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## Summary
+
+Briefly describe the changes in this PR.
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] Test coverage improvement
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+
+## Related Issues
+
+Closes #(issue number)
+
+## Checklist
+
+- [ ] I have read the [CONTRIBUTING](../CONTRIBUTING.md) guide
+- [ ] My code follows the project's code style (`ruff check` passes)
+- [ ] I have added tests that cover my changes
+- [ ] All new and existing tests pass (`pytest tests/ -x -q`)
+- [ ] I have updated documentation if the public API changed

dissectml-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,101 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+
+  test:
+    name: Tests (Python ${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+        exclude:
+          # Reduce Windows matrix to one Python version
+          - os: windows-latest
+            python-version: "3.10"
+          - os: windows-latest
+            python-version: "3.12"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install core dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests (core)
+        shell: bash
+        run: |
+          pytest tests/ \
+            --ignore=tests/integration \
+            -x -q \
+            --tb=short \
+            --cov=dissectml \
+            --cov-report=term-missing
+
+  test-boost:
+    name: Tests with boost extras (Ubuntu / Python 3.11)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+      - name: Install with boost extra
+        run: pip install -e ".[boost,dev]"
+      - name: Run all tests including integration
+        run: |
+          pytest tests/ -x -q --tb=short
+
+  coverage:
+    name: Coverage report
+    runs-on: ubuntu-latest
+    needs: [test]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+      - run: pip install -e ".[dev]"
+      - name: Generate coverage XML
+        shell: bash
+        run: |
+          pytest tests/ \
+            --ignore=tests/integration \
+            --cov=dissectml \
+            --cov-report=xml \
+            -q
+      - name: Upload to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+          fail_ci_if_error: false

dissectml-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,94 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  contents: write
+  id-token: write  # for PyPI trusted publishing
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  test-release:
+    name: Smoke-test the built wheel
+    needs: [build]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install from wheel
+        run: pip install dist/*.whl
+
+      - name: Verify import
+        run: python -c "import dissectml; print(dissectml.__version__)"
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [test-release]
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: [publish-pypi]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Extract tag name
+        id: tag
+        run: echo "tag=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ steps.tag.outputs.tag }}
+          files: dist/*
+          generate_release_notes: true

dissectml-0.1.0/.gitignore

@@ -0,0 +1,86 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyd
+*.pyo
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environment
+.venv/
+venv/
+ENV/
+env/
+.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+htmlcov/
+.pytest_cache/
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+
+# MyPy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Jupyter
+.ipynb_checkpoints/
+*.ipynb_checkpoints
+
+# Docs
+docs/site/
+site/
+
+# Reports (generated output)
+*.html
+!InsightML.html
+!src/dissectml/report/templates/
+!src/dissectml/report/assets/
+
+# Temporary files
+*.tmp
+*.bak
+*.stackdump
+
+# CatBoost training cache
+catboost_info/
+
+# Windows
+desktop.ini

dissectml-0.1.0/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to InsightML will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-04-06
+
+### Added
+- `iml.explore(df)` — Deep EDA with lazy evaluation
+- Dataset overview: type detection, column profiles, memory stats
+- Univariate analysis: distributions, KDE, descriptive stats
+- Bivariate analysis: cross-type pair analysis
+- Correlation analysis: unified matrix (Pearson/Spearman/Cramer's V/eta)
+- Missing data intelligence: Little's MCAR test, MAR/MNAR classification
+- Outlier detection: IQR, Z-score, Isolation Forest with consensus
+- Statistical tests: normality, independence, variance, group comparison
+- Cluster discovery: auto K-Means + DBSCAN with profiling
+- Feature interactions: interaction strength, non-linearity detection
+- Target analysis: class balance, distribution, feature-target relationships
+- `iml.battle(df, target)` — parallel CV across 19 classifiers / 17 regressors
+- EDA-informed preprocessing (KNN imputer, Robust scaler, OrdinalEncoder)
+- ModelRegistry, MODEL_CATALOG, ModelTuner (quick/tuned/custom modes)
+- `iml.analyze_intelligence(df, target)` — 4-pronged leakage detection, VIF, condition number
+- Data readiness score 0–100 with grade (A–F) and penalty waterfall
+- Composite feature importance ranking (MI + correlation + F-score)
+- Algorithm recommendations engine (7 algorithm profiles)
+- `ModelComparator` — McNemar test, corrected paired t-test, Pareto front, error analysis
+- ROC/PR curves, confusion matrices, residual plots, actual vs predicted
+- SHAP model comparison (TreeExplainer / LinearExplainer / KernelExplainer)
+- `iml.analyze(df, target)` — full 5-stage pipeline, returns `AnalysisReport`
+- `AnalysisReport.export(path)` — self-contained interactive HTML report
+- `AnalysisReport.show()` — export + open in browser
+- `iml.load_titanic()` / `iml.load_housing()` — built-in demo datasets
+- `iml.to_pandas()` — Polars DataFrame / file path / dict / numpy array conversion
+- `report/pdf_renderer.py` — optional PDF export via WeasyPrint
+- Report sections module (`report/sections/`), Jinja2 templates, CSS/JS assets
+- GitHub Actions CI/CD (`.github/workflows/ci.yml`, `release.yml`)
+- MkDocs Material documentation site
+- 4 example Jupyter notebooks (quickstart, deep EDA, model battle, full pipeline)
+- 472 tests (453 passing, 3 skipped — tabulate/weasyprint optional deps)

dissectml-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,52 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a welcoming experience for everyone, regardless of background or
+identity.
+
+We pledge to act and interact in ways that contribute to an open, inclusive,
+and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+- Trolling, insulting or derogatory comments, and personal attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of unacceptable behavior may be reported to the project maintainer at
+**rupeshbharambe2004@gmail.com**. All complaints will be reviewed and
+investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the
+[Contributor Covenant](https://www.contributor-covenant.org), version 2.1,
+available at
+<https://www.contributor-covenant.org/version/2/1/code_of_conduct.html>.

dissectml-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,141 @@
+# Contributing to InsightML
+
+Thank you for your interest in contributing to InsightML. This guide covers
+everything you need to get started.
+
+---
+
+## Table of Contents
+
+1. [Development Setup](#development-setup)
+2. [Running Tests](#running-tests)
+3. [Code Style](#code-style)
+4. [Pull Request Process](#pull-request-process)
+5. [Commit Message Convention](#commit-message-convention)
+6. [Reporting Issues](#reporting-issues)
+7. [Code of Conduct](#code-of-conduct)
+
+---
+
+## Development Setup
+
+1. Fork the repository on GitHub and clone your fork:
+
+   ```bash
+   git clone https://github.com/rupeshbharambe24/InsightML.git
+   cd InsightML
+   ```
+
+2. Create and activate a virtual environment (recommended):
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate   # Linux / macOS
+   .venv\Scripts\activate      # Windows
+   ```
+
+3. Install the package in editable mode with dev dependencies:
+
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+## Running Tests
+
+Run the full test suite with:
+
+```bash
+pytest tests/ -x -q
+```
+
+- `-x` stops on the first failure so you can fix issues incrementally.
+- `-q` keeps the output concise.
+
+To run a specific test file:
+
+```bash
+pytest tests/eda/test_univariate.py -x -q
+```
+
+## Code Style
+
+This project uses **ruff** for linting and formatting.
+
+```bash
+ruff check src/ tests/
+```
+
+Key style rules:
+
+- **Line length**: 100 characters maximum.
+- **Type hints**: Encouraged on all public function signatures.
+- **Docstrings**: Use Google-style docstrings for public classes and functions.
+- **Imports**: Sorted automatically by ruff; one import per line for clarity.
+
+Fix auto-fixable lint issues with:
+
+```bash
+ruff check --fix src/ tests/
+```
+
+## Pull Request Process
+
+1. **Fork** the repository and create a feature branch from `master`:
+
+   ```bash
+   git checkout -b feat/my-feature master
+   ```
+
+2. **Write code** and add or update tests as needed.
+
+3. **Ensure all tests pass** and the linter reports no errors:
+
+   ```bash
+   pytest tests/ -x -q
+   ruff check src/ tests/
+   ```
+
+4. **Push** your branch to your fork and open a Pull Request against `master`.
+
+5. Fill out the PR template. A maintainer will review your changes and may
+   request modifications before merging.
+
+## Commit Message Convention
+
+Use **imperative mood** and prefix each commit message with one of the
+following tags:
+
+| Prefix      | Purpose                          |
+|-------------|----------------------------------|
+| `feat:`     | New feature                      |
+| `fix:`      | Bug fix                          |
+| `docs:`     | Documentation only               |
+| `test:`     | Adding or updating tests         |
+| `refactor:` | Code change that is not a fix or feature |
+| `chore:`    | Build scripts, CI, dependencies  |
+
+Examples:
+
+```
+feat: add SHAP summary plot to intelligence stage
+fix: handle missing values in correlation matrix
+docs: update installation instructions in README
+```
+
+## Reporting Issues
+
+Before opening an issue, please:
+
+1. Search existing issues to avoid duplicates.
+2. Use the appropriate issue template (bug report or feature request).
+3. Include a minimal reproducible example when reporting bugs.
+4. Specify your environment: OS, Python version, and `dissectml` version.
+
+## Code of Conduct
+
+All contributors are expected to follow our
+[Code of Conduct](CODE_OF_CONDUCT.md). Please read it before participating.
+
+---
+
+Thank you for helping make InsightML better.

dissectml-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rupesh Bharambe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.