Skip to content

Commit 7b107f0

Browse files
authored
Merge pull request #6 from gitwikc/development
Development
2 parents 799663a + cc52666 commit 7b107f0

File tree

3 files changed

+52
-19
lines changed

3 files changed

+52
-19
lines changed

README.md

Lines changed: 50 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,85 @@
1+
<p align="center">
2+
<img src="./img/filet.png">
3+
</p>
4+
15
# Filet
6+
27
The ⚡ superfast ⚡ CLI tool to create file trees at the drop of a hat
38

49
## Installation 📥
5-
1. Download `filet.exe` from the [releases](https://github.com/gitwikc/filet/releases) page
10+
11+
> If you already have `filet` installed on your computer, you may want to [update](#updating) to the latest version.
12+
13+
1. Download (latest or desired version) `filet.exe` from the [releases](https://github.com/gitwikc/filet/releases) page
614
2. Add the path of the folder where you stored `filet.exe` to the system **PATH** variable like [this](https://stackoverflow.com/questions/44272416/how-to-add-a-folder-to-path-environment-variable-in-windows-10-with-screensho)
7-
3. Restart your computer and Filet is ready to be used in your favorite terminal! 🥳🎆
15+
3. (_Optional_) Restart your computer and Filet is ready to be used in your favorite terminal! 🥳🎆
816

917
## Usage :electric_plug: 💻
18+
1019
Use the `--help` flag for instructions
20+
1121
```
1222
$ filet --help
13-
usage: filet.exe [-h] [--root [ROOT]] [--notree] struc
14-
15-
positional arguments:
16-
struc The structure of the filetree in filet synax
23+
usage: filet.exe [-h] [--version] [--root [ROOT]] [--notree] struc
1724
1825
optional arguments:
1926
-h, --help show this help message and exit
27+
28+
INFO:
29+
--version, -v Prints out current version and release date of Filet
30+
31+
CREATE:
2032
--root [ROOT], -r [ROOT]
21-
Root directory to create the filetree
33+
Location of root directory to create the filetree
34+
struc The structure of the filetree in filet syntax
2235
--notree File tree will not be logged to console
2336
```
37+
2438
### Syntax 👩‍🏫
39+
2540
| item | syntax | example1 | example2 |
26-
|--------|-----------------------------------------------------|----------------------------------|---------------------|
41+
| ------ | --------------------------------------------------- | -------------------------------- | ------------------- |
2742
| file | `{file_name1}.{extension}+{file_name2}.{extension}` | `hello.py` | `server.js+auth.js` |
2843
| folder | `{folder_name1}[]+{folder_name2}[]` | `src[]` | `api[]+auth[]` |
2944
| tree | `{folder_name}[{file1}+{file2}+...]` | `src[main.jsx+data[users.json]]` | |
3045

3146
### Example 🥊
47+
3248
1. Create file tree in current directory
49+
3350
```
3451
$ filet dir1[f1.txt+f2.txt+dir2[f3.txt]]
35-
Successfully created file tree
36-
[{'dir1': ['f1.txt', 'f2.txt', {'dir2': ['f3.txt']}]}]
52+
✔ Successfully created file tree
53+
54+
▼ dir1
55+
∟ f1.txt
56+
∟ f2.txt
57+
▼ dir2
58+
∟ f3.txt
3759
```
60+
3861
2. Create file tree in specified directory using `-r` or `--root` arg
3962

40-
- **Absolute path**
41-
`$ filet -r C://Users//ADMIN myfolder[images[]+important[bday.txt+todos.txt]]+software[README.txt]`<br />
42-
Creates file tree in `C://Users//ADMIN` directory
63+
- **Absolute path**<br />
64+
`$ filet -r C://Users//ADMIN myfolder[images[]+important[bday.txt+todos.txt]]+software[README.txt]`<br />
65+
Creates file tree in `C://Users//ADMIN` directory
4366

44-
- **Relative path**
45-
`$ filet ../tests myfolder[images[]+important[bday.txt+todos.txt]]+software[README.txt]`<br />
46-
Creates the file tree in the parent directory of current directory (in which the terminal runs `filet` command)
67+
- **Relative path**<br />
68+
`$ filet --root ../tests myfolder[images[]+important[bday.txt+todos.txt]]+software[README.txt]`<br />
69+
Creates the file tree in the `tests` folder in **parent directory** of current directory (in which the terminal runs `filet` command)
70+
71+
## Updating
72+
73+
To update the version of `filet` on your computer:
74+
75+
1. Download the desired (preferably _latest_) version of `filet.exe` from the [releases](https://github.com/gitwikc/filet/releases) page.
76+
2. Save it in the directory where you have previously installed `filet`
77+
3. 🎆 YAY! You have successfully updated `filet` on your computer
4778

4879
## Contributing
80+
4981
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
5082

5183
## License
52-
[MIT](https://choosealicense.com/licenses/mit/)
84+
85+
[ISC](https://choosealicense.com/licenses/isc/)

img/filet.png

81.3 KB
Loading

release.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
{
2-
"version": "1.2",
3-
"date": "2021-07-03"
2+
"version": "v1.5",
3+
"date": "2021-07-04"
44
}

0 commit comments

Comments
 (0)