madomeda/USAGE.md

Madomeda Usage Examples

Basic Usage

Process the current directory:

python madomeda.py

Dry Run Mode

Preview changes without modifying files:

python madomeda.py --whatif

Specify Directory

Process a specific repository:

python madomeda.py --dir /path/to/repo

Force Update

Re-process all files regardless of conformance:

python madomeda.py --force

Skip Confirmation

Automatically accept metadata discards:

python madomeda.py --no-confirm

Ignore Paths

Exclude specific paths from processing:

python madomeda.py --ignore-paths docs/archive vendor/external

Custom Template

Use a specific template:

python madomeda.py --template my-template

Example: Tag Normalization

Before:

---
Title: My Document
Tag: Python, Machine-Learning, Data Science
Summary: A comprehensive guide
---

After (regular mode):

---
title: My Document
created: '2025-10-23T17:27:16+02:00'
changed: '2025-10-23T17:27:16+02:00'
authors:
- John Doe
version: 34d2d05
tags:
- python
- machine_learning
- data_science
---

After (--add-only mode):

---
title: My Document
description: A comprehensive guide
created: '2025-10-23T17:27:16+02:00'
changed: '2025-10-23T17:27:16+02:00'
authors:
- John Doe
version: 34d2d05
tags:
- python
- machine_learning
- data_science
---

Note: In add-only mode, "Summary" becomes "description" (normalized), and all template fields are added.

Database Inspection

The SQLite database (madomeda.db) contains:

• File tracking
• Frontmatter versions
• Git commit information
• Unique tags repository

Query example:

import sqlite3
conn = sqlite3.connect('madomeda.db')
cursor = conn.cursor()
cursor.execute('SELECT tag FROM tags ORDER BY tag')
tags = [row[0] for row in cursor.fetchall()]
print(tags)

Changelog

All changes are logged to madomeda_changelog.txt:

2025-10-23 17:40:36 (commit: 34d2d054afff9f679468f2d662bf9b8eb9754b82)
  sample.md - frontmatter updated
  test.md - frontmatter updated