gitpane 1.0.0__tar.gz

gitpane-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thongvan Alexis
+
+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.

gitpane-1.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+prune tests
+exclude README.md

gitpane-1.0.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: gitpane
+Version: 1.0.0
+Summary: Lightweight desktop Git client for Windows, Linux and macOS, in the spirit of Git Extensions
+Author: Thongvan Alexis
+License-Expression: MIT AND OFL-1.1 AND PSF-2.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: <3.15,>=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+License-File: src/gitpane/ui/resource/NotoColorEmoji-OFL.txt
+License-File: src/gitpane/vendor/DISTLIB-LICENSE.txt
+Requires-Dist: PySide6-Essentials<6.12,>=6.11.2
+Requires-Dist: Pygments<3,>=2.21
+Provides-Extra: dev
+Requires-Dist: PySide6-Essentials==6.11.2; extra == "dev"
+Requires-Dist: shiboken6==6.11.2; extra == "dev"
+Requires-Dist: Pygments==2.21.0; extra == "dev"
+Requires-Dist: pip==26.2.1; extra == "dev"
+Requires-Dist: setuptools==84.0.0; extra == "dev"
+Requires-Dist: pytest==9.1.1; extra == "dev"
+Requires-Dist: pytest-qt==4.5.0; extra == "dev"
+Requires-Dist: pytest-xdist==3.8.0; extra == "dev"
+Requires-Dist: execnet==2.1.2; extra == "dev"
+Requires-Dist: ruff==0.16.6; extra == "dev"
+Requires-Dist: colorama==0.4.6; sys_platform == "win32" and extra == "dev"
+Requires-Dist: iniconfig==2.3.0; extra == "dev"
+Requires-Dist: packaging==26.3; extra == "dev"
+Requires-Dist: pluggy==1.6.0; extra == "dev"
+Requires-Dist: typing_extensions==4.16.0; extra == "dev"
+Requires-Dist: build==1.6.1; extra == "dev"
+Requires-Dist: pyproject_hooks==1.3.3; extra == "dev"
+Dynamic: license-file
+
+# GitPane
+
+GitPane is a Git Extensions clone that runs on Windows, macOS and most Linux distributions. I only reimplemented the features I have used every day for the past 16 years.
+
+GitPane needs Git and Python 3.13 or 3.14 (Python 3.15 is not supported yet).
+
+## Install
+
+Install GitPane with pipx: it creates a private environment for GitPane and puts the `gitpane` command on your PATH. On Linux and macOS, the system Python does not accept new packages, so pipx is the simple way (regular pip into a venv of your own also works).
+
+---
+### macOS
+
+```bash
+brew install python@3.13 pipx
+pipx ensurepath
+```
+
+In a **new** terminal:
+
+```bash
+pipx install --python python3.13 gitpane
+```
+
+Run `gitpane` in any terminal, then click **Settings › Utilities › Create desktop shortcut** to get a launcher on your desktop.
+
+---
+### Linux
+
+Fedora:
+
+```bash
+sudo dnf install pipx
+pipx ensurepath
+```
+
+Ubuntu and Debian:
+
+```bash
+sudo apt update
+sudo apt install pipx libxcb-cursor0 # required for X11 versions of linux
+pipx ensurepath
+```
+
+In a **new** terminal:
+
+```bash
+pipx install gitpane
+```
+
+Run `gitpane` in any terminal, then click **Settings › Utilities › Create desktop shortcut** to get a launcher on your desktop.
+
+---
+### Windows
+
+Install Python 3.14 from [python.org](https://www.python.org/downloads/windows/), then in PowerShell or Command Prompt:
+
+```powershell
+python -m pip install --user pipx
+python -m pipx ensurepath
+```
+
+pip may warn that `pipx.exe` is not on PATH: `ensurepath` has just fixed that.
+
+In a **new** terminal:
+
+```powershell
+pipx install gitpane
+```
+Run `gitpane` in any terminal, then click **Settings › Utilities › Create desktop shortcut** to get a launcher on your desktop.
+
+## Update
+
+Close GitPane, then:
+
+```bash
+pipx upgrade gitpane
+```
+
+---
+## Command line
+
+- `gitpane` starts GitPane and gives the terminal back. Closing the terminal does not close GitPane.
+- `gitpane --attach` keeps GitPane attached to the terminal: its output and errors are shown there, and Ctrl+C stops it.
+- `gitpane --log` writes a diagnostic log and shows its path.
+- `gitpane --version` prints the version (Linux and macOS).
+
+## When gitpane is not found
+
+Run `pipx ensurepath` again (`python -m pipx ensurepath` on Windows), then open a **new** terminal: the PATH change only reaches terminals opened after it.
+
+## License
+
+GitPane is under the MIT license. It ships the Noto Color Emoji font under the SIL Open Font License 1.1 (OFL-1.1) and the Windows launchers of distlib under the Python Software Foundation License 2.0 (PSF-2.0).

gitpane-1.0.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,109 @@
+# Third-party notices
+
+## GitPane action drawings
+
+The maintainer supplied thirteen redrawn PNGs on 2026-09-13 in commit `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`, replacing the previously imported images. Those files are preserved byte for byte. The provenance below records that maintainer declaration; it does not assign an additional image-specific license or make a legal assurance.
+
+Stash and Resolve are original geometric drawings created for GitPane with the existing Qt drawing language. Their maintained source is [tools/draw_conflict_icon.py](tools/draw_conflict_icon.py), using the existing gold palette and green action color. They were neither copied nor traced from upstream artwork. Regenerate only those two files with `.venv/Scripts/python.exe tools/draw_conflict_icon.py`. Runtime resources are the local PNG files under `src/gitpane/ui/resource/`.
+
+The "Choose another revision" button icon of the Cherry pick commit form (a list sheet with one highlighted row and a mouse pointer) is an original geometric drawing created for GitPane with the same Qt drawing language. It is painted at runtime by `_paint_revision_choice` in [src/gitpane/ui/look/action_icon.py](src/gitpane/ui/look/action_icon.py) and has no image file. It was neither copied nor traced from Git Extensions or any other upstream artwork.
+
+The "Rebase current branch here interactively" entry of the history graph menu (a grey target branch with three commits, two blue commits beside it and a curved blue arrow bringing them down onto the target) is an original geometric drawing created for GitPane from the maintainer's own hand sketch, with the same Qt drawing language. It is painted at runtime by `_paint_rebase` in [src/gitpane/ui/look/action_icon.py](src/gitpane/ui/look/action_icon.py) and has no image file. It was neither copied nor traced from Git Extensions or any other upstream artwork.
+
+The "Stash pop" toolbar icon (the Stash tray with its sheet raised out of it and a green arrow pointing up on the sheet) is an original geometric drawing created for GitPane, chosen by the maintainer on 2026-09-19 among four GitPane sketches. It reuses the tray geometry of GitPane's own Stash drawing and the existing gold and green palette. It is painted at runtime by `_paint_stash_pop` in [src/gitpane/ui/look/action_icon.py](src/gitpane/ui/look/action_icon.py) and has no image file. It was neither copied nor traced from Git Extensions or any other upstream artwork.
+
+### ArrowDown.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `dec43df395521333c878595143d987187bb86351fb4debd4dbd67bda23fec423`.
+
+### ArrowUp.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `58934c6cef434c249c08553d4c6cff36ffcbdb3c5fb553fd8e29e805fe0e29c2`.
+
+### BranchCheckout.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `6331408167f5ef106d0a743c10c67ea98d3aa9abe1732e6a782c24d6dc3db9fb`.
+
+### BranchCreate.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `e782a8bc0fcd78358ba4f75ae498f4b284b814315c82ea22cf8f881d043254d2`.
+
+### BranchDelete.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `017fb620a4b964660e33eb410663304f9e193f0b3211a2cc010145524e67fbe9`.
+
+### checkout.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `13838b8d23962c88d3013b257acbf7826bf37dc3c12615dfbb7e1aecd52e5e49`.
+
+### CopyToClipboard.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `bdfe68b3e706135122914f4c4d46f0dcdaaf8688ea955f01b0d217bf01a23280`.
+
+### Renamed.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `9236c87cacd29b3c67f7be979a54acd7e76f0530c34e85417a15b79461b79bec`.
+
+### ResetAnotherBranchToHere.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `f1ec601281ebee395d576ec659f3e98ce01f5c36a9deb15c607ddc9ddc76c222`.
+
+### ResetCurrentBranchToHere.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `7a39350f2ac63f4e91202f0064883ec1e85668b9faea8d9afc62318c03ae482e`.
+
+### Stash.png
+
+- **Source:** Original GitPane drawing; source: `tools/draw_conflict_icon.py`.
+- **SHA-256:** `5af52be7748964ba97d24c072dae43e20f7b759a37fafac332effdc17decc83f`.
+
+### Tag.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `3bdcc3b37825a0625f18e0981a5739bb3cacbb080822972a16bca31ab67a2a91`.
+
+### TagCreate.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `f5e8722cfcf1142c22c6e0681ab8dc3548c041ec6bb228628a5cbc1a1d859e59`.
+
+### TagDelete.png
+
+- **Source:** Redrawn PNG supplied by the maintainer; source commit: `63b30122579ee3ba7fbedded70b4fc164b8a6ebd`.
+- **SHA-256:** `2d3edb0b95432ac2c10d404973f35e7681db354fde99720e941544874068d7fc`.
+
+### Unmerged.png
+
+- **Source:** Original GitPane drawing; source: `tools/draw_conflict_icon.py`.
+- **SHA-256:** `6d30f86d97d1e9b8188b4a5976cad90b8c0574d10b862356e2cff6fcea79c905`.
+
+## distlib Windows launchers
+
+GitPane bundles the unchanged windowless x86, x64 and ARM64 launchers from **distlib 0.4.2**, as distributed inside the project's pinned **pip 26.2.1**. These resource bytes let OpenSSH run a native askpass executable without a console or a runtime dependency on pip. GitPane appends its own isolated-Python entry script in a private temporary directory for each operation; the original resources remain unchanged.
+
+Source: [pypa/distlib](https://github.com/pypa/distlib), `PC/launcher.c`; upstream tutorial: [script launchers](https://distlib.readthedocs.io/en/latest/tutorial.html#using-the-scripts-api). Copyright Vinay Sajip and contributors; distributed under the Python Software Foundation license. The complete upstream license is bundled at `src/gitpane/vendor/DISTLIB-LICENSE.txt` and included in wheel package data.
+
+| Resource | SHA-256 |
+|---|---|
+| `vendor/w32.exe` | `47872cc77f8e18cf642f868f23340a468e537e64521d9a3a416c8b84384d064b` |
+| `vendor/w64.exe` | `7a319ffaba23a017d7b1e18ba726ba6c54c53d6446db55f92af53c279894f8ad` |
+| `vendor/w64-arm.exe` | `c5dc9884a8f458371550e09bd396e5418bf375820a31b9899f6499bf391c7b2e` |
+
+## Noto Color Emoji
+
+Noto Color Emoji 2.057 by Google, Windows-compatible build, is the colour font of the emoji keyboard grid and of the Commit message field. It is shipped complete, without any modification and under its upstream file name `NotoColorEmoji_WindowsCompatible.ttf`, in `src/gitpane/ui/resource/`. Symbols Noto does not have, such as the bold italic small i, the black rightwards arrowhead and the combining marks, are drawn by the system fonts; no other font is bundled.
+
+- **Source:** https://raw.githubusercontent.com/googlefonts/noto-emoji/v2026-09-24-unicode18_0/2D/fonts/NotoColorEmoji_WindowsCompatible.ttf (10739048 bytes).
+- **SHA-256:** `2c7ede2f5438f9c1da098778bd681535933a345334008bb03fc51119f6b1cd72`.
+- **License:** SIL Open Font License 1.1. The shipped copy `src/gitpane/ui/resource/NotoColorEmoji-OFL.txt` is a byte for byte copy of https://raw.githubusercontent.com/googlefonts/noto-emoji/v2026-09-24-unicode18_0/2D/fonts/LICENSE, SHA-256 `6a73f9541c2de74158c0e7cf6b0a58ef774f5a780bf191f2d7ec9cc53efe2bf2`. The notice "Copyright 2022 Google Inc." stays inside the unmodified font.
+- **Tool:** [tools/fetch_emoji_font.py](tools/fetch_emoji_font.py) downloads both files at the pinned tag and refuses any file whose SHA-256 differs. Run `.venv/Scripts/python.exe tools/fetch_emoji_font.py`; it downloads nothing when both files are already in place with the right hash.

gitpane-1.0.0/docs/PYPI_README.md

@@ -0,0 +1,94 @@
+# GitPane
+
+GitPane is a Git Extensions clone that runs on Windows, macOS and most Linux distributions. I only reimplemented the features I have used every day for the past 16 years.
+
+GitPane needs Git and Python 3.13 or 3.14 (Python 3.15 is not supported yet).
+
+## Install
+
+Install GitPane with pipx: it creates a private environment for GitPane and puts the `gitpane` command on your PATH. On Linux and macOS, the system Python does not accept new packages, so pipx is the simple way (regular pip into a venv of your own also works).
+
+---
+### macOS
+
+```bash
+brew install python@3.13 pipx
+pipx ensurepath
+```
+
+In a **new** terminal:
+
+```bash
+pipx install --python python3.13 gitpane
+```
+
+Run `gitpane` in any terminal, then click **Settings › Utilities › Create desktop shortcut** to get a launcher on your desktop.
+
+---
+### Linux
+
+Fedora:
+
+```bash
+sudo dnf install pipx
+pipx ensurepath
+```
+
+Ubuntu and Debian:
+
+```bash
+sudo apt update
+sudo apt install pipx libxcb-cursor0 # required for X11 versions of linux
+pipx ensurepath
+```
+
+In a **new** terminal:
+
+```bash
+pipx install gitpane
+```
+
+Run `gitpane` in any terminal, then click **Settings › Utilities › Create desktop shortcut** to get a launcher on your desktop.
+
+---
+### Windows
+
+Install Python 3.14 from [python.org](https://www.python.org/downloads/windows/), then in PowerShell or Command Prompt:
+
+```powershell
+python -m pip install --user pipx
+python -m pipx ensurepath
+```
+
+pip may warn that `pipx.exe` is not on PATH: `ensurepath` has just fixed that.
+
+In a **new** terminal:
+
+```powershell
+pipx install gitpane
+```
+Run `gitpane` in any terminal, then click **Settings › Utilities › Create desktop shortcut** to get a launcher on your desktop.
+
+## Update
+
+Close GitPane, then:
+
+```bash
+pipx upgrade gitpane
+```
+
+---
+## Command line
+
+- `gitpane` starts GitPane and gives the terminal back. Closing the terminal does not close GitPane.
+- `gitpane --attach` keeps GitPane attached to the terminal: its output and errors are shown there, and Ctrl+C stops it.
+- `gitpane --log` writes a diagnostic log and shows its path.
+- `gitpane --version` prints the version (Linux and macOS).
+
+## When gitpane is not found
+
+Run `pipx ensurepath` again (`python -m pipx ensurepath` on Windows), then open a **new** terminal: the PATH change only reaches terminals opened after it.
+
+## License
+
+GitPane is under the MIT license. It ships the Noto Color Emoji font under the SIL Open Font License 1.1 (OFL-1.1) and the Windows launchers of distlib under the Python Software Foundation License 2.0 (PSF-2.0).

gitpane-1.0.0/pyproject.toml

@@ -0,0 +1,93 @@
+[build-system]
+requires = ["setuptools==84.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gitpane"
+dynamic = ["version"]
+description = "Lightweight desktop Git client for Windows, Linux and macOS, in the spirit of Git Extensions"
+readme = "docs/PYPI_README.md"
+authors = [{name = "Thongvan Alexis"}]
+license = "MIT AND OFL-1.1 AND PSF-2.0"
+license-files = [
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "src/gitpane/ui/resource/NotoColorEmoji-OFL.txt",
+    "src/gitpane/vendor/DISTLIB-LICENSE.txt",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: X11 Applications :: Qt",
+    "Environment :: MacOS X",
+    "Environment :: Win32 (MS Windows)",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: Microsoft :: Windows :: Windows 10",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+# The upper bound follows the one PySide6-Essentials declares; a test keeps both equal.
+requires-python = ">=3.13,<3.15"
+# Narrow ranges rather than exact pins, so pip and pipx can install GitPane next to other packages;
+# the dev extra below pins the exact versions the tests run with. shiboken6 comes with PySide6-Essentials.
+dependencies = ["PySide6-Essentials>=6.11.2,<6.12", "Pygments>=2.21,<3"]
+
+[project.optional-dependencies]
+dev = [
+    "PySide6-Essentials==6.11.2",
+    "shiboken6==6.11.2",
+    "Pygments==2.21.0",
+    "pip==26.2.1",
+    "setuptools==84.0.0",
+    "pytest==9.1.1",
+    "pytest-qt==4.5.0",
+    "pytest-xdist==3.8.0",
+    "execnet==2.1.2",
+    "ruff==0.16.6",
+    "colorama==0.4.6; sys_platform == 'win32'",
+    "iniconfig==2.3.0",
+    "packaging==26.3",
+    "pluggy==1.6.0",
+    "typing_extensions==4.16.0",
+    "build==1.6.1",
+    "pyproject_hooks==1.3.3",
+]
+
+[project.gui-scripts]
+gitpane = "gitpane.application:main"
+
+[tool.setuptools.dynamic]
+# setuptools reads this literal from the text of config.py without running the module.
+version = {attr = "gitpane.config.APPLICATION_VERSION"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["gitpane*"]
+namespaces = true
+
+[tool.setuptools.package-data]
+gitpane = ["vendor/*.exe", "vendor/*.txt"]
+"gitpane.ui" = ["resource/*.png", "resource/*.ico", "resource/*.ttf", "resource/*.txt"]
+
+[tool.pytest.ini_options]
+qt_api = "pyside6"
+testpaths = ["tests"]
+strict_markers = true
+# A full headless batch leaves about 430 000 files in the system temporary folder, a tmpfs limited in inodes on Ubuntu.
+# Keeping only the folders of failed tests leaves room for the next batch and still keeps what explains a failure.
+tmp_path_retention_policy = "failed"
+# Warnings the offscreen plugin prints for window system requests it has no window system to pass on to; they say
+# nothing about the application, so they never fail a test that fails on Qt warnings.
+qt_log_ignore = [
+    '^This plugin does not support propagateSizeHints\(\)$',
+    '^This plugin does not support raise\(\)$',
+    '^This plugin does not support grabbing the keyboard$',
+]
+
+[tool.ruff]
+line-length = 250
+target-version = "py313"

gitpane-1.0.0/setup.cfg

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