crates.io Build Status

robots_txt is a lightweight robots.txt parser and generator written in Rust.

Nothing extra.

Unstable

The implementation is WIP.

Installation

Robots_txt is available on crates.io and can be included in your Cargo enabled project like this:

Cargo.toml: toml [dependencies] robots_txt = "0.3"

main.rs: ```rust extern crate robots_txt;

use robots_txt::Robots;

static ROBOTS: &'static str = r#"

robots.txt for http://www.site.com

User-Agent: * Disallow: /cyberworld/map/ # this is an infinite virtual URL space

Cybermapper knows where to go

User-Agent: cybermapper Disallow: "#;

fn main() { let robots = Robots::from_str(ROBOTS);

let matcher = SimpleMatcher::new(&robots.choose_section("AnyBot").rules);
assert!(matcher.check_path("/some/page"));
assert!(matcher.check_path("/cyberworld/welcome.html"));
assert!(!matcher.check_path("/cyberworld/map/object.html"));

let matcher = SimpleMatcher::new(&robots.choose_section("Mozilla/5.0; CyberMapper v. 3.14").rules);
assert!(matcher.check_path("/some/page"));
assert!(matcher.check_path("/cyberworld/welcome.html"));
assert!(matcher.check_path("/cyberworld/map/object.html"));

} ```

Alternatives

License

Licensed under either of * Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) * MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.