Byron/gitoxide git-config-v0.3.0

git-config v0.3.0

on GitHub

New Features

• GitConfig::path() for direct access to paths.
  Very similar to string(), but as path, whose query can never fail.

• add suppport for android
  Do not interpolate ~user/ on Android (Termux).
  There is no meaning of it. It is single user system.

• support for try_value(), boolean() and string() access. Support for a convenient way of knowing if a value does or doesn't exist via try_value()`, which can only fail if the conversion fails.

  Lastly, string() is a special case which doesn't fail as there is
  no conversion, and boolean() allows to obtain a plain boolean value
  if it was a valid boolean representation.

• new hierarchical errors for value lookup

Changed (BREAKING)

• remove values::*Error in favor of value::parse::Error.
  This makes it easier to work with errors in practice, we are either
  interested in the value that failed to parse to try something else
  or want a nice user message.

  Having one decode error type facilitates that.

• switch from quickerror to thiserror.
  This allows for generic types for sources of errors and allows to
  workaround a limitation with associated type constraints in the MSRV
  of 1.54.

  Using thiserror makes this work and brings the crate more closely
  to the rest of the gitoxide crates (which now prefer thiserror over
  quickerror).

• remove all get_ prefixes from methods
  That way the API is more idiomatic and fits better into the
  existing gitoxide crates.

• use lookup::Error and lookup::existing::Error
  Use the newly introduced structured error to replace the 'catch-all'
  GitConfigError while getting closer to naming conventions in other
  gitoxide crates.

Commit Statistics

• 37 commits contributed to the release over the course of 20 calendar days.
• 43 days passed between releases.
• 8 commits where understood as conventional.
• 5 unique issues were worked on: #298, #301, #331, #386, #404

Thanks Clippy

Clippy helped 4 times to make code idiomatic.

Commit Details