cargo-overlay-registry 0.1.5

A local Cargo registry proxy that overlays local crates on top of crates.io
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! Cargo Overlay Registry - A proxy registry for crates.io with local publishing support.
//!
//! This library provides the core functionality for running a cargo registry proxy that:
//! - Proxies requests to crates.io (or another upstream registry)
//! - Supports local publishing of crates
//! - Can act as an HTTP/HTTPS forward proxy for cargo
//! - Supports MITM interception for transparent proxying

use std::sync::Arc;

use axum::routing::{get, put};
use axum::Router;

pub mod endpoints;
pub mod http_proxy;
pub mod registry;
pub mod state;
pub mod tls;
pub mod types;

pub use endpoints::{
    handle_api_download, handle_api_publish, handle_api_search, handle_config, handle_index_1char,
    handle_index_2char, handle_index_3char, handle_index_4plus,
};
pub use http_proxy::{handle_proxy_connection, HttpProxyState};
pub use registry::{
    build_registry, AnyRegistry, BuiltRegistry, DynRegistry, Registry, RegistryBuildOptions,
    RegistrySpec,
};
pub use state::{GenericProxyState, MitmCa, RegistryState};
pub use tls::generate_self_signed_cert;

/// Build the standard registry router with all endpoints configured.
pub fn build_registry_router<S: RegistryState + Clone + Send + Sync + 'static>(
    state: Arc<S>,
) -> Router {
    Router::new()
        // Index config endpoint
        .route("/config.json", get(handle_config::<S>))
        // Index files for 1-char package names: /1/{name}
        .route("/1/{name}", get(handle_index_1char::<S>))
        // Index files for 2-char package names: /2/{name}
        .route("/2/{name}", get(handle_index_2char::<S>))
        // Index files for 3-char package names: /3/{first_char}/{name}
        .route("/3/{first_char}/{name}", get(handle_index_3char::<S>))
        // Index files for 4+ char package names: /{first_two}/{second_two}/{name}
        .route(
            "/{first_two}/{second_two}/{name}",
            get(handle_index_4plus::<S>),
        )
        // API: Search crates
        .route("/api/v1/crates", get(handle_api_search::<S>))
        // API: Publish crate
        .route("/api/v1/crates/new", put(handle_api_publish::<S>))
        // API: Download crate
        .route(
            "/api/v1/crates/{crate_name}/{version}/download",
            get(handle_api_download::<S>),
        )
        .with_state(state)
}