webcode-tk 0.7.4__tar.gz → 0.7.6__tar.gz

{webcode_tk-0.7.4 → webcode_tk-0.7.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webcode-tk
-Version: 0.7.4
+Version: 0.7.6
 Summary: 
 Home-page: https://github.com/HundredVisionsGuy/webcode-tk
 License: MIT

{webcode_tk-0.7.4 → webcode_tk-0.7.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "webcode-tk"
-version = "0.7.4"
+version = "0.7.6"
 description = ""
 authors = ["hundredvisionsguy <cwinikka@gmail.com>"]
 keywords = ["html", "validation", "css", ]

{webcode_tk-0.7.4 → webcode_tk-0.7.6}/webcode_tk/__init__.py

@@ -15,4 +15,4 @@ Modules exported by this package:
 - `validator_tools`: sends HTML or CSS code to the W3C Validator to check
           for errors.
 """
-__version__ = "0.7.4"
+__version__ = "0.7.6"

{webcode_tk-0.7.4 → webcode_tk-0.7.6}/webcode_tk/css_tools.py

@@ -25,6 +25,7 @@ regex_patterns: dict = {
     "adjacent_sibling_combinator": r"\w+\s*\+\s*\w+",
     "general_sibling_combinator": r"\w+\s*~\s*\w+",
     "grouped_selector": r"\w+\s*,\s*\w+",
+    "advanced_link_selector": r"(a[:.#\[]\w+)",
 }
 
 # all relevant at-rules.
@@ -97,6 +98,7 @@ class Stylesheet:
         self.repeated_selectors = []
         self.__minify()
         self.__replace_variables()
+        self.__replace_variables()
         self.__remove_external_imports()
         self.__extract_comments()
         self.__extract_nested_at_rules()
@@ -1295,7 +1297,12 @@ def get_color_codes_of_type(color_type: str, gradient: str) -> list:
 
 
 def is_required_selector(selector_type: str, selector: str) -> bool:
-    """checks selector to see if it's required type or not
+    """checks selector to see if it's required type or not.
+
+    Example: you may wish to loop through selectors and see which
+    ones are class selectors, or id selectors, etc..
+
+    It makes use of the list of regex_patterns for selector type.
 
     Args:
         selector_type: the type of selector in question, such as
@@ -1817,6 +1824,227 @@ def get_project_color_contrast(
     return results
 
 
+def file_applies_property_by_selector(
+    file_path: str, selector: str, property: str
+) -> bool:
+    """determines whether a specific property is applied to selector or not.
+
+    Args:
+        file_path: path to html doc in question.
+        selector: CSS selector (or element) that the property is applied.
+        property: the CSS property we are looking for.
+
+    Returns:
+        applies_property: whether that selector applies the property or not.
+    """
+    applies_property = False
+    style_sheets = get_all_stylesheets_by_file(file_path)
+
+    # look for the selector get all declaration block
+    declarations = []
+    for sheet in style_sheets:
+        declaration_block = get_declaration_block_from_selector(
+            selector, sheet
+        )
+        if declaration_block:
+            declarations.append(declaration_block)
+    combined_declaration_block = "\n".join(declarations)
+    if combined_declaration_block:
+        # check for property in declaration_block
+        declarations = combined_declaration_block.split(";")
+        for declaration in declarations:
+            try:
+                prop, value = declaration.split(":")
+                if property in prop:
+                    applies_property = True
+                    break
+            except ValueError:
+                print("Declaration is missing a colon!")
+    return applies_property
+
+
+def get_declaration_block_from_selector(
+    selector: str, style_sheet: Stylesheet
+) -> str:
+    declaration_block = ""
+    for ruleset in style_sheet.rulesets:
+        cur_selector = ruleset.selector
+        if selector in cur_selector:
+            # Check for grouped selectors
+            grouped_selectors = cur_selector.split(",")
+            if len(grouped_selectors) > 1:
+                for item in grouped_selectors:
+                    if selector in item:
+                        if " " not in item:
+                            declaration_block += ruleset.declaration_block.text
+                            break
+                        elif is_selector_at_end_of_descendant(selector, item):
+                            declaration_block += ruleset.declaration_block.text
+                            break
+
+            # Check for descendant selectors
+            if " " in cur_selector:
+                # we have a descendant selector
+                if is_selector_at_end_of_descendant(selector, cur_selector):
+                    declaration_block += ruleset.declaration_block.text
+                continue
+            declaration_block += ruleset.declaration_block.text + "\n"
+    return declaration_block
+
+
+def is_selector_at_end_of_descendant(selector: str, cur_selector: str) -> bool:
+    """returns whether a selector is at the end of a descendant selector"""
+    selector_at_end_of_descendant = False
+    selectors = cur_selector.split()
+    if selector in selectors[-1]:
+        # selector must be at the end of descendant selector
+        # or it doesn't count
+        selector_at_end_of_descendant = True
+    return selector_at_end_of_descendant
+
+
+def get_declaration_value_by_property(
+    block: Union[str, DeclarationBlock], property: str
+) -> str:
+    """returns the value of a property from a declaration block
+
+    Args:
+        block: the declaration block in question (could be as a string
+            or as a DeclarationBlock)
+        property: the property we are looking for
+
+    Returns:
+        value: the value of the property"""
+    value = ""
+    try:
+        block = block.text
+    except AttributeError:
+        declarations = block.strip()
+    declarations = block.split(";")
+    for item in declarations:
+        item = item.strip()
+        try:
+            # check for @media rules
+            if "{" in item:
+                item_split = item.split("{")
+                item = item_split[1].strip()
+            prop, val = item.split(":")
+            if prop.lower().strip() == property.lower():
+                value = val.strip()
+                continue
+        except ValueError:
+            print("Doh! no colon")
+    return value
+
+
+def has_link_selector(sheet: Stylesheet) -> bool:
+    """returns whether any style in a stylesheet targets a hyperlink
+
+    There could be one or more link selectors. This will check each possible
+    link selector (or psuedoselector). It only has to target a link and not
+    a descendant of a link.
+
+    Args:
+        sheet: the stylesheet object.
+
+    Returns:
+        has_selector: whether there is a selector that targets a link"""
+    has_selector = False
+    all_selectors = sheet.selectors
+    for selector in all_selectors:
+        selector_copy = selector
+        if " " in selector:
+            # we need to add a space at the end for the split to work
+            selector = selector.strip() + " "
+            selector_split = selector.split()
+            selector_copy = selector_split[-1]
+        if selector_copy == "a":
+            has_selector = True
+            break
+        # Check selector_copy to see if it's an anchor
+        regex_pattern = regex_patterns.get("advanced_link_selector")
+        selector_match = re.search(regex_pattern, selector_copy)
+        if selector_match:
+            has_selector = True
+            break
+    return has_selector
+
+
+def get_all_link_selectors(sheet: Stylesheet) -> list:
+    """returns all selectors that target a link
+
+    Args:
+        sheet: the stylesheet object.
+
+    Returns:
+        selectors: a list of all selectors that target a link"""
+    selectors = []
+    all_selectors = sheet.selectors
+    for selector in all_selectors:
+        selector_match = is_link_selector(selector)
+        if selector_match:
+            selectors.append(selector.strip())
+    return selectors
+
+
+def is_link_selector(selector):
+    selector_copy = selector
+    if " " in selector:
+        # we need to add a space at the end for the split to work
+        selector = selector.strip() + " "
+        selector_split = selector.split()
+        selector_copy = selector_split[-1]
+    if selector_copy == "a":
+        return True
+        # Check selector_copy to see if it's an anchor
+    regex_pattern = regex_patterns.get("advanced_link_selector")
+    selector_match = re.search(regex_pattern, selector_copy)
+    return selector_match
+
+
+def get_all_link_rules(sheet: Stylesheet) -> list:
+    """returns all rules that target a hyperlink
+
+    returns all rules that target a link
+
+    Args:
+        sheet: the stylesheet object.
+
+    Returns:
+        rules: a list of all rules that target a link"""
+    rules = []
+    link_selectors = get_all_link_selectors(sheet)
+    all_rulesets = sheet.rulesets
+    for rule in all_rulesets:
+        current_selector = rule.selector
+        if current_selector in link_selectors:
+            rules.append(rule)
+    return rules
+
+
+def get_link_color_data(project_path: str) -> list:
+    """returns all colors applied to links.
+
+    Identifies all selectors that target a link, and gets a
+    list of dictionaries that identify colors.
+
+    Args:
+        project_path: path to project folder
+
+    Returns:
+        link_styles: a list of link color data applied to each
+            file that includes a link color data"""
+    link_styles = []
+    color_contrast_data = get_project_color_contrast(project_path)
+    for item in color_contrast_data:
+        selector = item[1]
+        if not is_link_selector(selector):
+            continue
+        # it must be a link selector, let's get our data
+        link_styles.append(item)
+    return link_styles
+
+
 if __name__ == "__main__":
     insane_gradient = """
     -moz-radial-gradient(0% 200%, ellipse cover,