From eqqon

Revision as of 08:28, 29 October 2009 (view source) Henon (Talk | contribs) m (→Get the Source Code) ← Older edit		Revision as of 08:28, 29 October 2009 (view source) Henon (Talk | contribs) m (→Contributing) Newer edit →
Line 129:		Line 129:
-
-	== Contributing ==
-	If you never contributed to a github project or are a git newbie read the [[Collaborative Github Workflow]] guide.
-
-	The typical collaborative workflow with git can be described like this: Fork the [http://github.com/henon/GitSharp repository at github] clone your local repo and start coding. When you are done with the task, push to your fork on github and send a pull-request to henon. After other contributor's commits have been applied to the main repository your fork needs to be updated by pulling from henon/GitSharp. If you are not familiar with this workflow read the [[Collaborative Github Workflow|in-depth description with git commands]].
-
-	<br>
-	Never mind, if you haven't got the time to do some coding. Promoting the project and giving feedback are also most valuable contributions.
-	<br><br>
-	=== Short Contributor's How-To ===
-	* Join the [http://groups.google.com/group/gitsharp/ mailing list] and if you like to discuss/ask things in realtime the IRC channel '''#GitSharp''' on freenode.
-	* See what work is open at the issue tracker.
-	* Please '''*do not* use github fork queue''', just [[Collaborative Github Workflow|pull from henon/GitSharp]] to get other's changes
-	* Feel free to include your copyright to the files you contributed something to
-	* When you feel like your contribution should go into the main branch (henon/GitSharp) then post on the ML.
-	* When you corrupted your fork read [[Fixing Corrupt Git Branch]]
-
-	<br>
-
-	=== Porting from JGit ===
-
-	Porting of the core is done. As soon as there are new commits in jgit we are going to port them over. However, there is still a lot of work to do, i.e. port implementations of CLI commands from jgit/pgm or port unit tests from the original git to test the command line.
-
-	* Port small portions 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 code is ported.
-	* Please '''do''' keep order of methods, properties,... in sync with the Java version. If you work with a refactoring tool, make sure to configure it accordingly to this recommendation.
-	* Please '''consider''' committing ''small and atomic change-sets'' (instead of committing all your changes at the end of the day) in order to ease reviewing, merging and cherry-picking. You will benefit from it next time you pull.
-	* Check out the list of [[/Non Trivial Java To CSharp Conversions|non-trivial Java to C# conversions]].
-	* Please make sure you base your porting work on the same version of the [http://github.com/henon/jgit/tree/master jgit code] as all other developers to avoid inconsistencies.
-
-	<br>
-	;Clone from
-	{{code|git://github.com/henon/jgit.git}}
-
-	This mirror of the original jgit code base represents the currently tracked jgit version that has been ported into GitSharp.Core.
-
-	=== Collaborate! ===
-	;Via the Mailing List:
-	Feel free to join the [http://groups.google.com/group/gitsharp/ git# mailing list]
-
-	We will post status updates regularly to keep you informed about the project status.
-
-	;Via IRC:
-	Visit us on freenode in Channel #GitSharp

---

Revision as of 08:28, 29 October 2009

Git# --> Git for .NET and Mono

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

GitSharp is the most advanced CSharp implementation 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.

Navigation: Downloads | Sources | Bugs & Issues | Integration Server | Mailing List | 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 Torwalds 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

Porting from JGit is done. That means the library GitSharp.Core can be used already. We still need to implement most of the command line interface (git.exe) and many API interfaces. Future jgit commits will be tracked and ported on a regular basis.

Development Status

• GitSharp.Core (equivalent to jgit) - Beta
• GitSharp.CLI (git.exe) - Alpha
• GitSharp (a user friendly api) - Alpha

As of October, 20th 2009 all tests are passing, except 6 encoding related corner cases which have been ignored. For more details, see our integration server.

File a Bug Report

Note: we changed issue tracker from github to code.google.com

Please file any bugs, requests or other feedback in our issue tracker. Please always specify the release version number or the commit hash of the actual GitSharp version you are using when reporting bugs.

GitSharp.Demo

GitSharp.Demo is a small repository browser project that should demonstrate the use of the GitSharp library. Get the sources at github. It shows how to ...

• open a repository
• get the branches and tags
• get the commit history for a branch or tag
• recursive into the tree of a commit
• get the contents of a single file in a commit's tree (this commit's version of the file)
• get the changes between two commits (see screenshot of the diff viewer)

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