Metadata-Version: 2.1
Name: directory-info-extractor
Version: 0.1.1
Summary: A lightweight Python library for extracting comprehensive information from directories
Home-page: https://github.com/ezequielsobrino/directory-info-extractor
Author: Ezequiel Sobrino
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# Directory Info Extractor

A lightweight Python library for extracting comprehensive information from directories. It provides an easy way to retrieve project structure and file contents, with customizable inclusion and exclusion patterns. Ideal for project analysis and documentation.

## Installation

You can install the Directory Info Extractor using pip:

```
pip install directory-info-extractor
```

## Usage

Here's a quick example of how to use the Directory Info Extractor:

```python
from directory_info_extractor import get_directory_info

info = get_directory_info(
    "/path/to/your/directory",
    include_patterns=["*.py"],
    exclude_patterns=["*.pyc", "__pycache__"],
    recursive=True
)
print(info)
```

## Features

- Retrieve project structure
- Extract file contents
- Customizable file and directory inclusion patterns
- Customizable file and directory exclusion patterns
- Optional recursive directory traversal
- Optional logging of results

## Main Function Parameters

- `dir_path` (str): Path to the local directory.
- `include_project_structure` (bool): Include project structure in the output.
- `include_file_contents` (bool): Include file contents in the output.
- `include_patterns` (List[str], optional): Patterns to include (e.g., ["*.py", "specific_folder/*"]).
- `exclude_patterns` (List[str], optional): Patterns to exclude.
- `recursive` (bool): Whether to recursively search subdirectories.
- `log_path` (str, optional): Path to save the log.

## License

This project is licensed under the MIT License - see the LICENSE file for details.
