- Introduction
- Prerequisites
- Installation
- Usage
- Algorithm Loading
- Algorithm Listing
- Multiprocessing
- Logging
- License
This utility is a Python script designed to rename files in a folder or an individual file based on a dynamically loaded algorithm. It utilizes multiprocessing for efficiency and can operate recursively on directories. The example algorithm shifts each alphabetic character in the filenames to the left by 1.
- Python 3.6+
- Clone the GitHub repository.
git clone https://github.com/darkarp/algorename.git
- Navigate to the project directory.
cd algorename
- Install the required Python packages.
pip install -r requirements.txt
- To rename a single file:
python algorename.py -f [path/to/your/file]
- To rename all files in a directory:
python algorename.py -d [path/to/your/directory]
- To rename files recursively in a directory:
python algorename.py -d [path/to/your/directory] -r
- For silent mode (suppress errors):
python algorename.py -s (...)
- To not create a log file:
python algorename.py -nl (...)
- To use a specific algorithm:
python algorename.py -a [algorithm_name]
- To list available algorithms:
python algorename.py -l
- For help:
python algorename.py -h
The script supports loading custom algorithms. Place your algorithm module under the algorithms/
folder, and the script will be able to import it dynamically. Make sure to define a function called apply_algorithm
within the module.
The environment variable FCLOG_PATH
specifies the directories where the script will look for custom algorithm modules. You can modify this by changing your environment variables or by creating a .env
file.
Example:
- Windows:
FCLOG_PATH=C:\path\to\algorithms;D:\another\path\to\algorithms
- Linux/Mac:
FCLOG_PATH=/path/to/algorithms:/another/path/to/algorithms
You can list all available algorithms along with their metadata using the -l
flag. This is useful for understanding what each algorithm does before using it.
This utility uses multithreading to efficiently rename multiple files in a directory. It uses concurrent.futures.ThreadPoolExecutor
to speed up the renaming tasks.
Logging is implemented with a rotating log file mechanism to ensure that it doesn't consume too much disk space over time. The log file will be generated in the same directory as the script, named algorename.log
.
- You can set the logging verbosity level via an environment variable
FCLOG_LEVEL
, which accepts values likeDEBUG
,INFO
,WARNING
,ERROR
, andCRITICAL
. - You can set the log file name via an environment variable
FCLOG_NAME
. This name will be converted to lower-case. - You can disable logging by specifying
-nl
argument.
This project is licensed under the MIT License - see the LICENSE.md file for details.