Method parse

datafusion/execution/src/object_store.rs:58–72

Parse an [`ObjectStoreUrl`] from a string # Example ``` # use url::Url; # use datafusion_execution::object_store::ObjectStoreUrl; let object_store_url = ObjectStoreUrl::parse("s3://bucket").unwrap(); assert_eq!(object_store_url.as_str(), "s3://bucket/"); // can also access the underlying `Url` let url: &Url = object_store_url.as_ref(); assert_eq!(url.scheme(), "s3"); assert_eq!(url.host_str(), So

(s: impl AsRef<str>)

    /// assert_eq!(url.path(), "/");
    /// ```
    pub fn parse(s: impl AsRef<str>) -> Result<Self> {
        let mut parsed =
            Url::parse(s.as_ref()).map_err(|e| DataFusionError::External(Box::new(e)))?;

        let remaining = &parsed[url::Position::BeforePath..];
        if !remaining.is_empty() && remaining != "/" {
            return exec_err!(
                "ObjectStoreUrl must only contain scheme and authority, got: {remaining}"
            );
        }

        // Always set path for consistency
        parsed.set_path("/");
        Ok(Self { url: parsed })
    }

    /// An [`ObjectStoreUrl`] for the local filesystem (`file://`)
    ///