    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

    //! Implementations of `Source` trait.
    //!
    //! Cargo provides several built-in implementations of [`Source`] trait. Namely,
    //!
    //! * [`RegistrySource`] --- A source that provides an index for people to query
    //!   a crate's metadata, and fetch files for a certain crate. crates.io falls
    //!   into this category. So do local registry and sparse registry.
    //! * [`DirectorySource`] --- Files are downloaded ahead of time. Primarily
    //!   designed for crates generated from `cargo vendor`.
    //! * [`GitSource`] --- This gets crate information from a git repository.
    //! * [`PathSource`] --- This gets crate information from a local path on the
    //!   filesystem.
    //! * [`ReplacedSource`] --- This manages the [source replacement] feature,
    //!   redirecting operations on the original source to the replacement.
    //!
    //! This module also contains [`SourceConfigMap`], which is effectively the
    //! representation of the `[source.*]` value in Cargo configuration.
    //!
    //! [`Source`]: crate::core::Source
    //! [source replacement]: https://doc.rust-lang.org/nightly/cargo/reference/source-replacement.html

    pub use self::config::SourceConfigMap;
    pub use self::directory::DirectorySource;
    pub use self::git::GitSource;
    pub use self::path::PathSource;
    pub use self::registry::{RegistrySource, CRATES_IO_DOMAIN, CRATES_IO_INDEX, CRATES_IO_REGISTRY};
    pub use self::replaced::ReplacedSource;

    pub mod config;
    pub mod directory;
    pub mod git;
    pub mod path;
    pub mod registry;
    pub mod replaced;