Parse refspecs

Cargo.toml

@@ -162,6 +162,7 @@ members = [
     "git-lock",
     "git-attributes",
     "git-pathspec",
+    "git-refspec",
     "git-path",
     "git-repository",
     "gitoxide-core",

README.md

@@ -132,6 +132,7 @@ is usable to some extend.
   * [git-repository](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-repository)
   * [git-attributes](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-attributes)
   * [git-pathspec](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-pathspec)
+  * [git-refspec](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-refspec)
   * `gitoxide-core`
 * **very early**  _(possibly without any documentation and many rough edges)_
   * [git-index](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-index)

crate-status.md

@@ -232,7 +232,11 @@ Check out the [performance discussion][git-traverse-performance] as well.
 
 ### git-pathspec
 * [x] parse
-* [ ] check for match
+* [ ] matching of paths
+
+### git-refspec
+* [x] parse
+* [ ] matching of references and object names
 
 ### git-note
 

etc/check-package-size.sh

@@ -18,6 +18,7 @@ echo "in root: gitoxide CLI"
 (enter cargo-smart-release && indent cargo diet -n --package-size-limit 95KB)
 (enter git-actor && indent cargo diet -n --package-size-limit 5KB)
 (enter git-pathspec && indent cargo diet -n --package-size-limit 25KB)
+(enter git-refspec && indent cargo diet -n --package-size-limit 15KB)
 (enter git-path && indent cargo diet -n --package-size-limit 15KB)
 (enter git-attributes && indent cargo diet -n --package-size-limit 15KB)
 (enter git-discover && indent cargo diet -n --package-size-limit 20KB)

git-refspec/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.0.0 (2022-08-05)
+
+Initial release for name reservation.
+
+### Commit Statistics
+
+<csr-read-only-do-not-edit/>
+
+ - 2 commits contributed to the release.
+ - 0 commits where understood as [conventional](https://www.conventionalcommits.org).
+ - 1 unique issue was worked on: [#450](https://github.com/Byron/gitoxide/issues/450)
+
+### Commit Details
+
+<csr-read-only-do-not-edit/>
+
+<details><summary>view details</summary>
+
+ * **[#450](https://github.com/Byron/gitoxide/issues/450)**
+    - prepare git-refspec changelog prior to release ([`3383408`](https://github.com/Byron/gitoxide/commit/3383408ce22ca9c7502ad2d1fab51cf12dc5ee72))
+    - empty `git-refspec` crate for name reservation prior to implementation ([`871a3c0`](https://github.com/Byron/gitoxide/commit/871a3c054d4fe6c1e92b6f2e260b19463404509f))
+</details>
+

git-refspec/Cargo.toml

@@ -0,0 +1,26 @@
+[package]
+name = "git-refspec"
+version = "0.0.0"
+repository = "https://github.com/Byron/gitoxide"
+license = "MIT/Apache-2.0"
+description = "A WIP crate of the gitoxide project for parsing and representing refspecs"
+authors = ["Sebastian Thiel <[email protected]>"]
+edition = "2018"
+include = ["src/**/*", "CHANGELOG.md", "README.md"]
+
+[lib]
+doctest = false
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+git-revision = { version = "^0.3.0", path = "../git-revision" }
+git-validate = { version = "^0.5.4", path = "../git-validate" }
+git-hash = { version = "^0.9.6", path = "../git-hash" }
+
+bstr = { version = "0.2.13", default-features = false, features = ["std"]}
+thiserror = "1.0.26"
+smallvec = "1.9.0"
+
+[dev-dependencies]
+git-testtools = { path = "../tests/tools" }

git-refspec/README.md

@@ -0,0 +1,11 @@
+# `git-refspec`
+
+### Testing
+
+#### Fuzzing
+
+`cargo fuzz` is used for fuzzing, installable with `cargo install cargo-fuzz`.
+
+Targets can be listed with `cargo fuzz list` and executed via `cargo +nightly fuzz run <target>`,
+where `<target>` can be `parse` for example.
+

git-refspec/fuzz/.gitignore

@@ -0,0 +1,3 @@
+target
+corpus
+artifacts