code-to-txt 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

code_to_txt/cli.py

@@ -1,6 +1,11 @@
-import click
+from datetime import datetime
 from pathlib import Path
+
+import click
+import pyperclip
+
 from .code_to_txt import CodeToText
+from .config import create_default_config, load_config
 
 
 @click.command()
@@ -8,15 +13,15 @@ from .code_to_txt import CodeToText
 @click.option(
     "-o",
     "--output",
-    default="code_output.txt",
-    help="Output file path",
+    default=None,
+    help="Output file path (default: codetotxt_YYYYMMDD_HHMMSS.txt)",
     type=click.Path(),
 )
 @click.option(
     "-e",
     "--extensions",
-    multiple=True,
-    help="File extensions to include (e.g., .py .js). Can be specified multiple times.",
+    default=None,
+    help="File extensions to include. Space-separated list (e.g., '.py .js .ts') or comma-separated (e.g., '.py,.js,.ts')",
 )
 @click.option(
     "-x",
@@ -24,6 +29,12 @@ from .code_to_txt import CodeToText
     multiple=True,
     help="Patterns to exclude (gitignore style). Can be specified multiple times.",
 )
+@click.option(
+    "-g",
+    "--glob",
+    multiple=True,
+    help="Glob patterns to include (e.g., '*.py' 'src/**/*.js'). Can be specified multiple times.",
+)
 @click.option(
     "--no-gitignore",
     is_flag=True,
@@ -39,7 +50,48 @@ from .code_to_txt import CodeToText
     default="=" * 80,
     help="Separator between files",
 )
-def main(path, output, extensions, exclude, no_gitignore, no_tree, separator):
+@click.option(
+    "--clipboard",
+    "-c",
+    is_flag=True,
+    help="Copy output to clipboard in addition to saving to file",
+)
+@click.option(
+    "--clipboard-only",
+    is_flag=True,
+    help="Copy output to clipboard only (don't save to file)",
+)
+@click.option(
+    "--config",
+    type=click.Path(exists=True),
+    help="Path to config file (.yml or .yaml)",
+)
+@click.option(
+    "--init-config",
+    is_flag=True,
+    help="Create default configuration file (.code-to-txt.yml)",
+)
+@click.option(
+    "--timestamp",
+    "-t",
+    is_flag=True,
+    help="Add timestamp to output filename",
+)
+def main(
+    path: str,
+    output: str | None,
+    extensions: str | None,
+    exclude: tuple[str, ...],
+    glob: tuple[str, ...],
+    no_gitignore: bool,
+    no_tree: bool,
+    separator: str,
+    clipboard: bool,
+    clipboard_only: bool,
+    config: str | None,
+    init_config: bool,
+    timestamp: bool,
+) -> None:
     """
     Convert code files to a single text file for easy LLM consumption.
 
@@ -47,45 +99,126 @@ def main(path, output, extensions, exclude, no_gitignore, no_tree, separator):
 
     Examples:
 
-        # Convert all code files in current directory
-        code-to-txt
+        # Convert all code files in current directory with timestamp
+        code-to-txt -t
 
         # Convert specific directory to custom output
         code-to-txt ./my-project -o project.txt
 
-        # Only include Python and JavaScript files
-        code-to-txt -e .py -e .js
+        # Include Python, C, and header files (space or comma separated)
+        code-to-txt -e ".py .c .h"
+        code-to-txt -e ".py,.c,.h"
+
+        # Use glob patterns
+        code-to-txt -g "*.py" -g "src/**/*.js"
 
         # Exclude test files
         code-to-txt -x "tests/*" -x "*.test.js"
 
-        # Don't use .gitignore and don't show tree
-        code-to-txt --no-gitignore --no-tree
+        # Copy to clipboard
+        code-to-txt --clipboard
+
+        # Copy to clipboard only (no file)
+        code-to-txt --clipboard-only
+
+        # Create default config file
+        code-to-txt --init-config
+
+        # Use config file
+        code-to-txt --config .code-to-txt.yml
     """
+    if init_config:
+        config_path = Path(".code-to-txt.yml")
+        if config_path.exists():
+            click.confirm(
+                f"Config file {config_path} already exists. Overwrite?",
+                abort=True,
+            )
+        create_default_config(config_path)
+        click.echo(f"Created default config file: {config_path}")
+        click.echo("You can now edit this file and use it with --config flag")
+        return
+
+    config_data = {}
+    if config:
+        config_data = load_config(config)
+        click.echo(f"Using config file: {config}")
+
+    output = output or config_data.get("output")
+    extensions = extensions or config_data.get("extensions")
+    exclude = exclude or config_data.get("exclude", [])
+    glob_patterns = glob or config_data.get("glob", [])
+    no_gitignore = no_gitignore or config_data.get("no_gitignore", False)
+    no_tree = no_tree or config_data.get("no_tree", False)
+    separator = separator if separator == "=" * 80 else separator
+    separator = config_data.get("separator", separator)
+    clipboard = clipboard or config_data.get("clipboard", False)
+    clipboard_only = clipboard_only or config_data.get("clipboard_only", False)
+    timestamp = timestamp or config_data.get("timestamp", False)
+
+    if not output or timestamp:
+        timestamp_str = datetime.now().strftime("%Y%m%d_%H%M%S")
+        if output:
+            output_path = Path(output)
+            stem = output_path.stem
+            suffix = output_path.suffix or ".txt"
+            output = str(output_path.parent / f"{stem}_{timestamp_str}{suffix}")
+        else:
+            output = f"codetotxt_{timestamp_str}.txt"
+
     click.echo(f"Scanning: {path}")
 
-    include_extensions = set(extensions) if extensions else None
+    include_extensions = None
+    if extensions:
+        if "," in extensions:
+            ext_list = [e.strip() for e in extensions.split(",")]
+        else:
+            ext_list = extensions.split()
+
+        include_extensions = set()
+        for ext in ext_list:
+            ext = ext.strip()
+            if ext and not ext.startswith("."):
+                ext = "." + ext
+            if ext:
+                include_extensions.add(ext)
 
     codetotxt = CodeToText(
         root_path=path,
-        output_file=output,
+        output_file=output if not clipboard_only else None,
         include_extensions=include_extensions,
         exclude_patterns=list(exclude),
+        glob_patterns=list(glob_patterns),
         gitignore=not no_gitignore,
     )
 
     try:
-        num_files = codetotxt.convert(
-            add_tree=not no_tree,
-            separator=separator,
-        )
-
-        output_path = Path(output).resolve()
-        click.echo(f"Successfully processed {num_files} files")
-        click.echo(f"Output saved to: {output_path}")
-
-        size_kb = output_path.stat().st_size / 1024
-        click.echo(f"File size: {size_kb:.2f} KB")
+        if clipboard_only:
+            content = codetotxt.generate_content(
+                add_tree=not no_tree,
+                separator=separator,
+            )
+            pyperclip.copy(content)
+            click.echo("Content copied to clipboard")
+            click.echo(f"Processed {codetotxt.file_count} files")
+            click.echo(f"Content size: {len(content) / 1024:.2f} KB")
+        else:
+            num_files = codetotxt.convert(
+                add_tree=not no_tree,
+                separator=separator,
+            )
+
+            output_path = Path(output).resolve()
+            click.echo(f"Successfully processed {num_files} files")
+            click.echo(f"Output saved to: {output_path}")
+
+            size_kb = output_path.stat().st_size / 1024
+            click.echo(f"File size: {size_kb:.2f} KB")
+
+            if clipboard:
+                content = output_path.read_text(encoding="utf-8")
+                pyperclip.copy(content)
+                click.echo("Content also copied to clipboard")
 
     except Exception as e:
         click.echo(f"Error: {e}", err=True)

code_to_txt/code_to_txt.py

@@ -1,7 +1,10 @@
 import os
+from fnmatch import fnmatch
 from pathlib import Path
-from typing import List, Optional, Set
+from typing import Any
+
 import pathspec
+from pathspec import PathSpec
 
 
 class CodeToText:
@@ -9,19 +12,43 @@ class CodeToText:
         "__pycache__",
         "*.pyc",
         "*.pyo",
-        "*.pyd"
+        "*.pyd",
+        ".git",
+        ".svn",
+        ".hg",
+        "node_modules",
+        ".venv",
+        "venv",
+        ".env",
+        "*.egg-info",
+        "dist",
+        "build",
+        ".pytest_cache",
+        ".mypy_cache",
+        ".ruff_cache",
+        "*.so",
+        "*.dylib",
+        "*.dll",
     }
 
     DEFAULT_EXTENSIONS = {
-        ".py", ".js", ".ts", ".jsx", ".tsx", ".java", ".c", ".cpp", ".h"
+        ".py", ".js", ".ts", ".jsx", ".tsx",
+        ".java", ".c", ".cpp", ".h", ".hpp",
+        ".cs", ".go", ".rs", ".rb", ".php",
+        ".swift", ".kt", ".scala", ".r",
+        ".sql", ".sh", ".bash", ".zsh",
+        ".yaml", ".yml", ".json", ".toml",
+        ".xml", ".html", ".css", ".scss",
+        ".md", ".txt", ".rst",
     }
 
     def __init__(
             self,
             root_path: str,
-            output_file: str = "output.txt",
-            include_extensions: Optional[Set[str]] = None,
-            exclude_patterns: Optional[List[str]] = None,
+            output_file: str | None = "output.txt",
+            include_extensions: set[str] | None = None,
+            exclude_patterns: list[str] | None = None,
+            glob_patterns: list[str] | None = None,
             gitignore: bool = True,
     ):
         """
@@ -29,28 +56,31 @@ class CodeToText:
 
         Args:
             root_path: Root directory to scan
-            output_file: Output file path
+            output_file: Output file path (None for clipboard-only mode)
             include_extensions: Set of file extensions to include (with dots)
             exclude_patterns: List of patterns to exclude (gitignore style)
+            glob_patterns: List of glob patterns to include (e.g., '*.py', 'src/**/*.js')
             gitignore: Whether to respect .gitignore files
         """
         self.root_path = Path(root_path).resolve()
         self.output_file = output_file
         self.include_extensions = include_extensions or self.DEFAULT_EXTENSIONS
         self.exclude_patterns = exclude_patterns or []
+        self.glob_patterns = glob_patterns or []
         self.gitignore = gitignore
-        self.spec = None
+        self.spec: PathSpec | None = None
+        self.file_count = 0
 
         if self.gitignore:
             self._load_gitignore()
 
-    def _load_gitignore(self):
+    def _load_gitignore(self) -> None:
         """Load .gitignore patterns if present."""
         gitignore_path = self.root_path / ".gitignore"
         patterns = list(self.DEFAULT_IGNORE)
 
         if gitignore_path.exists():
-            with open(gitignore_path, "r") as f:
+            with open(gitignore_path, encoding="utf-8") as f:
                 for line in f:
                     line = line.strip()
                     if line and not line.startswith("#"):
@@ -59,11 +89,30 @@ class CodeToText:
         patterns.extend(self.exclude_patterns)
         self.spec = pathspec.PathSpec.from_lines("gitignore", patterns)
 
+    def _matches_glob_pattern(self, file_path: Path) -> bool:
+        """Check if file matches any glob pattern."""
+        if not self.glob_patterns:
+            return False
+
+        relative_path = file_path.relative_to(self.root_path)
+        relative_str = str(relative_path)
+
+        for pattern in self.glob_patterns:
+            if fnmatch(relative_str, pattern):
+                return True
+            if fnmatch(file_path.name, pattern):
+                return True
+
+        return False
+
     def _should_include_file(self, file_path: Path) -> bool:
         """Check if a file should be included."""
-        # Check extension
-        if file_path.suffix not in self.include_extensions:
-            return False
+        if self.glob_patterns:
+            if not self._matches_glob_pattern(file_path):
+                return False
+        else:
+            if file_path.suffix not in self.include_extensions:
+                return False
 
         if self.spec:
             relative_path = file_path.relative_to(self.root_path)
@@ -72,7 +121,7 @@ class CodeToText:
 
         return True
 
-    def _get_files(self) -> List[Path]:
+    def _get_files(self) -> list[Path]:
         """Get all files to process."""
         files = []
         for root, dirs, filenames in os.walk(self.root_path):
@@ -92,55 +141,85 @@ class CodeToText:
 
         return sorted(files)
 
-    def convert(self, add_tree: bool = True, separator: str = "=" * 80) -> int:
+    def generate_content(self, add_tree: bool = True, separator: str = "=" * 80) -> str:
         """
-        Convert files to single text file.
+        Generate content as string (for clipboard).
 
         Args:
             add_tree: Whether to add directory tree at the beginning
             separator: Separator between files
 
         Returns:
-            Number of files processed
+            Generated content as string
         """
         files = self._get_files()
+        self.file_count = len(files)
+
+        lines = []
+        lines.append(f"Code Export from: {self.root_path}")
+        lines.append(f"Total files: {len(files)}")
+        lines.append(separator)
+        lines.append("")
+
+        if add_tree:
+            lines.append("DIRECTORY TREE:")
+            lines.append(separator)
+            lines.append(self._generate_tree())
+            lines.append("")
+            lines.append(separator)
+            lines.append("")
+
+        for i, file_path in enumerate(files, 1):
+            relative_path = file_path.relative_to(self.root_path)
 
-        with open(self.output_file, "w", encoding="utf-8") as out:
-            out.write(f"Code Export from: {self.root_path}\n")
-            out.write(f"Total files: {len(files)}\n")
-            out.write(f"{separator}\n\n")
+            lines.append(f"FILE {i}/{len(files)}: {relative_path}")
+            lines.append(separator)
 
-            if add_tree:
-                out.write("DIRECTORY TREE:\n")
-                out.write(separator + "\n")
-                out.write(self._generate_tree())
-                out.write(f"\n{separator}\n\n")
+            try:
+                with open(file_path, encoding="utf-8") as f:
+                    content = f.read()
+                lines.append(content)
+            except UnicodeDecodeError:
+                lines.append("[Binary file - skipped]")
+            except Exception as e:
+                lines.append(f"[Error reading file: {e}]")
 
-            for i, file_path in enumerate(files, 1):
-                relative_path = file_path.relative_to(self.root_path)
+            lines.append("")
+            lines.append(separator)
+            lines.append("")
 
-                out.write(f"FILE {i}/{len(files)}: {relative_path}\n")
-                out.write(separator + "\n")
+        return "\n".join(lines)
 
-                try:
-                    with open(file_path, "r", encoding="utf-8") as f:
-                        content = f.read()
-                    out.write(content)
-                except UnicodeDecodeError:
-                    out.write(f"[Binary file - skipped]\n")
-                except Exception as e:
-                    out.write(f"[Error reading file: {e}]\n")
+    def convert(self, add_tree: bool = True, separator: str = "=" * 80) -> int:
+        """
+        Convert files to single text file.
+
+        Args:
+            add_tree: Whether to add directory tree at the beginning
+            separator: Separator between files
 
-                out.write(f"\n{separator}\n\n")
+        Returns:
+            Number of files processed
+        """
+        if not self.output_file:
+            raise ValueError("output_file must be specified for convert()")
 
-        return len(files)
+        content = self.generate_content(add_tree=add_tree, separator=separator)
+
+        with open(self.output_file, "w", encoding="utf-8") as out:
+            out.write(content)
+
+        return self.file_count
 
     def _generate_tree(self) -> str:
         """Generate a directory tree representation."""
         tree_lines = []
         files = self._get_files()
 
-        dir_structure = {}
+        if not files:
+            return "(no files to display)"
+
+        dir_structure: dict[str, Any] = {}
         for file_path in files:
             relative_path = file_path.relative_to(self.root_path)
             parts = relative_path.parts
@@ -155,7 +234,7 @@ class CodeToText:
                 current["__files__"] = []
             current["__files__"].append(parts[-1])
 
-        def print_tree(structure, prefix="", is_last=True):
+        def print_tree(structure: dict[str, Any], prefix: str = "", is_last: bool = True) -> None:
             items = []
             for key in sorted(structure.keys()):
                 if key != "__files__":

code_to_txt/config.py

@@ -0,0 +1,161 @@
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+DEFAULT_CONFIG = {
+    "output": "code_output.txt",
+    "extensions": None,  # None means use defaults
+    "exclude": [
+        "tests/*",
+        "*.test.js",
+        "*.test.ts",
+        "*.spec.js",
+        "*.spec.ts",
+    ],
+    "glob": [],  # e.g., ["*.py", "src/**/*.js"]
+    "no_gitignore": False,
+    "no_tree": False,
+    "separator": "=" * 80,
+    "clipboard": False,
+    "clipboard_only": False,
+    "timestamp": False,
+}
+
+
+def load_config(config_path: str) -> dict[str, Any]:
+    """
+    Load configuration from YAML file.
+
+    Args:
+        config_path: Path to the configuration file
+
+    Returns:
+        Dictionary with configuration values
+    """
+    path = Path(config_path)
+
+    if not path.exists():
+        raise FileNotFoundError(f"Config file not found: {config_path}")
+
+    with open(path, encoding="utf-8") as f:
+        config = yaml.safe_load(f)
+
+    if config is None:
+        config = {}
+
+    validated_config: dict[str, Any] = {}
+
+    if "output" in config:
+        validated_config["output"] = str(config["output"])
+
+    if "separator" in config:
+        validated_config["separator"] = str(config["separator"])
+
+    if "extensions" in config:
+        ext = config["extensions"]
+        if isinstance(ext, str):
+            validated_config["extensions"] = ext
+        elif isinstance(ext, list):
+            validated_config["extensions"] = " ".join(str(e) for e in ext)
+        elif ext is not None:
+            validated_config["extensions"] = str(ext)
+
+    for field in ["exclude", "glob"]:
+        if field in config:
+            value = config[field]
+            if isinstance(value, list):
+                validated_config[field] = value
+            elif isinstance(value, str):
+                validated_config[field] = [value]
+            elif value is not None:
+                validated_config[field] = [str(value)]
+
+    for field in ["no_gitignore", "no_tree", "clipboard", "clipboard_only", "timestamp"]:
+        if field in config:
+            validated_config[field] = bool(config[field])
+
+    return validated_config
+
+
+def create_default_config(config_path: Path) -> None:
+    """
+    Create a default configuration file.
+
+    Args:
+        config_path: Path where to create the config file
+    """
+    config_content = """# Code-to-Txt Configuration File
+# This file defines default settings for code-to-txt
+# CLI arguments will override these settings
+
+# Output file name (supports strftime formatting)
+# Use timestamp: true to automatically add timestamp
+output: code_output.txt
+
+# File extensions to include
+# Can be a list or space/comma-separated string
+# Leave as null to use default extensions
+# extensions: [.py, .js, .ts]
+# extensions: ".py .js .ts"
+extensions: null
+
+# Patterns to exclude (gitignore-style)
+# These are in addition to .gitignore patterns
+exclude:
+  - "tests/*"
+  - "*.test.js"
+  - "*.test.ts"
+  - "*.spec.js"
+  - "*.spec.ts"
+  - "node_modules/*"
+  - "__pycache__/*"
+  - "*.pyc"
+
+# Glob patterns to include (alternative to extensions)
+# If specified, only files matching these patterns will be included
+# glob:
+#   - "*.py"
+#   - "src/**/*.js"
+#   - "**/*.tsx"
+glob: []
+
+# Ignore .gitignore files
+no_gitignore: false
+
+# Don't include directory tree in output
+no_tree: false
+
+# Separator between files
+separator: "================================================================================"
+
+# Copy output to clipboard
+clipboard: false
+
+# Copy to clipboard only (don't save file)
+clipboard_only: false
+
+# Add timestamp to output filename
+timestamp: false
+
+# Example configurations:
+#
+# For Python projects:
+# extensions: [.py]
+# exclude: ["tests/*", "*.pyc", "__pycache__/*", "venv/*"]
+#
+# For JavaScript/TypeScript projects:
+# extensions: [.js, .ts, .jsx, .tsx]
+# exclude: ["node_modules/*", "dist/*", "build/*", "*.test.js"]
+#
+# For C/C++ projects:
+# extensions: [.c, .cpp, .h, .hpp]
+# exclude: ["build/*", "*.o", "*.a"]
+#
+# Using glob patterns:
+# glob: ["src/**/*.py", "lib/**/*.py", "*.md"]
+# extensions: null
+"""
+
+    with open(config_path, "w", encoding="utf-8") as f:
+        f.write(config_content)

code_to_txt-0.2.0.dist-info/METADATA

@@ -0,0 +1,440 @@
+Metadata-Version: 2.4
+Name: code-to-txt
+Version: 0.2.0
+Summary: Convert code files to a single text file for LLM consumption
+License: MIT
+License-File: LICENSE
+Author: Andrii Sonsiadlo
+Author-email: andrii.sonsiadlo@gmail.com
+Requires-Python: >=3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: click (>=8.3.1,<9.0.0)
+Requires-Dist: gitpython (>=3.1.46,<4.0.0)
+Requires-Dist: pathspec (>=1.0.4,<2.0.0)
+Requires-Dist: pyperclip (>=1.8.2,<2.0.0)
+Requires-Dist: pyyaml (>=6.0.0,<7.0.0)
+Description-Content-Type: text/markdown
+
+# CodeToTxt
+
+A powerful Python package to convert code files into a single text file, perfect for feeding into Large Language
+Models (LLMs) or for easy code review and documentation.
+
+## Features
+
+✨ **New in v0.2.0:**
+
+- 🕐 **Automatic timestamps** in output filenames
+- 📋 **Clipboard support** - copy output directly to clipboard
+- 🎯 **Better extension handling** - specify multiple extensions without repeating `-e` flag
+- 🔍 **Glob pattern support** - use patterns like `*.py` or `src/**/*.js`
+- ⚙️ **Configuration file support** - save your preferences in `.code-to-txt.yml`
+- 🚀 **Enhanced defaults** - more file types and ignore patterns out of the box
+
+**Core Features:**
+
+- 📁 Convert entire directories of code into a single text file
+- 🌳 Optional directory tree visualization
+- 🚫 Respects `.gitignore` patterns automatically
+- 🎨 Customizable file separators and output format
+- 🔧 Flexible file filtering by extension or glob patterns
+- 📦 Easy to use CLI and Python API
+
+## Installation
+
+```bash
+pip install code-to-txt
+```
+
+Or with Poetry:
+
+```bash
+poetry add code-to-txt
+```
+
+## Quick Start
+
+### Basic Usage
+
+```bash
+# Convert all code files in current directory with timestamp
+code-to-txt -t
+
+# Convert specific directory
+code-to-txt ./my-project -o project.txt
+
+# Copy to clipboard instead of saving
+code-to-txt --clipboard-only
+```
+
+### Specify File Types
+
+```bash
+# Multiple extensions (space or comma separated)
+code-to-txt -e ".py .js .ts"
+code-to-txt -e ".py,.js,.ts"
+
+# Using glob patterns
+code-to-txt -g "*.py" -g "src/**/*.js"
+code-to-txt -g "*.py" -g "*.md"
+```
+
+### Advanced Usage
+
+```bash
+# Exclude patterns
+code-to-txt -x "tests/*" -x "*.test.js"
+
+# Don't use .gitignore
+code-to-txt --no-gitignore
+
+# Don't show directory tree
+code-to-txt --no-tree
+
+# Custom separator
+code-to-txt --separator "---"
+
+# Combine options
+code-to-txt -t -c -e ".py .js" -x "tests/*"
+```
+
+## Configuration File
+
+Create a default configuration file:
+
+```bash
+code-to-txt --init-config
+```
+
+This creates `.code-to-txt.yml` with default settings:
+
+```yaml
+# Output file name
+output: codetotxt.txt
+
+# File extensions to include (null = use defaults)
+extensions: null
+
+# Patterns to exclude
+exclude:
+  - "tests/*"
+  - "*.test.js"
+  - "node_modules/*"
+
+# Glob patterns (alternative to extensions)
+glob: [ ]
+
+# Options
+no_gitignore: false
+no_tree: false
+separator: "================"
+clipboard: false
+clipboard_only: false
+timestamp: false
+```
+
+Use the config file:
+
+```bash
+code-to-txt --config .code-to-txt.yml
+```
+
+**Note:** CLI arguments override config file settings.
+
+### Example Configurations
+
+**Python Project:**
+
+```yaml
+extensions: [ .py ]
+exclude: [ "tests/*", "*.pyc", "__pycache__/*", "venv/*", ".venv/*" ]
+timestamp: true
+```
+
+**JavaScript/TypeScript Project:**
+
+```yaml
+extensions: [ .js, .ts, .jsx, .tsx ]
+exclude: [ "node_modules/*", "dist/*", "build/*", "*.test.js", "*.spec.ts" ]
+no_tree: false
+```
+
+**C/C++ Project:**
+
+```yaml
+extensions: [ .c, .cpp, .h, .hpp ]
+exclude: [ "build/*", "*.o", "*.a", "cmake-build-*" ]
+```
+
+**Using Glob Patterns:**
+
+```yaml
+glob: [ "src/**/*.py", "lib/**/*.py", "*.md" ]
+extensions: null  # Ignore extensions when using glob
+```
+
+## Command Line Options
+
+```
+Usage: code-to-txt [OPTIONS] [PATH]
+
+Arguments:
+  PATH                    Directory to scan (default: current directory)
+
+Options:
+  -o, --output PATH       Output file path (default: codetotxt_YYYYMMDD_HHMMSS.txt)
+  -e, --extensions TEXT   File extensions to include (space or comma separated)
+  -x, --exclude TEXT      Patterns to exclude (can be used multiple times)
+  -g, --glob TEXT         Glob patterns to include (can be used multiple times)
+  --no-gitignore          Don't respect .gitignore files
+  --no-tree               Don't include directory tree in output
+  --separator TEXT        Separator between files (default: ====...)
+  -c, --clipboard         Copy output to clipboard in addition to file
+  --clipboard-only        Copy to clipboard only (don't save file)
+  --config PATH           Path to config file (.yml or .yaml)
+  --init-config           Create default configuration file
+  -t, --timestamp         Add timestamp to output filename
+  --help                  Show this message and exit
+```
+
+## Python API
+
+### Basic Usage
+
+```python
+from code_to_txt import CodeToText
+
+# Create instance
+code_to_text = CodeToText(
+    root_path="./my-project",
+    output_file="output.txt",
+    include_extensions={".py", ".js"},
+)
+
+# Convert to file
+num_files = code_to_text.convert(add_tree=True)
+print(f"Processed {num_files} files")
+```
+
+### Generate Content for Clipboard
+
+```python
+from code_to_txt import CodeToText
+
+# Generate content without writing to file
+code_to_text = CodeToText(
+    root_path="./my-project",
+    output_file=None,  # No file needed
+    include_extensions={".py"},
+)
+
+content = code_to_text.generate_content(add_tree=True)
+print(f"Generated {len(content)} characters")
+
+# Copy to clipboard using pyperclip
+import pyperclip
+
+pyperclip.copy(content)
+```
+
+### Using Glob Patterns
+
+```python
+from code_to_txt import CodeToText
+
+code_to_text = CodeToText(
+    root_path="./my-project",
+    output_file="output.txt",
+    glob_patterns=["*.py", "src/**/*.js", "**/*.md"],
+)
+
+num_files = code_to_text.convert()
+```
+
+### Advanced Configuration
+
+```python
+from code_to_txt import CodeToText
+
+code_to_text = CodeToText(
+    root_path="./my-project",
+    output_file="detailed_output.txt",
+    include_extensions={".py", ".js", ".ts"},
+    exclude_patterns=["tests/*", "*.test.js", "node_modules/*"],
+    gitignore=True,  # Respect .gitignore (default)
+)
+
+num_files = code_to_text.convert(
+    add_tree=True,
+    separator="=" * 100,
+)
+```
+
+## Default File Extensions
+
+When no extensions are specified, CodeToTxt includes these file types by default:
+
+- **Python:** `.py`
+- **JavaScript/TypeScript:** `.js`, `.ts`, `.jsx`, `.tsx`
+- **Systems:** `.c`, `.cpp`, `.h`, `.hpp`, `.java`, `.cs`, `.go`, `.rs`
+- **Web:** `.html`, `.css`, `.scss`
+- **Config:** `.yaml`, `.yml`, `.json`, `.toml`, `.xml`
+- **Documentation:** `.md`, `.txt`, `.rst`
+- **Scripts:** `.sh`, `.bash`, `.zsh`
+- **Other:** `.rb`, `.php`, `.swift`, `.kt`, `.scala`, `.r`, `.sql`
+
+## Default Ignore Patterns
+
+CodeToTxt automatically ignores common build artifacts and dependencies:
+
+- `__pycache__`, `*.pyc`, `*.pyo`, `*.pyd`
+- `.git`, `.svn`, `.hg`
+- `node_modules`
+- `.venv`, `venv`, `.env`
+- `*.egg-info`, `dist`, `build`
+- `.pytest_cache`, `.mypy_cache`, `.ruff_cache`
+- `*.so`, `*.dylib`, `*.dll`
+
+Plus any patterns in your `.gitignore` file.
+
+## Output Format
+
+The generated file includes:
+
+1. **Header:** Source directory and file count
+2. **Directory Tree:** Visual representation of the file structure (optional)
+3. **File Contents:** Each file with its relative path and content
+
+Example output:
+
+```
+Code Export from: /path/to/project
+Total files: 4
+================================================================================
+
+DIRECTORY TREE:
+================================================================================
+my-project/
+├── src/
+│   ├── main.py
+│   └── utils.py
+├── tests/
+│   └── test_main.py
+└── README.md
+
+================================================================================
+
+FILE 1/4: src/main.py
+================================================================================
+def main():
+    print("Hello, World!")
+
+if __name__ == "__main__":
+    main()
+
+================================================================================
+...
+```
+
+## Use Cases
+
+- 📚 **Code Review:** Share entire codebase in a single file
+- 🤖 **LLM Input:** Feed code to ChatGPT, Claude, or other AI assistants
+- 📖 **Documentation:** Create comprehensive code documentation
+- 🔍 **Code Search:** Easy text-based search across entire project
+- 📊 **Analysis:** Input for code analysis tools
+- 💾 **Archival:** Simple code backup format
+
+## Tips & Tricks
+
+### For Large Projects
+
+```bash
+# Use specific extensions to reduce size
+code-to-txt -e ".py" -t
+
+# Exclude heavy directories
+code-to-txt -x "node_modules/*" -x "venv/*" -x "dist/*"
+```
+
+### For LLM Consumption
+
+```bash
+# Copy directly to clipboard for pasting into ChatGPT/Claude
+code-to-txt --clipboard-only -e ".py .md"
+
+# Or save and copy
+code-to-txt -t -c -e ".py .js"
+```
+
+### For Specific Features
+
+```bash
+# Only include source files, exclude tests
+code-to-txt -g "src/**/*.py" -g "lib/**/*.py"
+
+# Only documentation
+code-to-txt -e ".md .rst .txt"
+```
+
+## Requirements
+
+- Python 3.10+
+- Dependencies: `click`, `gitpython`, `pathspec`, `pyperclip`, `pyyaml`
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/AndriiSonsiadlo/code-to-txt.git
+cd code-to-txt
+
+# Install with Poetry
+poetry install
+
+# Run tests
+poetry run pytest
+
+# Run linting
+poetry run ruff check .
+poetry run mypy src/
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Changelog
+
+### v0.2.0
+
+- ✨ Added automatic timestamp generation for output files
+- 📋 Added clipboard support (`--clipboard` and `--clipboard-only`)
+- 🎯 Improved extension handling (space/comma separated)
+- 🔍 Added glob pattern support
+- ⚙️ Added configuration file support (`.code-to-txt.yml`)
+- 🚀 Expanded default file extensions and ignore patterns
+- 🐛 Various bug fixes and improvements
+
+### v0.1.0
+
+- 🎉 Initial release
+- 📁 Basic directory to text conversion
+- 🌳 Directory tree generation
+- 🚫 .gitignore support
+- 🎨 Customizable separators
+
+## Acknowledgments
+
+Created by Andrii Sonsiadlo
+

code_to_txt-0.2.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+code_to_txt/__init__.py,sha256=0_iks7Uz24B1pc-Na1n8C97vgMms6haaFNqIRkpq_Cg,62
+code_to_txt/cli.py,sha256=5NEXWGts1JBSXpAWsgrAfz9O0YFHzu6uRPf4NUePOj0,6662
+code_to_txt/code_to_txt.py,sha256=ZCqc-Yk-hc5AexDIGaphCe_2Ck3LhfVeQP8-pDVRCec,8417
+code_to_txt/config.py,sha256=KMlpeKO0F8YRbEmlXMnCs_PrR3iYQNTYOgZISZfCzVU,4148
+code_to_txt-0.2.0.dist-info/METADATA,sha256=AS-XxI1i8Au96Y1_y04nhgY2U6A8whMEshnGHUfHNgc,10519
+code_to_txt-0.2.0.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+code_to_txt-0.2.0.dist-info/entry_points.txt,sha256=jPT0g_nryiuAd0E496deFZAhdscNLXiUmUdD3KGN3iA,52
+code_to_txt-0.2.0.dist-info/licenses/LICENSE,sha256=-K4fNS51V7AiwILLB_InW4EECFSbFrrOBd66OqVVyh4,1068
+code_to_txt-0.2.0.dist-info/RECORD,,

{code_to_txt-0.1.0.dist-info → code_to_txt-0.2.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.3.0
+Generator: poetry-core 2.3.1
 Root-Is-Purelib: true
 Tag: py3-none-any

code_to_txt-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Andrii Sonsiadlo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

code_to_txt-0.1.0.dist-info/METADATA

@@ -1,24 +0,0 @@
-Metadata-Version: 2.4
-Name: code-to-txt
-Version: 0.1.0
-Summary: Convert code files to a single text file for LLM consumption
-License: MIT
-Author: Andrii Sonsiadlo
-Author-email: andrii.sonsiadlo@gmail.com
-Requires-Python: >=3.10
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: click (>=8.3.1,<9.0.0)
-Requires-Dist: gitpython (>=3.1.46,<4.0.0)
-Requires-Dist: pathspec (>=1.0.4,<2.0.0)
-Description-Content-Type: text/markdown
-
-# CodeToTxt
-
-A small Python package to convert code to text.
-

code_to_txt-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-code_to_txt/__init__.py,sha256=0_iks7Uz24B1pc-Na1n8C97vgMms6haaFNqIRkpq_Cg,62
-code_to_txt/cli.py,sha256=EEm87GRTgk1YorSfoLl2IR2NUjG0f_fkgEQ5YnkxpQ8,2409
-code_to_txt/code_to_txt.py,sha256=HKXiTXMUxM612f7SVHcoxsra6uK6SVV6_-UY49jtR2w,6089
-code_to_txt-0.1.0.dist-info/METADATA,sha256=QEbEcYTZonOO00fLkq3EFuIWBgaGWQLsxnGV3UY1O7I,807
-code_to_txt-0.1.0.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
-code_to_txt-0.1.0.dist-info/entry_points.txt,sha256=jPT0g_nryiuAd0E496deFZAhdscNLXiUmUdD3KGN3iA,52
-code_to_txt-0.1.0.dist-info/RECORD,,