8000 Update README.md · realpython/rptree@5a9ce07 · GitHub
[go: up one dir, main page]

Skip to content

Commit 5a9ce07

Browse files
committed
Update README.md
1 parent a9d243e commit 5a9ce07

File tree

1 file changed

+31
-15
lines changed

1 file changed

+31
-15
lines changed

README.md

Lines changed: 31 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,54 @@
11
# RP Tree
22

3-
RP Tree is a command-line tool to generate a directory tree diagram.
3+
RP Tree is a command-line tool to generate directory tree diagrams.
44

5-
## Run the App
5+
## Installation
66

7-
To run **RP Tree**, you need to download the source code. Then open a terminal or command-line window and run the following steps:
8-
9-
1. Create and activate a Python virtual environment
7+
To install **RP Tree**, just run the following command:
108

119
```sh
12-
$ cd rptree/
13-
$ python -m venv ./venv
14-
$ source venv/bin/activate
15-
(venv) $
10+
$ pip install rptree
1611
```
1712

18-
2. Run the application
13+
## Usage
1914

2015
```sh
21-
(venv) $ python tree.py /path/to/directory/
16+
$ rptree /path/to/directory/
2217
```
2318

2419
**Note:** The `-h` or `--help` option provides help on how to use RP Tree.
2520

26-
## Current Features
21+
## Sample Output
22+
23+
```sh
24+
$ rptree hello/
25+
./hello/
26+
27+
├── hello/
28+
│ ├── __init__.py
29+
│ └── hello.py
30+
31+
├── tests/
32+
│ └── test_hello.py
33+
34+
├── requirements.txt
35+
├── setup.py
36+
├── README.md
37+
└── LICENSE
38+
```
39+
40+
That's it! You've generated a nice directory tree diagram.
41+
42+
## Features
2743

28-
If you run RP Tree with a directory path as an argument, then you get the full directory tree printed on your screen. The default input directory is your current directory.
44+
If you run RP Tree with a directory path as an argument, then you get a full directory tree diagram printed on your screen. The default input directory is your current directory.
2945

3046
RP Tree also provides the following options:
3147

3248
- `-v`, `--version` shows the application version and exits
3349
- `-h`, `--help` show a usage message
34-
- `-d`, `--dir-only` generates a directory-only tree
35-
- `-o`, `--output-file` generates a tree and save it to a file in markdown format
50+
- `-d`, `--dir-only` generates a directory-only tree diagram
51+
- `-o`, `--output-file` generates a full directory tree diagram and save it to a file in markdown format
3652

3753
## Release History
3854

0 commit comments

Comments
 (0)
0