Analysis Pipeline

Every analyzer works independently, mutates the shared context, and produces isolated telemetry.

1

Character Analysis

Groups characters and compiles size counts to initialize the analysis context.

2

Theoretical Entropy

Computes default bits of entropy assuming fully independent, random characters.

3

Pattern Recognition

Runs repetition, substring, sequence, and keyboard walk checks to extract structural spans.

4

Leetspeak Mutations

Unwinds common dictionary substitutions to generate plaintext variants.

5

Dictionary Matcher

Scans original and mutated strings against the loaded wordlist dictionary.

6

Effective Entropy Estimator

Calculates mathematical penalties for detected patterns and reduces the final entropy score.

7

Scoring & Tiers

Maps final effective bits to a 0–100 score and assigns a security strength tier.

8

Crack Time Estimator

Calculates crack times across throttled/unthrottled online models and slow/fast offline hashing profiles.

9

Recommendations

Deduplicates and evaluates findings to output severity-rated user suggestions.

Password Input
Character Analysis
Theoretical Entropy
Pattern Recognition
Leetspeak Mutations
Dictionary Matcher
Effective Entropy
Scoring & Tiers
Report Dataclass

🔄 Context Mutation Lifecycle Flowchart

🔑 Input Password Initialize Context 🔬 Char & Entropy Assess pools & bounds 🔍 Pattern & Dict Find walks & runs (Leet Normalization) ⚡ Effective Entropy Overlap-safe penalties 📋 Report Score & Tiers

Design Philosophy

Why we built PassGuard from the ground up rather than wrapping external libraries.

Pipeline Transparency

Monolithic estimators hide intermediate outputs. PassGuard details context modifications at each step, allowing you to debug exact character penalties.

Zero Dependencies

Built completely in standard Python with no required external dependencies, allowing trivial inclusion in lightweight environments.

Composition over Monoliths

Allows replacing individual stages easily without restructuring the core context orchestration class.