ghlangmock

The tool is designed to copy langbar from a closed source project to a open portfolio version of the project (Example).

This tool creates dummy files with language-appropriate extensions (e.g., .py, .js). It fills them with ASCII text so that the final byte size for each language group matches the language distribution in your source repository. You can control the total size of all generated files (e.g., to 10000 bytes) using the --total-bytes option. This allows you to accurately mock your project's language bar on GitHub.

Install

pip install -e .[dev]

Or from the repo root for local development:

pip install -U pip
pip install -e .
pip install pytest pytest-cov

Usage

ghlangmock <SOURCE_DIR> <DEST_DIR> [--seed PATH] [--random|-Random] [--total-bytes N] [--max-files-per-language K] [--min-file-bytes M] [--no-overwrite]

• SOURCE_DIR: Path to the repository to scan (respects .gitignore files).
• DEST_DIR: Path to create dummy files reflecting the language ratios.
• --seed PATH: ASCII text file whose contents are repeated into dummy files.
• --random, -Random: Use cryptographically secure random ASCII (overrides seed).
• --total-bytes N: Target total bytes in the generated directory (default: 10000).
• --max-files-per-language K: Split each language into up to K files (default: 1).
• --min-file-bytes M: Minimum file size in bytes when splitting (default: 1).
• --no-overwrite: Prevent clearing the destination directory. By default, the destination is always cleared before generation.

Example

ghlangmock . ../app_showreel

Testing

pytest

Coverage is configured to fail below 75% by default.

Notes

• Sensitive information is never read or embedded; only file sizes and extensions are considered.
• Only ASCII payloads are written to generated files.