# PiFolderOrganizer
PiFolderOrganizer is a Python package that helps organize files into different categories based on their file extensions.
## Installation
You can install PiFolderOrganizer using pip:
```bash
pip install pi-folder-organizer
```
## Usage
To use PiFolderOrganizer in your Python code, import the PiFolderOrganizer class:
```python
from pi_folder_organizer import PiFolderOrganizer
```
Make object of class
```python
pi_organizer=PiFolderOrganizer()
```
To continue with default cleaning:
```python
pi_organizer.pi_folder_organizer("/path/to/source_folder", "/path/to/destination_folder")
```
If you want to see which folders and extentions I use:
```python
pi_organizer.get_counter()
```
This will return you a dictionary of folders and the files list as folder's files.
Same for getting extensions
```python
pi_organizer.get_extensions()
```
This will return you a dictionary of folders and the files tuple of file's extensions.
### Customization Options
You can customize the counter dictionary and extensions dictionary according to your preferences. Here's how:
```python
from pi_folder_organizer import PiFolderOrganizer
# Initialize PiFolderOrganizer
pi_organizer = PiFolderOrganizer()
# Customize the counter dictionary
new_counter = {
"Images": [],
"Documents": []
}
# Set the new counter
pi_organizer.set_counter(new_counter)
print("Updated Counter:", pi_organizer.get_counter())
# Customize the extensions dictionary
new_extensions = {
"Images": (".png", ".jpg"),
"Documents": (".txt", ".docs")
}
# Set the new extensions
pi_organizer.set_extensions(new_extensions)
print("Updated Extensions:", pi_organizer.get_extensions())
# Run the PiFolderOrganizer method after your setup
pi_organizer.pi_folder_organizer("source_folder", "destination_folder")
```
**Note**
The length of ```new_counter``` and ```new_extensions``` must be same. The remaining files automatically moved to folder ```Others```.
### Contact Information
Feel free to reach out to me on social media:
[![GitHub](https://img.shields.io/badge/GitHub-mrqadeer)](https://github.com/mrqadeer)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Qadeer)](https://www.linkedin.com/in/qadeer-ahmad-3499a4205/)
[![Twitter](https://img.shields.io/badge/Twitter-Twitter)](https://twitter.com/mr_sin_of_me)
[![Facebook](https://img.shields.io/badge/Facebook-Facebook)](https://web.facebook.com/mrqadeerofficial/)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "pi-folder-organizer",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, file organization, file cleanup, cluttered files, folder management, data organization, file management, data cleanup, Python package, developer tools, data processing, file sorting, data structuring, automated file organization, Python library, data management, data handling, file optimization, data optimization",
"author": "Qadeer Ahmad",
"author_email": "mrqdeer1231122@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ff/16/6e47a400f8372355c5ccd990c82f2024add146d77552f53aedca6efc69cd/pi_folder_organizer-2.2.2.tar.gz",
"platform": null,
"description": "\n# PiFolderOrganizer\n\nPiFolderOrganizer is a Python package that helps organize files into different categories based on their file extensions.\n\n## Installation\n\nYou can install PiFolderOrganizer using pip:\n\n```bash\npip install pi-folder-organizer\n```\n## Usage\nTo use PiFolderOrganizer in your Python code, import the PiFolderOrganizer class:\n```python\nfrom pi_folder_organizer import PiFolderOrganizer\n```\nMake object of class\n```python\npi_organizer=PiFolderOrganizer()\n```\nTo continue with default cleaning:\n```python\npi_organizer.pi_folder_organizer(\"/path/to/source_folder\", \"/path/to/destination_folder\")\n```\nIf you want to see which folders and extentions I use:\n```python\npi_organizer.get_counter()\n```\nThis will return you a dictionary of folders and the files list as folder's files.\nSame for getting extensions\n```python\npi_organizer.get_extensions()\n```\nThis will return you a dictionary of folders and the files tuple of file's extensions.\n\n### Customization Options\n\nYou can customize the counter dictionary and extensions dictionary according to your preferences. Here's how:\n\n```python\nfrom pi_folder_organizer import PiFolderOrganizer\n\n# Initialize PiFolderOrganizer\npi_organizer = PiFolderOrganizer()\n\n# Customize the counter dictionary\nnew_counter = {\n \"Images\": [],\n \"Documents\": []\n}\n\n# Set the new counter\npi_organizer.set_counter(new_counter)\nprint(\"Updated Counter:\", pi_organizer.get_counter())\n\n# Customize the extensions dictionary\nnew_extensions = {\n \"Images\": (\".png\", \".jpg\"),\n \"Documents\": (\".txt\", \".docs\")\n}\n\n# Set the new extensions\npi_organizer.set_extensions(new_extensions)\nprint(\"Updated Extensions:\", pi_organizer.get_extensions())\n\n# Run the PiFolderOrganizer method after your setup\npi_organizer.pi_folder_organizer(\"source_folder\", \"destination_folder\")\n```\n**Note**\nThe length of ```new_counter``` and ```new_extensions``` must be same. The remaining files automatically moved to folder ```Others```.\n\n### Contact Information\n\nFeel free to reach out to me on social media:\n\n[![GitHub](https://img.shields.io/badge/GitHub-mrqadeer)](https://github.com/mrqadeer)\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-Qadeer)](https://www.linkedin.com/in/qadeer-ahmad-3499a4205/)\n[![Twitter](https://img.shields.io/badge/Twitter-Twitter)](https://twitter.com/mr_sin_of_me)\n[![Facebook](https://img.shields.io/badge/Facebook-Facebook)](https://web.facebook.com/mrqadeerofficial/)\n\n\n\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python package for cleaning up cluttered files and organizing them into respective folders.",
"version": "2.2.2",
"project_urls": null,
"split_keywords": [
"python",
" file organization",
" file cleanup",
" cluttered files",
" folder management",
" data organization",
" file management",
" data cleanup",
" python package",
" developer tools",
" data processing",
" file sorting",
" data structuring",
" automated file organization",
" python library",
" data management",
" data handling",
" file optimization",
" data optimization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4abc70a059f75e75b4099e7e9161c501117c4d02848c0c523213f305ef3654c6",
"md5": "a4727a3925158dc4437c2c78556db998",
"sha256": "668dc79b74502699d4db4d6b486d9f58b0ff24bfec42909fe9ad47ff1e8b1930"
},
"downloads": -1,
"filename": "pi_folder_organizer-2.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a4727a3925158dc4437c2c78556db998",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8921,
"upload_time": "2024-07-05T14:15:34",
"upload_time_iso_8601": "2024-07-05T14:15:34.985300Z",
"url": "https://files.pythonhosted.org/packages/4a/bc/70a059f75e75b4099e7e9161c501117c4d02848c0c523213f305ef3654c6/pi_folder_organizer-2.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ff166e47a400f8372355c5ccd990c82f2024add146d77552f53aedca6efc69cd",
"md5": "35247fe85f1208420d6f25be9c2bf757",
"sha256": "06f0a95d1d3413bc62130a8c6162872ffb91b13590e7402d927c8be0ebe4df4b"
},
"downloads": -1,
"filename": "pi_folder_organizer-2.2.2.tar.gz",
"has_sig": false,
"md5_digest": "35247fe85f1208420d6f25be9c2bf757",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 8852,
"upload_time": "2024-07-05T14:16:04",
"upload_time_iso_8601": "2024-07-05T14:16:04.757296Z",
"url": "https://files.pythonhosted.org/packages/ff/16/6e47a400f8372355c5ccd990c82f2024add146d77552f53aedca6efc69cd/pi_folder_organizer-2.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-05 14:16:04",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pi-folder-organizer"
}