Python Architectural Analyzer (Decomplect)

概要

Decomplect-py provides deep architectural insights into Python codebases by evaluating them against rigorous design standards like Rich Hickey’s simplicity principles and Gary Bernhardt’s Functional Core/Imperative Shell (FCIS) pattern. It helps developers disentangle complex logic, detect high coupling between modules, and identify Python-specific anti-patterns such as mutable default arguments or circular imports. Ideal for design reviews and pre-refactoring assessments, this skill ensures your Python architecture remains scalable, testable, and maintainable by identifying exactly where concerns have become 'complected'.

主な機能

• 6 GitHub stars
• Simplicity analysis based on Rich Hickey’s philosophy of separating concerns.
• Analysis of immutable data patterns using frozen dataclasses and NamedTuples.
• Functional Core/Imperative Shell (FCIS) verification to isolate pure logic from I/O.
• Module coupling and cohesion evaluation using Constantine & Yourdon metrics.
• Detection of Python-specific anti-patterns like mutable default arguments and circular imports.

ユースケース

• Assessing design quality during code reviews to prevent technical debt accumulation.
• Validating the separation of business logic from framework-specific I/O in Django or Flask.
• Performing architectural audits before major refactoring or system migrations.