nwcommitaverages 2.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. nwcommitaverages-2.0.1/PKG-INFO +162 -0
  2. nwcommitaverages-2.0.1/README.md +142 -0
  3. nwcommitaverages-2.0.1/nwcommitaverages.egg-info/PKG-INFO +162 -0
  4. nwcommitaverages-2.0.1/nwcommitaverages.egg-info/SOURCES.txt +11 -0
  5. nwcommitaverages-2.0.1/nwcommitaverages.egg-info/dependency_links.txt +1 -0
  6. nwcommitaverages-2.0.1/nwcommitaverages.egg-info/entry_points.txt +2 -0
  7. nwcommitaverages-2.0.1/nwcommitaverages.egg-info/requires.txt +2 -0
  8. nwcommitaverages-2.0.1/nwcommitaverages.egg-info/top_level.txt +3 -0
  9. nwcommitaverages-2.0.1/nwcommitaverages.py +299 -0
  10. nwcommitaverages-2.0.1/nwcommitaveragescli.py +434 -0
  11. nwcommitaverages-2.0.1/setup.cfg +4 -0
  12. nwcommitaverages-2.0.1/setup.py +171 -0
  13. nwcommitaverages-2.0.1/setupinfo.py +14 -0
nwcommitaverages-2.0.1/PKG-INFO ADDED
@@ -0,0 +1,162 @@
1
+ Metadata-Version: 2.4
2
+ Name: nwcommitaverages
3
+ Version: 2.0.1
4
+ Summary: A library designed to calculate the average time between Git commits.
5
+ Home-page: https://github.com/numbworks/nwcommitaverages
6
+ Author: numbworks
7
+ License: MIT
8
+ Requires-Python: >=3.12
9
+ Description-Content-Type: text/markdown
10
+ Requires-Dist: tabulate>=0.9.0
11
+ Requires-Dist: pyyaml>=6.0.3
12
+ Dynamic: author
13
+ Dynamic: description
14
+ Dynamic: description-content-type
15
+ Dynamic: home-page
16
+ Dynamic: license
17
+ Dynamic: requires-dist
18
+ Dynamic: requires-python
19
+ Dynamic: summary
20
+
21
+ # nwcommitaverages
22
+
23
+ ## Introduction
24
+
25
+ This packages consists of the following modules:
26
+
27
+ - `nwcommitaverages` is an application designed to calculate the average time between Git commits.
28
+ - `nwcommitaveragescli` is a command-line application built on the top of `nwcommitaverages`.
29
+
30
+ ## Pre-Requisites
31
+
32
+ In order to work, this library requires to be run against a local Git repository and that Git itself is installed on the machine.
33
+
34
+ ## Getting Started
35
+
36
+ I'll use Debian as operating system, but the concept is similar for Windows or Mac.
37
+
38
+ Procedure:
39
+
40
+ 1. Install `pip` and `venv`:
41
+
42
+ ```sh
43
+ sudo apt install python3-pip python3.12-venv
44
+ ```
45
+
46
+ 2. Create a virtual environment:
47
+
48
+ ```sh
49
+ python3 -m venv /tmp/nwcommitaverages
50
+ source /tmp/nwcommitaverages/bin/activate
51
+ ```
52
+
53
+ 3. Download and install the package:
54
+
55
+ ```sh
56
+ pip install nwcommitaverages
57
+ ```
58
+
59
+ 4. Enter in the interactive Python environment:
60
+
61
+ ```sh
62
+ python3
63
+ ```
64
+ ```
65
+ Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0] on linux
66
+ Type "help", "copyright", "credits" or "license" for more information.
67
+ >>>
68
+ ```
69
+
70
+ 5. Try out if the library works:
71
+
72
+ ```python
73
+ from nwcommitaverages import CommitAverageCalculator
74
+
75
+ ca_calculator : CommitAverageCalculator = CommitAverageCalculator()
76
+ ```
77
+
78
+ 6. Exit from the interactive Python environment:
79
+
80
+ ```python
81
+ exit()
82
+ ```
83
+
84
+ 7. Try out if the CLI application works:
85
+
86
+ ```sh
87
+ nwcommitaveragescli
88
+ ```
89
+
90
+ 8. Deactivate and delete the virtual environment:
91
+
92
+ ```sh
93
+ deactivate
94
+ rm -rf /tmp/nwcommitaverages
95
+ ```
96
+
97
+ 9. Done!
98
+
99
+ ## Examples
100
+
101
+ To run it against the current folder (we assume it contains a `git` repository and that `git` itself is installed):
102
+
103
+ ```sh
104
+ nwcommitaveragescli
105
+ ```
106
+
107
+ ```
108
+ *****************************************************************
109
+ '##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
110
+ ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
111
+ ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
112
+ ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
113
+ ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
114
+ ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
115
+ ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
116
+ ..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
117
+ **********************************************Version: 2.0.1*****
118
+
119
+ Folder:'/home'
120
+
121
+ +-------------+--------+-----------+---------------+------------+
122
+ | YearMonth | Days | Commits | DailyAvgMin | RefNames |
123
+ +=============+========+===========+===============+============+
124
+ | 2025-05 | 2 | 29 | 16.71 | |
125
+ +-------------+--------+-----------+---------------+------------+
126
+ | 2026-03 | 2 | 26 | 16.43 | |
127
+ +-------------+--------+-----------+---------------+------------+
128
+ | 2026-04 | 1 | 4 | 73.76 | |
129
+ +-------------+--------+-----------+---------------+------------+
130
+ ```
131
+
132
+ To run it against another folder (which doesn't contain a `git` repository):
133
+
134
+ ```sh
135
+ nwcommitaveragescli --folder_path /home/test
136
+ ```
137
+
138
+ ```
139
+ *****************************************************************
140
+ '##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
141
+ ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
142
+ ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
143
+ ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
144
+ ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
145
+ ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
146
+ ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
147
+ ..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
148
+ **********************************************Version: 2.0.1*****
149
+
150
+ Folder:'/home/test'
151
+
152
+ Command '['git', '-C', '/home/test', 'log', '--pretty=format:%cs;%ct;%D', '--reverse']' returned non-zero exit status 128.
153
+ ```
154
+
155
+ ## Links
156
+
157
+ - Source: https://github.com/numbworks/nwcommitaverages
158
+ - License: https://github.com/numbworks/nwcommitaverages/blob/master/LICENSE
159
+
160
+ ## Total Downloads (PyPi)
161
+
162
+ [![PyPI Downloads](https://static.pepy.tech/personalized-badge/nwcommitaverages?period=total&units=NONE&left_color=BLACK&right_color=BLUE&left_text=TOTAL+DOWNLOADS)](https://pepy.tech/projects/nwcommitaverages)
nwcommitaverages-2.0.1/README.md ADDED
@@ -0,0 +1,142 @@
1
+ # nwcommitaverages
2
+
3
+ ## Introduction
4
+
5
+ This packages consists of the following modules:
6
+
7
+ - `nwcommitaverages` is an application designed to calculate the average time between Git commits.
8
+ - `nwcommitaveragescli` is a command-line application built on the top of `nwcommitaverages`.
9
+
10
+ ## Pre-Requisites
11
+
12
+ In order to work, this library requires to be run against a local Git repository and that Git itself is installed on the machine.
13
+
14
+ ## Getting Started
15
+
16
+ I'll use Debian as operating system, but the concept is similar for Windows or Mac.
17
+
18
+ Procedure:
19
+
20
+ 1. Install `pip` and `venv`:
21
+
22
+ ```sh
23
+ sudo apt install python3-pip python3.12-venv
24
+ ```
25
+
26
+ 2. Create a virtual environment:
27
+
28
+ ```sh
29
+ python3 -m venv /tmp/nwcommitaverages
30
+ source /tmp/nwcommitaverages/bin/activate
31
+ ```
32
+
33
+ 3. Download and install the package:
34
+
35
+ ```sh
36
+ pip install nwcommitaverages
37
+ ```
38
+
39
+ 4. Enter in the interactive Python environment:
40
+
41
+ ```sh
42
+ python3
43
+ ```
44
+ ```
45
+ Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0] on linux
46
+ Type "help", "copyright", "credits" or "license" for more information.
47
+ >>>
48
+ ```
49
+
50
+ 5. Try out if the library works:
51
+
52
+ ```python
53
+ from nwcommitaverages import CommitAverageCalculator
54
+
55
+ ca_calculator : CommitAverageCalculator = CommitAverageCalculator()
56
+ ```
57
+
58
+ 6. Exit from the interactive Python environment:
59
+
60
+ ```python
61
+ exit()
62
+ ```
63
+
64
+ 7. Try out if the CLI application works:
65
+
66
+ ```sh
67
+ nwcommitaveragescli
68
+ ```
69
+
70
+ 8. Deactivate and delete the virtual environment:
71
+
72
+ ```sh
73
+ deactivate
74
+ rm -rf /tmp/nwcommitaverages
75
+ ```
76
+
77
+ 9. Done!
78
+
79
+ ## Examples
80
+
81
+ To run it against the current folder (we assume it contains a `git` repository and that `git` itself is installed):
82
+
83
+ ```sh
84
+ nwcommitaveragescli
85
+ ```
86
+
87
+ ```
88
+ *****************************************************************
89
+ '##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
90
+ ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
91
+ ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
92
+ ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
93
+ ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
94
+ ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
95
+ ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
96
+ ..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
97
+ **********************************************Version: 2.0.1*****
98
+
99
+ Folder:'/home'
100
+
101
+ +-------------+--------+-----------+---------------+------------+
102
+ | YearMonth | Days | Commits | DailyAvgMin | RefNames |
103
+ +=============+========+===========+===============+============+
104
+ | 2025-05 | 2 | 29 | 16.71 | |
105
+ +-------------+--------+-----------+---------------+------------+
106
+ | 2026-03 | 2 | 26 | 16.43 | |
107
+ +-------------+--------+-----------+---------------+------------+
108
+ | 2026-04 | 1 | 4 | 73.76 | |
109
+ +-------------+--------+-----------+---------------+------------+
110
+ ```
111
+
112
+ To run it against another folder (which doesn't contain a `git` repository):
113
+
114
+ ```sh
115
+ nwcommitaveragescli --folder_path /home/test
116
+ ```
117
+
118
+ ```
119
+ *****************************************************************
120
+ '##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
121
+ ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
122
+ ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
123
+ ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
124
+ ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
125
+ ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
126
+ ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
127
+ ..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
128
+ **********************************************Version: 2.0.1*****
129
+
130
+ Folder:'/home/test'
131
+
132
+ Command '['git', '-C', '/home/test', 'log', '--pretty=format:%cs;%ct;%D', '--reverse']' returned non-zero exit status 128.
133
+ ```
134
+
135
+ ## Links
136
+
137
+ - Source: https://github.com/numbworks/nwcommitaverages
138
+ - License: https://github.com/numbworks/nwcommitaverages/blob/master/LICENSE
139
+
140
+ ## Total Downloads (PyPi)
141
+
142
+ [![PyPI Downloads](https://static.pepy.tech/personalized-badge/nwcommitaverages?period=total&units=NONE&left_color=BLACK&right_color=BLUE&left_text=TOTAL+DOWNLOADS)](https://pepy.tech/projects/nwcommitaverages)
nwcommitaverages-2.0.1/nwcommitaverages.egg-info/PKG-INFO ADDED
@@ -0,0 +1,162 @@
1
+ Metadata-Version: 2.4
2
+ Name: nwcommitaverages
3
+ Version: 2.0.1
4
+ Summary: A library designed to calculate the average time between Git commits.
5
+ Home-page: https://github.com/numbworks/nwcommitaverages
6
+ Author: numbworks
7
+ License: MIT
8
+ Requires-Python: >=3.12
9
+ Description-Content-Type: text/markdown
10
+ Requires-Dist: tabulate>=0.9.0
11
+ Requires-Dist: pyyaml>=6.0.3
12
+ Dynamic: author
13
+ Dynamic: description
14
+ Dynamic: description-content-type
15
+ Dynamic: home-page
16
+ Dynamic: license
17
+ Dynamic: requires-dist
18
+ Dynamic: requires-python
19
+ Dynamic: summary
20
+
21
+ # nwcommitaverages
22
+
23
+ ## Introduction
24
+
25
+ This packages consists of the following modules:
26
+
27
+ - `nwcommitaverages` is an application designed to calculate the average time between Git commits.
28
+ - `nwcommitaveragescli` is a command-line application built on the top of `nwcommitaverages`.
29
+
30
+ ## Pre-Requisites
31
+
32
+ In order to work, this library requires to be run against a local Git repository and that Git itself is installed on the machine.
33
+
34
+ ## Getting Started
35
+
36
+ I'll use Debian as operating system, but the concept is similar for Windows or Mac.
37
+
38
+ Procedure:
39
+
40
+ 1. Install `pip` and `venv`:
41
+
42
+ ```sh
43
+ sudo apt install python3-pip python3.12-venv
44
+ ```
45
+
46
+ 2. Create a virtual environment:
47
+
48
+ ```sh
49
+ python3 -m venv /tmp/nwcommitaverages
50
+ source /tmp/nwcommitaverages/bin/activate
51
+ ```
52
+
53
+ 3. Download and install the package:
54
+
55
+ ```sh
56
+ pip install nwcommitaverages
57
+ ```
58
+
59
+ 4. Enter in the interactive Python environment:
60
+
61
+ ```sh
62
+ python3
63
+ ```
64
+ ```
65
+ Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0] on linux
66
+ Type "help", "copyright", "credits" or "license" for more information.
67
+ >>>
68
+ ```
69
+
70
+ 5. Try out if the library works:
71
+
72
+ ```python
73
+ from nwcommitaverages import CommitAverageCalculator
74
+
75
+ ca_calculator : CommitAverageCalculator = CommitAverageCalculator()
76
+ ```
77
+
78
+ 6. Exit from the interactive Python environment:
79
+
80
+ ```python
81
+ exit()
82
+ ```
83
+
84
+ 7. Try out if the CLI application works:
85
+
86
+ ```sh
87
+ nwcommitaveragescli
88
+ ```
89
+
90
+ 8. Deactivate and delete the virtual environment:
91
+
92
+ ```sh
93
+ deactivate
94
+ rm -rf /tmp/nwcommitaverages
95
+ ```
96
+
97
+ 9. Done!
98
+
99
+ ## Examples
100
+
101
+ To run it against the current folder (we assume it contains a `git` repository and that `git` itself is installed):
102
+
103
+ ```sh
104
+ nwcommitaveragescli
105
+ ```
106
+
107
+ ```
108
+ *****************************************************************
109
+ '##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
110
+ ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
111
+ ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
112
+ ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
113
+ ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
114
+ ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
115
+ ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
116
+ ..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
117
+ **********************************************Version: 2.0.1*****
118
+
119
+ Folder:'/home'
120
+
121
+ +-------------+--------+-----------+---------------+------------+
122
+ | YearMonth | Days | Commits | DailyAvgMin | RefNames |
123
+ +=============+========+===========+===============+============+
124
+ | 2025-05 | 2 | 29 | 16.71 | |
125
+ +-------------+--------+-----------+---------------+------------+
126
+ | 2026-03 | 2 | 26 | 16.43 | |
127
+ +-------------+--------+-----------+---------------+------------+
128
+ | 2026-04 | 1 | 4 | 73.76 | |
129
+ +-------------+--------+-----------+---------------+------------+
130
+ ```
131
+
132
+ To run it against another folder (which doesn't contain a `git` repository):
133
+
134
+ ```sh
135
+ nwcommitaveragescli --folder_path /home/test
136
+ ```
137
+
138
+ ```
139
+ *****************************************************************
140
+ '##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
141
+ ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
142
+ ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
143
+ ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
144
+ ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
145
+ ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
146
+ ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
147
+ ..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
148
+ **********************************************Version: 2.0.1*****
149
+
150
+ Folder:'/home/test'
151
+
152
+ Command '['git', '-C', '/home/test', 'log', '--pretty=format:%cs;%ct;%D', '--reverse']' returned non-zero exit status 128.
153
+ ```
154
+
155
+ ## Links
156
+
157
+ - Source: https://github.com/numbworks/nwcommitaverages
158
+ - License: https://github.com/numbworks/nwcommitaverages/blob/master/LICENSE
159
+
160
+ ## Total Downloads (PyPi)
161
+
162
+ [![PyPI Downloads](https://static.pepy.tech/personalized-badge/nwcommitaverages?period=total&units=NONE&left_color=BLACK&right_color=BLUE&left_text=TOTAL+DOWNLOADS)](https://pepy.tech/projects/nwcommitaverages)
nwcommitaverages-2.0.1/nwcommitaverages.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,11 @@
1
+ README.md
2
+ nwcommitaverages.py
3
+ nwcommitaveragescli.py
4
+ setup.py
5
+ setupinfo.py
6
+ nwcommitaverages.egg-info/PKG-INFO
7
+ nwcommitaverages.egg-info/SOURCES.txt
8
+ nwcommitaverages.egg-info/dependency_links.txt
9
+ nwcommitaverages.egg-info/entry_points.txt
10
+ nwcommitaverages.egg-info/requires.txt
11
+ nwcommitaverages.egg-info/top_level.txt
nwcommitaverages-2.0.1/nwcommitaverages.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ nwcommitaveragescli = nwcommitaveragescli:main
nwcommitaverages-2.0.1/nwcommitaverages.egg-info/requires.txt ADDED
@@ -0,0 +1,2 @@
1
+ tabulate>=0.9.0
2
+ pyyaml>=6.0.3
nwcommitaverages-2.0.1/nwcommitaverages.egg-info/top_level.txt ADDED
@@ -0,0 +1,3 @@
1
+ nwcommitaverages
2
+ nwcommitaveragescli
3
+ setupinfo