webcode-tk 1.2.6__tar.gz → 1.2.7__tar.gz

{webcode_tk-1.2.6 → webcode_tk-1.2.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: webcode-tk
-Version: 1.2.6
-Summary: 
+Version: 1.2.7
+Summary: A set of tools for inspecting HTML and CSS code
 License: MIT
 License-File: LICENSE.rst
 Keywords: html,validation,css

{webcode_tk-1.2.6 → webcode_tk-1.2.7}/pyproject.toml

@@ -1,7 +1,7 @@
 [tool.poetry]
 name = "webcode-tk"
-version = "1.2.6"
-description = ""
+version = "1.2.7"
+description = "A set of tools for inspecting HTML and CSS code"
 authors = ["hundredvisionsguy <cwinikka@gmail.com>"]
 keywords = ["html", "validation", "css", ]
 license = "MIT"

{webcode_tk-1.2.6 → webcode_tk-1.2.7}/webcode_tk/__init__.py

@@ -16,6 +16,11 @@
 
 - **`color_tools`**: processes CSS color related properties and values.
 
+- **`contrast_tools`**: calculates contrast results taking into account how
+          the background is invisible, but still affects contrast on elements
+          even if those elements do not have a background color explicitly
+          applied. It also only checks elements with text in the innerHTML.
+
 - **`css_tools`**: creates Stylesheet objects that store CSS information.
 
 - **`font_tools`**: A collection of functions used to process font-related
@@ -35,4 +40,4 @@
 - **`validator_tools`**: sends HTML or CSS code to the W3C Validator to check
           for errors.
 """
-__version__ = "1.2.6"
+__version__ = "1.2.7"

{webcode_tk-1.2.6 → webcode_tk-1.2.7}/webcode_tk/contrast_tools.py

@@ -158,7 +158,8 @@ def generate_contrast_report(
             msg = f"{result}: in {current_file}, the {element} failed WCAG "
             msg += f"{wcag_level} contrast requirements (ratio: "
             msg += f"{actual_ratio}, required: {target_ratio})."
-            project_files[current_file].append(msg)
+            if msg not in project_files[current_file]:
+                project_files[current_file].append(msg)
 
     # Check for html docs with no fails.
     for file in project_files:
@@ -182,6 +183,7 @@ def generate_contrast_report(
                             msg = f"fail: in {file}, {error_msg.strip()}"
                     else:
                         msg = f"pass: {file} passes color contrast."
+
             report.append(msg)
     return report
 
@@ -402,6 +404,9 @@ def analyze_css(
     filename = html_doc["filename"]
     soup = html_doc["soup"]
 
+    # Check to see if background color was set globally
+    global_bg = detect_document_background(project_path, filename)
+
     # Check for CSS sources and create warnings if needed
     warnings = []
 
@@ -417,7 +422,7 @@ def analyze_css(
         )
 
     # Step 1: Apply default styles to all elements
-    default_styles = apply_browser_defaults(soup)
+    default_styles = apply_browser_defaults(soup, default_bg=global_bg)
 
     # Find CSS rules specific to this HTML document
     doc_css_rules = get_css_rules_for_document(filename, css_files)
@@ -468,6 +473,47 @@ def analyze_css(
     return doc_results
 
 
+def detect_document_background(project_path: str, filename: str) -> str:
+    """
+    Detect global background color from CSS rules for this document.
+
+    Args:
+        project_path: Path to project root
+        filename: Name of current HTML file
+
+    Returns:
+        str: Background color hex value, or DEFAULT_GLOBAL_BACKGROUND if
+            none found
+    """
+    # Get global colors for entire project
+    global_colors = css_tools.get_project_global_colors(project_path)
+
+    # Find entry for this specific HTML file
+    for file_path, color_data_list in global_colors.items():
+        # Match filename (handle both full path and just filename)
+        if filename in file_path:
+            # color_data_list is a list of dicts with global selector info
+            if isinstance(color_data_list, dict):
+                color_data_list = [
+                    color_data_list,
+                ]
+            for color_data in color_data_list:
+                # Look for body selector specifically
+                if color_data.get("selector") == "body":
+                    bg_color = color_data.get("background-color")
+                    if bg_color:
+                        return bg_color
+
+                # Also check for html or * selectors
+                if color_data.get("selector") in ["html", "*"]:
+                    bg_color = color_data.get("background-color")
+                    if bg_color:
+                        return bg_color
+
+    # No global background found, use default white
+    return DEFAULT_GLOBAL_BACKGROUND
+
+
 def has_any_css_sources(soup: BeautifulSoup) -> bool:
     """
     Check if HTML document has any CSS sources (external or internal).
@@ -495,7 +541,9 @@ def has_any_css_sources(soup: BeautifulSoup) -> bool:
     return False
 
 
-def apply_browser_defaults(soup: BeautifulSoup) -> dict:
+def apply_browser_defaults(
+    soup: BeautifulSoup, default_bg: str = DEFAULT_GLOBAL_BACKGROUND
+) -> dict:
     """
     Apply browser default styles to all elements with text content.
 
@@ -516,7 +564,7 @@ def apply_browser_defaults(soup: BeautifulSoup) -> dict:
                     "is_default": True,
                 },
                 "background-color": {
-                    "value": DEFAULT_GLOBAL_BACKGROUND,
+                    "value": default_bg,
                     "specificity": default_specificity,
                     "source": "default",
                     "is_default": True,
@@ -1627,4 +1675,7 @@ if __name__ == "__main__":
     project_path = "tests/test_files/large_project/"
     project_path = "tests/test_files/contrast_tool_test/"
     contrast_results = generate_contrast_report(project_path, "AAA")
+    project_path = "tests/test_files/contrast_tool_test/"
+    global_colors = css_tools.get_project_global_colors(project_path)
+    print(global_colors)
     print(contrast_results)

{webcode_tk-1.2.6 → webcode_tk-1.2.7}/webcode_tk/css_tools.py

@@ -2458,7 +2458,10 @@ def get_global_color_report(project_dir: str, level="aaa") -> list:
             if global_color_data:
                 for item in global_color_data:
                     file, result = get_color_data(filename, item, level)
-                    passes.append(f"pass: {file} {result}")
+                    if "fail" in result:
+                        passes.append(f"fail: {file} {result}")
+                    else:
+                        passes.append(f"pass: {file} {result}")
         if passes:
             details = ""
             for detail in passes:
@@ -2877,3 +2880,7 @@ if __name__ == "__main__":
     rulesets = get_element_rulesets(
         "tests/test_files/cascade_complexities", "figure"
     )
+    passing_global_colors = get_global_color_report(project_folder)
+    project_path = "tests/test_files/contrast_tool_test/"
+    global_colors = get_global_color_report(project_path)
+    print(global_colors)