# Byte-compiled / optimized / DLL files

__pycache__/

*.py[codz]

*$py.class

# C extensions

*.so

# Distribution / packaging

.Python

build/

develop-eggs/

dist/

downloads/

eggs/

.eggs/

lib/

lib64/

parts/

sdist/

var/

wheels/

share/python-wheels/

*.egg-info/

.installed.cfg

*.egg

MANIFEST

# PyInstaller

# Usually these files are written by a python script from a template

# before PyInstaller builds the exe, so as to inject date/other infos into it.

*.manifest

*.spec

# Installer logs

pip-log.txt

pip-delete-this-directory.txt

# Unit test / coverage reports

htmlcov/

.tox/

.nox/

.coverage

.coverage.*

.cache

nosetests.xml

coverage.xml

*.cover

*.py.cover

.hypothesis/

.pytest_cache/

cover/

# Translations

*.mo

*.pot

# Django stuff:

*.log

local_settings.py

db.sqlite3

db.sqlite3-journal

# Flask stuff:

instance/

.webassets-cache

# Scrapy stuff:

.scrapy

# Sphinx documentation

docs/_build/

# PyBuilder

.pybuilder/

target/

# Jupyter Notebook

.ipynb_checkpoints

# IPython

profile_default/

ipython_config.py

# pyenv

# For a library or package, you might want to ignore these files since the code is

# intended to run in multiple environments; otherwise, check them in:

# .python-version

# pipenv

# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.

# However, in case of collaboration, if having platform-specific dependencies or dependencies

# having no cross-platform support, pipenv may install dependencies that don't work, or not

# install all needed dependencies.

#Pipfile.lock

# UV

# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.

# This is especially recommended for binary packages to ensure reproducibility, and is more

# commonly ignored for libraries.

#uv.lock

# poetry

# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.

# This is especially recommended for binary packages to ensure reproducibility, and is more

# commonly ignored for libraries.

# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control

#poetry.lock

#poetry.toml

# pdm

# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.

# pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.

# https://pdm-project.org/en/latest/usage/project/#working-with-version-control

#pdm.lock

#pdm.toml

.pdm-python

.pdm-build/

# pixi

# Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.

#pixi.lock

# Pixi creates a virtual environment in the .pixi directory, just like venv module creates one

# in the .venv directory. It is recommended not to include this directory in version control.

.pixi

# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm

__pypackages__/

# Celery stuff

celerybeat-schedule

celerybeat.pid

# SageMath parsed files

*.sage.py

# Environments

.env

.envrc

.venv

env/

venv/

ENV/

env.bak/

venv.bak/

# Spyder project settings

.spyderproject

.spyproject

# Rope project settings

.ropeproject

# mkdocs documentation

/site

# mypy

.mypy_cache/

.dmypy.json

dmypy.json

# Pyre type checker

.pyre/

# pytype static type analyzer

.pytype/

# Cython debug symbols

cython_debug/

# PyCharm

# JetBrains specific template is maintained in a separate JetBrains.gitignore that can

# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore

# and can be added to the global gitignore or merged into this file. For a more nuclear

# option (not recommended) you can uncomment the following to ignore the entire idea folder.

#.idea/

# Abstra

# Abstra is an AI-powered process automation framework.

# Ignore directories containing user credentials, local state, and settings.

# Learn more at https://abstra.io/docs

.abstra/

# Visual Studio Code

# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore

# that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore

# and can be added to the global gitignore or merged into this file. However, if you prefer,

# you could uncomment the following to ignore the entire vscode folder

# .vscode/

# Ruff stuff:

.ruff_cache/

# PyPI configuration file

.pypirc

# Cursor

# Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to

# exclude from AI features like autocomplete and code analysis. Recommended for sensitive data

# refer to https://docs.cursor.com/context/ignore-files

.cursorignore

.cursorindexingignore

# Marimo

marimo/_static/

marimo/_lsp/

__marimo__/

# Exclude this tool's output

merged_code_context.txt

def generate_project_tree(file_paths: List[str], root_name: str) -> str:

"""Generates a string representation of the project tree from a list of file paths."""

tree_dict: Dict = {}

for path in sorted(file_paths):

parts = Path(path).parts

current_level = tree_dict

for part in parts:

if part not in current_level:

current_level[part] = {}

current_level = current_level[part]

lines = [f"{root_name}/"]

def _generate_lines_recursive(subtree: Dict, prefix: str):

entries = sorted(subtree.items())

for i, (name, content) in enumerate(entries):

is_last = (i == len(entries) - 1)

connector = "└── " if is_last else "├── "

lines.append(f"{prefix}{connector}{name}")

if content: # It's a directory, recurse

new_prefix = prefix + (" " if is_last else "│ ")

_generate_lines_recursive(content, new_prefix)

_generate_lines_recursive(tree_dict, "")

return "\n".join(lines) + "\n"

# 4. Phase 1.5: Top 10 Review and Tree Generation

# Generate the project tree string from the final list of files

relative_paths_for_tree = [f[1] for f in files_to_merge]

project_tree_str = generate_project_tree(relative_paths_for_tree, root_dir.name)

# 5. Phase 2: Merge files

try:

with open(output_file, "w", encoding="utf-8") as f:

f.write(f"# --- flatcode: Project Context Snapshot --- #\n")

f.write(f"# Root: {root_dir}\n")

f.write(f"# Files: {len(files_to_merge)}\n")

f.write(f"# Est. Tokens: {total_tokens}\n")

f.write(f"# --- Project Tree --- #\n")

f.write(project_tree_str)

f.write(f"# --- Start of Context --- #\n\n")

for path, rel_path, tokens, content in files_to_merge:

f.write(f"--- File: {rel_path} ---\n\n")

f.write(content)

f.write(f"\n\n--- End: {rel_path} ---\n\n")

except IOError as e:

print(f"\n*** Error writing to output file: {e} ***", file=sys.stderr)