Skip to content

Code-2-TXT_v1.0.0.0

Choose a tag to compare

View all tags
@Mr5niper Mr5niper released this 03 Jan 09:53
· 11 commits to main since this release
Code-2-TXT_v1.0.0.0
80d616f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release Notes – Combine Text GUI (Specialized) EXE

Build Type: Windows standalone executable (PyInstaller)
Interface: GUI-only (tkinter)
CLI: None

Overview

This release packages the Combine Text GUI tool as a single Windows executable, eliminating the need for a local Python installation. The application provides a safe, dependency-aware way to combine text and script files while explicitly avoiding firmware and binary content.

Key Features

Dual Operating Modes

  • Main-File Mode

    • Select a primary script file
    • Automatically discovers and appends referenced files
    • Breadth-first traversal with strict safety limits
    • Main file is always included first

  • Folder Mode

    • Recursively combines all text-like files under a selected folder
    • Skips common build, VCS, and virtual environment directories

Safety & Filtering (Intentional Behavior)

Always-Excluded File Types

The following extensions are never included, regardless of content:

.hex, .bin,
.s19, .s28, .s37,
.srec, .mot,
.xbin,
.ihx, .ihex

Firmware Detection

Files are excluded if their contents match:

  • Intel HEX records (:10...)
  • Motorola S-Record formats (S19...)

This detection is content-based, not extension-based.

Binary Protection

Files are skipped if they:

  • Contain null bytes
  • Fail text heuristics
  • Exceed binary character thresholds

This prevents accidental inclusion of compiled objects or encoded data.

Output Format

Each included file is wrapped with clear metadata and boundaries:

===== FILE START =====
Path: relative/path/to/file
Absolute: full\absolute\path
Size: #### bytes
Encoding: detected encoding
----- BEGIN CONTENT -----
(file contents)
----- END CONTENT -----
===== FILE END =====

A manifest listing all included files (in order) is appended at the end.

Internal Limits (Hard Caps)

These limits are enforced to prevent runaway traversal:

  • Maximum referenced files: 2000
  • Maximum dependency depth: 10
  • Wildcard expansion: scoped and limited
  • Bare filename searches: capped

Packaging Notes

  • Built with PyInstaller
  • Includes embedded Python runtime
  • No external dependencies required
  • No command-line arguments supported
  • GUI-only by design to avoid path and shell issues

Known Limitations

  • No CLI mode
  • Not intended for firmware, binaries, or hex dumps
  • Dependency resolution is heuristic-based, not language-aware

Intended Use Cases

  • Codebase snapshots
  • Script dependency audits
  • AI / LLM context preparation
  • Documentation and archival
  • Reviewing automation workflows

Compatibility

  • Windows 10 / 11
  • 64-bit systems
  • No Python installation required

Disclaimer

This tool prioritizes safety, determinism, and clarity over aggressive inclusion.
If a file is excluded, it is intentional.

Use at your own risk. No warranty is implied.

Assets 4
Loading