devops-events-local 0.0.1b4163__py3-none-any.whl

devops_events_local/src/constants_src_devops_events_local.py

@@ -0,0 +1,18 @@
+from logger_local.LoggerComponentEnum import LoggerComponentEnum
+
+
+class ConstantsSrcDevopsEventsLocal:
+    """The constants of devops-events-local"""
+
+    # TODO you can check component_table or for any #request-to-open-component-id request.
+    #  generic-webhook to call components-local to get the CODE and TEST componets ids
+    DEVOPS_EVENTS_LOCAL_PYTHON_CODE_COMPONENT_ID: int = 0
+    DEVOPS_EVENTS_LOCAL_PYTHON_CODE_COMPONENT_NAME = "devops-events-local-python-package"
+    DEVOPS_EVENTS_LOCAL_PYTHON_CODE_DEVELOPER_EMAIL_ADDRESS = "yuval.r@circ.zone"
+
+    DEVOPS_EVENTS_LOCAL_PYTHON_CODE_LOGGER_OBJECT = {
+        'component_id': DEVOPS_EVENTS_LOCAL_PYTHON_CODE_COMPONENT_ID,
+        'component_name': DEVOPS_EVENTS_LOCAL_PYTHON_CODE_COMPONENT_NAME,
+        'component_category': LoggerComponentEnum.ComponentCategory.Code.value,
+        'developer_email_address': DEVOPS_EVENTS_LOCAL_PYTHON_CODE_DEVELOPER_EMAIL_ADDRESS
+    }

devops_events_local/src/handle_request_to_open_a_jira_work_item.py

@@ -0,0 +1,46 @@
+import re
+from typing import Any
+
+from logger_local.LoggerLocal import Logger
+
+from .constants_src_devops_events_local import ConstantsSrcDevopsEventsLocal
+from .handle_slack_request import HandleSlackRequest
+
+logger = Logger.create_logger(object=ConstantsSrcDevopsEventsLocal.DEVOPS_EVENTS_LOCAL_PYTHON_CODE_LOGGER_OBJECT)
+
+LABEL_TO_FIELD = {"summary": "summary", "description": "description", "reponame": "repo_name",
+                  "components": "components", "component": "components"}
+MANDATORY_FIELD_LABELS = {"summary": "Summary", "description": "Description", "repo_name": "RepoName"}
+
+# Slack wraps text in *bold*, _italic_, `code`, ```blocks``` and > quotes; allow them around the labels.
+FORMATTING = r"[ \t>*_`]*"
+TRAILING_FORMATTING = r"[ \t*_`]*"
+LABEL = r"(?:summary|description|repo[ _]?name|components?)"
+FIELD_PATTERN = re.compile(
+    rf"^{FORMATTING}(?P<label>{LABEL}){TRAILING_FORMATTING}:{TRAILING_FORMATTING}(?P<value>.*?){TRAILING_FORMATTING}"
+    rf"(?=\n{FORMATTING}{LABEL}{TRAILING_FORMATTING}:|\Z)",
+    re.IGNORECASE | re.MULTILINE | re.DOTALL)
+
+
+class RequestToOpenAJiraWorkItemParseException(ValueError):
+    pass
+
+
+# TODO What if the request arrives in email/Telegram/REST-API ...?
+class HandleRequestToOpenAJiraWorkItem(HandleSlackRequest):
+    field_pattern = FIELD_PATTERN
+
+    def parse(self, text: str) -> dict[str, Any]:
+        """Split a #request-to-open-a-jira-issue Slack message into the fields jira_local expects:
+        summary, description, repo_name and components (list, may be empty)."""
+        fields: dict[str, Any] = {}
+        for match in self.field_pattern.finditer(self.clean_slack_text(text or "")):
+            field = LABEL_TO_FIELD[re.sub(r"[ _]", "", match.group("label").lower())]
+            fields.setdefault(field, match.group("value").strip())
+        missing_labels = [label for field, label in MANDATORY_FIELD_LABELS.items() if not fields.get(field)]
+        if missing_labels:
+            logger.warning(f"Request without {', '.join(missing_labels)}")
+            raise RequestToOpenAJiraWorkItemParseException(f"Missing {', '.join(missing_labels)}")
+        fields["components"] = [component.strip() for component in fields.get("components", "").split(",")
+                                if component.strip()]
+        return fields

devops_events_local/src/handle_slack_request.py

@@ -0,0 +1,30 @@
+import html
+import re
+from abc import ABC, abstractmethod
+from typing import Any
+
+# <https://url|label> -> label, <https://url> -> https://url (user/channel mentions <@U1>/<#C1> are kept)
+SLACK_LINK_PATTERN = re.compile(r"<((?:https?|mailto):[^|>]+)(?:\|([^>]+))?>")
+
+
+class HandleSlackRequest(ABC):
+    """A request posted in a Slack request channel, e.g. #request-to-open-a-jira-issue.
+    Each request type gives the pattern of its "Label: value" fields and parses them."""
+
+    field_pattern: re.Pattern
+
+    @staticmethod
+    def clean_slack_text(text: str) -> str:
+        text_without_links = SLACK_LINK_PATTERN.sub(lambda match: match.group(2) or match.group(1), text)
+        clean_text = html.unescape(text_without_links).replace("\r\n", "\n")
+        return clean_text
+
+    def has_request_fields(self, text: str) -> bool:
+        """True when the text has at least one field label (e.g. "Summary:"),
+        i.e. it is a request and not a chat reply."""
+        has_fields = self.field_pattern.search(self.clean_slack_text(text or "")) is not None
+        return has_fields
+
+    @abstractmethod
+    def parse(self, text: str) -> dict[str, Any]:
+        """The fields of the request, by their names in the target system"""

devops_events_local/src/version.py

@@ -0,0 +1,2 @@
+# Can _version.py created by git tag and pyproject.toml be used instead?
+PACKAGE_VERSION = "0.0.0"

devops_events_local-0.0.1b4163.dist-info/METADATA

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: devops-events-local
+Version: 0.0.1b4163
+Summary: PyPI devops-events-local Python Package owned by Circlez.ai
+Home-page: https://github.com/circles-zone/devops-events-local-python-package
+Author: Circles
+Author-email: info@circlez.ai
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+Requires-Dist: python-sdk-remote
+Requires-Dist: logger-local
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: summary
+
+PyPI devops-events-local Python Package owned by Circlez.ai  
+GHA: https://github.com/circles-zone/devops-events-local-python-package/actions

devops_events_local-0.0.1b4163.dist-info/RECORD

@@ -0,0 +1,10 @@
+devops_events_local/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devops_events_local/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+devops_events_local/src/constants_src_devops_events_local.py,sha256=dfU7lKciqZwsbIb16d-uPh2AV3hp1xaoASb3DCwyf1Q,936
+devops_events_local/src/handle_request_to_open_a_jira_work_item.py,sha256=3drFGD1FOUP5YeBd0bvD7dW0zJ_43-RzMpWBK9AeI6k,2308
+devops_events_local/src/handle_slack_request.py,sha256=qidXyw8d2npRYkIrtR8Eo_cTz_hfGvLegrPb3BDSgbs,1234
+devops_events_local/src/version.py,sha256=zJxrMPsUnBUY2lnD3AQv6itQvLgWWewqoE2P42Au80w,99
+devops_events_local-0.0.1b4163.dist-info/METADATA,sha256=LrTwIFWxcrqusuSC5D0a7jsQ81OHsT_moiPWOeLf0Rg,772
+devops_events_local-0.0.1b4163.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+devops_events_local-0.0.1b4163.dist-info/top_level.txt,sha256=HEeKOc6_g-BHAsRM12SX8xmw_79pNxrUDycysWWE2SI,20
+devops_events_local-0.0.1b4163.dist-info/RECORD,,

devops_events_local-0.0.1b4163.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

devops_events_local-0.0.1b4163.dist-info/top_level.txt

@@ -0,0 +1 @@
+devops_events_local