codefile 1.0.0__py3-none-any.whl

codefile-1.0.0.dist-info/METADATA

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: codefile
+Version: 1.0.0
+Summary: A CLI tool to bundle entire projects into a single AI-friendly context file.
+Author: Anthroberc
+Keywords: ai,gemini,codefile,llm,context,prompt-engineering,bundler,devtools,chatgpt,claude
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+codefile – Python Project Packager
+
+=====================================
+What Is codefile?
+=====================================
+
+codefile is a Python package that scans your project directory
+and packs everything into a single output file named:
+
+    CodeFile
+
+It includes:
+- Project folder structure (tree view)
+- File metadata (SHA-256 ID)
+- File contents
+- Total size (in MB)
+- UTC creation timestamp
+
+This is useful for:
+- Creating project snapshots
+- Sharing full source code as one file
+- Simple archiving
+- Backup purposes
+
+
+=====================================
+Installation
+=====================================
+
+If installed from source:
+
+    pip install .
+
+installing a package:
+
+    pip install codefile
+
+
+=====================================
+How To Use
+=====================================
+
+Step 1:
+Open terminal inside your project folder.
+
+Step 2:
+Run:
+
+    codefile
+
+Step 3:
+After execution, a new file will appear:
+
+    CodeFile
+
+That file contains your full project snapshot.
+
+
+=====================================
+What Gets Packed?
+=====================================
+
+✔ All regular files in the current directory  
+✔ Subdirectories  
+✔ File contents  
+✔ Directory structure  
+
+Automatically ignored:
+- .git folder
+- The generated CodeFile
+- The package script itself
+- Patterns listed in .gitignore (if present)
+
+
+=====================================
+Output File Structure
+=====================================
+
+The generated file contains:
+
+ROOT_NAME <project_name>
+CREATED_UTC <timestamp>
+TOTAL_SIZE_MB <size>
+
+START_STRUCTURE
+<folder tree>
+END_STRUCTURE
+
+FILE_START <relative_path> <file_id>
+<file content>
+FILE_END <relative_path> <file_id>
+
+
+=====================================
+Technical Details
+=====================================
+
+- Uses SHA-256 hashing (first 12 characters as ID)
+- Reads files in chunks (memory safe)
+- Skips unreadable or broken files safely
+- Writes output using UTF-8 encoding
+- Handles errors without crashing
+
+=====================================
+Requirements
+=====================================
+
+- Python 3.8+
+- No external dependencies (uses standard library only)

codefile-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+codefile.py,sha256=haYiYlKWLakguqivigOSAzPnoI7j5SfntqNhuoW6PeY,5423
+codefile-1.0.0.dist-info/METADATA,sha256=eiZjpYNw-ZWu3i-bjmDLGf2IUY824l1KSUKy8ondudc,2457
+codefile-1.0.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+codefile-1.0.0.dist-info/entry_points.txt,sha256=gF--gx0EZLvgBvHx5-XzaCf1vu7qlYkAhSRZ8dNmPwY,43
+codefile-1.0.0.dist-info/top_level.txt,sha256=v3___6J6zX4HRyt39z6KOtx1ZIPPuoyHrRHtFW_T7Ew,9
+codefile-1.0.0.dist-info/RECORD,,

codefile-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codefile-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codefile = codefile:main

codefile-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+codefile

codefile.py

@@ -0,0 +1,144 @@
+import os
+import hashlib
+import datetime
+import fnmatch
+from pathlib import Path
+
+def main():
+    IO_CHUNK = 65536
+    OUT_NAME = "CodeFile"
+    SCRIPT_NAME = Path(__file__).name if '__file__' in globals() else "packager.py"
+
+    def get_ignore_patterns(root):
+        patterns = {OUT_NAME, SCRIPT_NAME, ".git", ".git/"}
+        gitignore = root / ".gitignore"
+        try:
+            if gitignore.is_file():
+                with gitignore.open("r", encoding="utf-8", errors="ignore") as f:
+                    for line in f:
+                        line = line.strip()
+                        if line and not line.startswith("#"):
+                            patterns.add(line)
+        except Exception as e:
+            print(f"Warning: Failed reading .gitignore: {e}")
+        return list(patterns)
+
+    def is_ignored(path, root, patterns):
+        try:
+            rel_path = path.relative_to(root).as_posix()
+            parts = rel_path.split('/')
+            for pattern in patterns:
+                clean_pattern = pattern.rstrip('/')
+                for part in parts:
+                    if fnmatch.fnmatch(part, clean_pattern):
+                        return True
+                if fnmatch.fnmatch(rel_path, pattern):
+                    return True
+        except ValueError:
+            return True  # If it fails relative resolution (e.g., weird symlink), ignore it
+        return False
+
+    def build_visual_tree(root, all_relative_paths):
+        tree = {}
+        for path_str in sorted(all_relative_paths):
+            current = tree
+            for part in path_str.split('/'):
+                current = current.setdefault(part, {})
+
+        lines = [f"{root.name}/"]
+        def walk(node, prefix=""):
+            items = sorted(node.items(), key=lambda x: (not x[1], x[0]))
+            for i, (name, children) in enumerate(items):
+                is_last = (i == len(items) - 1)
+                connector = "\\-- " if is_last else "|-- "
+                lines.append(f"{prefix}{connector}{name}{'/' if children else ''}")
+                if children:
+                    walk(children, prefix + ("    " if is_last else "|   "))
+        walk(tree)
+        return "\n".join(lines)
+
+    # 1. Resolve Environment Safely
+    try:
+        root = Path.cwd().resolve()
+    except Exception as e:
+        return print(f"Fatal Error: Cannot resolve current directory: {e}")
+    
+    if not root.is_dir(): 
+        return print(f"Fatal Error: {root} is not a valid directory.")
+
+    patterns = get_ignore_patterns(root)
+    all_rel_paths = []
+    files_to_write = []
+    total_bytes = 0
+    
+    print(f"Scanning directory: {root.name} ...")
+    
+    # 2. Safely Walk Directory
+    for dirpath, dirnames, filenames in os.walk(root):
+        try:
+            dp = Path(dirpath)
+            
+            # Instantly skip git folder traversal
+            if ".git" in dp.parts:
+                continue
+                
+            for f in filenames:
+                p = dp / f
+                try:
+                    if not p.is_file():
+                        continue
+                        
+                    rel_path = p.relative_to(root).as_posix()
+                    all_rel_paths.append(rel_path)
+                    
+                    if not is_ignored(p, root, patterns):
+                        total_bytes += p.stat().st_size
+                        files_to_write.append(p)
+                except (OSError, ValueError):
+                    continue  # Skip unreadable files or broken symlinks
+        except Exception:
+            continue
+
+    print(f"Found {len(files_to_write)} files to pack. Building structure...")
+    
+    # 3. Safely Write Output
+    try:
+        tree_str = build_visual_tree(root, all_rel_paths)
+        timestamp = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+        out_file = root / OUT_NAME
+        
+        with out_file.open("w", encoding="utf-8", errors="replace", newline='\n') as out:
+            out.write(f"ROOT_NAME {root.name}\n")
+            out.write(f"CREATED_UTC {timestamp}\n")
+            out.write(f"TOTAL_SIZE_MB {total_bytes / (1024*1024):.2f}\n\n")
+            out.write("START_STRUCTURE\n" + tree_str + "\nEND_STRUCTURE\n\n")
+
+            for f_path in files_to_write:
+                try:
+                    rel = f_path.relative_to(root).as_posix()
+                    h = hashlib.sha256()
+                    
+                    # Read 1: Hash Calculation
+                    with f_path.open("rb") as rb:
+                        while chunk := rb.read(IO_CHUNK):
+                            h.update(chunk)
+                    f_id = h.hexdigest()[:12]
+
+                    # Read 2: Content Writing
+                    out.write(f"FILE_START {rel} {f_id}\n")
+                    with f_path.open("rb") as rb:
+                        while chunk := rb.read(IO_CHUNK):
+                            out.write(chunk.decode("utf-8", errors="replace"))
+                    out.write(f"\nFILE_END {rel} {f_id}\n\n")
+                    
+                except Exception as e:
+                    print(f"Warning: Skipped reading content of {f_path.name} ({e})")
+                    continue
+
+        print(f"Success. Generated {OUT_NAME} ({total_bytes / (1024*1024):.2f} MB)")
+        
+    except Exception as e:
+        print(f"Critical Failure writing output file: {e}")
+
+if __name__ == "__main__":
+    main()