1
0
Fork
You've already forked reflscan
0
Scan reflection files and create a queryable database.
  • Python 97%
  • Shell 3%
2026年07月09日 18:11:07 -07:00
.flake8 Make format script 2026年01月05日 12:12:09 -08:00
.gitignore Make update script 2026年06月04日 11:38:50 -07:00
constants.py Unnecessary formatting update 2026年07月09日 18:11:07 -07:00
format.sh Make format script 2026年01月05日 12:12:09 -08:00
get_metadata.py Add metadata list 2026年07月01日 10:32:36 -07:00
README.md README fix 2025年01月22日 13:27:51 -08:00
reflscan Unnecessary formatting update 2026年07月09日 18:11:07 -07:00
reflscan.py Unnecessary formatting update 2026年07月09日 18:11:07 -07:00
requirements.txt Unnecessary formatting update 2026年07月09日 18:11:07 -07:00
test_main.py Use Black on all files 2026年01月05日 12:09:30 -08:00
update.sh Make update script 2026年06月04日 11:38:50 -07:00
utils.py Use Black on all files 2026年01月05日 12:09:30 -08:00

Reflection Scanner

Loads your reflection files into a DB and queries them by task name, outputting the data as a TSV. Also outputs a DB so you can query yourself if you want.

Reflection files

I've been using these at work for a while. The structure of my files are generally as follows:

  • Sections are the top levels. Like "Good" or "Bad" in this example. Empty sections are ignored.
    • The Good section has it's own table and compiles with categories. All other sections will be saved without any parsing beyond links.
  • Tasks are anything within a section. They are recursive and will be stored with all parent's text.
  • Categories preface tasks and are single characters. I use "M" for "Meta" or "P" for "Project work", etc. Categories are inherited by all children when applied to a parent.
  • Links in the task text will be extracted and put into their own column.
## 19690420

Whatever notes are up here. Not parsed.
### Reflection

- Good
 - Team
 - M: Ran team sync up.
 - P: Refresh Project
 - Buttons
 - D: Talked with team about how to improve buttons.
 - [Fixed broken buttons in 10.1.1](http://example.com). And another [thing](http://zombo.com).
- Bad
 - Didn't do XYZ.
- Any other sections you would want

Development

  • Create a new environment: python -m venv env.
  • Install requirements: pip3 install -r requirements.txt.
  • Use pytest: pytest
  • use coverage.py: coverage run -m pytest, coverage html