gitonic 0.17.0__tar.gz → 0.18.1__tar.gz

{gitonic-0.17.0 → gitonic-0.18.1}/BACKLOG.md

@@ -1,11 +1,11 @@
 
-# BACKLOG
+# BACKLOG 
 
 - documentation
 - testcases?
-- revert changes / git checkout support
-  - undo support for unstaged files
-    - git restore <file>
+- ~~revert changes / git checkout support~~
+  - ~~undo support for unstaged files~~
+    - ~~git restore <file~~
 - ~~git fetch / merge  support~~
   - ~~currently gitonic supports only pull~~
 - git branch support
@@ -23,47 +23,55 @@
   - support also git commit --amend 
 - git tag support
 - git stash support (list, show, push, pop/apply, drop, clear)
-- support verbose output in expert mode
-  - support flags -v and -vv where applicable
+- ~~support verbose output in expert mode~~
+  - ~~support flags -v and -vv where applicable~~
 - settings tabs
   - check for installed git
   - ~~git exe configuration in settings~~
   - check for latest version of gitonic
   - 
 - ~~config file for last known config~~
-- diff-tool blocks main screen (see next)
+- ~~diff-tool blocks main screen (see next)~~
 - gui rework
   - theme support
-  - resize behavior -> expand
+  - ~~resize behavior -> expand~~
   - ~~icons~~
-  - grid layout / less floating 
-  - freezing ui -> see background tasks
+  - ~~grid layout / less floating ~~
+  - ~~freezing ui -> see background tasks~~
   -
-- background task and event loop -> freezing gui when running git utils
-  - use TkCmd also for Cmd runners
+- background task and event loop ~~-> freezing gui when running git utils~~
+  - ~~use TkCmd also for Cmd runners~~
   - status bar with running background tasks overview?
-  -
+  - esc esc handler and shut down
+    - currently it terminates all running background tasks
+      - option to show extra popup to inform the user regarding running tasks
 - refact for integration in other tools
-- filter git on 'changes' tab
+- ~~filter git on 'changes' tab~~
 - rework logging
 - ~~remove print statements in main~~
-- remove print statements in tile.core
+- ~~remove print statements in tile.core~~
+- remove print statements
 - automation / external jobs
   - ~~black PEP8 support~~
-  - desktop integration
-    - open shell at repo path
-    - open file management too at repo path
+  - ~~desktop integration~~
+    - ~~open shell at repo path~~
+    - ~~open file management too at repo path~~
 - ~~history of commit texts~~
   - ~~in combo box~~
   - git log / show integration?
 - git error handling
-- switch to log tab after pull
-- logging, use python logger for expert mode output
+- switch to log tab after pull???
+- ~~logging, use python logger for expert mode output~~
 - support for .gitignore 
   - adding single files 
-  - open .gitignore for editing
-- execute git operations in parallel where possible
-- make expert mode debugging out better (use python logging)
+  - ~~open .gitignore for editing~~
+- ~~execute git operations in parallel where possible~~
+- ~~make expert mode debugging out better (use python logging)~~
+- context menu 
+  - less sensitive (disappears to quickly)
+  - multiple row feature
+- splash screen
+- new version notification 
 - 
 
 

{gitonic-0.17.0 → gitonic-0.18.1}/CHANGELOG.md

@@ -1,5 +1,41 @@
  
-# Changelog
+# CHANGELOG
+
+
+## version v0.19.0 - ????????
+- 
+
+
+## version v0.18.1 - 20251109
+- patch entry point
+-
+
+
+## version v0.18.0 - 20251109
+- redesign multi tasking / tk eventloop
+  - user interface is now non-blocking
+    - multi tasking tested with python 3.12 
+      - **not yet tested** with python 3.13 / 3.14
+        - `gitonic` is released for python3.12 (fixed version)
+      - current implementation uses threads to fork `git` processes in the background
+      - the main tk eventloop receives the thread results and process this in callbacks
+        - read here for detailed information [`tk eventloop`](https://tkdocs.com/tutorial/eventloop.html))
+- ui redesign
+  - resizeable main window
+  - dropped external font-awesome pip package
+  - material design icons included
+- IMPORTANT: new right-mouse context handler `~/.gitonic/contextmenu.json`
+  - INCOMPATIBLE to `~/.gitonic/context.json`
+  - old context `~/.gitonic/context.json` is NOT supported anymore
+- improved logging
+  - filter log for each repo
+- codebase refactored 
+- new commandline tools (UNDER CONTSRUCTION - not yet final - dont expect anything!!! - this might be dropped in the future)
+  - `gtcd.py`
+    - opens a new terminal for a git repo quickly
+  - `gtls.py` 
+    - list all changes for all tracked git repo 
+-
 
 
 ## version v0.17.0 - 20250715

{gitonic-0.17.0 → gitonic-0.18.1}/LICENSE.md

@@ -1,6 +1,6 @@
 ---
 
-Copyright (c) 2022 k. goger - https://github.com/kr-g
+Copyright (c) 2022-2025 k. goger - https://github.com/kr-g
 
 ---
 

{gitonic-0.17.0 → gitonic-0.18.1}/MANIFEST.in

@@ -3,5 +3,8 @@ include README.md
 include CHANGELOG.md
 include BACKLOG.md
 
+include gitonic/tkui/material_fonts/*
+include gitonic/tkui/otherdeps/*
+
 include git-*.svg
 

{gitonic-0.17.0 → gitonic-0.18.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitonic
-Version: 0.17.0
+Version: 0.18.1
 Summary: manage a multi git workspace
 Home-page: https://github.com/kr-g/gitonic
 Author: k. goger
@@ -15,11 +15,10 @@ Classifier: Topic :: Utilities
 Classifier: Topic :: Desktop Environment
 Classifier: Topic :: Software Development :: Version Control :: Git
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
-Requires-Python: >=3.12
+Requires-Python: >=3.12,<3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: pytkfaicons
+Requires-Dist: pillow
 Requires-Dist: tkinter-tooltip
 Provides-Extra: pep08
 Requires-Dist: pycodestyle; extra == "pep08"
@@ -52,7 +51,20 @@ Dynamic: requires-python
 [![PEP-08](https://img.shields.io/badge/code%20style-PEP08-green.svg)](https://www.python.org/dev/peps/pep-0008/)
 
 
-you are reading VERSION = v0.17.0
+you are reading VERSION = v0.18.1
+
+version v0.18.1 will come with some bigger changes.
+
+read latest news here:
+
+[`CHANGELOG`](https://github.com/kr-g/gitonic/blob/main/CHANGELOG.md)
+
+
+older versions:
+
+[`OLD VERSIONS`](https://github.com/kr-g/gitonic/tags)
+
+
 
 
 # gitonic 
@@ -321,40 +333,47 @@ to open the system file manager tool (file explorer)
 at the base git repo path or at the changed file path.
 
 in addition it is possible to add own custom context menu entries here.
-configuration is done with `~/.gitonic/context.json` file.
+configuration is done with `~/.gitonic/contextmenu.json` file.
 
 the general structure is:
 
     {
-      "a-context-name-ctx": {
+    "acontext-name": {
         "expr": "*",
-        "workdir": ".",
-        "menu": [
-          [
-            "some text $GIT",
-            [
+        "changes-all|file|repo": [
+          {
+            "name": "a text $_GIT",
+            "para": [
               "cmd-path",
               "whatever_param=$GIT"
             ]
-          ],
-          [
-            "some other text $PATH",
-            [
+          },
+          {
+            "name": "some other text $_PATH",
+            "para": [
               "cmd-path2",
               "whatever_param=$PATH"
             ]
-          ]
+          },
+          ...
         ]
       },
       ...
     }
 
+where `changes-all|file|repo` is the section where the context menu should appear.
+- `changes-file` is the right section where all files are listed
+- `changes-repo` is the left section where all repos are listed
+- `changes-all` will appear in both (left and right section)
 
 here the variables `$GIT`, `$FILE`, `$PATH`, `$NAME`, or `$PYTHON` 
 are replaced by the corrosponding path before execution. 
 where `$PYTHON` expands to `sys.executable` from `gitonic` runtime.
 and `$NAME` is a placeholder for `os.path.basedir`,
-and `$PATH` for `os.path.dirname`
+and `$PATH` for `os.path.dirname`.
+
+the variables `$_GIT`, `$_FILE`, `$_PATH`, or `$_NAME` are the shorten
+path specifiers with `~` replacing the users home folder.
 
 the `expr` key contains a single file pattern, or a list of 
 file patterns - when to enable the context menu. 
@@ -363,96 +382,96 @@ the file pattern is following Unix filename pattern matching.
 the `workdir` key will change the current working directory before running
 the command.
 
-the `menu` array contains the text to display in the menu, 
-and the command params as embedded array.
+the `name` contains the text to display in the menu, 
+and `para` the command-binary plus params as array.
 
 the context name as such can have any value 
 (as long it is unique in the structure).
 
 
-below a sample `~/.gitonic/context.json` file 
+below a sample `~/.gitonic/contextmenu.json` file 
 for running on linux with xfce.
 
     {
       "term-ctx": {
         "expr": "*",
-        "menu": [
-          [
-            "Open Terminal at $GIT",
-            [
+        "changes-all": [
+          {
+            "name": "Open Terminal at $_GIT",
+            "para": [
               "xfce4-terminal",
-              "--working-directory=$GIT"
+              "--default-working-directory=$GIT"
             ]
-          ],
-          [
-            "Open Terminal at $PATH",
-            [
+          },
+          {
+            "name": "Open Terminal at $_PATH",
+            "para": [
               "xfce4-terminal",
-              "--working-directory=$PATH"
+              "--default-working-directory=$PATH"
             ]
-          ],
-          [
-            "Edit .gitignore at $GIT",
-            [
+          },
+          {
+            "name": "Edit .gitignore at $_GIT",
+            "para": [
               "xed",
               "$GIT/.gitignore"
             ]
-          ]
+          }
         ]
       },
       "basic-ctx": {
         "expr": "*",
-        "menu": [
-          [
-            "less $NAME at $PATH",
-            [
+        "changes-file": [
+          {
+            "name": "less $NAME at $_PATH",
+            "para": [
               "xfce4-terminal",
               "-x",
               "less",
               "$FILE"
             ]
-          ],
-          [
-            "edit $NAME at $PATH",
-            [
+          },
+          {
+            "name": "edit $NAME at $_PATH",
+            "para": [
               "xed",
               "$FILE"
             ]
-          ],
-          [
-            "vi $NAME at $PATH",
-            [
+          },
+          {
+            "name": "vi $NAME at $_PATH",
+            "para": [
               "xfce4-terminal",
               "-x",
               "vi",
               "$FILE"
             ]
-          ]
+          }
         ]
       },
       "spyder-ctx": {
         "expr": "*.py",
-        "menu": [
-          [
-            "spyder python $FILE",
-            [
+        "changes-file": [
+          {
+            "name": "spyder python $_FILE",
+            "para": [
               "~/spyder/.venv/bin/spyder",
               "$FILE"
             ]
-          ]
+          }
         ]
       },
       "autopep8-ctx": {
         "expr": "*.py",
-        "menu": [
-          [
-            "autopep8 python $FILE",
-            [
-              "autopep8",
+        "changes-file": [
+          {
+            "name": "autopep8 python $_FILE",
+            "para": [
+              "~/repo/gitonic/.venv/bin/autopep8",
               "-i",
               "$FILE"
             ]
-          ]
+          }
         ]
       },
       "geany-path": {
@@ -461,14 +480,14 @@ for running on linux with xfce.
           "*.cpp",
           "*.h"
         ],
-        "menu": [
-          [
-            "geany c $FILE",
-            [
+        "changes-file": [
+          {
+            "name": "geany c $_FILE",
+            "para": [
               "geany",
               "$FILE"
             ]
-          ]
+          }
         ]
       },
       "uncrustify-path": {
@@ -477,10 +496,10 @@ for running on linux with xfce.
           "*.cpp",
           "*.h"
         ],
-        "menu": [
-          [
-            "uncrustify c $FILE",
-            [
+        "changes-file": [
+          {
+            "name": "uncrustify c $_FILE",
+            "para": [
               "uncrustify",
               "-c",
               "~/.gitonic/uncrustify.cfg",
@@ -489,28 +508,28 @@ for running on linux with xfce.
               "--no-backup",
               "--if-changed"
             ]
-          ]
+          }
         ]
       },
       "git-base-tools": {
         "expr": [
           "*"
         ],
-        "workdir" : "$GIT",
-        "menu": [
-          [
-            "gitk $GIT",
-            [ 
-              "gitk" 
+        "workdir": "$GIT",
+        "changes-all": [
+          {
+            "name": "gitk $_GIT",
+            "para": [
+              "gitk"
             ]
-          ],
-          [
-            "git gui $GIT",
-            [ 
+          },
+          {
+            "name": "git gui $_GIT",
+            "para": [
               "git",
-              "gui" 
+              "gui"
             ]
-          ]
+          }
         ]
       }
     }
@@ -533,15 +552,22 @@ at the present time the context menu only works on the underlying file (row) in
 there is **no** support for multiple files (selection) as of now.
 
 
+# related
+
+plugin for thonny ide 
+[`thonny-gitonic`](https://github.com/kr-g/thonny-gitonic)
+
 
 # platform
 
 tested on python3, and linux
 
 
-# development status
+# contribution
 
-alpha state, use on your own risk!!!
+any contribution is welcome !
+
+please create one issue for each proposal, or merge request.
 
 
 # installation
@@ -550,14 +576,21 @@ it is recommented to install gitonic into a
 [virtual environment](https://docs.python.org/3/library/venv.html).
 the following script will install gitonic in your home directory (linux).
 
+
+    #!/bin/bash
+    
     # create virtual environment 
+    
     cd ~
     python3 -m venv gitonic
-
-    # install gitonic with recommended extras
-    ~/gitonic/bin/pip install gitonic[PEP08,MELD]
-    or
-    ~/gitonic/bin/pip install gitonic[DEFAULT]
+    
+    cd gitonic
+    
+    source ./bin/activate
+    
+    # install gitonic with all pep08 and meld
+    
+    pip3 install gitonic[PEP08,MELD]
 
 
 this script can be found here
@@ -679,7 +712,7 @@ following files are used:
 |---|---|
 |~/.gitonic/commit.json|the last commit messages show in the combo box|
 |~/.gitonic/config.json|configuration settings|
-|~/.gitonic/context.json|configuration for context menu on changes tab|
+|~/.gitonic/contextmenu.json|configuration for context menu on changes tab|
 |~/.gitonic/formatter.json|configuration for external formatter tools|
 |~/.gitonic/tracked.json|tracked git repositories|
 |~/.gitonic/socket|internal use|
@@ -698,9 +731,53 @@ gitonic is released under the following
 git logos from [git-scm](https://git-scm.com/downloads/logos)
 
 
+# support and donations
+
+support the further development of `gitonic` with a donation of your choice.
+
+[support and donnations](https://github.com/kr-g/gitonic/wiki/Support)
+
+thank you !!!
+
 
  
-# Changelog
+# CHANGELOG
+
+
+## version v0.19.0 - ????????
+- 
+
+
+## version v0.18.1 - 20251109
+- patch entry point
+-
+
+
+## version v0.18.0 - 20251109
+- redesign multi tasking / tk eventloop
+  - user interface is now non-blocking
+    - multi tasking tested with python 3.12 
+      - **not yet tested** with python 3.13 / 3.14
+        - `gitonic` is released for python3.12 (fixed version)
+      - current implementation uses threads to fork `git` processes in the background
+      - the main tk eventloop receives the thread results and process this in callbacks
+        - read here for detailed information [`tk eventloop`](https://tkdocs.com/tutorial/eventloop.html))
+- ui redesign
+  - resizeable main window
+  - dropped external font-awesome pip package
+  - material design icons included
+- IMPORTANT: new right-mouse context handler `~/.gitonic/contextmenu.json`
+  - INCOMPATIBLE to `~/.gitonic/context.json`
+  - old context `~/.gitonic/context.json` is NOT supported anymore
+- improved logging
+  - filter log for each repo
+- codebase refactored 
+- new commandline tools (UNDER CONTSRUCTION - not yet final - dont expect anything!!! - this might be dropped in the future)
+  - `gtcd.py`
+    - opens a new terminal for a git repo quickly
+  - `gtls.py` 
+    - list all changes for all tracked git repo 
+-
 
 
 ## version v0.17.0 - 20250715
@@ -869,13 +946,13 @@ git logos from [git-scm](https://git-scm.com/downloads/logos)
 -
 
 
-# BACKLOG
+# BACKLOG 
 
 - documentation
 - testcases?
-- revert changes / git checkout support
-  - undo support for unstaged files
-    - git restore <file>
+- ~~revert changes / git checkout support~~
+  - ~~undo support for unstaged files~~
+    - ~~git restore <file~~
 - ~~git fetch / merge  support~~
   - ~~currently gitonic supports only pull~~
 - git branch support
@@ -893,47 +970,55 @@ git logos from [git-scm](https://git-scm.com/downloads/logos)
   - support also git commit --amend 
 - git tag support
 - git stash support (list, show, push, pop/apply, drop, clear)
-- support verbose output in expert mode
-  - support flags -v and -vv where applicable
+- ~~support verbose output in expert mode~~
+  - ~~support flags -v and -vv where applicable~~
 - settings tabs
   - check for installed git
   - ~~git exe configuration in settings~~
   - check for latest version of gitonic
   - 
 - ~~config file for last known config~~
-- diff-tool blocks main screen (see next)
+- ~~diff-tool blocks main screen (see next)~~
 - gui rework
   - theme support
-  - resize behavior -> expand
+  - ~~resize behavior -> expand~~
   - ~~icons~~
-  - grid layout / less floating 
-  - freezing ui -> see background tasks
+  - ~~grid layout / less floating ~~
+  - ~~freezing ui -> see background tasks~~
   -
-- background task and event loop -> freezing gui when running git utils
-  - use TkCmd also for Cmd runners
+- background task and event loop ~~-> freezing gui when running git utils~~
+  - ~~use TkCmd also for Cmd runners~~
   - status bar with running background tasks overview?
-  -
+  - esc esc handler and shut down
+    - currently it terminates all running background tasks
+      - option to show extra popup to inform the user regarding running tasks
 - refact for integration in other tools
-- filter git on 'changes' tab
+- ~~filter git on 'changes' tab~~
 - rework logging
 - ~~remove print statements in main~~
-- remove print statements in tile.core
+- ~~remove print statements in tile.core~~
+- remove print statements
 - automation / external jobs
   - ~~black PEP8 support~~
-  - desktop integration
-    - open shell at repo path
-    - open file management too at repo path
+  - ~~desktop integration~~
+    - ~~open shell at repo path~~
+    - ~~open file management too at repo path~~
 - ~~history of commit texts~~
   - ~~in combo box~~
   - git log / show integration?
 - git error handling
-- switch to log tab after pull
-- logging, use python logger for expert mode output
+- switch to log tab after pull???
+- ~~logging, use python logger for expert mode output~~
 - support for .gitignore 
   - adding single files 
-  - open .gitignore for editing
-- execute git operations in parallel where possible
-- make expert mode debugging out better (use python logging)
+  - ~~open .gitignore for editing~~
+- ~~execute git operations in parallel where possible~~
+- ~~make expert mode debugging out better (use python logging)~~
+- context menu 
+  - less sensitive (disappears to quickly)
+  - multiple row feature
+- splash screen
+- new version notification 
 - 
 
 
@@ -964,7 +1049,7 @@ this must be done by checking the log tab manually where all cmdline output goes
 
 ---
 
-Copyright (c) 2022 k. goger - https://github.com/kr-g
+Copyright (c) 2022-2025 k. goger - https://github.com/kr-g
 
 ---