Skip to content

Commit 416ac2a

Browse files
committed
Add documentation
1 parent 817fe6e commit 416ac2a

File tree

3 files changed

+42
-0
lines changed

3 files changed

+42
-0
lines changed

README.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
## About
2+
3+
`pwd` is a Python tool to create a perfect bash prompt!
4+
5+
### Features:
6+
- Color
7+
- User+hostname if on an external system
8+
- Version control integration
9+
- Repo name
10+
- Submodule support
11+
- Dirty/clean flag
12+
- Supports: git
13+
- Python virtual environment (limited)
14+
15+
### Examples:
16+
17+
![An example](https://raw.githubusercontent.com/bclarkx2/pwd/master/doc/example1.png)
18+
19+
![Another example](https://raw.githubusercontent.com/bclarkx2/pwd/master/doc/example2.png)
20+
21+
22+
## Installation
23+
24+
Clone the git repo:
25+
26+
`git clone git@github.com:bclarkx2/pwd`
27+
28+
29+
Install using `make`:
30+
31+
`make install`
32+
33+
34+
Add the following line to your `.bashrc` (or other shell configuration files):
35+
36+
`export PROMPT_COMMAND='PS1="$(pwd.py)"`
37+
38+
39+
## Configuration
40+
41+
### Username/hostname
42+
If the current username and hostname are both equal to the respective values in the `MY_USERNAME` and `MY_HOSTNAME` environment variables, the `user@hostname` part of the prompt will be suppressed.

doc/example1.png

6.29 KB
Loading

doc/example2.png

6.48 KB
Loading

0 commit comments

Comments
 (0)