git-ember 1.2.0__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 (15) hide show
  1. git_ember-1.2.0/PKG-INFO +165 -0
  2. git_ember-1.2.0/README.md +157 -0
  3. git_ember-1.2.0/pyproject.toml +19 -0
  4. git_ember-1.2.0/setup.cfg +4 -0
  5. git_ember-1.2.0/src/git_ember.egg-info/PKG-INFO +165 -0
  6. git_ember-1.2.0/src/git_ember.egg-info/SOURCES.txt +13 -0
  7. git_ember-1.2.0/src/git_ember.egg-info/dependency_links.txt +1 -0
  8. git_ember-1.2.0/src/git_ember.egg-info/entry_points.txt +2 -0
  9. git_ember-1.2.0/src/git_ember.egg-info/requires.txt +1 -0
  10. git_ember-1.2.0/src/git_ember.egg-info/top_level.txt +1 -0
  11. git_ember-1.2.0/src/gitember/__init__.py +1 -0
  12. git_ember-1.2.0/src/gitember/cli.py +414 -0
  13. git_ember-1.2.0/src/gitember/colors.py +143 -0
  14. git_ember-1.2.0/src/gitember/git.py +535 -0
  15. git_ember-1.2.0/src/gitember/render.py +293 -0
git_ember-1.2.0/PKG-INFO ADDED
@@ -0,0 +1,165 @@
1
+ Metadata-Version: 2.4
2
+ Name: git-ember
3
+ Version: 1.2.0
4
+ Summary: A GitHub-style heatmap of commits for your terminal
5
+ Requires-Python: >=3.11
6
+ Description-Content-Type: text/markdown
7
+ Requires-Dist: ruff>=0.15.9
8
+
9
+ # git-ember
10
+
11
+ A GitHub-style heatmap of commit activity for your terminal.
12
+
13
+ ## Overview
14
+
15
+ `git-ember` displays a colored grid representing commit activity over time, similar to the contribution graph shown on GitHub profiles. It reads directly from your local Git history—no external APIs or network requests required.
16
+
17
+ The tool supports multiple color schemes, branch filtering, custom date ranges, and can display repository statistics, recent commits, and top contributors.
18
+
19
+ ## Prerequisites
20
+
21
+ - Python 3.11 or higher
22
+ - Git installed and available in PATH
23
+
24
+ ## Installation
25
+
26
+ Clone the repository:
27
+
28
+ ```bash
29
+ git clone https://codeberg.org/lukavr05/git-ember.git
30
+ cd git-ember
31
+ ```
32
+
33
+
34
+ ### Running without installation
35
+
36
+ ```bash
37
+ PYTHONPATH=src python3 main.py .
38
+ ```
39
+
40
+ ## Configuration
41
+
42
+ git-ember reads configuration from `~/.config/git-ember/config.toml`. CLI arguments take precedence over config values.
43
+
44
+ | Variable | Required | Default | Description |
45
+ |----------|----------|---------|-------------|
46
+ | `color` | No | `green` | Color scheme name |
47
+ | `border` | No | `=` | Border character |
48
+
49
+ ## Usage
50
+
51
+ Show commit heatmap for the current year:
52
+
53
+ ```bash
54
+ git-ember
55
+ ```
56
+
57
+ Show heatmap for a specific repository:
58
+
59
+ ```bash
60
+ git-ember /path/to/repo
61
+ ```
62
+
63
+ Show multiple years:
64
+
65
+ ```bash
66
+ git-ember --years 2
67
+ git-ember -y 3
68
+ ```
69
+
70
+ Use different color schemes:
71
+
72
+ ```bash
73
+ git-ember --color blue
74
+ git-ember --color orange
75
+ git-ember --color purple
76
+ git-ember --color mono
77
+ ```
78
+
79
+ Show heatmap for a specific branch:
80
+
81
+ ```bash
82
+ git-ember --branch feature-x
83
+ ```
84
+
85
+ Display branch tree visualization:
86
+
87
+ ```bash
88
+ git-ember --tree
89
+ git-ember --branch feature-x --tree
90
+ ```
91
+
92
+ Show custom date range:
93
+
94
+ ```bash
95
+ git-ember --after 2025-01-01 --before 2025-06-30
96
+ git-ember --after 2025-01-01
97
+ ```
98
+
99
+ Show extended report with recent commits and top contributors:
100
+
101
+ ```bash
102
+ git-ember --extended
103
+ git-ember -e
104
+ ```
105
+
106
+ Show repository statistics:
107
+
108
+ ```bash
109
+ git-ember --stats
110
+ git-ember -S
111
+ ```
112
+
113
+ ### Command-line options
114
+
115
+ | Flag | Alias | Description | Default |
116
+ |------|-------|-------------|---------|
117
+ | `--color` | `-c` | Color scheme | `green` |
118
+ | `--years` | `-y` | Number of years to show | `1` |
119
+ | `--border` | `-b` | Border character | `=` |
120
+ | `--extended` | `-e` | Show recent commits and top contributors | `false` |
121
+ | `--stats` | `-S` | Show repository statistics | `false` |
122
+ | `--ascii` | `-a` | Use ASCII characters instead of Unicode | `false` |
123
+ | `--compact` | - | Show last 4 months only | `false` |
124
+ | `--branch` | - | Show heatmap for specific branch | all branches |
125
+ | `--tree` | `-t` | Show branch tree under heatmap | `false` |
126
+ | `--scale` | - | Intensity scaling: auto or adaptive | `auto` |
127
+ | `--after` | - | Show commits after date (YYYY-MM-DD) | - |
128
+ | `--before` | - | Show commits before date (YYYY-MM-DD) | - |
129
+ | `--version` | `-V` | Show version | - |
130
+ | `--help` | `-h` | Show help | - |
131
+
132
+ ## Project Structure
133
+
134
+ ```
135
+ git-ember/
136
+ ├── main.py # Entry point
137
+ ├── pyproject.toml # Package configuration
138
+ ├── Makefile # Build targets
139
+ ├── .python-version # Python version (3.11)
140
+ ├── README.md # This file
141
+ ├── docs/
142
+ │ ├── CHANGELOG.md # Version history
143
+ │ └── PLAN.md # Feature planning
144
+ └── src/
145
+ └── githeat/
146
+ ├── __init__.py # Package version
147
+ ├── cli.py # CLI argument parsing and config
148
+ ├── git.py # Git command execution and parsing
149
+ ├── render.py # Grid and branch tree rendering
150
+ └── colors.py # ANSI color scheme definitions
151
+ ```
152
+
153
+ ## Development
154
+
155
+ Run the linter:
156
+
157
+ ```bash
158
+ make lint
159
+ ```
160
+
161
+ > ⚠️ Note: No test suite exists currently.
162
+
163
+ ## License
164
+
165
+ No LICENSE file exists in this repository.
git_ember-1.2.0/README.md ADDED
@@ -0,0 +1,157 @@
1
+ # git-ember
2
+
3
+ A GitHub-style heatmap of commit activity for your terminal.
4
+
5
+ ## Overview
6
+
7
+ `git-ember` displays a colored grid representing commit activity over time, similar to the contribution graph shown on GitHub profiles. It reads directly from your local Git history—no external APIs or network requests required.
8
+
9
+ The tool supports multiple color schemes, branch filtering, custom date ranges, and can display repository statistics, recent commits, and top contributors.
10
+
11
+ ## Prerequisites
12
+
13
+ - Python 3.11 or higher
14
+ - Git installed and available in PATH
15
+
16
+ ## Installation
17
+
18
+ Clone the repository:
19
+
20
+ ```bash
21
+ git clone https://codeberg.org/lukavr05/git-ember.git
22
+ cd git-ember
23
+ ```
24
+
25
+
26
+ ### Running without installation
27
+
28
+ ```bash
29
+ PYTHONPATH=src python3 main.py .
30
+ ```
31
+
32
+ ## Configuration
33
+
34
+ git-ember reads configuration from `~/.config/git-ember/config.toml`. CLI arguments take precedence over config values.
35
+
36
+ | Variable | Required | Default | Description |
37
+ |----------|----------|---------|-------------|
38
+ | `color` | No | `green` | Color scheme name |
39
+ | `border` | No | `=` | Border character |
40
+
41
+ ## Usage
42
+
43
+ Show commit heatmap for the current year:
44
+
45
+ ```bash
46
+ git-ember
47
+ ```
48
+
49
+ Show heatmap for a specific repository:
50
+
51
+ ```bash
52
+ git-ember /path/to/repo
53
+ ```
54
+
55
+ Show multiple years:
56
+
57
+ ```bash
58
+ git-ember --years 2
59
+ git-ember -y 3
60
+ ```
61
+
62
+ Use different color schemes:
63
+
64
+ ```bash
65
+ git-ember --color blue
66
+ git-ember --color orange
67
+ git-ember --color purple
68
+ git-ember --color mono
69
+ ```
70
+
71
+ Show heatmap for a specific branch:
72
+
73
+ ```bash
74
+ git-ember --branch feature-x
75
+ ```
76
+
77
+ Display branch tree visualization:
78
+
79
+ ```bash
80
+ git-ember --tree
81
+ git-ember --branch feature-x --tree
82
+ ```
83
+
84
+ Show custom date range:
85
+
86
+ ```bash
87
+ git-ember --after 2025-01-01 --before 2025-06-30
88
+ git-ember --after 2025-01-01
89
+ ```
90
+
91
+ Show extended report with recent commits and top contributors:
92
+
93
+ ```bash
94
+ git-ember --extended
95
+ git-ember -e
96
+ ```
97
+
98
+ Show repository statistics:
99
+
100
+ ```bash
101
+ git-ember --stats
102
+ git-ember -S
103
+ ```
104
+
105
+ ### Command-line options
106
+
107
+ | Flag | Alias | Description | Default |
108
+ |------|-------|-------------|---------|
109
+ | `--color` | `-c` | Color scheme | `green` |
110
+ | `--years` | `-y` | Number of years to show | `1` |
111
+ | `--border` | `-b` | Border character | `=` |
112
+ | `--extended` | `-e` | Show recent commits and top contributors | `false` |
113
+ | `--stats` | `-S` | Show repository statistics | `false` |
114
+ | `--ascii` | `-a` | Use ASCII characters instead of Unicode | `false` |
115
+ | `--compact` | - | Show last 4 months only | `false` |
116
+ | `--branch` | - | Show heatmap for specific branch | all branches |
117
+ | `--tree` | `-t` | Show branch tree under heatmap | `false` |
118
+ | `--scale` | - | Intensity scaling: auto or adaptive | `auto` |
119
+ | `--after` | - | Show commits after date (YYYY-MM-DD) | - |
120
+ | `--before` | - | Show commits before date (YYYY-MM-DD) | - |
121
+ | `--version` | `-V` | Show version | - |
122
+ | `--help` | `-h` | Show help | - |
123
+
124
+ ## Project Structure
125
+
126
+ ```
127
+ git-ember/
128
+ ├── main.py # Entry point
129
+ ├── pyproject.toml # Package configuration
130
+ ├── Makefile # Build targets
131
+ ├── .python-version # Python version (3.11)
132
+ ├── README.md # This file
133
+ ├── docs/
134
+ │ ├── CHANGELOG.md # Version history
135
+ │ └── PLAN.md # Feature planning
136
+ └── src/
137
+ └── githeat/
138
+ ├── __init__.py # Package version
139
+ ├── cli.py # CLI argument parsing and config
140
+ ├── git.py # Git command execution and parsing
141
+ ├── render.py # Grid and branch tree rendering
142
+ └── colors.py # ANSI color scheme definitions
143
+ ```
144
+
145
+ ## Development
146
+
147
+ Run the linter:
148
+
149
+ ```bash
150
+ make lint
151
+ ```
152
+
153
+ > ⚠️ Note: No test suite exists currently.
154
+
155
+ ## License
156
+
157
+ No LICENSE file exists in this repository.
git_ember-1.2.0/pyproject.toml ADDED
@@ -0,0 +1,19 @@
1
+ [project]
2
+ name = "git-ember"
3
+ version = "1.2.0"
4
+ description = "A GitHub-style heatmap of commits for your terminal"
5
+ readme = "README.md"
6
+ requires-python = ">=3.11"
7
+ dependencies = [
8
+ "ruff>=0.15.9",
9
+ ]
10
+
11
+ [project.scripts]
12
+ git-ember = "gitember.cli:main"
13
+
14
+ [tool.setuptools.packages.find]
15
+ where = ["src"]
16
+
17
+ [build-system]
18
+ requires = ["setuptools>=63", "wheel"]
19
+ build-backend = "setuptools.build_meta"
git_ember-1.2.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
git_ember-1.2.0/src/git_ember.egg-info/PKG-INFO ADDED
@@ -0,0 +1,165 @@
1
+ Metadata-Version: 2.4
2
+ Name: git-ember
3
+ Version: 1.2.0
4
+ Summary: A GitHub-style heatmap of commits for your terminal
5
+ Requires-Python: >=3.11
6
+ Description-Content-Type: text/markdown
7
+ Requires-Dist: ruff>=0.15.9
8
+
9
+ # git-ember
10
+
11
+ A GitHub-style heatmap of commit activity for your terminal.
12
+
13
+ ## Overview
14
+
15
+ `git-ember` displays a colored grid representing commit activity over time, similar to the contribution graph shown on GitHub profiles. It reads directly from your local Git history—no external APIs or network requests required.
16
+
17
+ The tool supports multiple color schemes, branch filtering, custom date ranges, and can display repository statistics, recent commits, and top contributors.
18
+
19
+ ## Prerequisites
20
+
21
+ - Python 3.11 or higher
22
+ - Git installed and available in PATH
23
+
24
+ ## Installation
25
+
26
+ Clone the repository:
27
+
28
+ ```bash
29
+ git clone https://codeberg.org/lukavr05/git-ember.git
30
+ cd git-ember
31
+ ```
32
+
33
+
34
+ ### Running without installation
35
+
36
+ ```bash
37
+ PYTHONPATH=src python3 main.py .
38
+ ```
39
+
40
+ ## Configuration
41
+
42
+ git-ember reads configuration from `~/.config/git-ember/config.toml`. CLI arguments take precedence over config values.
43
+
44
+ | Variable | Required | Default | Description |
45
+ |----------|----------|---------|-------------|
46
+ | `color` | No | `green` | Color scheme name |
47
+ | `border` | No | `=` | Border character |
48
+
49
+ ## Usage
50
+
51
+ Show commit heatmap for the current year:
52
+
53
+ ```bash
54
+ git-ember
55
+ ```
56
+
57
+ Show heatmap for a specific repository:
58
+
59
+ ```bash
60
+ git-ember /path/to/repo
61
+ ```
62
+
63
+ Show multiple years:
64
+
65
+ ```bash
66
+ git-ember --years 2
67
+ git-ember -y 3
68
+ ```
69
+
70
+ Use different color schemes:
71
+
72
+ ```bash
73
+ git-ember --color blue
74
+ git-ember --color orange
75
+ git-ember --color purple
76
+ git-ember --color mono
77
+ ```
78
+
79
+ Show heatmap for a specific branch:
80
+
81
+ ```bash
82
+ git-ember --branch feature-x
83
+ ```
84
+
85
+ Display branch tree visualization:
86
+
87
+ ```bash
88
+ git-ember --tree
89
+ git-ember --branch feature-x --tree
90
+ ```
91
+
92
+ Show custom date range:
93
+
94
+ ```bash
95
+ git-ember --after 2025-01-01 --before 2025-06-30
96
+ git-ember --after 2025-01-01
97
+ ```
98
+
99
+ Show extended report with recent commits and top contributors:
100
+
101
+ ```bash
102
+ git-ember --extended
103
+ git-ember -e
104
+ ```
105
+
106
+ Show repository statistics:
107
+
108
+ ```bash
109
+ git-ember --stats
110
+ git-ember -S
111
+ ```
112
+
113
+ ### Command-line options
114
+
115
+ | Flag | Alias | Description | Default |
116
+ |------|-------|-------------|---------|
117
+ | `--color` | `-c` | Color scheme | `green` |
118
+ | `--years` | `-y` | Number of years to show | `1` |
119
+ | `--border` | `-b` | Border character | `=` |
120
+ | `--extended` | `-e` | Show recent commits and top contributors | `false` |
121
+ | `--stats` | `-S` | Show repository statistics | `false` |
122
+ | `--ascii` | `-a` | Use ASCII characters instead of Unicode | `false` |
123
+ | `--compact` | - | Show last 4 months only | `false` |
124
+ | `--branch` | - | Show heatmap for specific branch | all branches |
125
+ | `--tree` | `-t` | Show branch tree under heatmap | `false` |
126
+ | `--scale` | - | Intensity scaling: auto or adaptive | `auto` |
127
+ | `--after` | - | Show commits after date (YYYY-MM-DD) | - |
128
+ | `--before` | - | Show commits before date (YYYY-MM-DD) | - |
129
+ | `--version` | `-V` | Show version | - |
130
+ | `--help` | `-h` | Show help | - |
131
+
132
+ ## Project Structure
133
+
134
+ ```
135
+ git-ember/
136
+ ├── main.py # Entry point
137
+ ├── pyproject.toml # Package configuration
138
+ ├── Makefile # Build targets
139
+ ├── .python-version # Python version (3.11)
140
+ ├── README.md # This file
141
+ ├── docs/
142
+ │ ├── CHANGELOG.md # Version history
143
+ │ └── PLAN.md # Feature planning
144
+ └── src/
145
+ └── githeat/
146
+ ├── __init__.py # Package version
147
+ ├── cli.py # CLI argument parsing and config
148
+ ├── git.py # Git command execution and parsing
149
+ ├── render.py # Grid and branch tree rendering
150
+ └── colors.py # ANSI color scheme definitions
151
+ ```
152
+
153
+ ## Development
154
+
155
+ Run the linter:
156
+
157
+ ```bash
158
+ make lint
159
+ ```
160
+
161
+ > ⚠️ Note: No test suite exists currently.
162
+
163
+ ## License
164
+
165
+ No LICENSE file exists in this repository.
git_ember-1.2.0/src/git_ember.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,13 @@
1
+ README.md
2
+ pyproject.toml
3
+ src/git_ember.egg-info/PKG-INFO
4
+ src/git_ember.egg-info/SOURCES.txt
5
+ src/git_ember.egg-info/dependency_links.txt
6
+ src/git_ember.egg-info/entry_points.txt
7
+ src/git_ember.egg-info/requires.txt
8
+ src/git_ember.egg-info/top_level.txt
9
+ src/gitember/__init__.py
10
+ src/gitember/cli.py
11
+ src/gitember/colors.py
12
+ src/gitember/git.py
13
+ src/gitember/render.py
git_ember-1.2.0/src/git_ember.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ git-ember = gitember.cli:main
git_ember-1.2.0/src/git_ember.egg-info/requires.txt ADDED
@@ -0,0 +1 @@
1
+ ruff>=0.15.9
git_ember-1.2.0/src/git_ember.egg-info/top_level.txt ADDED
@@ -0,0 +1 @@
1
+ gitember
git_ember-1.2.0/src/gitember/__init__.py ADDED
@@ -0,0 +1 @@
1
+ __version__ = "1.2.0"