Crate git_testtools

Utilities for testing gitoxide crates, many of which might be useful for testing programs that use git in general.

Re-exports

pub use bstr;

pub use is_ci;

pub use once_cell;

pub use tempfile;

Structs

Env

A utility to set environment variables, while unsetting them (or resetting them to their previous value) on drop.

GitDaemon

A wrapper for a running git-daemon process which is killed automatically on drop.

Enums

Creation

Define how scripted_fixture_writable_with_args() uses produces the writable copy.

Statics

GIT_VERSION

The major, minor and patch level of the git version on the system.

Functions

copy_recursively_into_existing_dir

A utility to copy the entire contents of src_dir into dst_dir.

fixture_bytes

Load the fixture from <crate-root>/tests/fixtures/<path> and return its data, or panic.

fixture_path

Return the path to the <crate-root>/tests/fixtures/<path> directory.

hex_to_id

Convert a hexadecimal hash into its corresponding ObjectId or panic.

run_git

Run git in working_dir with all provided args.

scripted_fixture_read_only

Run the executable at script_name, like make_repo.sh or my_setup.py to produce a read-only directory to which the path is returned.

scripted_fixture_read_only_with_args

Like scripted_fixture_read_only()], but passes args to script_name.

scripted_fixture_writable

Run the executable at script_name, like make_repo.sh to produce a writable directory to which the tempdir is returned. It will be removed automatically, courtesy of tempfile::TempDir.

scripted_fixture_writable_with_args

Like scripted_fixture_writable(), but passes args to script_name while providing control over the way files are created with mode.

should_skip_as_git_version_is_smaller_than

Returns true if the given major, minor and patch is smaller than the actual git version on the system to facilitate skipping a test on the caller. Will never return true on CI which is expected to have a recent enough git version.

spawn_git_daemon

Spawn a git daemon process to host all repository at or below working_dir.

to_bstr_err

Transform a verbose bom errors from raw bytes into a BStr to make printing/debugging human-readable.

Type Definitions

Result

A result type to allow using the try operator ? in unit tests.