pub struct Url {
pub scheme: Scheme,
pub port: Option<u16>,
pub path: BString,
/* private fields */
}
Expand description
A URL with support for specialized git related capabilities.
Additionally there is support for deserialization and serialization
(see the Display::fmt()
implementation).
Deviation
Note that we do not support passing the password using the URL as it’s likely leading to accidents.
Fields§
§scheme: Scheme
The URL scheme.
port: Option<u16>
The port to use when connecting to a host. If None
, standard ports depending on scheme
will be used.
path: BString
The path portion of the URL, usually the location of the git repository.
Implementations§
source§impl Url
impl Url
Instantiation
source§impl Url
impl Url
Builder
sourcepub fn serialize_alternate_form(self, use_alternate_form: bool) -> Self
pub fn serialize_alternate_form(self, use_alternate_form: bool) -> Self
Enable alternate serialization for this url, e.g. file:///path
becomes /path
.
This is automatically set correctly for parsed URLs, but can be set here for urls created by constructor.
sourcepub fn canonicalize(&mut self) -> Result<(), Error>
pub fn canonicalize(&mut self) -> Result<(), Error>
Turn a file url like file://relative
into file:///root/relative
, hence it assures the url’s path component is absolute.
source§impl Url
impl Url
Access
sourcepub fn path_is_root(&self) -> bool
pub fn path_is_root(&self) -> bool
Returns true if the path portion of the url is /
.
sourcepub fn port_or_default(&self) -> Option<u16>
pub fn port_or_default(&self) -> Option<u16>
Returns the actual or default port for use according to the url scheme. Note that there may be no default port either.
source§impl Url
impl Url
Transformation
sourcepub fn canonicalized(&self) -> Result<Self, Error>
pub fn canonicalized(&self) -> Result<Self, Error>
Turn a file url like file://relative
into file:///root/relative
, hence it assures the url’s path component is absolute.
Trait Implementations§
source§impl<'de> Deserialize<'de> for Url
impl<'de> Deserialize<'de> for Url
source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,
source§impl Ord for Url
impl Ord for Url
source§impl PartialOrd<Url> for Url
impl PartialOrd<Url> for Url
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read more