12 releases

0.4.5 Sep 6, 2024
0.4.4 Nov 5, 2022
0.4.3 Oct 11, 2022
0.4.2 May 30, 2022
0.1.0 Feb 6, 2020

#159 in Parser implementations

Download history 1168/week @ 2024-07-18 1395/week @ 2024-07-25 1583/week @ 2024-08-01 1069/week @ 2024-08-08 1240/week @ 2024-08-15 1138/week @ 2024-08-22 1180/week @ 2024-08-29 1472/week @ 2024-09-05 1468/week @ 2024-09-12 1187/week @ 2024-09-19 1385/week @ 2024-09-26 1360/week @ 2024-10-03 1397/week @ 2024-10-10 1217/week @ 2024-10-17 1020/week @ 2024-10-24 895/week @ 2024-10-31

4,752 downloads per month
Used in 29 crates (24 directly)

MIT license

25KB
362 lines

git-url-parse

Minimum Supported Rust Version Crates.io Github actions CI status docs.rs License Maintenance

Supports common protocols as specified by the Pro Git book

See: 4.1 Git on the Server - The Protocols

Supports parsing SSH/HTTPS repo urls for:

  • Github
  • Bitbucket
  • Azure Devops

See tests/parse.rs for expected output for a variety of inputs.


URLs that use the ssh:// protocol (implicitly or explicitly) undergo a small normalization process in order to be parsed.

Internally uses Url::parse() from the Url crate after normalization.

Examples

Run example with debug output

$ RUST_LOG=git_url_parse cargo run --example multi
$ RUST_LOG=git_url_parse cargo run --example trim_auth 

Simple usage and output

$ cargo run --example readme
use git_url_parse::GitUrl;

fn main() {
    println!("SSH: {:#?}", GitUrl::parse("git@github.com:tjtelan/git-url-parse-rs.git"));
    println!("HTTPS: {:#?}", GitUrl::parse("https://github.com/tjtelan/git-url-parse-rs"));
}

Example Output

SSH: Ok(
    GitUrl {
        host: Some(
            "github.com",
        ),
        name: "git-url-parse-rs",
        owner: Some(
            "tjtelan",
        ),
        organization: None,
        fullname: "tjtelan/git-url-parse-rs",
        scheme: Ssh,
        user: Some(
            "git",
        ),
        token: None,
        port: None,
        path: "tjtelan/git-url-parse-rs.git",
        git_suffix: true,
        scheme_prefix: false,
    },
)
HTTPS: Ok(
    GitUrl {
        host: Some(
            "github.com",
        ),
        name: "git-url-parse-rs",
        owner: Some(
            "tjtelan",
        ),
        organization: None,
        fullname: "tjtelan/git-url-parse-rs",
        scheme: Https,
        user: None,
        token: None,
        port: None,
        path: "/tjtelan/git-url-parse-rs",
        git_suffix: false,
        scheme_prefix: true,
    },
)

Dependencies

~2.2–3.5MB
~58K SLoC