Git tool

[yorik]

I recoded the Arch Git tool too (git commit 09e9c89). Now we have this:

screenshot.jpg (156.37 KiB) Viewed 2227 times

Basically, you need:

1) the python-git package installed (we can see about this for windows later)
2) you must have a git repo on your computer already, and have the current file saved in it.

Then you just click menu Arch->Utilities->Git and this panel appears. There, you can:

- read the git log
- see the diff of a selected file
- commit selected files
- pull from a selected remote
- push to a selected remote

Of course this need more stuff (ability to start a new repo, create and switch branches, manage remotes etc - anyone interested in extending? ) but for a simple, one-branch workflow this works well already...

[sgrogan]

1) the python-git package installed (we can see about this for windows later)

It's been in the dev-snapshot bundle for a few weeks. Testing results welcome.

[vejmarie]

Hey, is this related to the "git like" question I had a few days/weeks ago ?

[triplus]

Looking good.

But i do have one question. Does the Git executable need to be installed or can GitPython do this by itself?

[Jee-Bee]

Then you just click menu Arch->Utilities->Git and this panel appears. There, you can: ...

Why is this in Arch module and not Freecad standard (just workbench independend...)

[yorik]

Hey, is this related to the "git like" question I had a few days/weeks ago ?

It was on my todo list for some time, but yeah, the more people talk about it...

But i do have one question. Does the Git executable need to be installed or can GitPython do this by itself?

I think gitpython uses the git executable under the hood, but I suppose it is included in windows... in linux the python-git package depends on the git package.

Why is this in Arch module and not Freecad standard (just workbench independend...)

Basically I was still testing, and don't want to "pollute" the rest of FreeCAD while it's not finished. But you're right, at some point it should be migrated somewhere else.

[sgrogan]

I think gitpython uses the git executable under the hood, but I suppose it is included in windows... in linux the python-git package depends on the git package.

Only git-python is included in the win bundle. Windows users should install the git executable using the installer from here: https://git-scm.com/download/win

[yorik]

Only git-python is included in the win bundle. Windows users should install the git executable using the installer from here: https://git-scm.com/download/win

Does it say something when you type in the console:

Code: Select all

import git

and you don't have git installed?

If not, we could add a warning for the user...

[triplus]

But i do have one question. Does the Git executable need to be installed or can GitPython do this by itself?

I think gitpython uses the git executable under the hood, but I suppose it is included in windows... in linux the python-git package depends on the git package.

A while back i investigated this a bit and i was under the impression Git executable is needed. The licence of Git therefore isn't ideal fit for FreeCAD licence policy. But this option is the only one if we want the best possible Git support.

Alternative would be to use Dulwich and i guess porcelain API:

https://www.dulwich.io/apidocs/dulwich.porcelain.html

This approach would i guess always lack a bit against using "the real thing". But once it will have Apache licence i guess it could be packed as "FreeCAD module" and to be imported when needed for some FreeCAD Git related functionality? Anyway this are just some thoughts and lets wait and see what will the future bring.

[triplus]

In pseudo code if something like this would be possible in the future and available by default:

Code: Select all

import dulwich
dulwich.porcelain.clone("git url", target='UserAppData/Mod')

That would i guess make FreeCAD "git ready". And i do imagine some nice GUI dialogs would be made as a result to provide some useful features to FreeCAD users.