v1.8

This is release v1.8.0, "Das Fliegende Klassenzimmer". This release includes optional, experimental support for invoking OpenSSH to fetch and push, an easier mechanism to perform the default behavior ofgit commit, and has many improvements for worktrees. This release also includes many other new features and bugfixes.

Major changes

• Executable SSH (OpenSSH) support
  libgit2 can now invoke the command-line OpenSSH to fetch from and push to remotes over SSH. This support takes the place of libssh2 support. To use it, configure libgit2 withcmake -DUSE_SSH=exec, and please report any problems that you discover. By@ethomson inAdd OpenSSH support #6617

• Simplified commit creation
  Thegit_commit_create_from_stage API was introduced to allow users to better emulate the behavior ofgit commit without needing to provide unnecessary information. The current state of the index is committed to the current branch. By@ethomson incommit: introduce git_commit_create_from_stage #6716

• Worktree improvements
  A number of worktree improvements have been made for better compatibility with core git. First, libgit2 now understands per-worktree references, thanks to@csware inMake refdb_fs (hopefully) fully aware of per worktree refs #6387. Worktree-specific configuration is now supported, thanks to@vermiculus inSupport the extension for worktree-specific config #6202. And improved compatibility withgit worktree add is now supported, thanks to@herrerog inworktree: mimic 'git worktree add' behavior. #5319.

Breaking changes

• AddingWORKTREE configuration level (ABI breaking change)
  To support worktree configurations at the appropriate level (higher priority than local configuration, but lower priority than app-specific configuration), theGIT_CONFIG_LEVEL_WORKTREE level was introduced at priority 6.GIT_CONFIG_LEVEL_APP now begins at priority 7.

• Changes togit_config_entry (ABI breaking change) Thegit_config_entry structure now contains information about thebackend_type andorigin_path. The unusedpayload value has been removed.

• git_push_options includes remote push options (ABI breaking change)
  Thegit_push_options structure now contains a value for remote push options.

Other changes

New features

• config: provide an "origin" for config entries by@ethomson inconfig: provide an "origin" for config entries #6615
• cli: add agit config command by@ethomson incli: add agit config command #6616
• Add OpenSSH support by@ethomson inAdd OpenSSH support #6617
• remote: optionally report unchanged tips by@ethomson inremote: optionally report unchanged tips #6645
• Support setting oid type for in-memory repositories by@kcsaul inSupport setting oid type for in-memory repositories #6671
• cli: addindex-pack command by@ethomson incli: addindex-pack command #6681
• Addgit_repository_commit_parents to identify the parents of the next commit given the repository state by@ethomson inAddgit_repository_commit_parents to identify the parents of the next commit given the repository state #6707
• commit: introduce git_commit_create_from_stage by@ethomson incommit: introduce git_commit_create_from_stage #6716
• set SSH timeout by@vafada inset SSH timeout #6721
• Implement push options on push by@russell inImplement push options on push #6439
• Support index.skipHash true config by@parnic inSupport index.skipHash true config #6738
• worktree: mimic 'git worktree add' behavior. by@herrerog inworktree: mimic 'git worktree add' behavior. #5319
• Support the extension for worktree-specific config by@vermiculus inSupport the extension for worktree-specific config #6202
• Separate config reader and writer backend priorities (for worktree configs) by@ethomson inSeparate config reader and writer backend priorities (for worktree configs) #6756
• fetch: enable deepening/shortening shallow clones by@kempniu infetch: enable deepening/shortening shallow clones #6662

Bug fixes

• repository: make cleanup safe for re-use with grafts by@carlosmn inrepository: make cleanup safe for re-use with grafts #6600
• fix: Add missing include for oidarray. by@dvzrv infix: Add missing include for oidarray. #6608
• ssh: fix known_hosts leak in _git_ssh_setup_conn by@steven9724 inssh: fix known_hosts leak in _git_ssh_setup_conn #6599
• proxy: Return an error for invalid proxy URLs instead of crashing. by@lrm29 inproxy: Return an error for invalid proxy URLs instead of crashing. #6597
• errors: refactoring - never returnNULL ingit_error_last() by@ethomson inerrors: refactoring - never returnNULL ingit_error_last() #6625
• Reject potential option injections over ssh by@carlosmn inReject potential option injections over ssh #6636
• remote: fix memory leak in git_remote_download() by@7Ji inremote: fix memory leak in git_remote_download() #6651
• git2: Fix crash when called w/o parameters by@csware ingit2: Fix crash when called w/o parameters #6673
• Avoid macro redefinition of ENABLE_INTSAFE_SIGNED_FUNCTIONS by@csware inAvoid macro redefinition of ENABLE_INTSAFE_SIGNED_FUNCTIONS #6666
• util: suppress some uninitialized variable warnings by@boretrk inutil: suppress some uninitialized variable warnings #6659
• fetch: enable deepening/shortening shallow clones by@kempniu infetch: enable deepening/shortening shallow clones #6662
• push: set generic error in push_negotiation cb by@ethomson inpush: set generic error in push_negotiation cb #6675
• process: test /usr/bin/false on BSDs by@ethomson inprocess: test /usr/bin/false on BSDs #6677
• clone: don't mix up "http://url" with "http:/url" when figuring out if we should do a local clone by@boretrk inclone: don't mix up "http://url" with "http:/url" when figuring out if we should do a local clone #6361
• Several compatibility fixes by@ethomson inSeveral compatibility fixes #6678
• Git blame buffer gives the wrong result in many cases where there are… by@thosey inGit blame buffer gives the wrong result in many cases where there are… #6572
• Fix 'path cannot exist in repository' during diff for in-memory repository by@kcsaul inFix 'path cannot exist in repository' during diff for in-memory repository #6683
• process: don't try to close the status by@ethomson inprocess: don't try to close the status #6693
• Minor bug fixes by@ethomson inMinor bug fixes #6695
• Bypass shallow clone support for in-memory repositories by@kcsaul inBypass shallow clone support for in-memory repositories #6684
• examples: use unsigned int for bitfields by@ethomson inexamples: use unsigned int for bitfields #6699
• Fix some bugs caught by UBscan by@ethomson inFix some bugs caught by UBscan #6700
• git_diff_find_similar doesn't always remove unmodified deltas by@yori ingit_diff_find_similar doesn't always remove unmodified deltas #6642
• httpclient: clear client->parser.data after use by@ethomson inhttpclient: clear client->parser.data after use #6705
• Do not normalize safe.directory paths by@csware inDo not normalize safe.directory paths #6668
• clone: don't swallow error in should_checkout by@ethomson inclone: don't swallow error in should_checkout #6727
• Correct index add directory/file conflict detection by@ethomson inCorrect index add directory/file conflict detection #6729
• Correctgit_revparse_single and add revparse fuzzing by@ethomson inCorrectgit_revparse_single and add revparse fuzzing #6730
• config: properly delete or rename section containing multivars by@samueltardieu inconfig: properly delete or rename section containing multivars #6723
• revparse: ensure bare '@' is truly bare by@ethomson inrevparse: ensure bare '@' is truly bare #6742
• repo: ensure we can initialize win32 paths by@ethomson inrepo: ensure we can initialize win32 paths #6743
• SwapGIT_DIFF_LINE_(ADD|DEL)_EOFNL to match other Diffs by@xphoniex inSwapGIT_DIFF_LINE_(ADD|DEL)_EOFNL to match other Diffs #6240
• diff: fix test for SHA256 support in diff_from_buffer by@ethomson indiff: fix test for SHA256 support in diff_from_buffer #6745
• http: support empty http.proxy config setting by@ethomson inhttp: support empty http.proxy config setting #6744
• Moresafe.directory improvements by@ethomson inMoresafe.directory improvements #6739
• Ensure that completely ignored diff is empty by@ethomson inEnsure that completely ignored diff is empty #5893
• Fix broken regexp that matches submodule names containing ".path" by@csware inFix broken regexp that matches submodule names containing ".path" #6749
• Fix memory leaks by@csware inFix memory leaks #6748
• Make refdb_fs (hopefully) fully aware of per worktree refs by@csware inMake refdb_fs (hopefully) fully aware of per worktree refs #6387
• fix log example by@albfan infix log example #6359
• fetch: fail on depth for local transport by@ethomson infetch: fail on depth for local transport #6757
• Fix message trailer parsing by@ethomson inFix message trailer parsing #6761
• config: correct fetching the HIGHEST_LEVEL config by@ethomson inconfig: correct fetching the HIGHEST_LEVEL config #6766
• Avoid some API breaking changes in v1.8 by@ethomson inAvoid some API breaking changes in v1.8 #6768

Build and CI improvements

• meta: update version numbers to v1.8 by@ethomson inmeta: update version numbers to v1.8 #6596
• Revert "CMake: Search for ssh2 instead of libssh2." by@ethomson inRevert "CMake: Search for ssh2 instead of libssh2." #6619
• cmake: fix openssl build on win32 by@lazka incmake: fix openssl build on win32 #6626
• ci: retry flaky online tests by@ethomson inci: retry flaky online tests #6628
• ci: update to macOS 12 by@ethomson inci: update to macOS 12 #6629
• Use #!/bin/bash for script with bash-specific commands by@roehling inUse #!/bin/bash for script with bash-specific commands #6581
• ci: overwrite nonsense in /usr/local during macOS setup by@ethomson inci: overwrite nonsense in /usr/local during macOS setup #6664
• release: add a compatibility label by@ethomson inrelease: add a compatibility label #6676
• actions: set permissions by@ethomson inactions: set permissions #6680
• cmake: rename FindIconv to avoid collision with cmake by@ethomson incmake: rename FindIconv to avoid collision with cmake #6682
• ci: allow workflows to read and write packages by@ethomson inci: allow workflows to read and write packages #6687
• ci: allow workflows to push changes by@ethomson inci: allow workflows to push changes #6688
• tests: remove test for strcasecmp by@boretrk intests: remove test for strcasecmp #6691
• CI fixes by@ethomson inCI fixes #6694
• ci: improvements to prepare for Cygwin support by@ethomson inci: improvements to prepare for Cygwin support #6696
• Yet more CI improvements by@ethomson inYet more CI improvements #6697
• Fix nightly builds by@ethomson inFix nightly builds #6709
• Benchmarks: add a site to view results by@ethomson inBenchmarks: add a site to view results #6715
• GIT_RAND_GETENTROPY: do not include sys/random.h by@semarie inGIT_RAND_GETENTROPY: do not include sys/random.h #6736
• add dl to LIBGIT2_SYSTEM_LIBS by@christopherfujino inadd dl to LIBGIT2_SYSTEM_LIBS #6631
• meta: add dependency tag to release.yml by@ethomson inmeta: add dependency tag to release.yml #6740
• CI: fix our nightlies by@ethomson inCI: fix our nightlies #6751
• trace: Re-enable tests as tracing is now enabled by default by@lrm29 intrace: Re-enable tests as tracing is now enabled by default #6752
• tests: don't free an unininitialized repo by@ethomson intests: don't free an unininitialized repo #6763
• ci: reduce ASLR randomization for TSAN by@ethomson inci: reduce ASLR randomization for TSAN #6764
• packbuilder: adjust nondeterministic tests by@ethomson inpackbuilder: adjust nondeterministic tests #6762
• Allow libgit2 to be compiled with mbedtls3. by@adamharrison inAllow libgit2 to be compiled with mbedtls3. #6759
• build: update to latest actions versions by@ethomson inbuild: update to latest actions versions #6765
• ctype: cast characters to unsigned when classifying characters by@boretrk inctype: cast characters to unsigned when classifying characters #6679 and@ethomson incast characters to unsigned when classifying characters #6770
• valgrind: suppress OpenSSL warnings by@ethomson invalgrind: suppress OpenSSL warnings #6769
• ci: split SHA256 builds out into their own workflow by@ethomson inci: split SHA256 builds out into their own workflow #6772

Documentation improvements

• README.md: Fix link to conan packages by@lrm29 inREADME.md: Fix link to conan packages #6621
• README: replace gmaster with GitButler by@ethomson inREADME: replace gmaster with GitButler #6692
• blame example: Fix support for line range in CLI by@wetneb inblame example: Fix support for line range in CLI #6638
• Support authentication in push example by@pluehne inSupport authentication in push example #5904
• docs: fix mistake in attr.h by@DavHau indocs: fix mistake in attr.h #6714
• Fix broken links by@csware inFix broken links #6747

Platform compatibility fixes

• stransport: macOS: replace errSSLNetworkTimeout, with hard-coded value by@mascguy instransport: macOS: replace errSSLNetworkTimeout, with hard-coded value #6610

Git compatibility fixes

• Do not trim dots from usernames by@georgthegreat inDo not trim dots from usernames #6657
• merge: fix incorrect rename detection for empty files. by@herrerog inmerge: fix incorrect rename detection for empty files. #6717

Dependency updates

• zlib: upgrade bundled zlib to v1.3 by@ethomson inzlib: upgrade bundled zlib to v1.3 #6698
• ntlmclient: update to latest upstream ntlmclient by@ethomson inntlmclient: update to latest upstream ntlmclient #6704

New Contributors

• @dvzrv made their first contribution infix: Add missing include for oidarray. #6608
• @mascguy made their first contribution instransport: macOS: replace errSSLNetworkTimeout, with hard-coded value #6610
• @steven9724 made their first contribution inssh: fix known_hosts leak in _git_ssh_setup_conn #6599
• @lazka made their first contribution incmake: fix openssl build on win32 #6626
• @roehling made their first contribution inUse #!/bin/bash for script with bash-specific commands #6581
• @7Ji made their first contribution inremote: fix memory leak in git_remote_download() #6651
• @kempniu made their first contribution infetch: enable deepening/shortening shallow clones #6662
• @thosey made their first contribution inGit blame buffer gives the wrong result in many cases where there are… #6572
• @wetneb made their first contribution inblame example: Fix support for line range in CLI #6638
• @yori made their first contribution ingit_diff_find_similar doesn't always remove unmodified deltas #6642
• @pluehne made their first contribution inSupport authentication in push example #5904
• @DavHau made their first contribution indocs: fix mistake in attr.h #6714
• @vafada made their first contribution inset SSH timeout #6721
• @semarie made their first contribution inGIT_RAND_GETENTROPY: do not include sys/random.h #6736
• @christopherfujino made their first contribution inadd dl to LIBGIT2_SYSTEM_LIBS #6631
• @parnic made their first contribution inSupport index.skipHash true config #6738
• @samueltardieu made their first contribution inconfig: properly delete or rename section containing multivars #6723
• @xphoniex made their first contribution inSwapGIT_DIFF_LINE_(ADD|DEL)_EOFNL to match other Diffs #6240
• @adamharrison made their first contribution inAllow libgit2 to be compiled with mbedtls3. #6759

Full Changelog:v1.7.0...v1.8.0