PyPI - git-visual-timeline - Versions diffs - 0.1.0__tar.gz - Mend

git-visual-timeline 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 (29) hide show

git_visual_timeline-0.1.0/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Adam Reese
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

git_visual_timeline-0.1.0/PKG-INFO ADDED Viewed

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: git-visual-timeline
+Version: 0.1.0
+Summary: Git Visual Timeline — a keyboard-driven TUI for exploring file commit history
+Author-email: Adam Reese <areese801@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/areese801/git-visual-timeline
+Project-URL: Repository, https://github.com/areese801/git-visual-timeline
+Project-URL: Issues, https://github.com/areese801/git-visual-timeline/issues
+Keywords: git,tui,timeline,diff,blame,textual
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.40.0
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: pygments>=2.17.0
+Requires-Dist: thefuzz[speedup]>=0.20.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: textual-dev>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+# gvt — Git Visual Timeline
+A keyboard-driven TUI for exploring the commit history of any file in a git repo. Think lazygit meets a video timeline scrubber, focused on per-file history.
+## Install
+```bash
+pip install git-visual-timeline
+```
+## Usage
+```bash
+# Open in any git repo
+gvt
+# Jump directly to a file
+gvt path/to/file.py
+```
+## Features
+- **Visual timeline** with heatmap-colored ticks (green=adds, red=deletes, amber=mixed)
+- **Step-through mode** — scrub one commit at a time to see what changed
+- **Pin mode** — press `x` to mark start/end and diff any two commits
+- **Syntax-highlighted diffs** with inline and whole-file views
+- **Commit search** (`c`) — fuzzy search all repo commits by message, branch name, or author, then drill into changed files
+- **File search** (`f`) — fzf-style file picker
+- **Time filter** (`t`) — filter timeline by date range (1w, 1m, 3m, custom date)
+- **Inline blame** (`b`) — right-aligned blame annotations
+- **Contributor breakdown** (`B`) — visual bar chart of who changed the file
+- **WIP indicator** — hollow tick showing uncommitted changes
+- **5-pane layout** with numbered switching (1-5) and Ctrl+hjkl navigation
+- **tmux integration** — seamless pane switching at edges (add `gvt` to your `is_vim` regex)
+- **Context-sensitive status bar** showing relevant shortcuts per pane
+## Keybindings
+| Key | Action |
+|-----|--------|
+| `1`-`5` | Jump to pane |
+| `Ctrl+h/j/k/l` | Navigate panes directionally |
+| `h`/`l` | Move timeline cursor |
+| `x` | Pin start/end commits |
+| `X` | Snap nearest pin to cursor |
+| `n`/`p` | Next/prev diff hunk |
+| `w` | Toggle whole-file view |
+| `b` | Toggle inline blame |
+| `B` | Contributor breakdown |
+| `c` | Search commits (all repo) |
+| `f` | Search files |
+| `t` | Time filter |
+| `+`/`-` | More/less diff context |
+| `?` | Help |
+| `q` | Quit (with confirmation) |
+| `qq` | Quit immediately |
+## Requirements
+- Python 3.10+
+- A git repository
+## License
+MIT

git_visual_timeline-0.1.0/README.md ADDED Viewed

@@ -0,0 +1,65 @@
+# gvt — Git Visual Timeline
+A keyboard-driven TUI for exploring the commit history of any file in a git repo. Think lazygit meets a video timeline scrubber, focused on per-file history.
+## Install
+```bash
+pip install git-visual-timeline
+```
+## Usage
+```bash
+# Open in any git repo
+gvt
+# Jump directly to a file
+gvt path/to/file.py
+```
+## Features
+- **Visual timeline** with heatmap-colored ticks (green=adds, red=deletes, amber=mixed)
+- **Step-through mode** — scrub one commit at a time to see what changed
+- **Pin mode** — press `x` to mark start/end and diff any two commits
+- **Syntax-highlighted diffs** with inline and whole-file views
+- **Commit search** (`c`) — fuzzy search all repo commits by message, branch name, or author, then drill into changed files
+- **File search** (`f`) — fzf-style file picker
+- **Time filter** (`t`) — filter timeline by date range (1w, 1m, 3m, custom date)
+- **Inline blame** (`b`) — right-aligned blame annotations
+- **Contributor breakdown** (`B`) — visual bar chart of who changed the file
+- **WIP indicator** — hollow tick showing uncommitted changes
+- **5-pane layout** with numbered switching (1-5) and Ctrl+hjkl navigation
+- **tmux integration** — seamless pane switching at edges (add `gvt` to your `is_vim` regex)
+- **Context-sensitive status bar** showing relevant shortcuts per pane
+## Keybindings
+| Key | Action |
+|-----|--------|
+| `1`-`5` | Jump to pane |
+| `Ctrl+h/j/k/l` | Navigate panes directionally |
+| `h`/`l` | Move timeline cursor |
+| `x` | Pin start/end commits |
+| `X` | Snap nearest pin to cursor |
+| `n`/`p` | Next/prev diff hunk |
+| `w` | Toggle whole-file view |
+| `b` | Toggle inline blame |
+| `B` | Contributor breakdown |
+| `c` | Search commits (all repo) |
+| `f` | Search files |
+| `t` | Time filter |
+| `+`/`-` | More/less diff context |
+| `?` | Help |
+| `q` | Quit (with confirmation) |
+| `qq` | Quit immediately |
+## Requirements
+- Python 3.10+
+- A git repository
+## License
+MIT

git_visual_timeline-0.1.0/pyproject.toml ADDED Viewed

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "git-visual-timeline"
+version = "0.1.0"
+description = "Git Visual Timeline — a keyboard-driven TUI for exploring file commit history"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    {name = "Adam Reese", email = "areese801@gmail.com"},
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+keywords = ["git", "tui", "timeline", "diff", "blame", "textual"]
+dependencies = [
+    "textual>=0.40.0",
+    "gitpython>=3.1.40",
+    "pygments>=2.17.0",
+    "thefuzz[speedup]>=0.20.0",
+]
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+    "textual-dev>=1.0",
+    "ruff>=0.1.0",
+    "build",
+    "twine",
+]
+[project.urls]
+Homepage = "https://github.com/areese801/git-visual-timeline"
+Repository = "https://github.com/areese801/git-visual-timeline"
+Issues = "https://github.com/areese801/git-visual-timeline/issues"
+[project.scripts]
+gvt = "gvt.cli:main"
+[tool.setuptools.packages.find]
+where = ["src"]
+[tool.ruff]
+line-length = 88
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

git_visual_timeline-0.1.0/setup.cfg ADDED Viewed

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build =
+tag_date = 0

git_visual_timeline-0.1.0/src/git_visual_timeline.egg-info/PKG-INFO ADDED Viewed

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: git-visual-timeline
+Version: 0.1.0
+Summary: Git Visual Timeline — a keyboard-driven TUI for exploring file commit history
+Author-email: Adam Reese <areese801@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/areese801/git-visual-timeline
+Project-URL: Repository, https://github.com/areese801/git-visual-timeline
+Project-URL: Issues, https://github.com/areese801/git-visual-timeline/issues
+Keywords: git,tui,timeline,diff,blame,textual
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.40.0
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: pygments>=2.17.0
+Requires-Dist: thefuzz[speedup]>=0.20.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: textual-dev>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+# gvt — Git Visual Timeline
+A keyboard-driven TUI for exploring the commit history of any file in a git repo. Think lazygit meets a video timeline scrubber, focused on per-file history.
+## Install
+```bash
+pip install git-visual-timeline
+```
+## Usage
+```bash
+# Open in any git repo
+gvt
+# Jump directly to a file
+gvt path/to/file.py
+```
+## Features
+- **Visual timeline** with heatmap-colored ticks (green=adds, red=deletes, amber=mixed)
+- **Step-through mode** — scrub one commit at a time to see what changed
+- **Pin mode** — press `x` to mark start/end and diff any two commits
+- **Syntax-highlighted diffs** with inline and whole-file views
+- **Commit search** (`c`) — fuzzy search all repo commits by message, branch name, or author, then drill into changed files
+- **File search** (`f`) — fzf-style file picker
+- **Time filter** (`t`) — filter timeline by date range (1w, 1m, 3m, custom date)
+- **Inline blame** (`b`) — right-aligned blame annotations
+- **Contributor breakdown** (`B`) — visual bar chart of who changed the file
+- **WIP indicator** — hollow tick showing uncommitted changes
+- **5-pane layout** with numbered switching (1-5) and Ctrl+hjkl navigation
+- **tmux integration** — seamless pane switching at edges (add `gvt` to your `is_vim` regex)
+- **Context-sensitive status bar** showing relevant shortcuts per pane
+## Keybindings
+| Key | Action |
+|-----|--------|
+| `1`-`5` | Jump to pane |
+| `Ctrl+h/j/k/l` | Navigate panes directionally |
+| `h`/`l` | Move timeline cursor |
+| `x` | Pin start/end commits |
+| `X` | Snap nearest pin to cursor |
+| `n`/`p` | Next/prev diff hunk |
+| `w` | Toggle whole-file view |
+| `b` | Toggle inline blame |
+| `B` | Contributor breakdown |
+| `c` | Search commits (all repo) |
+| `f` | Search files |
+| `t` | Time filter |
+| `+`/`-` | More/less diff context |
+| `?` | Help |
+| `q` | Quit (with confirmation) |
+| `qq` | Quit immediately |
+## Requirements
+- Python 3.10+
+- A git repository
+## License
+MIT

git_visual_timeline-0.1.0/src/git_visual_timeline.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,27 @@
+LICENSE
+README.md
+pyproject.toml
+src/git_visual_timeline.egg-info/PKG-INFO
+src/git_visual_timeline.egg-info/SOURCES.txt
+src/git_visual_timeline.egg-info/dependency_links.txt
+src/git_visual_timeline.egg-info/entry_points.txt
+src/git_visual_timeline.egg-info/requires.txt
+src/git_visual_timeline.egg-info/top_level.txt
+src/gvt/__init__.py
+src/gvt/app.py
+src/gvt/cli.py
+src/gvt/git/__init__.py
+src/gvt/git/cache.py
+src/gvt/git/repo.py
+src/gvt/widgets/__init__.py
+src/gvt/widgets/changed_files.py
+src/gvt/widgets/commit_bar.py
+src/gvt/widgets/commit_toast.py
+src/gvt/widgets/diff_view.py
+src/gvt/widgets/file_tree.py
+src/gvt/widgets/modals.py
+src/gvt/widgets/status_bar.py
+src/gvt/widgets/timeline.py
+tests/test_cache.py
+tests/test_git_repo.py
+tests/test_widgets.py

git_visual_timeline-0.1.0/src/git_visual_timeline.egg-info/dependency_links.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+

git_visual_timeline-0.1.0/src/git_visual_timeline.egg-info/entry_points.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ [console_scripts]
2	+ gvt = gvt.cli:main

git_visual_timeline-0.1.0/src/git_visual_timeline.egg-info/requires.txt ADDED Viewed

@@ -0,0 +1,12 @@
+textual>=0.40.0
+gitpython>=3.1.40
+pygments>=2.17.0
+thefuzz[speedup]>=0.20.0
+[dev]
+pytest>=7.0
+pytest-asyncio>=0.21
+textual-dev>=1.0
+ruff>=0.1.0
+build
+twine

git_visual_timeline-0.1.0/src/git_visual_timeline.egg-info/top_level.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ gvt

git_visual_timeline-0.1.0/src/gvt/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ __version__ = "0.1.0"