pystylometry 1.3.1__tar.gz

pystylometry-1.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Craig Trim
+
+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.

pystylometry-1.3.1/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.1
+Name: pystylometry
+Version: 1.3.1
+Summary: Comprehensive Python package for stylometric analysis
+License: MIT
+Keywords: stylometry,nlp,text-analysis,authorship,readability,lexical-diversity,readability-metrics
+Author: Craig Trim
+Author-email: craigtrim@gmail.com
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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 :: Information Analysis
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Dist: stylometry-ttr (>=1.0.3,<2.0.0)
+Project-URL: Homepage, https://github.com/craigtrim/pystylometry
+Project-URL: Issues, https://github.com/craigtrim/pystylometry/issues
+Project-URL: Repository, https://github.com/craigtrim/pystylometry
+Description-Content-Type: text/markdown
+
+# pystylometry
+
+[![PyPI version](https://badge.fury.io/py/pystylometry.svg)](https://badge.fury.io/py/pystylometry)
+[![Downloads](https://static.pepy.tech/badge/pystylometry)](https://pepy.tech/project/pystylometry)
+[![Downloads/Month](https://static.pepy.tech/badge/pystylometry/month)](https://pepy.tech/project/pystylometry)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-1022%20passed-brightgreen)]()
+
+Stylometric analysis and authorship attribution for Python. 50+ metrics across 11 modules, from vocabulary diversity to AI-generation detection.
+
+## Install
+
+```bash
+pip install pystylometry              # Core (lexical metrics)
+pip install pystylometry[all]         # Everything
+```
+
+## Modules
+
+| Module | Metrics | Description |
+|--------|---------|-------------|
+| [**lexical**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/lexical) | TTR, MTLD, Yule's K/I, Hapax, MATTR, VocD-D, HD-D, MSTTR, function words, word frequency | Vocabulary diversity and richness |
+| [**readability**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/readability) | Flesch, Flesch-Kincaid, SMOG, Gunning Fog, Coleman-Liau, ARI, Dale-Chall, Fry, FORCAST, Linsear Write, Powers-Sumner-Kearl | Grade-level and difficulty scoring |
+| [**syntactic**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/syntactic) | POS ratios, sentence types, parse tree depth, clausal density, passive voice, T-units, dependency distance | Sentence and parse structure (requires spaCy) |
+| [**authorship**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/authorship) | Burrows' Delta, Cosine Delta, Zeta, Kilgarriff chi-squared, MinMax, John's Delta, NCD | Author attribution and text comparison |
+| [**stylistic**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/stylistic) | Contractions, hedges, intensifiers, modals, punctuation, vocabulary overlap (Jaccard/Dice/Cosine/KL), cohesion, genre/register | Style markers and text similarity |
+| [**character**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/character) | Letter frequencies, digit/uppercase ratios, special characters, whitespace | Character-level fingerprinting |
+| [**ngrams**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/ngrams) | Word/character/POS n-grams, Shannon entropy, skipgrams | N-gram profiles and entropy |
+| [**dialect**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/dialect) | British/American classification, spelling/grammar/vocabulary markers, markedness | Regional dialect detection |
+| [**consistency**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/consistency) | Sliding-window chi-squared drift, pattern classification | Intra-document style analysis |
+| [**prosody**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/prosody) | Syllable stress, rhythm regularity | Prose rhythm (requires spaCy) |
+| [**viz**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/viz) | Timeline, scatter, report (PNG + interactive HTML) | Drift detection visualization |
+
+## Development
+
+```bash
+git clone https://github.com/craigtrim/pystylometry && cd pystylometry
+pip install -e ".[dev,all]"
+make test       # 1022 tests
+make lint       # ruff + mypy
+make all        # lint + test + build
+```
+
+## License
+
+MIT
+
+## Author
+
+Craig Trim -- craigtrim@gmail.com
+

pystylometry-1.3.1/README.md

@@ -0,0 +1,51 @@
+# pystylometry
+
+[![PyPI version](https://badge.fury.io/py/pystylometry.svg)](https://badge.fury.io/py/pystylometry)
+[![Downloads](https://static.pepy.tech/badge/pystylometry)](https://pepy.tech/project/pystylometry)
+[![Downloads/Month](https://static.pepy.tech/badge/pystylometry/month)](https://pepy.tech/project/pystylometry)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-1022%20passed-brightgreen)]()
+
+Stylometric analysis and authorship attribution for Python. 50+ metrics across 11 modules, from vocabulary diversity to AI-generation detection.
+
+## Install
+
+```bash
+pip install pystylometry              # Core (lexical metrics)
+pip install pystylometry[all]         # Everything
+```
+
+## Modules
+
+| Module | Metrics | Description |
+|--------|---------|-------------|
+| [**lexical**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/lexical) | TTR, MTLD, Yule's K/I, Hapax, MATTR, VocD-D, HD-D, MSTTR, function words, word frequency | Vocabulary diversity and richness |
+| [**readability**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/readability) | Flesch, Flesch-Kincaid, SMOG, Gunning Fog, Coleman-Liau, ARI, Dale-Chall, Fry, FORCAST, Linsear Write, Powers-Sumner-Kearl | Grade-level and difficulty scoring |
+| [**syntactic**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/syntactic) | POS ratios, sentence types, parse tree depth, clausal density, passive voice, T-units, dependency distance | Sentence and parse structure (requires spaCy) |
+| [**authorship**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/authorship) | Burrows' Delta, Cosine Delta, Zeta, Kilgarriff chi-squared, MinMax, John's Delta, NCD | Author attribution and text comparison |
+| [**stylistic**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/stylistic) | Contractions, hedges, intensifiers, modals, punctuation, vocabulary overlap (Jaccard/Dice/Cosine/KL), cohesion, genre/register | Style markers and text similarity |
+| [**character**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/character) | Letter frequencies, digit/uppercase ratios, special characters, whitespace | Character-level fingerprinting |
+| [**ngrams**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/ngrams) | Word/character/POS n-grams, Shannon entropy, skipgrams | N-gram profiles and entropy |
+| [**dialect**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/dialect) | British/American classification, spelling/grammar/vocabulary markers, markedness | Regional dialect detection |
+| [**consistency**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/consistency) | Sliding-window chi-squared drift, pattern classification | Intra-document style analysis |
+| [**prosody**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/prosody) | Syllable stress, rhythm regularity | Prose rhythm (requires spaCy) |
+| [**viz**](https://github.com/craigtrim/pystylometry/tree/master/pystylometry/viz) | Timeline, scatter, report (PNG + interactive HTML) | Drift detection visualization |
+
+## Development
+
+```bash
+git clone https://github.com/craigtrim/pystylometry && cd pystylometry
+pip install -e ".[dev,all]"
+make test       # 1022 tests
+make lint       # ruff + mypy
+make all        # lint + test + build
+```
+
+## License
+
+MIT
+
+## Author
+
+Craig Trim -- craigtrim@gmail.com

pystylometry-1.3.1/pyproject.toml

@@ -0,0 +1,116 @@
+[tool.poetry]
+name = "pystylometry"
+version = "1.3.1"
+description = "Comprehensive Python package for stylometric analysis"
+authors = ["Craig Trim <craigtrim@gmail.com>"]
+readme = "README.md"
+license = "MIT"
+packages = [{ include = "pystylometry" }]
+keywords = [
+    "stylometry",
+    "nlp",
+    "text-analysis",
+    "authorship",
+    "readability",
+    "lexical-diversity",
+    "readability-metrics",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Text Processing :: Linguistic",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Typing :: Typed",
+]
+
+[tool.poetry.scripts]
+# pystylometry-drift manuscript.txt --window-size=500 --stride=250
+pystylometry-drift = "pystylometry.cli:drift_cli"
+# pystylometry-viewer drift_analyzer.html
+pystylometry-viewer = "pystylometry.cli:viewer_cli"
+
+[tool.poetry.urls]
+Homepage = "https://github.com/craigtrim/pystylometry"
+Repository = "https://github.com/craigtrim/pystylometry"
+Issues = "https://github.com/craigtrim/pystylometry/issues"
+
+[tool.poetry.dependencies]
+python = "^3.9"
+stylometry-ttr = "^1.0.3"
+
+[tool.poetry.group.readability.dependencies]
+pronouncing = "^0.2.0"
+# spaCy added for NLP-enhanced Gunning Fog Index (PR #4)
+# Enables accurate proper noun detection (POS tagging) and inflection handling (lemmatization)
+# See: https://github.com/craigtrim/pystylometry/pull/4
+spacy = "^3.8.0"
+
+[tool.poetry.group.syntactic.dependencies]
+spacy = "^3.8.0"
+
+[tool.poetry.group.lexical.dependencies]
+# Lexical lookup tools for rare word and neologism detection
+# Used in hapax legomena analysis to distinguish:
+# - True neologisms (not in WordNet, not in BNC)
+# - Rare words (in BNC but not WordNet, or vice versa)
+# - Common words (in both lexicons)
+bnc-lookup = ">=1.3.0"
+wordnet-lookup = "*"
+
+[tool.poetry.group.viz.dependencies]
+# Visualization support for drift detection and stylometric analysis
+# Install with: pip install pystylometry[viz] or poetry install --with viz
+matplotlib = "^3.8.0"
+seaborn = "^0.13.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0"
+pytest-cov = "^4.0"
+ruff = "^0.1"
+mypy = "^1.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-v --cov=pystylometry --cov-report=term-missing"
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+ignore = []
+
+[tool.ruff.lint.per-file-ignores]
+# JSX template files contain embedded JavaScript that can't be easily line-wrapped
+"pystylometry/viz/jsx/*.py" = ["E501"]
+# Test files may have long assertions and test data
+"tests/*.py" = ["E501"]
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[[tool.mypy.overrides]]
+module = [
+    "seaborn",
+    "seaborn.*",
+    "bnc_lookup",
+    "wordnet_lookup",
+    "matplotlib.*",
+]
+ignore_missing_imports = true

pystylometry-1.3.1/pystylometry/README.md

@@ -0,0 +1,42 @@
+# pystylometry
+
+![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+Core package for stylometric analysis and authorship attribution.
+
+## Module Map
+
+| Module | Purpose | Key Functions |
+|--------|---------|---------------|
+| [`lexical/`](lexical/) | Vocabulary diversity & richness | `compute_mtld`, `compute_yule`, `compute_ttr`, `compute_hapax_ratios` |
+| [`readability/`](readability/) | Text readability scoring | `compute_flesch`, `compute_gunning_fog`, `compute_ari`, `compute_smog` |
+| [`syntactic/`](syntactic/) | Sentence & parse structure | `compute_pos_ratios`, `compute_sentence_types`, `compute_advanced_syntactic` |
+| [`authorship/`](authorship/) | Author attribution & comparison | `compute_burrows_delta`, `compute_kilgarriff`, `compute_compression_distance` |
+| [`stylistic/`](stylistic/) | Style markers & vocabulary overlap | `compute_stylistic_markers`, `compute_vocabulary_overlap`, `compute_genre_register` |
+| [`character/`](character/) | Character-level features | `compute_character_metrics` |
+| [`ngrams/`](ngrams/) | N-gram entropy & sequences | `compute_extended_ngrams`, `compute_ngram_entropy` |
+| [`dialect/`](dialect/) | Regional dialect detection | `compute_dialect` |
+| [`consistency/`](consistency/) | Intra-document drift detection | `compute_kilgarriff_drift` |
+| [`prosody/`](prosody/) | Rhythm & stress patterns | `compute_rhythm_prosody` |
+| [`viz/`](viz/) | Visualization (PNG & interactive HTML) | `plot_drift_timeline`, `export_drift_report_jsx` |
+
+## Shared Internals
+
+| File | Purpose |
+|------|---------|
+| `_types.py` | All dataclass result types (e.g. `FleschResult`, `MTLDResult`, `KilgarriffDriftResult`) |
+| `_normalize.py` | Text normalization for readability and stylometry pipelines |
+| `_utils.py` | Shared tokenization and helper functions |
+| `tokenizer.py` | Configurable tokenizer with sentence/word splitting |
+| `cli.py` | Command-line interface (`pystylometry analyze`) |
+
+## Installation Extras
+
+```
+pip install pystylometry                  # Core (lexical only)
+pip install pystylometry[readability]     # + readability
+pip install pystylometry[syntactic]       # + syntactic (requires spaCy)
+pip install pystylometry[authorship]      # + authorship attribution
+pip install pystylometry[all]             # Everything
+```

pystylometry-1.3.1/pystylometry/__init__.py

@@ -0,0 +1,247 @@
+"""
+pystylometry - Comprehensive Python package for stylometric analysis.
+
+A modular package for text analysis with lexical, readability, syntactic,
+authorship, n-gram, dialect detection, and consistency analysis metrics.
+
+Installation:
+    pip install pystylometry                    # Core (lexical only)
+    pip install pystylometry[readability]       # With readability metrics
+    pip install pystylometry[syntactic]         # With syntactic analysis
+    pip install pystylometry[authorship]        # With authorship attribution
+    pip install pystylometry[all]               # Everything
+
+Usage:
+    # Direct module imports
+    from pystylometry.lexical import compute_mtld, compute_yule
+    from pystylometry.readability import compute_flesch
+    from pystylometry.syntactic import compute_pos_ratios
+    from pystylometry.authorship import compute_burrows_delta, compute_kilgarriff
+    from pystylometry.consistency import compute_kilgarriff_drift
+    from pystylometry.dialect import compute_dialect
+
+    # Or use the unified analyze() function
+    from pystylometry import analyze
+
+    results = analyze(text, lexical=True, readability=True)
+    print(results.lexical['mtld'].mtld_average)
+    print(results.readability['flesch'].reading_ease)
+
+    # Dialect detection
+    result = compute_dialect("The colour of the programme was brilliant.")
+    print(result.dialect)  # 'british'
+    print(result.british_score)  # 0.85
+
+    # Consistency analysis (Style Drift Detector - Issue #36)
+    from pystylometry.consistency import compute_kilgarriff_drift
+
+    result = compute_kilgarriff_drift(long_document)
+    print(result.pattern)  # 'consistent', 'sudden_spike', 'suspiciously_uniform', etc.
+    print(result.pattern_confidence)
+"""
+
+from ._types import AnalysisResult
+
+# Version
+__version__ = "0.1.0"
+
+# Core exports - always available
+from . import lexical
+
+# Optional exports - may raise ImportError if dependencies not installed
+try:
+    from . import readability  # noqa: F401
+
+    _READABILITY_AVAILABLE = True
+except ImportError:
+    _READABILITY_AVAILABLE = False
+
+try:
+    from . import syntactic  # noqa: F401
+
+    _SYNTACTIC_AVAILABLE = True
+except ImportError:
+    _SYNTACTIC_AVAILABLE = False
+
+# Prosody requires pronouncing (CMU dictionary) - same dependency as readability
+try:
+    from . import prosody  # noqa: F401 - Rhythm and prosody metrics (Issue #25)
+
+    _PROSODY_AVAILABLE = True
+except ImportError:
+    _PROSODY_AVAILABLE = False
+
+# Authorship, ngrams, dialect, consistency, and stylistic use only stdlib (no external dependencies)
+from . import (
+    authorship,  # noqa: F401
+    consistency,  # noqa: F401 - Style drift detection (Issue #36)
+    dialect,  # noqa: F401
+    ngrams,  # noqa: F401
+    stylistic,  # noqa: F401 - Vocabulary overlap and similarity (Issue #21)
+)
+
+_AUTHORSHIP_AVAILABLE = True
+_NGRAMS_AVAILABLE = True
+_DIALECT_AVAILABLE = True
+_CONSISTENCY_AVAILABLE = True
+_STYLISTIC_AVAILABLE = True
+
+
+def analyze(
+    text: str,
+    lexical_metrics: bool = True,
+    readability_metrics: bool = False,
+    syntactic_metrics: bool = False,
+    authorship_metrics: bool = False,
+    ngram_metrics: bool = False,
+) -> AnalysisResult:
+    """
+    Unified interface to compute multiple stylometric metrics at once.
+
+    This is a convenience function that calls all requested metric computations
+    and returns a unified result object. Only computes metrics for which the
+    required optional dependencies are installed.
+
+    Args:
+        text: Input text to analyze
+        lexical_metrics: Compute lexical diversity metrics (default: True)
+        readability_metrics: Compute readability metrics (default: False)
+        syntactic_metrics: Compute syntactic metrics (default: False)
+        authorship_metrics: Compute authorship metrics (default: False)
+            Note: Authorship metrics typically require multiple texts for comparison.
+            This will compute features that can be used for authorship analysis.
+        ngram_metrics: Compute n-gram entropy metrics (default: False)
+
+    Returns:
+        AnalysisResult with requested metrics in nested dictionaries
+
+    Raises:
+        ImportError: If requested analysis requires uninstalled dependencies
+
+    Example:
+        >>> from pystylometry import analyze
+        >>> results = analyze(text, lexical=True, readability=True)
+        >>> print(results.lexical['mtld'].mtld_average)
+        >>> print(results.readability['flesch'].reading_ease)
+
+    Example with all metrics:
+        >>> results = analyze(text, lexical=True, readability=True,
+        ...                   syntactic=True, ngrams=True)
+        >>> print(f"MTLD: {results.lexical['mtld'].mtld_average:.2f}")
+        >>> print(f"Flesch: {results.readability['flesch'].reading_ease:.1f}")
+        >>> print(f"Noun ratio: {results.syntactic['pos'].noun_ratio:.3f}")
+        >>> print(f"Bigram entropy: {results.ngrams['word_bigram'].entropy:.3f}")
+    """
+    result = AnalysisResult(metadata={"text_length": len(text)})
+
+    # Lexical metrics (always available)
+    if lexical_metrics:
+        result.lexical = {}
+        result.lexical["ttr"] = lexical.compute_ttr(text)
+        result.lexical["mtld"] = lexical.compute_mtld(text)
+        result.lexical["yule"] = lexical.compute_yule(text)
+        result.lexical["hapax"] = lexical.compute_hapax_ratios(text)
+
+    # Readability metrics (optional dependency)
+    if readability_metrics:
+        if not _READABILITY_AVAILABLE:
+            raise ImportError(
+                "Readability metrics require optional dependencies. "
+                "Install with: pip install pystylometry[readability]"
+            )
+        # Import locally to avoid name conflict
+        from . import readability as readability_module
+
+        result.readability = {}
+        result.readability["flesch"] = readability_module.compute_flesch(text)
+        result.readability["smog"] = readability_module.compute_smog(text)
+        result.readability["gunning_fog"] = readability_module.compute_gunning_fog(text)
+        result.readability["coleman_liau"] = readability_module.compute_coleman_liau(text)
+        result.readability["ari"] = readability_module.compute_ari(text)
+
+    # Syntactic metrics (optional dependency)
+    if syntactic_metrics:
+        if not _SYNTACTIC_AVAILABLE:
+            raise ImportError(
+                "Syntactic metrics require optional dependencies. "
+                "Install with: pip install pystylometry[syntactic]"
+            )
+        # Import locally to avoid name conflict
+        from . import syntactic as syntactic_module
+
+        result.syntactic = {}
+        result.syntactic["pos"] = syntactic_module.compute_pos_ratios(text)
+        result.syntactic["sentence_stats"] = syntactic_module.compute_sentence_stats(text)
+
+    # Authorship metrics (uses stdlib only)
+    # Note: These are typically used for comparison between texts
+    # Here we just note that they're available but don't compute them
+    # since they require multiple texts as input
+    if authorship_metrics:
+        result.authorship = {
+            "note": "Authorship metrics require multiple texts for comparison. "
+            "Use pystylometry.authorship.compute_burrows_delta(text1, text2) directly."
+        }
+
+    # N-gram metrics (uses stdlib only)
+    if ngram_metrics:
+        result.ngrams = {}
+        result.ngrams["character_bigram"] = ngrams.compute_character_bigram_entropy(text)
+        result.ngrams["word_bigram"] = ngrams.compute_word_bigram_entropy(text)
+
+    return result
+
+
+# Convenient access to availability flags
+def get_available_modules() -> dict[str, bool]:
+    """
+    Get dictionary of available optional modules.
+
+    Returns:
+        Dictionary mapping module names to availability status
+
+    Example:
+        >>> from pystylometry import get_available_modules
+        >>> available = get_available_modules()
+        >>> if available['readability']:
+        ...     from pystylometry.readability import compute_flesch
+        >>> if available['consistency']:
+        ...     from pystylometry.consistency import compute_kilgarriff_drift
+    """
+    return {
+        "lexical": True,  # Always available
+        "readability": _READABILITY_AVAILABLE,
+        "syntactic": _SYNTACTIC_AVAILABLE,
+        "authorship": _AUTHORSHIP_AVAILABLE,
+        "ngrams": _NGRAMS_AVAILABLE,
+        "dialect": _DIALECT_AVAILABLE,
+        "consistency": _CONSISTENCY_AVAILABLE,  # Style drift detection (Issue #36)
+        "stylistic": _STYLISTIC_AVAILABLE,  # Vocabulary overlap (Issue #21)
+        "prosody": _PROSODY_AVAILABLE,  # Rhythm and prosody (Issue #25)
+    }
+
+
+__all__ = [
+    "__version__",
+    "analyze",
+    "get_available_modules",
+    "lexical",
+]
+
+# Conditionally add to __all__ based on availability
+if _READABILITY_AVAILABLE:
+    __all__.append("readability")
+if _SYNTACTIC_AVAILABLE:
+    __all__.append("syntactic")
+if _AUTHORSHIP_AVAILABLE:
+    __all__.append("authorship")
+if _NGRAMS_AVAILABLE:
+    __all__.append("ngrams")
+if _DIALECT_AVAILABLE:
+    __all__.append("dialect")
+if _CONSISTENCY_AVAILABLE:
+    __all__.append("consistency")
+if _STYLISTIC_AVAILABLE:
+    __all__.append("stylistic")
+if _PROSODY_AVAILABLE:
+    __all__.append("prosody")