pstruc 0.4.0

Get a project file structure to analyze it

Project Structure Generator

Overview

Project Structure Generator is a versatile tool available both as a command-line interface and as a library. It enables users to generate directory structures in JSON, YAML, or plain text formats and offers the ability to pretty-print the structure with color.

Features

• Generate directory structures in JSON, YAML, or plain text.
• Exclude patterns specified in .gitignore.
• Pretty-print the directory structure with colorful output.
• Command-line interface for ease of use.
• Ability to include content of specified files.
• Customizable patterns for more precise control over the directory structure output.

Installation

To install the package, use the following command:

pip install pstruc

CLI Usage

The pstruc tool supports various arguments for generating and customizing the directory structure.

Arguments

• directory: Specify the directory to inspect (not specified: current directory)
• -f, --format: Choose the output format (json, yaml, txt).
• -o, --output: Specify the output file name.
• -p, --print: Print the directory structure without saving it.
• -ns, --not-save: Do not save the generated structure to an output file.
• -ip, --add-ignore-patterns: Add custom patterns to ignore.
• -iff, --ignore-from-files: List of files to get the ignore patterns from.
• -igi, --ignore-git-ignore: Ignore the patterns inside .gitignore file.
• -fc, --add-content-file-patterns: Include content of specified files.

Example

python pstruc.py /path/to/directory -f json -o output_structure -ip "*.log","__pycache__" -fc "*.md","*.txt"

This command will generate a JSON file output_structure.json representing the directory structure of /path/to/directory, ignoring files matching *.log and __pycache__, and including content of markdown and text files.

Library Usage

As a library, pstruc provides a straightforward API for generating and manipulating directory structures. The core functionality is based on generating the structure, saving it, and pretty-printing.

Example

from pstruc import get_project_structure, save_structure_to_file, pretty_print

# Generate directory structure
structure = get_project_structure('/path/to/directory', 'json', ignore_patterns=["*.log", "__pycache__"], file_content=["*.md", "*.txt"])

# Save to a file
save_structure_to_file('output_structure.json', structure)

# Pretty-print the structure
pretty_print(structure)

Library Available Methods

• get_project_structure(start_path, output_format, ignore_patterns, file_content): Generates the directory structure.
• save_structure_to_file(output_file, structure): Saves the directory structure to a file.
• pretty_print(structure): Pretty-prints the directory structure.
• get_all_ignore_patterns: Get a list of all ignore patterns from files and lists.

Contributing

Contributions are welcome! Please follow our Contributing Guidelines.

License

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

Acknowledgments

• colorama - For colorful output.