Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 50 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,52 +1,85 @@
<p align="center">
<img src="./img/filet.png">
</p>

# Filet

The ⚡ superfast ⚡ CLI tool to create file trees at the drop of a hat

## Installation 📥
1. Download `filet.exe` from the [releases](https://github.com/gitwikc/filet/releases) page

> If you already have `filet` installed on your computer, you may want to [update](#updating) to the latest version.

1. Download (latest or desired version) `filet.exe` from the [releases](https://github.com/gitwikc/filet/releases) page
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)
3. Restart your computer and Filet is ready to be used in your favorite terminal! 🥳🎆
3. (_Optional_) Restart your computer and Filet is ready to be used in your favorite terminal! 🥳🎆

## Usage :electric_plug: 💻

Use the `--help` flag for instructions

```
$ filet --help
usage: filet.exe [-h] [--root [ROOT]] [--notree] struc

positional arguments:
struc The structure of the filetree in filet synax
usage: filet.exe [-h] [--version] [--root [ROOT]] [--notree] struc

optional arguments:
-h, --help show this help message and exit

INFO:
--version, -v Prints out current version and release date of Filet

CREATE:
--root [ROOT], -r [ROOT]
Root directory to create the filetree
Location of root directory to create the filetree
struc The structure of the filetree in filet syntax
--notree File tree will not be logged to console
```

### Syntax 👩‍🏫

| item | syntax | example1 | example2 |
|--------|-----------------------------------------------------|----------------------------------|---------------------|
| ------ | --------------------------------------------------- | -------------------------------- | ------------------- |
| file | `{file_name1}.{extension}+{file_name2}.{extension}` | `hello.py` | `server.js+auth.js` |
| folder | `{folder_name1}[]+{folder_name2}[]` | `src[]` | `api[]+auth[]` |
| tree | `{folder_name}[{file1}+{file2}+...]` | `src[main.jsx+data[users.json]]` | |

### Example 🥊

1. Create file tree in current directory

```
$ filet dir1[f1.txt+f2.txt+dir2[f3.txt]]
Successfully created file tree
[{'dir1': ['f1.txt', 'f2.txt', {'dir2': ['f3.txt']}]}]
✔ Successfully created file tree

▼ dir1
∟ f1.txt
∟ f2.txt
▼ dir2
∟ f3.txt
```

2. Create file tree in specified directory using `-r` or `--root` arg

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

- **Relative path**
`$ filet ../tests myfolder[images[]+important[bday.txt+todos.txt]]+software[README.txt]`<br />
Creates the file tree in the parent directory of current directory (in which the terminal runs `filet` command)
- **Relative path**<br />
`$ filet --root ../tests myfolder[images[]+important[bday.txt+todos.txt]]+software[README.txt]`<br />
Creates the file tree in the `tests` folder in **parent directory** of current directory (in which the terminal runs `filet` command)

## Updating

To update the version of `filet` on your computer:

1. Download the desired (preferably _latest_) version of `filet.exe` from the [releases](https://github.com/gitwikc/filet/releases) page.
2. Save it in the directory where you have previously installed `filet`
3. 🎆 YAY! You have successfully updated `filet` on your computer

## Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

## License
[MIT](https://choosealicense.com/licenses/mit/)

[ISC](https://choosealicense.com/licenses/isc/)
Binary file added img/filet.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions release.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"version": "1.2",
"date": "2021-07-03"
"version": "v1.5",
"date": "2021-07-04"
}