Skip to content

Commit 3e7dac1

Browse files
author
Dark Coder Cat | Vansh
authored
Merge pull request #5 from Mannuel25/master
Repository Revamp
2 parents 775b211 + 439255b commit 3e7dac1

File tree

2 files changed

+83
-39
lines changed

2 files changed

+83
-39
lines changed

CONTRIBUTING.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# CONTRIBUTION GUIDELINES
2+
3+
- Fork the repo
4+
- Open your terminal and clone it on your machine:
5+
```
6+
https://github.com/dark-coder-cat/Empty-Folder-Cleaner.git
7+
```
8+
- Add an upstream link to the main branch in your cloned repo:
9+
```
10+
git remote add upstream https://github.com/dark-coder-cat/Empty-Folder-Cleaner.git
11+
```
12+
- Keep your cloned repo up to date by pulling from upstream (to avoid any merge conflicts while committing new changes):
13+
```
14+
git pull upstream master
15+
```
16+
- Create your own branch: `git checkout -b <branch-name>`
17+
- Commit all the changes (use descriptive commit messages): git commit -m "a descriptive commit message"
18+
- Push your changes: `git push origin <branch-name>`
19+
- Make a PR on Github; use a descriptive PR title to specify the change(s) made.
20+
- Any contribution is welcomed such as fixing grammatical errors, fixing broken links, adding resources, etc.
21+
- Before contributing, here's our [CODE OF CONDUCT](CODE_OF_CONDUCT.md) which must be adhered to.
22+
- Use the `[Title Case Name](link)` format.
23+
- Use concise descriptions.
24+
- Pull requests should have a useful title.

README.md

Lines changed: 59 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,67 @@
11
# Empty Folder Cleaner
22

3-
## Aim/Purpose
3+
## Table Of Contents
44

5-
Clear Empty Directories/Folders present in system
5+
- [Description](#description)
6+
- [Libaries Used](#libaries-used)
7+
- [Setup Instructions](#setup-instructions)
8+
- [How it works](#how-it-works)
9+
- [Screenshots](#screenshots)
10+
- [Contributing](#contributing)
11+
- [Meet our contributors](#meet-our-contributors)
12+
- [License](#license)
613

7-
## Short description of script
14+
## Description
815

9-
- this script is menu driven program
10-
- libraries imported are
11-
- time
12-
- os
13-
- platform
14-
- external modules -`None`
16+
Empty Folder Cleaner is a program that deletes empty folders from your computer or device and removes clutter to improve performance. It supports only windows and android for now.
1517

16-
## Setup instructions
17-
This script doesn't need any additional modules.
18-
So you can run directly without any requirements other than Python itself(Duh.)
19-
```cmd
20-
cd Empty Folder Cleaner
18+
## Libaries Used
19+
20+
- [Time](https://docs.python.org/3/library/time.html)
21+
- [OS](https://docs.python.org/3/library/os.html)
22+
- [Platform](https://docs.python.org/3/library/platform.html)
23+
24+
## Setup Instructions
25+
26+
There are no prerequisites; simply run the script. If you don't already have Python installed, you can get it [here](https://www.python.org/downloads/).
27+
28+
- Clone the repository
29+
```
30+
git clone https://github.com/dark-coder-cat/Empty-Folder-Cleaner.git
31+
```
32+
- Go to the folder directory
33+
```
34+
cd Empty-Folder-Cleaner
35+
```
36+
- Run the script
37+
```
2138
python empty_folder_cleaner.py
2239
```
2340

24-
## For using on android
41+
To run it on android, you can use either Pydroid or Termux.
2542

26-
You can use any of the following
27-
- Pydroid3
28-
- Termux
43+
## How it works
2944

30-
## Detailed explanation of script
45+
The program removes any empty folder(s) fom your device by:
46+
- Checking the empty folders in curent path.
47+
- Checking the empty folder in given path provided by user.
3148

32-
### This script has 3 options:
49+
> Note: If you get any code like `03m[` on your terminal choose OPTION 3 before providing the path to be checked.
50+
> Option 3 is used to change the text color but it doesn't work on some devices or computer.
3351
34-
- 1 Check the empty folders in curent path
35-
- 2 Check the empty folder in given path by user
36-
- 3 **This is important** See **NOTE**
37-
> it is used to change the text color. but on some computers dosen't works.
38-
- Or write "exit" at any input for exiting.
39-
- After using opt. 1 or 2 you will be asked to enter (Y/N) if you want to delete the Folders
40-
- At end it would display
41-
- `the no. of folder deleted`
42-
- `the no. of folders scanned`
43-
- `the no. of files and folders present.`
44-
- `Scanned dir path`
52+
After providing the path to be checked, you'll be required to enter (Y/N) to confim the deletion of the folders.
53+
Upon deletion, the following would be displayed:
54+
- The number of folders deleted.
55+
- The number of folders scanned.
56+
- The number of files and folders present in the provided path.
57+
- The scanned dir path.
4558

46-
## NOTE
59+
> Enter **exit** at any input to stop the program.
4760
48-
> **If getting any code like `03m[` on terminal then choose OPTION 3 in starting**
4961

50-
## Output/Screenshots
62+
## Screenshots
5163

52-
>***UI may differ due to terminal difference***
53-
54-
<table>
64+
<table >
5565
<tr>
5666
<td colspan=2 align=center>Starting Screen<img src= "Images/startScreen.jpg" alt="startScreen.jpg">↙↘ </td>
5767
</tr>
@@ -77,6 +87,16 @@ You can use any of the following
7787
</tr>
7888
</table>
7989

80-
## Developer
90+
## Contributing
91+
92+
Feel free to add more features to this repo by either creating an issue or making a Pull Request. See our [contribution guidelines](CONTRIBUTING.md) to get started.
93+
94+
## Meet our contributors
95+
96+
<a href="https://github.com/dark-coder-cat/Empty-Folder-Cleaner/graphs/contributors">
97+
<img src="https://contrib.rocks/image?repo=dark-coder-cat/Empty-Folder-Cleaner" />
98+
</a>
99+
100+
## License
81101

82-
[Dark Coder Cat | Vansh](https://github.com/dark-coder-cat)
102+
This project is under an [MIT LICENSE](LICENSE).

0 commit comments

Comments
 (0)