CHANGES.md

LibGit2Sharp Changes

LibGit2Sharp brings all the might and speed of libgit2, a native Git implementation, to the managed world of .Net and Mono.

• Source code: https://github.com/libgit2/libgit2sharp
• NuGet package: http://nuget.org/List/Packages/LibGit2Sharp
• Issue tracker: https://github.com/libgit2/libgit2sharp/issues
• @libgit2sharp: http://twitter.com/libgit2sharp
• CI servers:
• CodeBetter TeamCity: http://teamcity.codebetter.com/project.html?projectId=LibGit2Sharp&guest=1
• Travis: https://travis-ci.org/libgit2/libgit2sharp

v0.19 - (diff)

Additions

• Introduce repo.Network.Remotes.Rename() (#730, #741)
• Introduce repo.ObjectDatabase.ShortenObjectId() (#677)
• Introduce Remote.IsSupportedUrl() (#754)
• Introduce repo.CherryPick() (#755, #756)
• Expose advanced conflict data (REUC, renames) (#748)

Changes

• Make Patch expose a richer PatchEntryChanges type (#686, #702)
• Make network operations accept Credentials through a callback (#759, #761, #767)
• Make repo.Index.Stage() respect ignored files by default (#777)
• Make OdbBackend IDisposable (#713)
• Update libgit2 binaries to libgit2/libgit2@d28b2b7

Fixes

• Don't require specific rights to the parent hierarchy of a repository (#795)
• Prevent Clone() from choking on empty packets (#794)
• Ensure Tags can be created in detached Head state (#791)
• Properly determine object size when calculating its CRC (#783)
• Prevent blind fast forwards merges when there are checkout conflicts (#781)
• Make repo.Reset() and repo.Index.Unstage() cope with renamed entries (#777)
• Do not throw when parsing annotated tags without a Signature (#775, #776)
• Remove conflicts upon repo.Index.Remove() call (#768)
• Honor the merge.ff configuration entry (#709)
• Make Clone() properly throws when passed an invalid url (#701)

v0.18.1 - (diff)

Additions

• Make CommitOptions expose additional properties to control how the message should be prettified (#744, #745)

Changes

• Update libgit2 binaries to libgit2/libgit2@90befde

Fixes

• Fix issue when cloning from a different local volume (#742, #743)

v0.18.0 - (diff)

Additions

• Introduce repo.Revert() (#706)
• Enhanced control over Merge behavior through MergeOptions (#685)
• Introduce repo.Network.Remotes.Remove() (#729, #731)
• Teach repo.Network.ListReferences() to accept a Credentials (#647, #704)
• Introduce Reference.IsValidName() (#680, #691)
• Introduce Remote.IsValidName() (#679, #690)
• Expose StatusOptions.RecurseIgnoredDirs (#728)
• Introduce GlobalSettings.Features() (#717)
• Make Repository.Version output the libgit2 built-in features (#676, #694)

Changes

• LibGit2Sharp now requires .Net 4.0 (#654, #678)
• Repository.Checkout() and Branch.Checkout() overloads now accept a CheckoutOptions parameter (#685)
• Deprecate repo.Refs.IsValidName() (#680, #691)
• Deprecate repo.Network.Remotes.IsValidName() (#679, #690)
• Deprecate repo.Branches.Move() in favor of repo.Branches.Rename() (#737, #738)
• Update libgit2 binaries to libgit2/libgit2@2f6f6eb

Fixes

• Do not fail enumerating the ObjectDatabase content when an unexpected file is found under .git/objects (#704)
• Fix update of HEAD when committing against a bare repository with a temporary working directory (#692)

v0.17.0 - (diff)

Additions

• Introduce Network.Pull() (#643 and #65)
• Introduce DefaultCredentials for NTLM/Negotiate authentication (#660)
• Make repo.Merge() accept a Branch (#643)
• Introduce MergeOptions type, to specify the type of merge and whether to commit or not (#643, #662, #663)
• Teach reference altering methods to let the caller control how the reflog is valued (#612, #505 and #389)
• Teach repo.Commits.FindMergeBase to leverage either Standard or Octopus strategy (#634 and #629)
• Make ObjectDatabase.CreateCommit() accept an option controlling the prettifying of the message (#619)
• Allow notes retrieval by namespace and ObjectId (#653)

Changes

• Deprecate repo.Commits.FindCommonAncestor() in favor of repo.Commits.FindMergeBase() (#634)
• Deprecate Network.FetchHeads and Repository.MergeHeads (#643)
• Repository.Commit() overloads now accept a CommitOptions parameter (#668)
• Repository.Clone() now accepts a CloneOptions parameter
• Ease testability by making all GetEnumerator() methods fakeable (#646 and #644)
• Update libgit2 binaries to libgit2/libgit2@bcc6229

Fixes

• Make Branch.Add() and Branch.Move() use the correct indentity to feed the reflog (#612 and #616)
• Fix NullReferenceException occuring in Repository.Clone (#659 and #635)

v0.16.0 - (diff)

Additions

• Introduce Repository.Merge() (#608 and #620)
• Teach Diff.Compare<>() to return a PatchStats (#610)

Changes

• Speed up NuGet post build copy of the native binaries (#613)

Fixes

• Fix Remotes.Add(name, url, refspec) to prevent the creation of a default fetch refspec beside the passed in one (#614)
• Make LibGit2SharpException.Data expose the correct libgit2 error categories (#601)

v0.15.0 - (diff)

Additions

• Introduce ObjectDatabase.Archive()
• Introduce Repository.Blame()
• Introduce ObjectDatabase.CalculateHistoryDivergence()
• Add Configuration.Find(regexp)
• Add CommitFilter.FirstParentOnly
• Expose Configuration.BuildSignature()
• Add TreeDefinition.Add(string, TreeEntry)
• Make Remote expose its refspecs

Changes

• Make Network.Fetch() accepts optional refspec
• Extend Network.Fetch() and ListReferences() to allow downloading from a url
• Allow Network.Push() to control packbuilder parallelism
• Expose Network.Push() progress reporting
• Extend RemoteUpdater to allow updation of refspecs
• Teach Index.RetrieveStatus to detect renames in index and workdir
• Teach NoteCollection to optionally build a Signature from configuration
• Add RewriteHistoryOptions.OnSucceeding and OnError
• Introduce Blob FilteringOptions
• Rename Blob.ContentAsText() as Blob.GetContentText()
• Rename Blob.ContentStream() as Blob.GetContentStream()
• Deprecate Blob.Content
• Teach Diff.Compare<> to detect renames and copies
• Split Patch and TreeChanges generation
• Deprecate ResetOptions in favor of ResetMode.
• Simplify OdbBackend.ReadPrefix() implementation
• Deprecate ObjectId.StartsWith(byte[], int) in favor of ObjectId.StartsWith(string)
• Update libgit2 binaries to libgit2/libgit2@96fb6a6

Fixes

• Fix building with Mono on OS X (#557)
• Make RetrieveStatus() reload on-disk index beforehand (#322 and #519)

v0.14.1 - (diff)

Changes

• Rename OrphanedHeadException into UnbornBranchException

Fixes

• Fix handling of http->https redirects
• Make probing for libgit2 binaries work from within the NuGet packages folder
• Accept submodule paths with native directory separators

v0.14.0 - (diff)

Additions

• Introduce Blob.ContentAsText()
• Teach repo.Refs.RewriteHistory() to prune empty commits
• Teach repo.Refs.RewriteHistory() to rewrite symbolic references
• Teach repo.ObjectDatabase to enumerate GitObjects
• Teach Branches.Add() and Move() to append to the reflog
• Honor core.logAllRefUpdates configuration setting
• Add strongly-typed LockedFileException
• Add TreeDefinition.Remove(IEnumerable)
• Introduce ObjectId.StartsWith()
• Introduce repo.Config.GetValueOrDefault()

Changes

• Introduce RewriteHistoryOptions type and make repo.Refs.RewriteHistory() leverage it
• Introduce CheckoutOptions type and make repo.CheckoutPaths() leverage it
• Obsolete Blob.ContentAsUnicode and Blob.ContentAsUf8
• Make OdbBackend interface ObjectId based
• Update libgit2 binaries to libgit2/libgit2@32e4992

Fixes

• Ensure repo.Network.Push() overloads pass the Credentials down the call chain
• Make SymbolicReference.Target cope with chained symbolic references
• Do not throw when parsing a Remote with no url
• Prevent files or directories starting with ! from being ignored
• Teach Index.Stage to stage files in ignored dirs

v0.13.0 - (diff)

Additions

• Teach Repository to Checkout paths
• Teach Checkout() to cope with revparse extended syntax leading to references
• Make Stash expose Base, Index and Untracked commits
• Teach Repository.Init() to set up a separate git directory
• Teach checkout to report notifications
• Create a new repo.Checkout() overload which accepts a Commit object
• Allow ObjectDatabase.CreateBlob() to limit the number of bytes to consume
• Make ObjectDatabase.CreateBlob() accept a Stream
• Introduce repo.Refs.RewriteHistory()
• Introduce repo.Refs.ReachableFrom()
• Introduce TreeDefinition.From(Commit)
• Expose TagFetchMode property on Remote type
• Add CopyNativeDependencies.targets

Changes

• Rename CheckoutOptions into CheckoutModifiers
• Rename DiffOptions into DiffModifiers
• Rename StashOptions into StashModifiers
• Rename GitSortOptions into CommitSortStrategies
• Rename Filter into CommitFilter
• Rename ObjectDatabase.CreateTag into ObjectDatabase.CreateTagAnnotation
• Obsolete repo.Clone() overload which returns a Repository
• Obsolete repo.Init() overload which returns a Repository
• Obsolete ObjectDatabase.CreateBlob(BinaryReader, string)
• Update libgit2 binaries to libgit2/libgit2@7940036

Fixes

• Fetch should respect the remote's configured tagopt setting unless explicitly specified

v0.12.0 - (diff)

Additions

• Introduce repo.Info.IsShallow
• Teach repo.Reset to append to the Reflog
• Introduce repo.ObjectDatabase.CreateTag()
• Make repo.Diff.Compare() able to define the expected number of context and interhunk lines (#423)

Changes

• Obsolete TreeEntryTargetType.Tag
• Update libgit2 binaries to libgit2/libgit2@9d9fff3

Fixes

• Change probing mechanism to rely on specifically named versions of libgit2 binaries (#241)
• Ensure that two versions of LibGit2Sharp can run side by side (#241)

v0.11.0 - (diff)

Additions

• Introduce Repository.Refs.Log()
• Teach Checkout() and Commit() to append to the reflog
• Teach Refs.Add(), Refs.UpdateTarget() to optionally append to the reflog
• Add Repository.Submodules namespace
• Add submodule support to Index.Stage()
• Add TreeDefinition.Add(Submodule) and TreeDefinition.AddGitLink()
• Introduce ExplicitPathsOptions type to control handling of unmatched pathspecs
• Make Index.Remove(), Index.Unstage()/Stage(), Diff.Compare() and Reset() accept ExplicitPathsOptions
• Add an indexer to the StashCollection
• Add the UpstreamBranchCanonicalName property to Branch
• Make Push accept Branch instances
• Introduce Reference.IsTag, Reference.IsLocalBranch and Reference.IsRemoteTrackingBranch
• Add Repository.IsValid()
• Refine build resilience on Linux

Changes

• Obsolete Tree.Trees and Tree.Blobs properties
• Replace GitObjectType with ObjectType and TreeEntryTargetType
• Rename TreeEntry.Type and TreeEntryDefinition.Type to *.TargetType
• Move Repository.Conflicts to Index.Conflicts
• Move Remote.Fetch() in Repository.Network
• Modify StashCollection.Remove() to accept an integer param rather than a revparse expression
• Rename BranchUpdater.Upstream to TrackedBranch
• Rename BranchUpdater.UpstreamMergeBranch to UpstreamBranch
• Rename BranchUpdater.UpstreamRemote to Remote

Fixes

• Make Commit() append to the reflog (#371)
• Make Index.Remove() able to only remove from index (#270)
• Teach Index.Remove() to clear the associated conflicts (#325)
• Make Index.Remove() able to remove folders (#327)
• Fix repo.Checkout() when working against repo.Head
• Fix update of the target of repo.Refs.Head
• Teach Checkout() to cope with revparse syntax
• Support TreeEntry.Target for GitLink entries

v0.10.0 - (diff)

Additions

• Update working directory on checkout
• New network related features: clone, fetch, push, list remote references
• Expose the heads that have been updated during the last fetch in Repository.Network.FetchHeads
• Introduce Repository.Network.Remotes.IsValidName()
• New .gitignore related features: temporary rules, path checking
• Add support for custom, managed ODB backends
• Add revparse support in Repository.Lookup()
• Improve Repository.Commit(): add merged branches as parents, cleanup merge data
• Introduce Blob.IsBinary
• Add strongly-typed exceptions (NonFastForwardException, UnmergedIndexEntriesException, ...)
• Add basic stashing support: add, retrieve, list and remove
• Add git clean support in Repository.RemoveUntrackedFiles()
• Add shortcut to HEAD in Repository.Refs.Head
• Introduce Repository.Refs.IsValidName()
• Add Repository.Refs.FromGlob() to enumerate references matching a specified glob
• Add support for XDG configuration store
• Make Config.Get() and Config.Delete() able to target a specific store
• Diff.Compare() enhancements: work against workdir and index, consider untracked changes, expose typechanges
• Allow retrieval of the remote of a non-local branch through Branch.Remote
• Allow modification of the branch properties through Repository.Branches.Update()
• Expose merge related information: Repository.Index.IsFullyMerged, Repository.Conflicts, IndexEntry.StageLevel
• Expose the heads being merged in Repository.MergeHeads
• Introduce IndexEntry.Mode
• Add more repository information: Repository.Info.CurrentOperation, Repository.Info.Message, Repository.Info.IsHeadOrphaned
• Allow passing an optional RepositoryOptions to Repository.Init()
• Allow reset filtering by passing a list of paths to consider

Changes

• Make TreeChanges and TreeEntryChanges expose native paths
• Make Repository.Reset accept a Commit instead of a string
• Stop sorting collections (references, remotes, notes ...)
• Move AheadBy/BehindBy into new Branch.TrackingDetails
• Move Repository.Remotes to Repository.Network.Remotes
• Move Configuration.HasXXXConfig() to Configuration.HasConfig()
• Rename CommitCollection to CommitLog
• Rename LibGit2Exception to LibGit2SharpException
• Rename Delete() to Unset() in Configuration
• Rename Delete() to Remove() in TagCollection, ReferenceCollection, NoteCollection, BranchCollection
• Rename Create() to Add() in TagCollection, BranchCollection, ReferenceCollection, RemoteCollection, NoteCollection
• Obsolete RepositoryInformation.IsEmpty, DiffTarget, IndexEntry.State, Commit.ParentsCount

Fixes

• Allow abstracting LibGit2Sharp in testing context (#138)
• Ease the detection of a specific key in a specific store (#162)
• Expose libgit2 error information through the LibGit2SharpException.Data property(#137)
• Preserve non-ASCII characters in commit messages (#191)
• Fix retrieval of the author of a commit (#242)
• Prevent duplicated tree entries in commits (#243)
• Fix Repository.Discover behaviour with UNC paths (#256)
• Make Index.Unstage work against an orphaned head (#257)
• Make IsTracking & TrackedBranch property not throw for a detached head (#266, #268)

v0.9.5 - (diff)

Additions

• Add support to create, retrieve, list and remove object notes (#140)
• Make Repository able to rely on specified global and system config files (#157)

Changes

• Remove repo.Branches.Checkout()
• Remove Tree.Files
• Update libgit2 binaries to libgit2/libgit2@4c977a6

Fixes

• Allow initialization of a repository located on a network path (#153)

v0.9 - (diff)

Additions

• Support local tracking branches (#113)
• Add an Ignored collection to the RepositoryStatus type (#120)
• Expose the relative path of TreeEntries (#122)
• Make Repository able to work against specified index and workdir (#132)
• Direct creation or Blobs, Trees and Commits without the workdir nor index involvement (#135)
• New Diff namespace: supports tree-to-tree, tree-to-index and blob-to-blob comparisons (#136)
• Add Commits.FindCommonAncestor() (#149)

Changes

• Deprecate repo.Branches.Checkout() in favor of repo.Checkout()
• Deprecate Tree.Files in favor of Tree.Blobs
• Update libgit2 binaries to libgit2/libgit2@7a361e9

Fixes

• Embed both x86 and amd64 compiled versions of libgit2 binaries (#55, #70)
• Honor symbolically linked global .gitconfig (#84)
• Ease the creation of a remote (#114)
• Prevent memory issues when revwalking a large repository (#115)
• Cleanup commit and tag messages (#117)
• Make RetrieveStatus() return correct results (#123)
• Allow staging on a network shared repository (#125)

v0.8 - (diff)

Additions

• Add Repository.Reset() and support of Soft and Mixed modes
• Make Repository.Commit() able to amend the current tip of the Head
• Make the constructor of Repository able to open a repository from a working directory path
• Make Repository.Index.RetriveStatus honor the .gitgnore files

Changes

• Remove Repository.HasObject()
• Change Repository.Init() to make it return an instance of the Repository type, instead of a string containing the path of the repository
• Update libgit2 binaries to libgit2/libgit2@6d39c0d

Fixes

• Reinit a repository doesn't throw anymore (#54)
• Embedded libgit2 binaries are now compiled with THREADSAFE=ON flag (#64)
• Prevent Repository.Head.IsCurrentRepositoryHead from throwing when the Repository is empty (#105)

v0.7 - (diff)

Additions

• Allow access to System and Global configuration outside the context of a repo
• Add overloads to index methods that accept collection of paths

Changes

• Make Index.RetrieveStatus() return native file paths
• Make IndexEntry able to cope with native file paths
• Update libgit2 binaries to libgit2/libgit2@be00b00
• Deprecate Repository.HasObject()

Fixes

• Fix the build script to be fully XBuild compatible on Linux/Mono 2.10
• Fix Index.Remove() to correctly handle files which have been deleted and modified in the working directory

v0.6.2 - (diff)

Fixes

• Make Index methods (Stage, Unstage, Move... ) able to cope with native Windows directory separator char

v0.6.1 - (diff)

Changes

• Update libgit2 binaries to libgit2/libgit2@e3baa3c

Fixes

• Prevent segfault when determining the status a of repository
• Fix retrieval of buggy status in some (not that rare) cases

v0.6 - (diff)

Additions

• Add Configuration.Get() overload that takes key in parts
• Add tracking branch details (#75)
• Allow creation of commit using signature from configuration files
• Add Index.Remove() (#78)
• Add a string indexer to the Commit and Tree types in order to ease retrieval of TreeEntries

Changes

• Provide default value for non existent configuration setting (#67)
• Change the tree structure into which libgit2 binaries are located (#70)
• Update libgit2 binaries to libgit2/libgit2@28c1451

Fixes

• Prevent enumeration of branches from throwing when the repository contains remote branches (#69)
• Fix Index.Stage(), Index.Unstage() (#78)

v0.5 - (diff)

Additions

• Add Repository.Index.RetrieveStatus() (#49)
• Add handling of configuration settings of the repository and retrieval of Remotes (#60)

Changes

• Can now enumerate from multiple starting points
• While enumerating commits, automatically dereference objects to a commit object id
• Defer resolving of Branch.Tip, Tag.Target and Tag.Annotation
• Replace usage of ApplicationException with LibGit2Exception
• Update libgit2 binaries to libgit2/libgit2@35e9407

Fixes

• Prevent enumeration of commits from throwing when starting from a tag which points at a blob or a tree (#62)
• Prevent a branch from being removed if it's the current HEAD
• References are now being enumerated in a ordered way
• Fix Repository.Discover() implementation when no .git folder exists

v0.4 - (diff)

Additions

• Add Repository.Index.Move()
• Add handling of abbreviated identifiers
• Add Repository.Discover() (#25)
• Add TreeEntry.Type

Changes

• Propagate libgit2 error messages upward
• Update libgit2 binaries to libgit2/libgit2@33afca4

Fixes

• Prevents GitSharp from throwing when browsing a repository initialized with LibGit2Sharp (#56)
• Hide the .git directory when initializing a new standard repository (#53)
• Fix Repository.IsEmpty implementation when HEAD is in detached state (#52)
• Relaxed handling of bogus signatures (#51)
• Improve Mono compatibility (#46 and #47)
• Remove dependency to msvcr100.dll

v0.3 - (diff)

Additions

• Add basic Commit feature (#32)
• Add Repository.Index.Unstage()
• Add branch renaming feature
• Add symbolsource.org support (#37)

Changes

• Make Repository.Head return a Branch instead of a Reference
• Defer resolving of Repository.Info
• Update libgit2 binaries to libgit2/libgit2@a5aa5bd
• Improved Mono compatibility (#34)

Fixes

• Add required msvcr100.dll dependency (#43)
• Fix index updating issue
• Fix branch creation issue

v0.2.0 - (diff)

Changes

• Update CommitCollection API to query commits
• Update libgit2 binaries to libgit2/libgit2@4191d52

Fixes

• Fix Repository.Info.IsEmpty
• Fix default CommitCollection sorting behavior
• Fix creation of reference to prevent it from choking on corrupted ones
• Fix interop issue in a IIS hosted application

v0.1.1 - (diff)

Additions

• Update staging mechanism to authorize full paths to be used (#23)

Fixes

• Fix NuGet packaging

v0.1.0

• Initial release