Struct git_repository::open::Options

pub struct Options { /* private fields */ }

The options used in ThreadSafeRepository::open_opts

Implementations

impl Options

Instantiation

pub fn isolated() -> Self

Options configured to prevent accessing anything else than the repository configuration file, prohibiting accessing the environment or spreading beyond the git repository location.

impl Options

Builder methods

pub fn object_store_slots(self, slots: Slots) -> Self

Set the amount of slots to use for the object database. It’s a value that doesn’t need changes on the client, typically, but should be controlled on the server.

pub fn replacement_objects(self, config: ReplacementObjects) -> Self

Configure replacement objects, see the ReplacementObjects type for details.

pub fn permissions(self, permissions: Permissions) -> Self

Set the given permissions, which are typically derived by a Trust level.

pub fn with(self, trust: Trust) -> Self

Set the trust level of the .git directory we are about to open.

This can be set manually to force trust even though otherwise it might not be fully trusted, leading to limitations in how configuration files are interpreted.

If not called explicitly, it will be determined by looking at its ownership via git_sec::Trust::from_path_ownership().

Security Warning

Use with extreme care and only if it’s absolutely known that the repository is always controlled by the desired user. Using this capability only saves a permission check and only so if the open() method is used, as opposed to discovery.

pub fn bail_if_untrusted(self, toggle: bool) -> Self

If true, default false, and if the repository’s trust level is not Full (see with() for more), then the open operation will fail.

Use this to mimic gits way of handling untrusted repositories. Note that gitoxide solves this by not using configuration from untrusted sources and by generally being secured against doctored input files which at worst could cause out-of-memory at the time of writing.

pub fn filter_config_section(self, filter: fn(_: &Metadata) -> bool) -> Self

Set the filter which determines if a configuration section can be used to read values from, hence it returns true if it is eligible.

The default filter selects sections whose trust level is full or whose source is not repository-local.

pub fn lossy_config(self, toggle: bool) -> Self

By default, in release mode configuration will be read without retaining non-essential information like comments or whitespace to optimize lookup performance.

Some application might want to toggle this to false in they want to display or edit configuration losslessly with all whitespace and comments included.

pub fn strict_config(self, toggle: bool) -> Self

If set, default is false, invalid configuration values will cause an error even if these can safely be defaulted.

This is recommended for all applications that prefer correctness over usability. git itself by defaults to strict configuration mode to let you know if configuration is incorrect.

pub fn open(
    self,
    path: impl Into<PathBuf>
) -> Result<ThreadSafeRepository, Error>

Open a repository at path with the options set so far.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Options

fn default() -> Self

Returns the “default value” for a type.

impl DefaultForLevel for Options

fn default_for_level(level: Trust) -> Self

Produce a default value for the given trust level.