From eqqon

Git# --> Git for .NET

... a native Windows version of the fast & free open source version control system

GitSharp is the most advanced CSharp implementations for the .NET framework and Mono. It is aimed to be fully compatible to the original git and shall be a light weight library for cool applications that are based on git as their object database or are reading or manipulating repositories in some way.

What you can do with Git#

Git# as object oriented interface to your git repo

Want to manipulate you git repo from C#? Want to calculate statistics or create a beautiful visualization? Use git#'s well designed object oriented API to access and manipulate repositories.

Git# as object database

Git is an object database with built-in history and branching. If you need to create snapshots of your application's configuration or your user's data with alternative configuration branches then use git. By moving the HEAD in the repository you can easily implement undo/redo operations. For instance, one could build a wiki on top of git# or a distributed content management system. Write-support is already implemented so you could already give it a try.

Git# as (distributed) file system

Git has been designed by Linus Thorwalds to be a file system that is very good at content-tracking and keeping multiple distributed versions of the same content in sync. If your application needs to implement backup and/or content synchronization routines then it can build on top of git to do that. (We still need to implement remote transport for this.)

Git# as peer-to-peer content distribution system

If you need to build a content distribution framework that will easily and efficiently transport content to different machines then you can easily build one on top of git. (We still need to implement remote transport for this.)

Git# as a future replacement of msysGit?

msysGit currently is the most complete and usable native provider for git on Windows. The problem with msysGit is, that it can not be easily extended by or embedded in other applications. Apart from being a lightweight library, in the future git# might also become a real alternative to msysGit but we are still far away from this.

News

• July 2nd, 2009: Mauricio Scheffer has set up git# on the build and integration service teamcity.codebetter.com
• July 1st, 2009: Writing of blobs, trees and commits works
• June 15th, 2009: Reading of commit history, trees, blobs and tags works. See the demo browser screenshot below.

Status of the Project

Development Status

Pre-Alpha, "fast-forward" =P, still need to port large portions of java code. Wanna help?

Watch the commit history on github to keep informed!

Test Summary as of July 6th, 2009

204 passed | 12 failed | 216/1000 tests ported to C#

To execute the testsuite start the TestGUI, select "All Assemblies" from the tree and hit "Run". This are up-to-date stats:

Porting Status as of July 6th, 2009

11657/24588 lines of code are ported => 47.4% complete (without counting comments and tests)

Get the Source Code

public clone url

git://github.com/henon/GitSharp.git

Contributing

Fork the repository at github and start coding. We will pull your commits regularly. However, feedback and bug reports are also contributions.

Short how-to

• Make small logical changes, execute the TestSuite to see the impact of the change
• Provide a meaningful commit message.
• Include your Signed-Off-By line
• Make sure all code is under the proper license (BSD)

Porting from JGit

clone the jgit repository git://repo.or.cz/egit.git

• Port small and simple methods with few dependencies first and comment out code that is ported but can not yet compile due to missing dependencies.
• Please do not rename java classes, methods, constants etc. or else porting of dependent code will be more complicated and error prone. We are going to rename according to .NET conventions as soon as all tests are ported.
• Please make sure you base your porting work on the same version of the jgit code as all other developers to avoid inconsistencies. The current jgit commit we are based on is

commit c6e3b9fe2da0293f11eae202ec35fb343191a82d

Author: Shawn O. Pearce <spearce@spearce.org>

Date: Wed Jun 3 10:19:00 2009 -0700

To go back to that commit type

git checkout c6e3b9fe2da0293f11eae202ec35fb343191a82d

Changes after that commit can be tracked later after Git# is completely ported.

File a Bug Report

Please file any bugs at git# issue tracker.

Mailing List

Feel free to join the git# mailinglist

Screenshots

Demo repository browser

Unit test runner

License

Git# is derived from the Java library jgit and is released under the BSD license like jgit.

Please refer to the LICENSE.txt files for the complete license, and please refer to the individual source file header to determine which license covers it and who contributed and therefor holds copyrights to the files.

Thanks

Many thanks go to ...

• Linus Thorwalds, the creator of git
• Shawn O. Pearce, the main contributor of jgit. Git# is largely based on his work.
• Kevin Thompson, for porting a lot of code from jgit. Git# is based on his initial efforts.

Motto

Brain

Come, Pinky we need to get back to the lab and prepare for tomorrow night.

Pinky

But why, Brain? What are we going to do tomorrow night?

Brain

Try to get Git# done!!