Merge branch 'main' into remote-ls-refs

Author: Byron

Diff for: Cargo.lock

@@ -132,11 +132,10 @@ 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)
+  * [git-index](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-index)
   * [git-revision](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-revision)
   * `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)
   * [git-worktree](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-worktree)
   * [git-bitmap](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-bitmap)
   * [git-date](https://github.com/Byron/gitoxide/blob/main/crate-status.md#git-date)

Diff for: README.md

@@ -22,7 +22,7 @@ echo "in root: gitoxide CLI"
 (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)
-(enter git-index && indent cargo diet -n --package-size-limit 30KB)
+(enter git-index && indent cargo diet -n --package-size-limit 40KB)
 (enter git-worktree && indent cargo diet -n --package-size-limit 30KB)
 (enter git-quote && indent cargo diet -n --package-size-limit 5KB)
 (enter git-revision && indent cargo diet -n --package-size-limit 25KB)
@@ -40,7 +40,7 @@ echo "in root: gitoxide CLI"
 (enter git-traverse && indent cargo diet -n --package-size-limit 10KB)
 (enter git-url && indent cargo diet -n --package-size-limit 15KB)
 (enter git-validate && indent cargo diet -n --package-size-limit 5KB)
-(enter git-date && indent cargo diet -n --package-size-limit 5KB)
+(enter git-date && indent cargo diet -n --package-size-limit 10KB)
 (enter git-filter && indent cargo diet -n --package-size-limit 5KB)
 (enter git-lfs && indent cargo diet -n --package-size-limit 5KB)
 (enter git-note && indent cargo diet -n --package-size-limit 5KB)

Diff for: etc/check-package-size.sh

@@ -20,7 +20,7 @@ serde1 = ["serde", "bstr/serde1"]
 bstr = { version = "0.2.13", default-features = false, features = ["std"]}
 serde = { version = "1.0.114", optional = true, default-features = false, features = ["derive"]}
 itoa = "1.0.1"
-time = { version = "0.3.2", default-features = false, features = ["local-offset"] }
+time = { version = "0.3.2", default-features = false, features = ["local-offset", "formatting", "macros"] }
 
 document-features = { version = "0.2.0", optional = true }
 

Diff for: git-date/Cargo.toml

@@ -9,20 +9,11 @@
 #![forbid(unsafe_code)]
 #![deny(missing_docs, rust_2018_idioms)]
 
-use bstr::BStr;
-
 ///
 pub mod time;
 
-#[allow(missing_docs)]
-pub fn parse(input: &BStr) -> Option<Time> {
-    // TODO: actual implementation, this is just to not constantly fail
-    if input == "1979-02-26 18:30:00" {
-        Some(Time::new(42, 1800))
-    } else {
-        None
-    }
-}
+mod parse;
+pub use parse::parse;
 
 /// A timestamp with timezone.
 #[derive(PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone, Copy)]

Diff for: git-date/src/lib.rs

@@ -0,0 +1,11 @@
+use crate::Time;
+
+#[allow(missing_docs)]
+pub fn parse(input: &str) -> Option<Time> {
+    // TODO: actual implementation, this is just to not constantly fail
+    if input == "1979-02-26 18:30:00" {
+        Some(Time::new(42, 1800))
+    } else {
+        None
+    }
+}

Diff for: git-date/src/parse.rs

@@ -0,0 +1,27 @@
+use crate::Time;
+use time::format_description::FormatItem;
+use time::formatting::Formattable;
+use time::macros::format_description;
+
+/// E.g. `2018-12-24`
+pub const SHORT: &[FormatItem<'_>] = format_description!("[year]-[month]-[day]");
+
+/// Formatting
+impl Time {
+    /// Format this instance according to the given `format`.
+    ///
+    /// Use the [`format_description`] macro to create and validate formats at compile time, courtesy of the [`time`] crate.
+    pub fn format(&self, format: &(impl Formattable + ?Sized)) -> String {
+        self.to_time()
+            .format(&format)
+            .expect("well-known format into memory never fails")
+    }
+}
+
+impl Time {
+    fn to_time(self) -> time::OffsetDateTime {
+        time::OffsetDateTime::from_unix_timestamp(self.seconds_since_unix_epoch as i64)
+            .expect("always valid unix time")
+            .replace_offset(time::UtcOffset::from_whole_seconds(self.offset_in_seconds).expect("valid offset"))
+    }
+}