git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Jacob Stopak <jacob@initialcommit.io>
To: git@vger.kernel.org
Subject: [ANNOUNCE] git-sim: a command line tool to visually simulate local git operations
Date: Sun, 22 Jan 2023 07:02:15 -0800	[thread overview]
Message-ID: <Y81P9w6osdfUcxb9.jacob@initialcommit.io> (raw)

I've been working on a free and open-source dev tool called "git-sim" which
allows devs to visually simulate Git commands using a git-like syntax directly
in their local repos from the command-line.

Posting it here to put out some feelers and to see if folks in the community might
find it interesting / useful, and if so to get some feedback on how to improve it.

The goal of the tool is to help make Git more accessible to newcomers, as well
as to allows users of all experience levels to get a clear, visual idea of how a
particular Git command will affect the state of their repo before actually
running it.

Think of it as serving a similar purpose as the --dry-run option that some Git
commands have, but where the result is an output image (default) or video
animation of the impact of the Git command in question. My hope is that this
could be a great asset for visual learners.

Git-Sim is written in Python and leverages the GitPython library to interact
with local Git repos and Manim (Math-animation) library to draw and animate the
simulated Git command output.

Here's a link to the codebase/readme on GitHub detailing what Git-Sim does:

https://github.com/initialcommit-com/git-sim

Supported commands so far are: log, status, add, restore, commit, stash, branch,
tag, reset, revert, merge, rebase, cherry-pick

So far the functionality is quite basic, but built out enough that hopefully
folks can get a decent idea of how (and whether) it can be useful. I'm sure
it has bugs and obvious enhancements to be made.

All thoughts/suggestions/criticisms/ideas are welcome.

-Jack

                 reply	other threads:[~2023-01-22 15:02 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=Y81P9w6osdfUcxb9.jacob@initialcommit.io \
    --to=jacob@initialcommit.io \
    --cc=git@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).