files-to-prompt concatenates selected files with their paths and separators. It is useful for preparing an AI input that you can trace back to its source. This 0.6 test checks Markdown formatting, line numbers, file selection, and failure handling. It does not send content to a model or evaluate summarization.
If the input grows to a whole repository, compare Repomix's project packing with Gitingest's repository digest, then check which files were included.
Define the text you expect to keep
Create project/README.md with Dispatch NOTE-31 leaves at 08:30. and sum.py with an addition function. Add synthetic private.txt and debug.log controls, with matching .gitignore entries. The desired input consists of the two working files, not everything in the directory.
Use a pinned version and readable output
Install 0.6 in a Python 3.12 virtual environment, then use the command below. Markdown mode adds fenced blocks; line-number mode identifies source lines. The explicit ignore rule supplements the fixture .gitignore. This example keeps the default .gitignore behavior rather than using --ignore-gitignore.
These commands use a POSIX shell. The test ran in Linux; Windows shell behavior was not tested.
python -m pip install "files-to-prompt==0.6"
files-to-prompt ./project --markdown --line-numbers --ignore private.txt > ./prompt.md
Verify the result by reading its contents
Check the paths for README.md and sum.py, the known sentence, and return a + b. Search for both excluded fixture records and confirm they are absent. Verify that the source hashes remain unchanged. A missing input should return a nonzero exit. An initial harness run used the wrong executable path; the corrected replay is stored separately.
Line numbers still need a citation check
Line numbers give you a place to verify a citation; they do not prove that a model will cite it correctly or provide a confidentiality boundary. CXML, stdin path input, and hidden-file options are documented from official v0.6 material and were not locally tested. Binary files, symlinks, and cross-platform newline behavior also remain untested. Evaluate Gitingest if you need a directory tree.
Official sources and test scope
Codex ran this synthetic-data test in a credential-free, non-root, network-disabled container. It is not a claim that the site owner tested it. Package version: 0.6; documentation snapshot: 1b234ff6dccb.