mirror of
https://seed.radicle.dev/rad:z6cFWeWpnZNHh9rUW8phgA3b5yGt.git
synced 2026-10-26 23:00:38 +08:00
Fintan Halpenny
502053d972
There is an advisory error[0] relating to tokio which is transitively brought in via deadpool. Since git-storage is not currently used and heartwood is avoiding any async runtimes, the pool module is removed. [0]: https://rustsec.org/advisories/RUSTSEC-2023-0001.html Signed-off-by: Fintan Halpenny <fintan.halpenny@gmail.com> X-Clacks-Overhead: GNU Terry Pratchett
78 lines
2.0 KiB
Rust
78 lines
2.0 KiB
Rust
// Copyright © 2022 The Radicle Link Contributors
|
|
// SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
//! # `git-storage`
|
|
//!
|
|
//! This crate provides access to git [references][refs] and [objects][objs].
|
|
//!
|
|
//! To first initialise the storage use [`Write::open`].
|
|
//!
|
|
//! After the storage is initialised, use [`Write::open`] or [`Read::open`] for
|
|
//! read-write or read-only access to the underlying storage. These structs will
|
|
//! implement the traits below depending on their access levels.
|
|
//!
|
|
//! ## Read-only access
|
|
//!
|
|
//! * [`refdb::Read`]
|
|
//! * [`odb::Read`]
|
|
//!
|
|
//! ## Read-write access
|
|
//!
|
|
//! * [`refdb::Read`]
|
|
//! * [`refdb::Write`]
|
|
//! * [`odb::Read`]
|
|
//! * [`odb::Write`]
|
|
//!
|
|
//! ## Concurrency
|
|
//!
|
|
//!
|
|
//! [`Read`] and [`Write`] can be sent between threads, but it can't be shared
|
|
//! between threads. _Some_ operations are safe to perform concurrently in much
|
|
//! the same way two `git` processes can access the same repository.
|
|
//!
|
|
//! [refs]: https://git-scm.com/book/en/v2/Git-Internals-Git-References
|
|
//! [objs]: https://git-scm.com/book/en/v2/Git-Internals-Git-Objects
|
|
|
|
extern crate radicle_git_ext as git_ext;
|
|
extern crate radicle_std_ext as std_ext;
|
|
|
|
pub mod glob;
|
|
|
|
pub mod refdb;
|
|
pub use refdb::{Applied, Reference, SymrefTarget, Target, Update, Updated};
|
|
|
|
pub mod odb;
|
|
pub use odb::{Blob, Commit, Object, Tag, Tree};
|
|
|
|
mod backend;
|
|
pub use backend::{
|
|
read::{self, Read},
|
|
write::{self, Write},
|
|
};
|
|
|
|
pub mod signature;
|
|
|
|
/// Initialise the git backend.
|
|
///
|
|
/// **SHOULD** be called before all accesses to git functionality.
|
|
pub fn init() {
|
|
use libc::c_int;
|
|
use libgit2_sys as raw_git;
|
|
use std::sync::Once;
|
|
|
|
static INIT: Once = Once::new();
|
|
|
|
unsafe {
|
|
INIT.call_once(|| {
|
|
let ret =
|
|
raw_git::git_libgit2_opts(raw_git::GIT_OPT_SET_MWINDOW_FILE_LIMIT as c_int, 256);
|
|
if ret < 0 {
|
|
panic!(
|
|
"error setting libgit2 option: {}",
|
|
git2::Error::last_error(ret).unwrap()
|
|
)
|
|
}
|
|
})
|
|
}
|
|
}
|