assumeless 1.0.0

An assumptions-first diagnostic tool that aims to surface dangerous hidden assumptions in code.

Assumeless

An Assumptions-First Diagnostic Tool For Python

---

Stop Guessing. Start Assuming Less.

---

Project Overview

Assumeless is a specialized static analysis tool designed to surface dangerous hidden assumptions in your code.

Unlike traditional linters that focus on style or syntax errors, Assumeless audits your codebase for semantic fragility—places where the code "assumes" success without ensuring it.

Key Goals:

• Reliability: Detect undefined behavior like silent exception swallowing.
• Security: Identify hardcoded paths, secrets, and environment dependencies.
• Integrity: Ensure documentation matches the reality of your implementation.

---

Tech Stack

Core	Analysis	Interface	Formatting
Python 3.9+	AST Visitor	Click CLI	Rich

---

CLI Showcase

Assumeless provides a suite of 10+ standardized commands for every workflow.

Scan Mode	Doctor Mode	Docs Check
assumeless scan	assumeless doctor	assumeless docs
Fast, minimal CI output	Human-readable diagnosis	Detect documentation drift

Key Commands

# Quick diagnostics for CI/CD
$ assumeless scan . --json

# Detailed human-readable report
$ assumeless doctor

# Check if README.md matches code reality
$ assumeless docs

# List all active rules
$ assumeless rules

---

Active Rules

Assumeless enforces a strict catalog of assumption checks:

ID	Name	Description
AL-ERR-01	Silent Exception	except: blocks that swallow errors silently.
AL-ERR-02	Broad Catch	except Exception: without logging re-raise.
AL-ENV-01	Direct Env Var	os.environ["KEY"] which crashes if missing.
AL-PATH-01	Hardcoded Path	Absolute file paths that break portability.
AL-PATH-08	Unclosed File	open() calls without context managers.
AL-GLOB-07	Mutable Default	Function arguments like def foo(x=[]):.
AL-DOC-XX	Docs Drift	Mismatches between docs and code.

---

License & Credits

This Project is licensed under the Apache-2.0 License.

---

Developed by Huntwter

Built with a focus on reliability, maintainability, and truth.