mpra 0.1.1

MPRA - Multipurpose Resource Automation

MPRA (Multipurpose Resource Automation) 🚀

MPRA is a powerful multipurpose utility package designed to automate common file and directory management tasks. From organizing files by extensions to checking disk space and monitoring directories for changes, MPRA provides an efficient and user-friendly solution to streamline your workflow.

---

Why MPRA? 🤔

MPRA is designed to be an all-in-one toolkit to simplify everyday system tasks. Whether you’re managing files, running system commands, or filtering directories, MPRA provides a lightweight yet effective solution to cover your automation needs.

• ⚡ Efficiency: Speed up your tasks with automated processes.
• 📁 Organization: Keep your directories clean and well-organized.
• 🔧 Customizable: Perform operations tailored to your specific requirements.
• 📊 System Monitoring: Easily monitor system resources and directories.

---

Installation 💻

Ready to give it a go? Just run the following command to install MPRA:

pip install mpra

---

Usage 🔧

Here’s how you can integrate MPRA functions into your daily tasks.

from mpra import mpra

# Example usage
mpra.disk_stats("/path/to/directory")
mpra.file_organizer("/path/to/your/files")

---

Features 🛠️

Disk Usage Checker

Function: disk_stats(directory_path)
Description: This function takes a directory path as input and returns the total, used, and free disk space in gigabytes.

Parameters:

• directory_path (str): The path of the directory to check.

Returns:

• Total disk space, used space, and free space in gigabytes.

Example:

mpra.disk_stats('/path/to/directory')

File Organizer

Function: organize_files(directory_path)
Description: This function organizes files in the specified directory into subdirectories based on file extensions.

Parameters:

• directory_path (str): The path of the directory to organize.

Example:

mpra.organize_files('/path/to/directory')

Directory Monitor

Function: monitor_directory(directory_path)
Description: This function monitors a directory for new files and prints a message each time a new file is added.

Parameters:

• directory_path (str): The directory to monitor.

Example:

mpra.monitor_directory('/path/to/directory')

File Backup

Function: backup_files(source_directory, destination_directory)
Description: This function copies all files from the source directory to the destination directory.

Parameters:

• source_directory (str): The path of the directory to copy files from.
• destination_directory (str): The path of the directory to copy files to.

Example:

mpra.backup_files('/source/directory', '/destination/directory')

Batch Rename Files

Function: batch_rename(directory_path, prefix=None, suffix=None)
Description: This function renames all files in a directory by adding a prefix or suffix.

Parameters:

• directory_path (str): The path of the directory containing the files.
• prefix (str, optional): The prefix to add to each file name.
• suffix (str, optional): The suffix to add to each file name.

Example:

mpra.batch_rename('/path/to/directory', prefix='backup_')

System Command Runner

Function: run_command(command)
Description: This function takes a system command as input and executes it. It returns the command's output.

Parameters:

• command (str): The system command to execute.

Example:

mpra.run_command('ls -la')

Delete Empty Directories

Function: delete_empty_dirs(directory_path)
Description: This function recursively searches through a directory and deletes all empty subdirectories.

Parameters:

• directory_path (str): The directory to clean up.

Example:

mpra.delete_empty_dirs('/path/to/directory')

File Size Filter

Function: filter_files_by_size(directory_path, min_size_bytes)
Description: This function lists all files in a directory that are larger than a specified size.

Parameters:

• directory_path (str): The path of the directory to search.
• min_size_bytes (int): The minimum file size (in bytes) to filter.

Example:

mpra.filter_files_by_size('/path/to/directory', min_size_bytes=1000000)

Log File Creator

Function: create_log(directory_path)
Description: This function generates a log file in the specified directory, logging the current date and time each time the script runs.

Parameters:

• directory_path (str): The directory where the log file will be created.

Example:

mpra.create_log('/path/to/directory')

---

Feedback, Bugs, & Contributions 🐛

Got feedback or found a bug? Feel free to open an issue or contribute on GitHub:

• GitHub: https://github.com/ManojPennada/mpra
• Email: [e-mail]

---

License

Refer to the LICENSE file for details.

© 2024 MPRA Documentation. All rights reserved.