|
| 1 | +<p align="center"> |
| 2 | + <img src="./img/filet.png"> |
| 3 | +</p> |
| 4 | + |
1 | 5 | # Filet |
| 6 | + |
2 | 7 | The ⚡ superfast ⚡ CLI tool to create file trees at the drop of a hat |
3 | 8 |
|
4 | 9 | ## 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 |
6 | 14 | 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! 🥳🎆 |
8 | 16 |
|
9 | 17 | ## Usage :electric_plug: 💻 |
| 18 | + |
10 | 19 | Use the `--help` flag for instructions |
| 20 | + |
11 | 21 | ``` |
12 | 22 | $ 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 |
17 | 24 |
|
18 | 25 | optional arguments: |
19 | 26 | -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: |
20 | 32 | --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 |
22 | 35 | --notree File tree will not be logged to console |
23 | 36 | ``` |
| 37 | + |
24 | 38 | ### Syntax 👩🏫 |
| 39 | + |
25 | 40 | | item | syntax | example1 | example2 | |
26 | | -|--------|-----------------------------------------------------|----------------------------------|---------------------| |
| 41 | +| ------ | --------------------------------------------------- | -------------------------------- | ------------------- | |
27 | 42 | | file | `{file_name1}.{extension}+{file_name2}.{extension}` | `hello.py` | `server.js+auth.js` | |
28 | 43 | | folder | `{folder_name1}[]+{folder_name2}[]` | `src[]` | `api[]+auth[]` | |
29 | 44 | | tree | `{folder_name}[{file1}+{file2}+...]` | `src[main.jsx+data[users.json]]` | | |
30 | 45 |
|
31 | 46 | ### Example 🥊 |
| 47 | + |
32 | 48 | 1. Create file tree in current directory |
| 49 | + |
33 | 50 | ``` |
34 | 51 | $ 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 |
37 | 59 | ``` |
| 60 | + |
38 | 61 | 2. Create file tree in specified directory using `-r` or `--root` arg |
39 | 62 |
|
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 |
43 | 66 |
|
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 |
47 | 78 |
|
48 | 79 | ## Contributing |
| 80 | + |
49 | 81 | Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. |
50 | 82 |
|
51 | 83 | ## License |
52 | | -[MIT](https://choosealicense.com/licenses/mit/) |
| 84 | + |
| 85 | +[ISC](https://choosealicense.com/licenses/isc/) |
0 commit comments