Skip to content

Commit bd07641

Browse files
committed
Merge branch 'main' of github.com:tomice/git-py-stats into main
2 parents bfbb217 + 3593299 commit bd07641

File tree

1 file changed

+25
-6
lines changed

1 file changed

+25
-6
lines changed

README.md

Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,9 @@ It offers a similar set of git statistics and reports, but it's built entirely
66
using Python 3, providing improved cross-platform compatibility
77
and ease of maintenance.
88

9+
![mainMenuScreenshot](https://github.com/user-attachments/assets/4c3f49d8-62a9-4208-a968-5270e36aa3b8)
10+
11+
912
## Why Git Py Stats?
1013

1114
While `git-quick-stats` is a fantastic tool, it has some limitations due to its
@@ -87,20 +90,36 @@ Git Py Stats is currently in beta format. As such, it is missing the following:
8790
pip install -e .
8891
```
8992
90-
3. **Verify the Installation**:
93+
Or you can run it locally without `pip` by doing the following
94+
while inside the `git-py-stats` repo from Step 1:
95+
96+
```bash
97+
export PYTHONPATH=$(pwd):$PYTHONPATH
98+
```
99+
100+
4. **Verify the Installation**:
101+
102+
While inside of a valid git repo, type the following:
91103
92104
```bash
93105
git-py-stats --help
94106
```
95107
108+
If you decided to use the `PYTHONPATH` method, commands will need
109+
to be done in the following manner:
110+
111+
```bash
112+
python3 -m git_py_stats.main --help
113+
```
114+
96115
### Using `setup.py`
97116
98117
If you prefer using `setup.py` directly:
99118
100119
1. **Install the Package**:
101120
102121
```bash
103-
python setup.py install
122+
python3 setup.py install
104123
```
105124
106125
2. **Verify the Installation**:
@@ -176,15 +195,15 @@ This project uses Python's built-in `unittest` framework for testing.
176195
within the `git_py_stats/tests/` directory:
177196

178197
```bash
179-
python -m unittest discover -s git_py_stats/tests
198+
python3 -m unittest discover -s git_py_stats/tests
180199
```
181200

182201
3. **Run a Specific Test File**:
183202

184203
To run a specific test file, you can use:
185204

186205
```bash
187-
python -m unittest git_py_stats.tests.test_generate_cmds
206+
python3 -m unittest git_py_stats.tests.test_generate_cmds
188207
```
189208

190209
#### Additional Tips
@@ -193,13 +212,13 @@ This project uses Python's built-in `unittest` framework for testing.
193212
- To view more detailed output, use the `-v` (verbose) flag:
194213

195214
```bash
196-
python -m unittest discover -s git_py_stats/tests -v
215+
python3 -m unittest discover -s git_py_stats/tests -v
197216
```
198217

199218
- To run all tests automatically and display a summary of results:
200219

201220
```bash
202-
python -m unittest discover -s git_py_stats/tests
221+
python3 -m unittest discover -s git_py_stats/tests
203222
```
204223

205224
## Contribution

0 commit comments

Comments
 (0)