Metadata-Version: 2.4
Name: Foldpro
Version: 1.1.0
Summary: A program to make organized copies of your folders.
Keywords: folders,organization,macOS
Author-email: Iman Taeb <imantaeb507@gmail.com>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: MacOS
License-File: LICENSE
Requires-Dist: rich>=14.2.0

# Foldpro
Have you ever wished you could parse your directories and find specific types of files?
Foldpro lets you do exactly that. Give it the path to a folder you'd like to organize, and it will create an organized copy under `~/Foldpro Copies`.

These organized copies can be categorized into one (or all) of the following:
- Pictures
- Code Files
- Downloads From Terminal
- Others

# Prerequisites
- Running macOS
- Python 3.9 or higher

# How to Use
1. Install Foldpro: pip3 install foldpro
2. Run this command in your terminal: foldpro the/path/to/a/folder
3. Go to `~/Foldpro Copies` to view the organized copy

# Optional Arguments
If you would like to organize your folders into only one of the categories(e.g.photos only) run the foldpro comamnd with the -m optional argument:
// For photos only:
foldpro -m p the/path

// For code files only:
foldpro -m c the/path

// For others only:
foldpro -m o the/path

// For downloads from terminal only:
foldpro -m d the/path



# How Foldpro Works
Here are some details about how Foldpro organizes your files:

1. In `all` mode, only folders containing categorized files will remain in the organized copy. Empty folders are removed for neatness.
2. If files in the copy share the same name, Foldpro appends digits to avoid collisions.
3. Symlinks are organized based on their targets. Symlinks whose targets are directories or do not exist will be placed in the `Others` folder to prevent clutter.

