A lightweight, Python-only CLI tool that captures the elusive Maltese Python and detects hidden directories.
"It's like the Ghostbusters thing, but also not."
Capturer is a small command-line game built for educational purposes. It ships two CLI commands:
capture— validates a file by checksum and, if it matches the secretmaltese-python.png, copies the file into acagedirectory.detect— scans the current directory for hidden folders (names starting with.) and reports whether the room feels "drafty."
- No external dependencies (uses Python's standard library only).
- Two lightweight entry points:
captureanddetect. - Checksum verification with MD5.
- Automatic upward search for the project root (marked by
.gatorgrade.yml).
Clone the repository and install the package in editable mode:
git clone https://github.com/ComputationalExpression/Capturer.git
cd Capturer
pip install -e .After installation, the capture and detect commands are available in your terminal.
Provide a file for capture to inspect. If the file's MD5 checksum matches the Maltese Python, it will be captured.
capture maltese-python.pngExample outputs:
You've found the Maltese Python!
Looks like that ain't it.
Run detect in any directory to check for hidden folders.
detectExample outputs:
This room seems a bit drafty...
Nothing to see here. Might move on...
.
├── pyproject.toml # Package metadata and entry points
├── src/
│ ├── capturer/
│ │ └── main.py # capture command implementation
│ └── detect/
│ └── main.py # detect command implementation
└── README.md
This is a small educational project. Feel free to open an issue or submit a pull request if you have ideas or improvements.
No license has been assigned to this project yet. See the repository root for any future LICENSE file.
- Douglas Luman — dluman@allegheny.edu