@@ -6,6 +6,9 @@ It offers a similar set of git statistics and reports, but it's built entirely
6
6
using Python 3, providing improved cross-platform compatibility
7
7
and ease of maintenance.
8
8
9
+ ![ mainMenuScreenshot] ( https://github.com/user-attachments/assets/4c3f49d8-62a9-4208-a968-5270e36aa3b8 )
10
+
11
+
9
12
## Why Git Py Stats?
10
13
11
14
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:
87
90
pip install -e .
88
91
```
89
92
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:
91
103
92
104
```bash
93
105
git-py-stats --help
94
106
```
95
107
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
+
96
115
### Using `setup.py`
97
116
98
117
If you prefer using `setup.py` directly:
99
118
100
119
1. **Install the Package**:
101
120
102
121
```bash
103
- python setup.py install
122
+ python3 setup.py install
104
123
```
105
124
106
125
2. **Verify the Installation**:
@@ -176,15 +195,15 @@ This project uses Python's built-in `unittest` framework for testing.
176
195
within the ` git_py_stats/tests/` directory:
177
196
178
197
` ` ` bash
179
- python -m unittest discover -s git_py_stats/tests
198
+ python3 -m unittest discover -s git_py_stats/tests
180
199
` ` `
181
200
182
201
3. ** Run a Specific Test File** :
183
202
184
203
To run a specific test file, you can use:
185
204
186
205
` ` ` bash
187
- python -m unittest git_py_stats.tests.test_generate_cmds
206
+ python3 -m unittest git_py_stats.tests.test_generate_cmds
188
207
` ` `
189
208
190
209
# ### Additional Tips
@@ -193,13 +212,13 @@ This project uses Python's built-in `unittest` framework for testing.
193
212
- To view more detailed output, use the ` -v` (verbose) flag:
194
213
195
214
` ` ` bash
196
- python -m unittest discover -s git_py_stats/tests -v
215
+ python3 -m unittest discover -s git_py_stats/tests -v
197
216
` ` `
198
217
199
218
- To run all tests automatically and display a summary of results:
200
219
201
220
` ` ` bash
202
- python -m unittest discover -s git_py_stats/tests
221
+ python3 -m unittest discover -s git_py_stats/tests
203
222
` ` `
204
223
205
224
# # Contribution
0 commit comments