OeditusCredo Quick Start

View Source

One-Command Installation

mix archive.install hex oeditus_credo

For CI/CD

# In your CI config
mix archive.install hex oeditus_credo --force
mix oeditus_credo --strict

Usage

# Run all OeditusCredo checks
mix oeditus_credo

# Strict mode (fail on any issues)
mix oeditus_credo --strict

# Analyze specific directory
mix oeditus_credo lib/my_app

# JSON output (for tooling integration)
mix oeditus_credo --format=json

# Show all issues (including low priority)
mix oeditus_credo --all

What It Checks

OeditusCredo automatically runs 20 specialized checks:

  1. Error Handling: Missing error handling, silent errors, swallowed exceptions
  2. Database: N+1 queries, inefficient filters, missing preloads
  3. LiveView: Unmanaged tasks, blocking operations, missing throttling
  4. Code Quality: Hardcoded values, callback hell, blocking plugs
  5. Telemetry: Missing instrumentation, recursive telemetry anti-patterns

CI/CD Examples

GitHub Actions

- run: mix archive.install hex oeditus_credo --force
- run: mix oeditus_credo --strict

GitLab CI

script:
  - mix archive.install hex oeditus_credo --force
  - mix oeditus_credo --strict

Alternative: Escript (No Mix Required)

# Download
curl -LO https://github.com/Oeditus/oeditus_credo/releases/latest/download/oeditus_credo
chmod +x oeditus_credo

# Run
./oeditus_credo

Need More Details?

  • Full documentation: README.md
  • Standalone guide: STANDALONE.md
  • Check descriptions: Run mix oeditus_credo explain ISSUE_ID