Metadata-Version: 2.1
Name: foldermap
Version: 0.1.0
Summary: A tool for mapping files and folders to markdown documentation
Home-page: https://github.com/newrachael/foldermap
Author: Raykim
Author-email: enro2414@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# Foldermap

Foldermap is a utility that collects files from a directory, creates a visual tree structure, and generates a comprehensive markdown report with all the file contents.

## Features
* Collect files from directories and subdirectories
* Filter files by extension
* Exclude specific folders
* Generate folder structure visualization
* Create markdown reports with file contents
* Simple command-line interface

## Installation

```bash
pip install foldermap
```

## Usage

### Command Line

```bash
# Basic usage
foldermap /path/to/folder

# Specify output file
foldermap /path/to/folder -o report.md

# Filter files by extension
foldermap /path/to/folder -e py,txt,md

# Exclude specific folders
foldermap /path/to/folder -x node_modules,.git,venv

# Combine options
foldermap /path/to/folder -o report.md -e py,txt -x node_modules,venv
```

### Python API

```python
from foldermap import collect_files, get_folder_structure, generate_markdown

# Collect files from a directory
files = collect_files(
    folder_path="your/folder/path", 
    extensions=[".py", ".txt"],  # Optional
    exclude_folders=["venv", ".git"]  # Optional
)

# Generate folder structure
structure = get_folder_structure("your/folder/path", files)

# Generate markdown report
generate_markdown("your/folder/path", files, structure, "output.md")
```

## Example Output
The generated markdown file includes:
1. A timestamp of when the report was generated
2. The absolute path of the base folder
3. A visual tree structure of all folders and files
4. The content of each file, formatted as code blocks

Example folder structure:

```
📄 README.md
📁 foldermap
  📄 __init__.py
  📄 core.py
  📄 cli.py
📁 tests
  📄 test_foldermap.py
```

## License
MIT License
