chore(config): add reference config auditing

README.md

@@ -6,7 +6,7 @@ The Rust web accessibility engine.
 
 ```toml
 [dependencies]
-accessibility-rs = "^0.0.64"
+accessibility-rs = "^0.1.0"
 ```
 
 ```rs
@@ -32,7 +32,7 @@ With the Tokio runtime.
 
 ```toml
 [dependencies]
-accessibility-rs = { version = "^0.0.64", features = ["tokio"]}
+accessibility-rs = { version = "^0.1.0", features = ["tokio"]}
 ```
 
 ```rs
@@ -60,7 +60,7 @@ With the Spider full website crawling.
 
 ```toml
 [dependencies]
-accessibility-rs = { version = "^0.0.64", features = ["spider"]}
+accessibility-rs = { version = "^0.1.0", features = ["spider"]}
 ```
 
 ```rs
@@ -87,6 +87,7 @@ async fn main() {
 1. i18n support for multiple languages.
 1. Re-creating layout tree to get element position coordinates.
 1. Crawling full websites lightning-fast using [spider](https://github.com/spider-rs/spider).
+1. Low-level built to be used as an engine in browsers.
 
 ## [Benchmarks](./benches/)
 

accessibility-rs/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "accessibility-rs"
-version = "0.0.64"
+version = "0.1.0"
 authors = ["The A11yWatch Project Developers", "Jeff Mendez <[email protected]>"]
 edition = "2021"
 license = "MIT OR Apache-2.0"

accessibility-rs/src/integration_test.rs

@@ -6,7 +6,7 @@ use mocks::mock;
 
 #[test]
 fn _audit() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_WEBSITE_HTML,
         &mock::MOCK_CSS_RULES,
         false,
@@ -17,7 +17,7 @@ fn _audit() {
 
 #[test]
 fn _audit_large() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_HTML_LARGE_PAGE,
         &mock::MOCK_CSS_RULES_LARGE,
         false,
@@ -28,7 +28,7 @@ fn _audit_large() {
 
 #[test]
 fn _audit_bounded() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_WEBSITE_HTML,
         &mock::MOCK_CSS_RULES,
         true,
@@ -39,7 +39,7 @@ fn _audit_bounded() {
 
 #[test]
 fn _audit_large_bounded() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_HTML_LARGE_PAGE,
         &mock::MOCK_CSS_RULES_LARGE,
         true,

accessibility-rs/src/lib.rs

@@ -253,7 +253,7 @@ pub async fn audit(config: AuditConfig) -> AuditResults {
 
 /// audit a web page passing the html and css rules.
 #[cfg(not(feature = "tokio"))]
-pub fn audit(config: AuditConfig) -> Vec<Issue> {
+pub fn audit(config: &AuditConfig) -> Vec<Issue> {
     let document = accessibility_scraper::Html::parse_document(&config.html);
     let auditor = Auditor::new(&document, &config.css, config.bounding_box, &config.locale);
     engine::audit::wcag::WCAGAAA::audit(auditor)

accessibility-rs/tests/integration_test.rs

@@ -7,7 +7,7 @@ use mocks::mock;
 #[cfg(feature = "tokio")]
 #[tokio::test]
 async fn _audit() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_WEBSITE_HTML,
         &mock::MOCK_CSS_RULES,
         false,
@@ -20,7 +20,7 @@ async fn _audit() {
 #[test]
 #[cfg(not(feature = "tokio"))]
 fn _audit() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_WEBSITE_HTML,
         &mock::MOCK_CSS_RULES,
         false,
@@ -32,7 +32,7 @@ fn _audit() {
 #[test]
 #[cfg(not(feature = "tokio"))]
 fn _audit_large() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_HTML_LARGE_PAGE,
         &mock::MOCK_CSS_RULES_LARGE,
         false,
@@ -44,7 +44,7 @@ fn _audit_large() {
 #[test]
 #[cfg(not(feature = "tokio"))]
 fn _audit_with_layout() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_WEBSITE_HTML,
         &mock::MOCK_CSS_RULES,
         true,
@@ -56,7 +56,7 @@ fn _audit_with_layout() {
 #[test]
 #[cfg(not(feature = "tokio"))]
 fn _audit_large_with_layout() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_HTML_LARGE_PAGE,
         &mock::MOCK_CSS_RULES_LARGE,
         true,
@@ -68,7 +68,7 @@ fn _audit_large_with_layout() {
 #[test]
 #[cfg(not(feature = "tokio"))]
 fn _audit_xlarge() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_WEBSITE_XLARGE_HTML,
         &mock::MOCK_CSS_RULES_XLARGE,
         false,
@@ -80,7 +80,7 @@ fn _audit_xlarge() {
 #[tokio::test]
 #[cfg(feature = "tokio")]
 async fn _audit_xlarge() {
-    let report = accessibility_rs::audit(AuditConfig::new(
+    let report = accessibility_rs::audit(&AuditConfig::new(
         mock::MOCK_WEBSITE_XLARGE_HTML,
         &mock::MOCK_CSS_RULES_XLARGE,
         false,
@@ -94,6 +94,6 @@ async fn _audit_xlarge() {
 #[tokio::test]
 async fn _audit_website() {
     let audit_config = AuditConfig::new_website("https://choosealicense.com", "", false, "");
-    let report = accessibility_rs::audit(audit_config).await;
+    let report = accessibility_rs::audit(&audit_config).await;
     println!("{:?}", report)
 }

accessibility-rs/tests/unit/anchor.rs

@@ -7,7 +7,7 @@ use maud::html;
 #[cfg(not(feature = "tokio"))]
 /// anchor contains single img element without alt
 fn _audit_missing_alt_anchor_img() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
     <head>     
        <title>Decrative Img: Do not use!</title>
@@ -33,7 +33,7 @@ fn _audit_missing_anchor_content_valid_href() {
     let markup = html! {
         a href="www.example.com";
     };
-    let audit = accessibility_rs::audit(AuditConfig::basic(&markup.into_string()));
+    let audit = accessibility_rs::audit(&AuditConfig::basic(&markup.into_string()));
     let valid = !audit
         .iter()
         .any(|x| x.code == "WCAGAAA.Principle4.Guideline4_1.H91");
@@ -48,7 +48,7 @@ fn _audit_missing_anchor_content() {
     let markup = html! {
         a { "" }
     };
-    let audit = accessibility_rs::audit(AuditConfig::basic(&markup.into_string()));
+    let audit = accessibility_rs::audit(&AuditConfig::basic(&markup.into_string()));
     let valid = !audit
         .iter()
         .any(|x| x.code == "WCAGAAA.Principle4.Guideline4_1.H91");
@@ -60,7 +60,7 @@ fn _audit_missing_anchor_content() {
 #[cfg(not(feature = "tokio"))]
 /// anchor text matches img alt
 fn _audit_img_alt_matches_text_anchor() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
     <head>     
        <title>Decrative Img: Do not use!</title>

accessibility-rs/tests/unit/applet.rs

@@ -6,7 +6,7 @@ use accessibility_rs::AuditConfig;
 #[cfg(not(feature = "tokio"))]
 /// missing applet alt
 fn _audit_missing_applet_alt() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html lang="en">
        <head>     
           <title>Missing applet alt: Do not use this!</title>
@@ -34,7 +34,7 @@ fn _audit_missing_applet_alt() {
 #[cfg(not(feature = "tokio"))]
 /// missing applet body
 fn _audit_missing_applet_body() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html lang="en">
        <head>     
           <title>Missing applet alt: Do not use this!</title>

accessibility-rs/tests/unit/area.rs

@@ -14,7 +14,7 @@ fn _audit_missing_alt_area() {
       <area shape="circle" coords="337,300,44" alt="Cup of coffee" href="coffee.htm">
     </map>"#;
     let audit: Vec<accessibility_rs::engine::issue::Issue> =
-        accessibility_rs::audit(AuditConfig::basic(html));
+        accessibility_rs::audit(&AuditConfig::basic(html));
 
     let valid = audit
         .iter()
@@ -35,7 +35,7 @@ fn _audit_missing_alt_map() {
       <area shape="circle" coords="337,300,44" alt="Cup of coffee" href="coffee.htm">
     </map>"#;
     let audit: Vec<accessibility_rs::engine::issue::Issue> =
-        accessibility_rs::audit(AuditConfig::basic(html));
+        accessibility_rs::audit(&AuditConfig::basic(html));
 
     let valid = audit.iter().any(|x| x.message == "1_1_1_H24.ImageMapNoAlt");
 

accessibility-rs/tests/unit/contrast.rs

@@ -12,7 +12,7 @@ fn _audit_contrast_text_anchor() {
             a href="www.example.com" style="color:blue;" { "example" };
         }
     };
-    let audit = accessibility_rs::audit(AuditConfig::basic(&markup.into_string()));
+    let audit = accessibility_rs::audit(&AuditConfig::basic(&markup.into_string()));
 
     let valid = !audit
         .iter()

accessibility-rs/tests/unit/fieldset.rs

@@ -15,7 +15,7 @@ fn _audit_missing_fieldset_legend() {
         }
     };
 
-    let audit = accessibility_rs::audit(AuditConfig::basic(&m.into_string()));
+    let audit = accessibility_rs::audit(&AuditConfig::basic(&m.into_string()));
 
     let valid = !audit
         .iter()

accessibility-rs/tests/unit/heading.rs

@@ -6,7 +6,7 @@ use accessibility_rs::AuditConfig;
 #[cfg(not(feature = "tokio"))]
 /// empty headings
 fn _audit_headings_empty() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
     <head>     
        <title>Valid headings</title>
@@ -48,7 +48,7 @@ fn _audit_headings_empty() {
 
     assert_eq!(valid, true);
 
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
     <head>     
        <title>Do not use missing Headings conent.</title>

accessibility-rs/tests/unit/img.rs

@@ -5,7 +5,7 @@ use accessibility_rs::AuditConfig;
 #[cfg(not(feature = "tokio"))]
 /// img is missing an alt
 fn _audit_img_missing_alt() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
     <head>     
        <title>Missing Alt: Do not Use.</title>
@@ -31,7 +31,7 @@ fn _audit_img_missing_alt() {
 #[cfg(not(feature = "tokio"))]
 /// img is missing an alt
 fn _audit_form_submit_img_missing_alt() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
     <head>     
        <title>Missing Alt: Do not Use.</title>
@@ -60,7 +60,7 @@ fn _audit_form_submit_img_missing_alt() {
 #[cfg(not(feature = "tokio"))]
 /// img has empty alt and title
 fn _audit_form_submit_img_has_alt_and_title() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
     <head>     
        <title>Contains Title with Alt: Do not Use.</title>

accessibility-rs/tests/unit/input.rs

@@ -5,7 +5,7 @@ use accessibility_rs::AuditConfig;
 #[cfg(not(feature = "tokio"))]
 /// input is missing a valid name
 fn _audit_input_valid_name() {
-    let audit = accessibility_rs::audit(AuditConfig::basic(
+    let audit = accessibility_rs::audit(&AuditConfig::basic(
         r###"<html lang="en">
     <head>     
        <title>Missing Form control name: Do not Use.</title>

accessibility-rs/tests/unit/label.rs

@@ -12,7 +12,7 @@ fn _audit_label_valid_name() {
         label for="accessibility" { "My label" }
     };
 
-    let audit = accessibility_rs::audit(AuditConfig::basic(&markup.into_string()));
+    let audit = accessibility_rs::audit(&AuditConfig::basic(&markup.into_string()));
 
     let valid = !audit
         .iter()
@@ -30,7 +30,7 @@ fn _audit_label_id_noexist() {
         input type="text" placeholder="Accessibility rocks!" value="Here";
     };
 
-    let audit = accessibility_rs::audit(AuditConfig::basic(&markup.into_string()));
+    let audit = accessibility_rs::audit(&AuditConfig::basic(&markup.into_string()));
 
     let valid = !audit
         .iter()