contextpulse 0.1.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 (14) hide show
  1. contextpulse-0.1.0/LICENSE +21 -0
  2. contextpulse-0.1.0/PKG-INFO +133 -0
  3. contextpulse-0.1.0/README.md +107 -0
  4. contextpulse-0.1.0/contextpulse/__init__.py +2 -0
  5. contextpulse-0.1.0/contextpulse/main.py +808 -0
  6. contextpulse-0.1.0/contextpulse.egg-info/PKG-INFO +133 -0
  7. contextpulse-0.1.0/contextpulse.egg-info/SOURCES.txt +12 -0
  8. contextpulse-0.1.0/contextpulse.egg-info/dependency_links.txt +1 -0
  9. contextpulse-0.1.0/contextpulse.egg-info/entry_points.txt +2 -0
  10. contextpulse-0.1.0/contextpulse.egg-info/requires.txt +2 -0
  11. contextpulse-0.1.0/contextpulse.egg-info/top_level.txt +1 -0
  12. contextpulse-0.1.0/pyproject.toml +38 -0
  13. contextpulse-0.1.0/setup.cfg +4 -0
  14. contextpulse-0.1.0/tests/test_main.py +149 -0
contextpulse-0.1.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Nathanael Linder
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
contextpulse-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,133 @@
1
+ Metadata-Version: 2.4
2
+ Name: contextpulse
3
+ Version: 0.1.0
4
+ Summary: Turn your Git history into a human story
5
+ Author: Nathanael Linder
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/truth-against-lies/context-pulse
8
+ Project-URL: Issues, https://github.com/truth-against-lies/context-pulse/issues
9
+ Keywords: git,cli,report,changelog,developer-tools
10
+ Classifier: Development Status :: 3 - Alpha
11
+ Classifier: Environment :: Console
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.8
15
+ Classifier: Programming Language :: Python :: 3.9
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Topic :: Software Development :: Version Control :: Git
20
+ Requires-Python: >=3.8
21
+ Description-Content-Type: text/markdown
22
+ License-File: LICENSE
23
+ Requires-Dist: gitpython>=3.1
24
+ Requires-Dist: rich>=13.0
25
+ Dynamic: license-file
26
+
27
+ # ContextPulse
28
+
29
+ Turn your Git history into a human story.
30
+
31
+ ContextPulse is a CLI tool that analyzes your Git repository and generates beautiful, human-readable activity reports. Instead of reading through dozens of raw commits, get a clear summary of what happened, when, and why.
32
+
33
+ ## Features
34
+
35
+ - **Smart Summary** — Automatically detects what you've been working on (bug fixes, new features, improvements)
36
+ - **Category Breakdown** — Groups changes by type (HTML, Python, JavaScript, Config, etc.) with colors
37
+ - **Hot Files** — Shows which files changed the most (your "hot spots")
38
+ - **Daily Activity Chart** — Visual bar chart showing your most active days
39
+ - **Directory Breakdown** — See which folders got the most attention (great for monorepos)
40
+ - **Multiple Time Ranges** — Today, this week, this month, custom days, or since a specific date
41
+ - **Author Filtering** — Focus on one contributor's work
42
+ - **Branch Comparison** — Compare what changed between two branches
43
+ - **Interactive Mode** — Menu-driven interface, no flags to memorize
44
+ - **Export** — Save reports as Markdown or JSON
45
+
46
+ ## Installation
47
+
48
+ ```bash
49
+ pip install contextpulse
50
+ ```
51
+
52
+ Or install from source:
53
+
54
+ ```bash
55
+ git clone https://github.com/truth-against-lies/context-pulse.git
56
+ cd context-pulse
57
+ pip install -r requirements.txt
58
+ python main.py
59
+ ```
60
+
61
+ ## Quick Start
62
+
63
+ ```bash
64
+ # Run in any Git repository
65
+ pulse
66
+
67
+ # See today's activity
68
+ pulse --today
69
+
70
+ # Last 30 days
71
+ pulse --month
72
+
73
+ # Scan a specific repo
74
+ pulse ~/code/my-project
75
+
76
+ # Export to Markdown
77
+ pulse --export report.md
78
+
79
+ # Interactive mode (guided menu)
80
+ pulse --interactive
81
+ ```
82
+
83
+ ## All Options
84
+
85
+ | Flag | Short | Description |
86
+ |------|-------|-------------|
87
+ | `--today` | `-t` | Show today's commits only |
88
+ | `--days N` | `-d N` | Last N days |
89
+ | `--week` | `-w` | Last 7 days (default) |
90
+ | `--month` | `-m` | Last 30 days |
91
+ | `--since DATE` | `-s DATE` | Since a specific date (YYYY-MM-DD) |
92
+ | `--author NAME` | `-a NAME` | Filter by author name |
93
+ | `--compare A..B` | `-c A..B` | Compare two branches |
94
+ | `--export FILE` | `-e FILE` | Export report to Markdown file |
95
+ | `--json` | `-j` | Output as JSON |
96
+ | `--interactive` | `-i` | Interactive menu mode |
97
+
98
+ ## Example Output
99
+
100
+ ```
101
+ ╭────────────────────────────────────╮
102
+ │ ContextPulse - Git Activity Report │
103
+ │ last 7 days │
104
+ ╰──────────── 54 commits ────────────╯
105
+
106
+ ╭──────────────────── Summary ─────────────────────╮
107
+ │ You made 54 commits, focusing mainly on HTML │
108
+ │ (89%). Main activities: bug fixes, new features. │
109
+ │ Also touched: JavaScript, Style. │
110
+ ╰──────────────────────────────────────────────────╯
111
+
112
+ Hot Files (most changed)
113
+ ┏━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┓
114
+ ┃ # ┃ File ┃ Changes ┃
115
+ ┡━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━┩
116
+ │ 1 │ 🔥 index.html │ 12 │
117
+ │ 2 │ 🔥 index-en.html │ 11 │
118
+ │ 3 │ 🔥 sw.js │ 5 │
119
+ └─────┴──────────────────┴─────────┘
120
+
121
+ Daily Activity
122
+ 2026-03-26 ███████████████████████ 7
123
+ 2026-03-27 ██████████████████████████████ 9
124
+ ```
125
+
126
+ ## Requirements
127
+
128
+ - Python 3.8+
129
+ - Git installed on your system
130
+
131
+ ## License
132
+
133
+ MIT
contextpulse-0.1.0/README.md ADDED
@@ -0,0 +1,107 @@
1
+ # ContextPulse
2
+
3
+ Turn your Git history into a human story.
4
+
5
+ ContextPulse is a CLI tool that analyzes your Git repository and generates beautiful, human-readable activity reports. Instead of reading through dozens of raw commits, get a clear summary of what happened, when, and why.
6
+
7
+ ## Features
8
+
9
+ - **Smart Summary** — Automatically detects what you've been working on (bug fixes, new features, improvements)
10
+ - **Category Breakdown** — Groups changes by type (HTML, Python, JavaScript, Config, etc.) with colors
11
+ - **Hot Files** — Shows which files changed the most (your "hot spots")
12
+ - **Daily Activity Chart** — Visual bar chart showing your most active days
13
+ - **Directory Breakdown** — See which folders got the most attention (great for monorepos)
14
+ - **Multiple Time Ranges** — Today, this week, this month, custom days, or since a specific date
15
+ - **Author Filtering** — Focus on one contributor's work
16
+ - **Branch Comparison** — Compare what changed between two branches
17
+ - **Interactive Mode** — Menu-driven interface, no flags to memorize
18
+ - **Export** — Save reports as Markdown or JSON
19
+
20
+ ## Installation
21
+
22
+ ```bash
23
+ pip install contextpulse
24
+ ```
25
+
26
+ Or install from source:
27
+
28
+ ```bash
29
+ git clone https://github.com/truth-against-lies/context-pulse.git
30
+ cd context-pulse
31
+ pip install -r requirements.txt
32
+ python main.py
33
+ ```
34
+
35
+ ## Quick Start
36
+
37
+ ```bash
38
+ # Run in any Git repository
39
+ pulse
40
+
41
+ # See today's activity
42
+ pulse --today
43
+
44
+ # Last 30 days
45
+ pulse --month
46
+
47
+ # Scan a specific repo
48
+ pulse ~/code/my-project
49
+
50
+ # Export to Markdown
51
+ pulse --export report.md
52
+
53
+ # Interactive mode (guided menu)
54
+ pulse --interactive
55
+ ```
56
+
57
+ ## All Options
58
+
59
+ | Flag | Short | Description |
60
+ |------|-------|-------------|
61
+ | `--today` | `-t` | Show today's commits only |
62
+ | `--days N` | `-d N` | Last N days |
63
+ | `--week` | `-w` | Last 7 days (default) |
64
+ | `--month` | `-m` | Last 30 days |
65
+ | `--since DATE` | `-s DATE` | Since a specific date (YYYY-MM-DD) |
66
+ | `--author NAME` | `-a NAME` | Filter by author name |
67
+ | `--compare A..B` | `-c A..B` | Compare two branches |
68
+ | `--export FILE` | `-e FILE` | Export report to Markdown file |
69
+ | `--json` | `-j` | Output as JSON |
70
+ | `--interactive` | `-i` | Interactive menu mode |
71
+
72
+ ## Example Output
73
+
74
+ ```
75
+ ╭────────────────────────────────────╮
76
+ │ ContextPulse - Git Activity Report │
77
+ │ last 7 days │
78
+ ╰──────────── 54 commits ────────────╯
79
+
80
+ ╭──────────────────── Summary ─────────────────────╮
81
+ │ You made 54 commits, focusing mainly on HTML │
82
+ │ (89%). Main activities: bug fixes, new features. │
83
+ │ Also touched: JavaScript, Style. │
84
+ ╰──────────────────────────────────────────────────╯
85
+
86
+ Hot Files (most changed)
87
+ ┏━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┓
88
+ ┃ # ┃ File ┃ Changes ┃
89
+ ┡━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━┩
90
+ │ 1 │ 🔥 index.html │ 12 │
91
+ │ 2 │ 🔥 index-en.html │ 11 │
92
+ │ 3 │ 🔥 sw.js │ 5 │
93
+ └─────┴──────────────────┴─────────┘
94
+
95
+ Daily Activity
96
+ 2026-03-26 ███████████████████████ 7
97
+ 2026-03-27 ██████████████████████████████ 9
98
+ ```
99
+
100
+ ## Requirements
101
+
102
+ - Python 3.8+
103
+ - Git installed on your system
104
+
105
+ ## License
106
+
107
+ MIT
contextpulse-0.1.0/contextpulse/__init__.py ADDED
@@ -0,0 +1,2 @@
1
+ """ContextPulse - Turn your Git history into a human story."""
2
+ __version__ = "0.1.0"