5 releases
0.0.5 | Oct 25, 2023 |
---|---|
0.0.4 | Aug 12, 2023 |
0.0.3 | Jul 25, 2023 |
0.0.2 | Mar 11, 2023 |
0.0.1 | Oct 23, 2022 |
#189 in Embedded development
1,070 downloads per month
Used in 5 crates
(4 directly)
21KB
276 lines
About rhai-url
This crate provides url::Url
access for the Rhai scripting language.
Usage
Cargo.toml
[dependencies]
rhai-url = "0.0.4"
Rhai script
// create a new Url
let url = Url("http://example.com/?q=query");
// get the absolute url as a string
print(url.href); // print 'http://example.com/?q=query'
print(url.to_string()); // print 'http://example.com/?q=query'
// get the url query string, without the leading ?
print(url.query); // print 'q=query'
// get the url fragment
print(url.fragment); // print ''
// hash is an alias of fragment
print(url.hash); // print ''
// clear the query
url.query_clear();
print(url.query); // print ''
// remove a query key
url.query_remove("q");
// query_remove with no arguments will clear the query string
url.query_remove();
// adds a query key value pair into the query string
url.query_append("q", "name");
You can see an example on how to use those function in the tests.
Rust source
use rhai::{Engine, EvalAltResult};
use rhai::packages::Package;
use rhai_url::UrlPackage;
use url::Url;
fn main() -> Result<(), Box<EvalAltResult>> {
// Create Rhai scripting engine
let mut engine = Engine::new();
// Create url package and add the package into the engine
let package = UrlPackage::new();
package.register_into_engine(&mut engine);
// Print the url
let url = engine.eval::<Url>(r#"Url("http://test.dev/")"#)?;
println!("{}", url);
// Print the url string, equivalent of to_string()
let href = engine.eval::<String>(r#"Url("http://test.dev/").href"#)?;
println!("{}", href);
Ok(())
}
Features
Feature | Default | Description |
---|---|---|
array |
enabled | Enables support for Rhai Array |
metadata |
disabled | Enables support for generating package documentation |
Dependencies
~5–6.5MB
~133K SLoC