Release Date: 2025-10-10
Status: Beta
Python Support: 3.8 - 3.13
Version 0.2.0 is a major refactoring release introducing modular architecture, testing infrastructure, and constants-driven design. Full backward compatibility maintained.
Installation
pip install insightfulpy==0.2.0Added
- Modular architecture with specialized modules (core, constants, summary, statistics, data_quality, visualization, advanced_viz, analysis, comparison)
- Constants-driven design eliminating magic numbers
- Environment detection with
_JUPYTER_AVAILABLEflag and_safe_display()function for Jupyter and terminal compatibility - Type marker file
py.typedfor PEP 561 compliance - Build system using pyproject.toml (PEP 517/518)
- Testing infrastructure with pytest (69% coverage, 227 passing tests)
- Code quality tools: Black, Flake8, mypy, isort, pre-commit hooks
- Documentation system (user guide, API reference, developer guide, configuration, troubleshooting, gallery, examples)
- GitHub templates for bug reports, feature requests, and pull requests
- MANIFEST.in for distribution control
Changed
- Refactored monolithic eda.py into modular specialized modules (eda.py now acts as backward compatibility layer)
- Migrated package metadata from setup.py to pyproject.toml
- Updated Python version support to 3.8-3.12
- Elevated development status to Beta
- Updated test dependencies (pytest>=8.0.0, pytest-cov>=6.0.0, pytest-xdist>=3.0.0)
- Updated code quality tool versions (black>=24.0.0, flake8>=7.0.0, mypy>=1.8.0, isort>=5.12.0, pre-commit>=3.0.0)
Fixed
- Consistent function naming across all modules
- Type hints added for all parameters and return values
- Warning management to prevent dependency warnings from affecting users
- Cross-environment compatibility between Jupyter and terminal
Upgrade Notes
No migration required. All existing code from previous versions (0.1.0 - 0.1.8) will work without changes. Full backward compatibility maintained.
Links
- Homepage: https://github.com/dhaneshbb/insightfulpy
- PyPI: https://pypi.org/project/insightfulpy/
- Documentation: https://github.com/dhaneshbb/insightfulpy/tree/main/docs/
- Full Changelog: https://github.com/dhaneshbb/insightfulpy/blob/main/CHANGELOG.md