insightfulpy-v0.2.0

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.0

Added

• 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_AVAILABLE flag and _safe_display() function for Jupyter and terminal compatibility
• Type marker file py.typed for 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

insightfulpy-v0.1.6

Release Date: 2025-02-24

Changed

• Renamed functions for consistency:
  • compare_column_profiles() to compare_df_columns()
  • comprehensive_profile() to linked_key()
  • find_and_display_key_columns() to display_key_columns()
  • find_interconnected_outliers() to interconnected_outliers()

use insightfulpy-v0.1.6.zip

insightfulpy-v0.1.5

Release Date: 2025-02-24

Changed

• Merged utils.py into eda.py
• All utility functions now exported directly from eda.py
• Simplified import structure

Removed

• Separate utils.py module

use insightfulpy-v0.1.5.zip

insightfulpy-v0.1.4

Release Date: 2025-02-20

Added

• comp_cat_analysis() function for categorical comparison
• comp_num_analysis() function for numerical comparison with outlier
  analysis
• compare_column_profiles() function for column profiling
• comprehensive_profile() function for multi-dataset profiling
• find_and_display_key_columns() function for key column detection
• find_interconnected_outliers() function for multi-column outlier
  detection
• missing_inf_values() function for missing and infinite value detection
• __init__.py with explicit function exports

use insightfulpy-v0.1.4.zip

insightfulpy-v0.1.3

Release Date: 2025-02-06

Changed

• Package metadata in setup.cfg:
  • Package name changed from InsightfulPy to insightfulpy (lowercase)
    in setup.cfg
  • Version number updated from 0.1.2 to 0.1.3
• No functional code changes

use insightfulpy-v0.1.3.zip

insightfulpy-v0.1.1

Release Date: 2025-02-06

Fixed
Import statement in eda.py changed from from utils import to from .utils import for proper relative imports

use insightfulpy-v0.1.1.zip

insightfulpy-v0.1.0

Release Date: 2025-02-06

Added

• Initial release
• Core EDA module
• num_summary() function for numerical data summary
• cat_summary() function for categorical data summary
• columns_info() function for column information
• analyze_data() function for data analysis
• grouped_summary() function using TableOne
• calculate_skewness_kurtosis() function
• detect_outliers() function using IQR method
• detect_mixed_data_types() function
• cat_high_cardinality() function
• Visualization functions: show_missing(), plot_boxplots(),
  kde_batches(), box_plot_batches(), qq_plot_batches()
• Pairwise visualization functions: num_vs_num_scatterplot_pair_batch(),
  cat_vs_cat_pair_batch(), num_vs_cat_box_violin_pair_batch()
• Categorical visualization functions: cat_bar_batches(),
  cat_pie_chart_batches()
• Analysis functions: num_analysis_and_plot(), cat_analyze_and_plot()
• Utility module with calc_stats(), iqr_trimmed_mean(), mad()
  functions
• Support for pandas, numpy, matplotlib, seaborn, scipy, researchpy,
  tableone, missingno, tabulate
• MIT License

use only insightfulpy-v0.1.0.zip

insightfulpy-v0.1.2

Release Date: 2025-02-06

Changed

• Package name changed from "InsightfulPy" to "insightfulpy" (lowercase)
  in setup.py
• Version number updated from 0.1.1 to 0.1.2
• Package directory renamed from InsightfulPy/ to insightfulpy/
• Egg-info directory renamed from InsightfulPy.egg-info/ to
  insightfulpy.egg-info/
• Fixed setup.cfg version from 1.0.1 to 0.1.2 (corrected version
  numbering)
• No functional code changes to eda.py, utils.py, or init.py

use insightfulpy-v0.1.2.zip

insightfulpy-v0.1.8

Release Date: 2025-08-05

Added

• help system with four distinct help functions:
  • help() - function overview with categories
  • quick_start() - Step-by-step guide for immediate use
  • examples() - Practical usage examples for common scenarios
  • list_all() - Complete function listing organized by
    category
• function categorization:
  • BASIC_FUNCTIONS - Essential functions for getting started
  • VISUALIZATION_FUNCTIONS - Core plotting and visualization
    tools
  • ADVANCED_FUNCTIONS - Complex analysis and multi-dataset
    operations
  • STATISTICAL_FUNCTIONS - Statistical calculation utilities
• documentation with mermaid diagrams for clear visualization
  of workflows
• PyPI-optimized README with professional formatting and clear
  installation instructions

Enhanced

• Streamlined __init__.py with intuitive function organization
• Improved user experience with logical function grouping
• Professional package structure following Python packaging
  standards
• Better accessibility for users of all skill levels

Changed

• Updated package metadata for better PyPI presentation
• Refined function imports for cleaner namespace management
• Enhanced code documentation and examples
• Improved help system navigation

Technical

• Maintained backward compatibility with all existing functions
• Preserved original EDA functionality without modifications
• Updated development dependencies and build configuration
• Enhanced project structure for maintainability

use insightfulpy-v0.1.8.zip

insightfulpy-v0.1.7

Release Date: 2025-02-28

Changed

• Improved interconnected_outliers() function output format
• Modified outlier frequency reporting to show column set combinations
• Removed detailed row-by-row outlier printout

use insightfulpy-v0.1.7.zip