file-content-extractor 0.3.3

A tool to extract content from text files in a directory, with options to ignore certain files and directories.

FileContentExtractor

Languages: 🇺🇸English | 🇰🇷한국어

FileContentExtractor is a versatile Python tool designed to recursively extract and save the contents of text files in a directory. It provides various options to ignore specific files or directories, filter files based on several criteria, and output file paths as either absolute or relative paths. The tool also includes user confirmation, version display, and help options for better usability.

Features

• Recursively traverses directories and extracts the content of text files.
• Allows you to ignore specific files, directories, or patterns using a .conf file.
• Outputs file paths as either relative or absolute paths.
• Supports filtering files by extension, size, and modification date.
• Allows splitting output into multiple files based on size.
• Displays a progress bar during extraction.
• Prompts user confirmation before proceeding with extraction.
• Provides version information and help details via command-line options.

Installation

You can install the package via pip:

pip install file-content-extractor

Usage

1. Basic command:

   • Default usage (relative paths):

     fce
     

     • After running this command, you will be prompted to confirm the extraction by typing y.

   • Use absolute paths:

     fce -a
     

2. Specify additional options:

   • Ignore specific files or directories:

     fce -i my_ignore_list.conf
     

   • Save output to a custom file:

     fce -o my_output.txt
     

   • Filter by file extension, size, and modification date:

     fce -e .txt,.py -m 1024 -M 1048576 -d 2023-01-01
     

   • Split output into multiple files:

     fce -s 10485760
     

   • Specify the directory to start extraction from:

     fce -p /path/to/directory
     

3. Check version:

   • To display the current version of the tool:

     fce -v
     

4. Help:

   • To display help information and usage details:

     fce -h
     

Options

• -a, --absolute: Use absolute paths in the output.
• -i <file>, --ignore=<file>: Specify a custom ignore file (default is ignore.conf).
• -o <file>, --output=<file>: Specify a custom output file (default is output.txt).
• -e <ext1,ext2,...>, --extensions=<ext1,ext2,...>: Specify file extensions to include (e.g., .txt,.py).
• -m <bytes>, --min-size=<bytes>: Specify minimum file size to include.
• -M <bytes>, --max-size=<bytes>: Specify maximum file size to include.
• -d <YYYY-MM-DD>, --modified-after=<YYYY-MM-DD>: Include only files modified after a specific date.
• -s <bytes>, --split-size=<bytes>: Split output files into chunks of the specified size.
• -p <directory>, --path=<directory>: Specify the directory to start extraction from.
• --tree: Print the directory tree of the current path and add it to the output file.
• --include-ignored: Include files and directories listed in the ignore.conf when printing the directory tree.
• -h, --help: Show this help message and exit.
• -v, --version: Show version information and exit.

Contributing

Contributions are welcome! Feel free to submit a Pull Request.

License

This project is licensed

under the MIT License. See the LICENSE file for details.

Author

• Daniel - joonheeu - [e-mail]
• Company: UDIT