From eqqon

Git# --> Git for .NET and Mono

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

GitSharp is an implementation of Git for the Dot.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.

Navigation: Downloads | Sources | API Docs | Bugs & Issues | Integration Server | Mailing List | GitSharp.Demo

What you could 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 Torvalds 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.

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.

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 that.

Status of the Project

We are continually porting over all additions that are made to JGit while improving the GitSharp API as well as the command line interface. GitSharp still is missing some crucial features, but it is already in a usable state. To get an idea check out the Demo!

We still need to implement most of the command line interface (git.exe) and some important features such as CRLF autoconversion, merge support and stuff ;).

Development Status

• GitSharp.Core (equivalent to jgit) - Beta
• GitSharp.CLI (git.exe) - Alpha
• GitSharp (a user friendly api) - Alpha .... basically the API features the same as the core but is designed to be easier to use and learn. It's alpha because it does not yet provide as much features as the core.

The next release will bring you merge support!--Henon 22:51, 13 January 2010 (CET)

Roadmap

Upcoming Release

Status

• Repository.Status ... done
• gitignore support ... done
• git.exe: Status command ... done

Branch reset

• Branch.Reset( ResetBehavior.Hard / Soft / Mixed ) ... done
• git.exe: Reset command

Index Operations

• Index.Add ... done
• don't add ignored files in Index.AddAll(...)
• git.exe: Add command
• Index.Remove ... done
• git.exe Remove command
• Index.Checkout ... done

Branch switching

• Branch.Checkout ... done
• git.exe Checkout command

Committing

• Commit.Create(...) ... done
• Index.Commit ... done
• Commit.Create( paths)
• git.exe: Commit command

Merge support <---- henon is working on this

• Merge strategies Ours and Theirs ... done
• Merge strategy recursive
  • Fast forward merging
  • Rename detection
  • Merging conflicting paths on file level using conflict syntax

Transport <---- nulltoken is working on this

• Track down various transport related bugs reported on the list
• CloneCommand ... done
• git.exe Clone command ... done
• FetchCommand ... done
• git.exe Fetch command
• PushCommand
• git.exe PushCommand
• PullCommand
• git.exe PullCommand

Future Releases

• CRLF conversion
• git-svn support <---- Dan Rigby is working on this
• http-server

Projects using GitSharp

GitSharp.Demo

GitSharp.Demo is a small repository browser project that demonstrates the use of the GitSharp library and the user oriented API.

The source demonstrates how easy it is to ...

• open and interact with a git repository
• iterate over the file-tree of a specific revision
• get the contents of a single file of a specific revision
• get the changes between two commits
• display a modification as text diff

TicGit.net

TicGit.net a small distributed issue tracker that uses git to keep track of tickets. It demonstrates the use of gitsharp's commiting API. TicGit is a toy project inspired by Scott Chacon's ruby application "ticgit".

License

Git# is derived from the Java library jgit and is released under the same BSD license as 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 and Credits

Thanks to all the kind people who contributed in one way or another. These are the credits:

• Dave Cameron: for fixing bugs
• Björn Carlson (hackerbaloo): for killing bugs that crept into the core
• Emeric Fermas (nulltoken): for eliminating some of the hardest to find bugs and for verifying the complete test suite against jgit
• Martinho Fernandes (eue): for fixing bugs
• Andriano Machado (ammachado): for porting massive amounts of code and tests, also fixing many bugs
• Jim Radford: for the continuous integration server account and the support
• Gil Ran: for porting and fixing lots of tests and initial efforts on Mono
• Meinrad Recheis (henon): I started this project and put all my effort into having it take off
• Dan Rigby: for setting up the #GitSharp irc channel as well as porting and fixing tests
• rolenun: for the command line interface framework. hey, what is your real name?
• Stefan Schake (caytchen): for porting huge parts of the transport layer, and hunting down nasty bugs.
• Mauricio Scheffer (mausch): for the testing and build server expertise and CI server trouble shooting
• Neil Stalker (nestalk): for caring much about gitsharp's Mono compatibility and squashing bugs
• Kevin Thompson: for initially porting large amounts of code and letting me rise the baby

Furthermore, much appreciation and thanks to ...

• Linus Torvalds and the git community for creating and maintaining it.
• Shawn O. Pearce and the jgit/egit community. Git# is based on their excellent work.

--Henon 22:45, 13 October 2009 (CEST)

Links

• git
• git online manual
• JGit