devopsdriver 0.1.37__tar.gz → 0.1.39__tar.gz

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: devopsdriver
-Version: 0.1.37
+Version: 0.1.39
 Summary: DevOps tools
 Author-email: Marc Page <marcallenpage@gmail.com>
 License: This is free and unencumbered software released into the public domain.
@@ -51,9 +51,16 @@ Requires-Dist: keyring==25.0.0
 Requires-Dist: setuptools==69.0.2
 Requires-Dist: azure-devops==7.1.0b4
 Requires-Dist: Mako==1.3.2
+Provides-Extra: dev
+Requires-Dist: black>=24.3.0; extra == "dev"
+Requires-Dist: pylint>=3.1.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=8.1.1; extra == "test"
+Requires-Dist: coverage>=7.4.4; extra == "test"
+Provides-Extra: doc
 
 ![status sheild](https://img.shields.io/static/v1?label=status&message=beta&color=blue&style=plastic)
-[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.37&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.37/)
+[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.39&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.39/)
 [![GitHub](https://img.shields.io/github/license/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver?tab=Unlicense-1-ov-file#readme)
 [![GitHub contributors](https://img.shields.io/github/contributors/marcpage/devops-driver?style=flat)](https://github.com/marcpage/devops-driver/graphs/contributors)
 [![PR's Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](http://makeapullrequest.com)
@@ -84,7 +91,16 @@ OS:
 
 Devops-driver is a collection of tools to help streamline developer's experience and gain insights into various processes.
 
-## Access to secrets
+## Tools
+
+devopsdriver is a toolbox that helps to quickly put together reports. Some of the items in the toolbox are:
+
+- **Settings**: store data, constants, settings, keys, tokens, etc. both in and out of the repository
+- **send_email**: send emails over SMTP (including SSL), using `Settings` to store credentials
+- **Template**: Simplify generating reports using `.mako` templates
+- **Azure.workitem**: Search for and inspect Azure DevOps work items
+
+## Example use-case
 
 To allow seamless work in both pipelines as well as in the development environment, the `Settings` object gives you access to common settings among multiple scripts, secrets, and configuration constants in a way the helps keep secrets out of the repository but runs just as well in the pipeline as your machine.
 
@@ -101,7 +117,6 @@ secrets:
 ```
 
 This file is in a global place (location varies by OS) and stores information that you may not want in your repository or is specific to development. 
-The `secrets` are extra sensative and are stored in the OS keychain.
 
 | Platform | Global Directory       |
 |----------|------------------------|
@@ -109,26 +124,28 @@ The `secrets` are extra sensative and are stored in the OS keychain.
 | Linux    | ~/.devopsdriver/       |
 | macOS    | ~/Library/Preferences/ |
 
+The `secrets` are extra sensative and are stored in the OS keychain.
+
 ### Set secrets in the keychain
 ```bash
 $ python3 -m venv .venv
 $ source .venv/bin/activate
 $ pip install devopsdriver
-$ python -m devopsdriver.settings --secrets
+$ settings --secrets
 secret: smtp.password  key: smtp/password
 smtp.password (smtp/password): ****
 secret: azure.token  key: azure/token
 smtp.password (azure/token): ****
-$ python -m devopsdriver.settings --secrets
+$ settings --secrets
 secret: azure.token  key: azure/token
 	Value set
 secret: smtp.password  key: smtp/password
 	Value set
 $
 ```
-The first call to `devopsdriver.settings` will look for every secret and check if they are already set in the keychain.
+The first call to `settings` will look for every secret and check if they are already set in the keychain.
 For any secret that has not been set in the keychain, you will be prompted to enter the password to store.
-The second call to `devopsdriver.settings` will verify that all the values have been set in the keychain.
+The second call to `settings` will verify that all the values have been set in the keychain.
 
 ### devopsdriver.yml
 ```yaml
@@ -174,6 +191,8 @@ These are values that you want to use in your script but have them here for easy
 </ul>
 ```
 
+This file is the template for the email body.
+
 ### new_stories.py
 ```python
 from datetime import date, timedelta

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/README.md

@@ -1,5 +1,5 @@
 ![status sheild](https://img.shields.io/static/v1?label=status&message=beta&color=blue&style=plastic)
-[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.37&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.37/)
+[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.39&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.39/)
 [![GitHub](https://img.shields.io/github/license/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver?tab=Unlicense-1-ov-file#readme)
 [![GitHub contributors](https://img.shields.io/github/contributors/marcpage/devops-driver?style=flat)](https://github.com/marcpage/devops-driver/graphs/contributors)
 [![PR's Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](http://makeapullrequest.com)
@@ -30,7 +30,16 @@ OS:
 
 Devops-driver is a collection of tools to help streamline developer's experience and gain insights into various processes.
 
-## Access to secrets
+## Tools
+
+devopsdriver is a toolbox that helps to quickly put together reports. Some of the items in the toolbox are:
+
+- **Settings**: store data, constants, settings, keys, tokens, etc. both in and out of the repository
+- **send_email**: send emails over SMTP (including SSL), using `Settings` to store credentials
+- **Template**: Simplify generating reports using `.mako` templates
+- **Azure.workitem**: Search for and inspect Azure DevOps work items
+
+## Example use-case
 
 To allow seamless work in both pipelines as well as in the development environment, the `Settings` object gives you access to common settings among multiple scripts, secrets, and configuration constants in a way the helps keep secrets out of the repository but runs just as well in the pipeline as your machine.
 
@@ -47,7 +56,6 @@ secrets:
 ```
 
 This file is in a global place (location varies by OS) and stores information that you may not want in your repository or is specific to development. 
-The `secrets` are extra sensative and are stored in the OS keychain.
 
 | Platform | Global Directory       |
 |----------|------------------------|
@@ -55,26 +63,28 @@ The `secrets` are extra sensative and are stored in the OS keychain.
 | Linux    | ~/.devopsdriver/       |
 | macOS    | ~/Library/Preferences/ |
 
+The `secrets` are extra sensative and are stored in the OS keychain.
+
 ### Set secrets in the keychain
 ```bash
 $ python3 -m venv .venv
 $ source .venv/bin/activate
 $ pip install devopsdriver
-$ python -m devopsdriver.settings --secrets
+$ settings --secrets
 secret: smtp.password  key: smtp/password
 smtp.password (smtp/password): ****
 secret: azure.token  key: azure/token
 smtp.password (azure/token): ****
-$ python -m devopsdriver.settings --secrets
+$ settings --secrets
 secret: azure.token  key: azure/token
 	Value set
 secret: smtp.password  key: smtp/password
 	Value set
 $
 ```
-The first call to `devopsdriver.settings` will look for every secret and check if they are already set in the keychain.
+The first call to `settings` will look for every secret and check if they are already set in the keychain.
 For any secret that has not been set in the keychain, you will be prompted to enter the password to store.
-The second call to `devopsdriver.settings` will verify that all the values have been set in the keychain.
+The second call to `settings` will verify that all the values have been set in the keychain.
 
 ### devopsdriver.yml
 ```yaml
@@ -120,6 +130,8 @@ These are values that you want to use in your script but have them here for easy
 </ul>
 ```
 
+This file is the template for the email body.
+
 ### new_stories.py
 ```python
 from datetime import date, timedelta

devopsdriver-0.1.39/devopsdriver/__init__.py

@@ -0,0 +1,5 @@
+""" DevOps tools """
+
+__version__ = "0.1.39"
+__author__ = "Marc Page"
+__credits__ = ""

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/azdo/__init__.py

@@ -2,8 +2,9 @@
 
 # re export symbols for easier use
 from .clients import Azure
+from .timestamp import Timestamp
 
-from .workitem import WorkItem
+from .workitem.workitem import WorkItem
 from .workitem.wiql import Wiql, Value, Field
 from .workitem.wiql import Ascending, Descending, And, Or
 from .workitem.wiql import Equal, NotEqual, LessThanOrEqual, GreaterThanOrEqual

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/azdo/clients.py

@@ -7,12 +7,15 @@ API Documented here:
 https://github.com/microsoft/azure-devops-python-api
 """
 
+
 from azure.devops.connection import Connection as AzureConnection
 from msrest.authentication import BasicAuthentication as MSBasicAuthentication
 
 from devopsdriver.settings import Settings
 from devopsdriver.azdo.workitem.client import Client as WIClient
 
+
+# for testing
 CONNECTION = AzureConnection
 AUTHENTICATION = MSBasicAuthentication
 

devopsdriver-0.1.39/devopsdriver/azdo/timestamp.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+
+
+""" Tools that help when working with Azure """
+
+
+from datetime import datetime, timezone
+
+
+class Timestamp:
+    """An Azure timestamp"""
+
+    DATE_FORMAT = "%Y-%m-%dT%H:%M:%S"
+    US_PER_MS = 1000  # microseconds per millisecond
+    US_PER_SEC = 1000 * US_PER_MS  # microseconds per second
+
+    @staticmethod
+    def is_timestamp(value: any) -> bool:
+        """Determines if the value is a timestamp string
+
+        Args:
+            value (any): The value to check
+
+        Returns:
+            bool: True if the value is an Azure timestamp
+        """
+        if not isinstance(value, str):
+            return False
+
+        if not value.endswith("Z"):
+            return False
+
+        try:
+            Timestamp.__parse_string(value)
+            return True
+
+        except ValueError:
+            return False
+
+    def __init__(self, value: datetime | str | float | int):
+        if isinstance(value, datetime):
+            self.value = value
+
+        elif isinstance(value, str):
+            self.value = Timestamp.__parse_string(value)
+
+        elif isinstance(value, (int, float)):
+            self.value = datetime.fromtimestamp(value, tz=timezone.utc)
+
+    def __str__(self) -> str:
+        return self.to_string()
+
+    def to_string(self) -> str:
+        """Returns the Azure formatted timestamp
+
+        Returns:
+            str: The correctly formatted string
+        """
+        milliseconds = f"{self.value.microsecond / Timestamp.US_PER_MS:03.0f}".rstrip(
+            "0"
+        )
+        return f"{self.value.strftime(Timestamp.DATE_FORMAT)}.{milliseconds}Z"
+
+    def to_timestamp(self) -> float:
+        """Converts to a number to use with time.time()
+
+        Returns:
+            float: The number of seconds since the epoch
+        """
+        return datetime.timestamp(self.value)
+
+    @staticmethod
+    def __parse_string(timestamp: str) -> datetime:
+        assert timestamp.endswith("Z"), timestamp
+        whole, fractional = timestamp.rsplit(".", 1)
+        result = datetime.strptime(whole, Timestamp.DATE_FORMAT)
+        fractional_seconds = float(f"0.{fractional[:-1].ljust(3, '0')}")
+        return result.replace(
+            microsecond=int(fractional_seconds * Timestamp.US_PER_SEC)
+        ).replace(tzinfo=timezone.utc)

devopsdriver-0.1.39/devopsdriver/azdo/workitem/__init__.py

@@ -0,0 +1 @@
+""" init workitem module """

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/azdo/workitem/client.py

@@ -1,12 +1,14 @@
 #!/usr/bin/env python3
 
+
 """ Azure WorkItem Client """
 
+
 from azure.devops.v7_1.work_item_tracking.models import Wiql as AzureWiql
 from azure.devops.v7_1.work_item_tracking.models import WorkItem as AzureWorkItem
 from azure.devops.v7_1.work_item_tracking.models import TeamContext
 from azure.devops.v7_1.work_item_tracking.models import WorkItemQueryResult
-from devopsdriver.azdo.workitem import WorkItem
+from devopsdriver.azdo.workitem.workitem import WorkItem
 from devopsdriver.azdo.workitem.wiql import Wiql
 
 

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/azdo/workitem/wiql.py

@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 
+
 """ Builds a WIQL query
 https://learn.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax?view=azure-devops
 

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/azdo/workitem/workitem.py

@@ -1,10 +1,15 @@
 #!/usr/bin/env python3
 
+
 """ An Azure Devops WorkItem """
 
+
 from typing import Any
+
 from azure.devops.v7_1.work_item_tracking.models import WorkItem as AzureWorkItem
 
+from devopsdriver.azdo.timestamp import Timestamp
+
 
 class WorkItem:  # pylint: disable=too-few-public-methods
     """Azure WorkItem"""
@@ -43,11 +48,21 @@ class WorkItem:  # pylint: disable=too-few-public-methods
         if "fields" in data:
             return WorkItem._parse_field(name, data["fields"])
 
-        raise AttributeError(f"'WorkItem' object has no attribute '{name}'")
+        return None
 
     class _Dict(dict):
         def __getattr__(self, name: str) -> Any:
-            return WorkItem._parse_field(name, self)
+            value = WorkItem._parse_field(name, self)
+
+            if Timestamp.is_timestamp(value):
+                return Timestamp(value)
+
+            return value
 
     def __getattr__(self, name: str) -> Any:
-        return WorkItem._parse_field(name, self.raw.as_dict())
+        value = WorkItem._parse_field(name, self.raw.as_dict())
+
+        if Timestamp.is_timestamp(value):
+            return Timestamp(value)
+
+        return value

devopsdriver-0.1.39/devopsdriver/manage_settings.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+
+
+""" Module Doc """
+
+
+from os.path import dirname, join
+from sys import argv as sys_argv
+from getpass import getpass as os_getpass
+
+from keyring import set_password
+
+from .settings import Settings
+from .template import Template
+
+ARGV = sys_argv
+PRINT = print
+SET_PASSWORD = set_password
+GET_PASS = os_getpass
+
+
+def main() -> None:
+    """Get settings values"""
+    args = list(ARGV[1:])
+
+    if not args or "--help" in args or "-h" in args:
+        PRINT(
+            Template(
+                __file__, join(dirname(__file__), "templates"), extension=".txt.mako"
+            ).render()
+        )
+        return
+
+    settings = Settings(__file__, dirname(dirname(__file__))).key("secrets")
+
+    if "--secrets" in args:
+        args.remove("--secrets")
+
+        for secret, key in settings.secrets.items():
+            PRINT(f"secret: {secret}  key: {key}")
+
+            if not settings.has(secret):
+                value = GET_PASS(f"{secret} ({key}): ")
+
+                if value:
+                    SET_PASSWORD(*Settings.split_key(key), value)
+            else:
+                PRINT("\tValue set")
+
+    for arg in args:
+        PRINT(f"{settings.get(arg)}")
+
+
+if __name__ == "__main__":
+    main()

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/sendmail.py

@@ -1,6 +1,9 @@
 #!/usr/bin/env python3
 
+
 """ Ability to send emails with embedded images """
+
+
 from smtplib import SMTP as OS_SMTP, SMTP_SSL as OS_SMTP_SSL
 from email.mime.multipart import MIMEMultipart as OS_MIMEMultipart
 from email.mime.text import MIMEText as OS_MIMEText
@@ -8,6 +11,7 @@ from email.mime.image import MIMEImage as OS_MIMEImage
 
 from devopsdriver.settings import Settings
 
+
 IMAGE_HEADERS = {".png": b"\x89PNG\r\n\x1a\n", ".jpg": b"\xff\xd8\xff"}
 
 # for testing

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/settings.py

@@ -86,6 +86,8 @@ from getpass import getpass as os_getpass
 
 from yaml import safe_load
 from keyring import get_password, set_password
+from keyring.backends import fail
+
 
 # for testing
 ENVIRON = os_environ
@@ -266,7 +268,7 @@ class Settings:
         if key in self.secrets:
             value = GET_PASSWORD(*Settings.split_key(self.secrets[key]))
 
-            if value is not None:
+            if value is not None and not isinstance(value, fail.Keyring):
                 return True if check else value
 
         # Last check the files for settings
@@ -357,38 +359,3 @@ class Settings:
             Settings.__merge(settings, contents)
 
         return settings
-
-
-def main() -> None:
-    """Get settings values"""
-    args = list(ARGV[1:])
-
-    if not args or "--help" in args or "-h" in args:
-        PRINT("pass in settings to see if they are set and to what value")
-        PRINT("You can pass dotted names to get inner values, like smpt.server")
-        PRINT("You can pass --secrets to set keychain values that have not been set")
-        PRINT("You can also pass --help or -h to get this message")
-        return
-
-    settings = Settings(__file__, dirname(dirname(__file__))).key("secrets")
-
-    if "--secrets" in args:
-        args.remove("--secrets")
-
-        for secret, key in settings.secrets.items():
-            PRINT(f"secret: {secret}  key: {key}")
-
-            if not settings.has(secret):
-                value = GET_PASS(f"{secret} ({key}): ")
-
-                if value:
-                    SET_PASSWORD(*Settings.split_key(key), value)
-            else:
-                PRINT("\tValue set")
-
-    for arg in args:
-        PRINT(f"{settings.get(arg)}")
-
-
-if __name__ == "__main__":
-    main()

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver/template.py

@@ -1,7 +1,9 @@
 #!/usr/bin/env python3
 
+
 """ Module Doc """
 
+
 from os.path import dirname, basename, splitext
 
 from mako.lookup import TemplateLookup

devopsdriver-0.1.39/devopsdriver/templates/manage_settings.txt.mako

@@ -0,0 +1,14 @@
+Usage:
+
+  settings [-h | --help] 
+  settings --secrets
+  settings <value>...
+
+-h --help  Display this help information
+
+--secrets  Prompt for any secrets that have not been set in the keychain
+            For secrets that are set, confirms that the value is set
+
+<value>    A value to display the value for. For instance:
+                "smtp" will display all the smtp values (but not secrets in smtp, like password)
+                "smtp.server" will display just the smtp server

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: devopsdriver
-Version: 0.1.37
+Version: 0.1.39
 Summary: DevOps tools
 Author-email: Marc Page <marcallenpage@gmail.com>
 License: This is free and unencumbered software released into the public domain.
@@ -51,9 +51,16 @@ Requires-Dist: keyring==25.0.0
 Requires-Dist: setuptools==69.0.2
 Requires-Dist: azure-devops==7.1.0b4
 Requires-Dist: Mako==1.3.2
+Provides-Extra: dev
+Requires-Dist: black>=24.3.0; extra == "dev"
+Requires-Dist: pylint>=3.1.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=8.1.1; extra == "test"
+Requires-Dist: coverage>=7.4.4; extra == "test"
+Provides-Extra: doc
 
 ![status sheild](https://img.shields.io/static/v1?label=status&message=beta&color=blue&style=plastic)
-[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.37&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.37/)
+[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.39&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.39/)
 [![GitHub](https://img.shields.io/github/license/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver?tab=Unlicense-1-ov-file#readme)
 [![GitHub contributors](https://img.shields.io/github/contributors/marcpage/devops-driver?style=flat)](https://github.com/marcpage/devops-driver/graphs/contributors)
 [![PR's Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](http://makeapullrequest.com)
@@ -84,7 +91,16 @@ OS:
 
 Devops-driver is a collection of tools to help streamline developer's experience and gain insights into various processes.
 
-## Access to secrets
+## Tools
+
+devopsdriver is a toolbox that helps to quickly put together reports. Some of the items in the toolbox are:
+
+- **Settings**: store data, constants, settings, keys, tokens, etc. both in and out of the repository
+- **send_email**: send emails over SMTP (including SSL), using `Settings` to store credentials
+- **Template**: Simplify generating reports using `.mako` templates
+- **Azure.workitem**: Search for and inspect Azure DevOps work items
+
+## Example use-case
 
 To allow seamless work in both pipelines as well as in the development environment, the `Settings` object gives you access to common settings among multiple scripts, secrets, and configuration constants in a way the helps keep secrets out of the repository but runs just as well in the pipeline as your machine.
 
@@ -101,7 +117,6 @@ secrets:
 ```
 
 This file is in a global place (location varies by OS) and stores information that you may not want in your repository or is specific to development. 
-The `secrets` are extra sensative and are stored in the OS keychain.
 
 | Platform | Global Directory       |
 |----------|------------------------|
@@ -109,26 +124,28 @@ The `secrets` are extra sensative and are stored in the OS keychain.
 | Linux    | ~/.devopsdriver/       |
 | macOS    | ~/Library/Preferences/ |
 
+The `secrets` are extra sensative and are stored in the OS keychain.
+
 ### Set secrets in the keychain
 ```bash
 $ python3 -m venv .venv
 $ source .venv/bin/activate
 $ pip install devopsdriver
-$ python -m devopsdriver.settings --secrets
+$ settings --secrets
 secret: smtp.password  key: smtp/password
 smtp.password (smtp/password): ****
 secret: azure.token  key: azure/token
 smtp.password (azure/token): ****
-$ python -m devopsdriver.settings --secrets
+$ settings --secrets
 secret: azure.token  key: azure/token
 	Value set
 secret: smtp.password  key: smtp/password
 	Value set
 $
 ```
-The first call to `devopsdriver.settings` will look for every secret and check if they are already set in the keychain.
+The first call to `settings` will look for every secret and check if they are already set in the keychain.
 For any secret that has not been set in the keychain, you will be prompted to enter the password to store.
-The second call to `devopsdriver.settings` will verify that all the values have been set in the keychain.
+The second call to `settings` will verify that all the values have been set in the keychain.
 
 ### devopsdriver.yml
 ```yaml
@@ -174,6 +191,8 @@ These are values that you want to use in your script but have them here for easy
 </ul>
 ```
 
+This file is the template for the email body.
+
 ### new_stories.py
 ```python
 from datetime import date, timedelta

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver.egg-info/SOURCES.txt

@@ -2,24 +2,30 @@ LICENSE
 README.md
 pyproject.toml
 devopsdriver/__init__.py
+devopsdriver/manage_settings.py
 devopsdriver/sendmail.py
 devopsdriver/settings.py
 devopsdriver/template.py
 devopsdriver.egg-info/PKG-INFO
 devopsdriver.egg-info/SOURCES.txt
 devopsdriver.egg-info/dependency_links.txt
+devopsdriver.egg-info/entry_points.txt
 devopsdriver.egg-info/requires.txt
 devopsdriver.egg-info/top_level.txt
 devopsdriver/azdo/__init__.py
 devopsdriver/azdo/clients.py
+devopsdriver/azdo/timestamp.py
 devopsdriver/azdo/workitem/__init__.py
 devopsdriver/azdo/workitem/client.py
 devopsdriver/azdo/workitem/wiql.py
 devopsdriver/azdo/workitem/workitem.py
+devopsdriver/templates/manage_settings.txt.mako
 tests/test_azure_clients.py
+tests/test_azure_timestamp.py
 tests/test_azure_workitem.py
 tests/test_azure_workitem_client.py
 tests/test_azure_workitem_wiql.py
+tests/test_manage_settings.py
 tests/test_sendmail.py
 tests/test_settings.py
 tests/test_template.py

devopsdriver-0.1.39/devopsdriver.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+settings = devopsdriver.manage_settings:main

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/devopsdriver.egg-info/requires.txt

@@ -3,3 +3,13 @@ keyring==25.0.0
 setuptools==69.0.2
 azure-devops==7.1.0b4
 Mako==1.3.2
+
+[dev]
+black>=24.3.0
+pylint>=3.1.0
+
+[doc]
+
+[test]
+pytest>=8.1.1
+coverage>=7.4.4

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/pyproject.toml

@@ -28,6 +28,23 @@ authors = [
   {name = "Marc Page", email = "marcallenpage@gmail.com"},
 ]
 
+[project.scripts]
+settings = "devopsdriver.manage_settings:main"
+
+[tool.setuptools.package-data]
+"*" = ["*.mako"]
+
+[project.optional-dependencies]
+dev = [
+    "black>=24.3.0",
+    "pylint>=3.1.0",
+]
+test = [
+    "pytest>=8.1.1",
+    "coverage>=7.4.4",
+]
+doc = []
+
 [project.urls]
 Homepage = "https://github.com/marcpage/devops-driver"
 Documentation = "https://github.com/marcpage/devops-driver"

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/tests/test_azure_clients.py

@@ -10,7 +10,7 @@ from os.path import join
 
 from helpers import setup_settings, write
 
-from devopsdriver import Azure
+from devopsdriver.azdo import Azure
 from devopsdriver.azdo import clients
 
 

devopsdriver-0.1.39/tests/test_azure_timestamp.py

@@ -0,0 +1,247 @@
+#!/usr/bin/env python3
+
+""" Test Azure Timestamp """
+
+from devopsdriver.azdo import Timestamp
+
+TEST_TIMESTAMPS = [
+    "2023-11-16T03:24:40.36Z",
+    "2023-11-16T03:17:01.413Z",
+    "2023-11-16T05:09:11.62Z",
+    "2023-11-16T16:21:29.393Z",
+    "2023-11-16T16:21:48.88Z",
+    "2023-11-16T17:49:38.527Z",
+    "2023-11-16T22:47:07.257Z",
+    "2023-11-17T03:54:07.34Z",
+    "2023-11-18T22:31:38.557Z",
+    "2023-11-21T03:54:54.98Z",
+    "2023-11-21T17:12:58.44Z",
+    "2023-11-21T17:17:13.987Z",
+    "2023-11-21T17:35:06.58Z",
+    "2023-11-24T16:17:49.49Z",
+    "2023-11-24T16:18:09.48Z",
+    "2023-11-24T16:24:42.23Z",
+    "2023-11-24T19:00:29.217Z",
+    "2023-11-24T19:01:07.813Z",
+    "2023-11-29T03:18:24.333Z",
+    "2023-11-29T03:21:16.353Z",
+    "2023-11-29T03:21:20.96Z",
+    "2023-11-29T03:25:54.02Z",
+    "2023-11-29T03:28:59.403Z",
+    "2023-11-29T03:29:55.51Z",
+    "2023-11-29T03:44:19.653Z",
+    "2023-11-29T03:48:15.777Z",
+    "2023-11-29T15:49:26.967Z",
+    "2023-11-29T15:49:33.457Z",
+    "2023-11-29T15:54:59.17Z",
+    "2023-12-05T01:53:52.67Z",
+    "2023-12-05T01:54:03.417Z",
+    "2023-12-09T02:49:15.053Z",
+    "2023-12-09T02:53:44.95Z",
+    "2023-12-16T02:16:58.697Z",
+    "2024-01-15T15:10:41.83Z",
+    "2024-01-15T16:27:31.43Z",
+    "2024-01-15T19:16:11.38Z",
+    "2024-01-15T19:16:16.017Z",
+    "2024-01-16T21:21:48.23Z",
+    "2024-01-16T21:21:48.87Z",
+    "2024-01-16T21:21:54.127Z",
+    "2024-01-16T21:21:55.277Z",
+    "2024-01-16T21:21:57.223Z",
+    "2024-01-16T21:31:02.743Z",
+    "2024-02-01T15:12:12.277Z",
+    "2024-02-02T17:30:43.253Z",
+    "2024-02-02T17:31:18.313Z",
+    "2024-02-02T17:49:10.37Z",
+    "2024-02-02T17:51:32.537Z",
+    "2024-02-02T17:55:17.257Z",
+    "2024-02-05T03:13:24.16Z",
+    "2024-02-05T03:13:24.66Z",
+    "2024-02-05T03:15:24.9Z",
+    "2024-02-05T14:46:44.583Z",
+    "2024-02-05T14:47:54.803Z",
+    "2024-02-12T17:01:23.693Z",
+    "2024-02-12T17:04:20.5Z",
+    "2024-02-13T00:30:14.31Z",
+    "2024-02-13T00:55:01.35Z",
+    "2024-02-13T16:08:30.643Z",
+    "2024-02-13T16:46:34.79Z",
+    "2024-02-13T16:46:35.35Z",
+    "2024-02-15T20:41:26.767Z",
+    "2024-02-20T17:18:06.95Z",
+    "2024-02-20T17:18:07.49Z",
+    "2024-02-20T17:18:09.537Z",
+    "2024-02-21T15:11:34.86Z",
+    "2024-02-21T15:30:12.723Z",
+    "2024-02-21T15:30:28.887Z",
+    "2024-02-21T15:30:57.373Z",
+    "2024-02-21T15:36:03.137Z",
+    "2024-02-21T15:37:26.463Z",
+    "2024-02-21T16:53:53.29Z",
+    "2024-02-21T16:53:57.943Z",
+    "2024-02-21T17:55:39.323Z",
+    "2024-02-22T16:01:50.477Z",
+    "2024-02-22T16:02:19.69Z",
+    "2024-02-22T17:22:02.963Z",
+    "2024-02-22T17:22:05.7Z",
+    "2024-02-27T17:11:56.247Z",
+    "2024-03-03T21:11:41.707Z",
+    "2024-03-03T21:11:42.257Z",
+    "2024-03-03T21:17:57.317Z",
+    "2024-03-03T21:18:19.83Z",
+    "2024-03-03T21:19:16.68Z",
+    "2024-03-03T21:23:35.33Z",
+    "2024-03-08T20:26:21.927Z",
+    "2024-03-08T20:27:36.023Z",
+    "2024-03-08T21:46:49.617Z",
+    "2024-03-10T18:28:05.983Z",
+    "2024-03-10T20:18:28.353Z",
+    "2024-03-10T20:27:13.34Z",
+    "2024-03-10T20:28:19.893Z",
+    "2024-03-10T22:22:23.163Z",
+    "2024-03-11T00:00:10.72Z",
+    "2024-03-11T01:15:51.407Z",
+    "2024-03-11T01:15:57.817Z",
+    "2024-03-11T03:39:43.92Z",
+    "2024-03-11T15:46:50.733Z",
+    "2024-03-11T15:48:01.667Z",
+    "2024-03-11T15:58:51.747Z",
+    "2024-03-11T18:37:30.577Z",
+    "2024-03-11T18:50:51.663Z",
+    "2024-03-11T18:57:36.687Z",
+    "2024-03-11T19:14:03.663Z",
+    "2024-03-11T19:15:28.78Z",
+    "2024-03-11T22:52:00.85Z",
+    "2024-03-12T00:44:38.52Z",
+    "2024-03-12T00:45:25.517Z",
+    "2024-03-12T00:45:31.18Z",
+    "2024-03-12T00:46:11.873Z",
+    "2024-03-14T19:11:36.84Z",
+    "2024-03-14T21:21:55.313Z",
+    "2024-03-14T21:23:05.68Z",
+    "2024-03-14T21:23:06.013Z",
+    "2024-03-14T21:23:13.693Z",
+    "2024-03-14T21:24:06.643Z",
+    "2024-03-15T20:46:03.337Z",
+    "2024-03-15T20:46:07.973Z",
+    "2024-03-15T20:52:28.92Z",
+    "2024-03-15T21:01:55.407Z",
+    "2024-03-18T20:13:03.047Z",
+    "2024-03-19T02:46:45.227Z",
+    "2024-03-19T02:53:31.133Z",
+    "2024-03-19T02:58:25.87Z",
+    "2024-03-19T02:59:42.95Z",
+    "2024-03-19T03:00:17.017Z",
+    "2024-03-19T19:21:11.957Z",
+    "2024-03-19T21:13:49.46Z",
+    "2024-03-19T22:29:45.097Z",
+    "2024-03-20T14:52:04.92Z",
+    "2024-03-21T15:04:26.963Z",
+    "2024-03-21T15:04:59.003Z",
+    "2024-03-21T15:05:08.52Z",
+    "2024-03-21T15:26:09.337Z",
+    "2024-03-21T15:29:49.457Z",
+    "2024-03-21T15:30:33.85Z",
+    "2024-03-21T17:29:38.59Z",
+    "2024-03-21T18:07:55.047Z",
+    "2024-03-21T18:08:22.883Z",
+    "2024-03-22T17:23:07.13Z",
+    "2024-03-22T17:31:21.85Z",
+    "2024-03-22T21:55:56.293Z",
+    "2024-03-22T21:55:57.267Z",
+    "2024-03-23T16:04:49.38Z",
+    "2024-03-25T23:37:29.403Z",
+    "2024-03-25T23:37:45.44Z",
+    "2024-03-25T23:38:14.967Z",
+    "2024-03-26T00:01:26.593Z",
+    "2024-03-26T00:01:36.127Z",
+    "2024-03-26T15:55:04.947Z",
+    "2024-03-26T16:10:08.82Z",
+    "2024-03-26T16:24:48.657Z",
+    "2024-03-26T16:24:49.053Z",
+    "2024-03-26T16:24:53.573Z",
+    "2024-03-27T13:21:04.567Z",
+    "2024-03-27T13:32:11.08Z",
+    "2024-03-27T13:32:12.76Z",
+    "2024-03-27T13:33:08.953Z",
+    "2024-03-27T17:29:49.157Z",
+    "2024-03-27T17:37:58.327Z",
+    "2024-03-27T17:39:51.85Z",
+    "2024-03-27T17:40:09.95Z",
+    "2024-03-27T17:40:21.84Z",
+    "2024-03-28T15:15:34.357Z",
+    "2024-03-28T16:09:35.753Z",
+    "2024-03-28T16:27:05.56Z",
+    "2024-03-28T16:33:28.717Z",
+    "2024-03-28T16:33:35.71Z",
+    "2024-03-28T16:33:56.49Z",
+    "2024-03-28T16:35:01.127Z",
+    "2024-03-28T16:35:03.513Z",
+    "2024-03-28T16:35:11.627Z",
+    "2024-03-28T16:35:48.313Z",
+    "2024-03-28T16:36:11.28Z",
+    "2024-03-28T16:37:02.943Z",
+    "2024-03-28T16:37:30.85Z",
+    "2024-03-28T16:37:32.873Z",
+    "2024-03-28T16:42:45.65Z",
+    "2024-03-28T16:42:48.86Z",
+    "2024-03-28T16:42:51.15Z",
+    "2024-04-01T16:27:02.117Z",
+    "2024-04-02T01:31:12.047Z",
+    "2024-04-02T01:31:36.603Z",
+    "2024-04-02T01:34:48.52Z",
+    "2024-04-02T01:34:57.02Z",
+    "2024-04-02T01:35:44.64Z",
+    "2024-04-02T16:12:35.537Z",
+    "2024-04-02T16:12:44.213Z",
+    "2024-04-02T16:15:18.68Z",
+    "2024-04-02T16:21:59.76Z",
+    "2024-04-02T16:24:44.087Z",
+    "2024-04-02T16:24:52.65Z",
+    "2024-04-02T16:25:09.547Z",
+    "2024-04-02T16:25:55.57Z",
+    "2024-04-02T16:27:56.313Z",
+    "2024-04-02T16:28:00.403Z",
+    "2024-04-02T16:29:39.293Z",
+    "2024-04-02T16:32:20.54Z",
+    "2024-04-02T16:32:41.527Z",
+    "2024-04-02T16:42:20.413Z",
+    "2024-04-02T20:38:32.47Z",
+    "2024-04-02T20:39:42.337Z",
+    "2024-04-03T01:26:25.087Z",
+    "2024-04-04T16:04:50.917Z",
+    "2024-04-04T16:05:11.873Z",
+    "2024-04-04T16:05:17.573Z",
+    "2024-04-04T16:06:35.577Z",
+    "2024-04-04T16:07:22.947Z",
+    "2024-04-04T16:09:58.193Z",
+    "2024-04-04T16:10:06.467Z",
+    "2024-04-04T16:10:11.853Z",
+    "2024-04-04T16:10:28.763Z",
+    "2024-04-04T16:10:31.533Z",
+    "2024-04-04T16:15:19.473Z",
+    "2024-04-04T16:15:23.39Z",
+    "2024-04-04T16:16:09.86Z",
+    "2024-04-04T18:09:35.133Z",
+    "2024-04-04T23:12:30.663Z",
+]
+
+
+def test_basic() -> None:
+    """Test basic timestamp functionality"""
+    for timestamp_string in TEST_TIMESTAMPS:
+        value_under_test = Timestamp(timestamp_string)
+        assert (
+            str(value_under_test) == timestamp_string
+        ), f"{str(value_under_test)} != {timestamp_string}"
+        timestamp = value_under_test.to_timestamp()
+        assert (
+            abs(timestamp - Timestamp(timestamp).to_timestamp()) < 0.001
+        ), f"{timestamp} != {Timestamp(timestamp).to_timestamp()}"
+        assert (
+            abs(timestamp - Timestamp(value_under_test.value).to_timestamp()) < 0.001
+        ), f"{timestamp} != {Timestamp(value_under_test.value).to_timestamp()}"
+
+
+if __name__ == "__main__":
+    test_basic()

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/tests/test_azure_workitem.py

@@ -21,7 +21,7 @@ class MockAzureWorkItem:
                 "System.Reason": "New",
                 "System.CreatedDate": "2023-11-16T03:12:32.94Z",
                 "System.CreatedBy": {
-                    "displayName": "Edna Johnson",
+                    "displayName": "Edna Johnson Z",
                     "url": "https://spsprodcus5.vssps.visualstudio.com/"
                     + "A3eb27a26-75f2-40f9-87dc-cc10e8e565e4/_apis/Identities"
                     + "/45fcf770-0670-69d4-8e48-3ae6e0bf9b5c",
@@ -40,7 +40,8 @@ class MockAzureWorkItem:
                 },
                 "System.ChangedDate": "2023-11-16T03:12:32.94Z",
                 "System.ChangedBy": {
-                    "displayName": "Edna Johnson",
+                    "displayName": "Edna Johnson .Z",
+                    "changedOn": "2023-11-16T03:12:32.94Z",
                     "url": "https://spsprodcus5.vssps.visualstudio.com/"
                     + "A3eb27a26-75f2-40f9-87dc-cc10e8e565e4/_apis/Identities/"
                     + "45fcf770-0670-69d4-8e48-3ae6e0bf9b5c",
@@ -60,7 +61,7 @@ class MockAzureWorkItem:
                 "System.CommentCount": 0,
                 "System.TeamProject": "Creative",
                 "System.AreaPath": "Creative",
-                "System.IterationPath": "Creative\\November 2 2023",
+                "System.IterationPath": "2023-11-16T03:12:32.alphaZ",
                 "System.Title": "test",
                 "Microsoft.VSTS.Common.Priority": 2,
                 "Microsoft.VSTS.Common.ValueArea": "Business",
@@ -80,16 +81,24 @@ def test_workitem() -> None:
     assert wi.ID == 5, wi.ID
     assert wi.workitemtype == "User Story", wi.workitemtype
     assert wi.system_workitemtype == "User Story", wi.system_workitemtype
-    assert wi.ChangedBy["displayName"] == "Edna Johnson", wi.changedBy
-    assert wi.changedby.displayname == "Edna Johnson", wi.changedby.displayname
     assert wi.microsoft_vsts_common_priority == 2, wi.microsoft_vsts_common_priority
+    assert wi.not_a_field is None, wi.not_a_field
 
-    try:
-        _ = wi.not_a_field
 
-    except AttributeError as error:
-        assert "not_a_field" in str(error)
+def test_timestamp() -> None:
+    """test timestamps"""
+    wi = WorkItem(MockAzureWorkItem())
+    assert wi.StateChangeDate.to_string() == "2023-11-16T03:12:32.94Z"
+    assert wi.CreatedDate.to_string() == "2023-11-16T03:12:32.94Z"
+    assert wi.ChangedDate.to_string() == "2023-11-16T03:12:32.94Z"
+    assert wi.IterationPath == "2023-11-16T03:12:32.alphaZ", wi.IterationPath
+    assert wi.ChangedBy["displayName"] == "Edna Johnson .Z", wi.changedBy["displayName"]
+    assert wi.createdBy.displayName == "Edna Johnson Z", wi.createdBy.displayName
+    assert (
+        wi.changedBy.changedOn.to_string() == "2023-11-16T03:12:32.94Z"
+    ), wi.changedBy.changedOn
 
 
 if __name__ == "__main__":
+    test_timestamp()
     test_workitem()

devopsdriver-0.1.39/tests/test_manage_settings.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+
+""" Test the manage_settings tool """
+
+from os.path import join
+from tempfile import TemporaryDirectory
+from helpers import setup_settings, write
+
+from devopsdriver import settings
+from devopsdriver import manage_settings
+
+
+def test_main():
+    """test the main entry point"""
+    with TemporaryDirectory() as working_dir:
+        setup_settings(shared="test", Linux=join(working_dir, "Linux"))
+        settings.ARGV = ["ignore", "test"]
+        manage_settings.ARGV = ["ignore", "test"]
+        storage = {}
+
+        def mock_print(message: str) -> None:
+            storage["print"] = message
+
+        settings.PRINT = mock_print
+        manage_settings.PRINT = mock_print
+        write(join(working_dir, "Linux", "test.yml"), test=3)
+        manage_settings.main()
+        assert storage["print"] == "3", storage
+
+
+def test_main_help():
+    """test the main entry point"""
+    with TemporaryDirectory() as working_dir:
+        setup_settings(shared="test", Linux=join(working_dir, "Linux"))
+        manage_settings.PRINT = settings.PRINT
+        settings.ARGV = ["ignore", "--help"]
+        manage_settings.ARGV = settings.ARGV
+        storage = {}
+
+        def mock_print(message: str) -> None:
+            storage["print"] = message
+
+        settings.PRINT = mock_print
+        manage_settings.PRINT = mock_print
+        write(join(working_dir, "Linux", "test.yml"), test=3)
+        manage_settings.main()
+        assert storage["print"].startswith("Usage:"), storage
+
+
+def test_main_set_secret():
+    """test the main entry point when settings keychain secrets"""
+
+    def set_password(s, n, p):
+        assert (
+            s in ("azure", "jira") and n == "token" and p == "setec astronomy"
+        ), f"{s} {n} {p}"
+
+    with TemporaryDirectory() as working_dir:
+        setup_settings(shared="test", Linux=join(working_dir, "Linux"))
+        settings.ARGV = ["ignore", "--secrets"]
+        manage_settings.ARGV = settings.ARGV
+        settings.GET_PASSWORD = lambda s, n: (
+            "password" if f"{s}/{n}" == "azure/token" else None
+        )
+        settings.GET_PASS = lambda p: "setec astronomy"
+        manage_settings.GET_PASS = settings.GET_PASS
+        manage_settings.PRINT = settings.PRINT
+        settings.SET_PASSWORD = set_password
+        manage_settings.SET_PASSWORD = settings.SET_PASSWORD
+        write(
+            join(working_dir, "Linux", "test.yml"),
+            secrets={"azure.token": "azure/token", "jira.token": "jira/token"},
+        )
+        manage_settings.main()
+
+
+if __name__ == "__main__":
+    test_main()
+    test_main_help()
+    test_main_set_secret()

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/tests/test_sendmail.py

@@ -3,7 +3,7 @@
 """ Test sendmail """
 
 from devopsdriver import sendmail  # for debugging
-from devopsdriver import send_email
+from devopsdriver.sendmail import send_email
 
 
 class MockMultipart(dict):

{devopsdriver-0.1.37 → devopsdriver-0.1.39}/tests/test_settings.py

@@ -10,7 +10,7 @@ from itertools import product
 from helpers import setup_settings, ensure, write
 
 from devopsdriver import settings  # debug access
-from devopsdriver import Settings
+from devopsdriver.settings import Settings
 
 
 def __setup_files(directory: str, dir1: str, dir2: str) -> None:
@@ -238,24 +238,6 @@ def test_environ_values():
         assert opts["value"] == "testing ${noenv} for noenv", opts["value"]
 
 
-def test_main():
-    """test the main entry point"""
-    with TemporaryDirectory() as working_dir:
-        setup_settings(shared="test", Linux=join(working_dir, "Linux"))
-        settings.ARGV = ["ignore", "test"]
-        write(join(working_dir, "Linux", "test.yml"), test=3)
-        settings.main()
-
-
-def test_main_help():
-    """test the main entry point"""
-    with TemporaryDirectory() as working_dir:
-        setup_settings(shared="test", Linux=join(working_dir, "Linux"))
-        settings.ARGV = ["ignore", "--help"]
-        write(join(working_dir, "Linux", "test.yml"), test=3)
-        settings.main()
-
-
 def test_secret():
     """test os secret storage"""
     with TemporaryDirectory() as working_dir:
@@ -274,33 +256,8 @@ def test_secret():
         assert opts["password"] == "setec astronomy", opts["password"]
 
 
-def test_main_set_secret():
-    """test the main entry point when settings keychain secrets"""
-
-    def set_password(s, n, p):
-        assert (
-            s in ("azure", "jira") and n == "token" and p == "setec astronomy"
-        ), f"{s} {n} {p}"
-
-    with TemporaryDirectory() as working_dir:
-        setup_settings(shared="test", Linux=join(working_dir, "Linux"))
-        settings.ARGV = ["ignore", "--secrets"]
-        settings.GET_PASSWORD = lambda s, n: (
-            "password" if f"{s}/{n}" == "azure/token" else None
-        )
-        settings.GET_PASS = lambda p: "setec astronomy"
-        settings.SET_PASSWORD = set_password
-        write(
-            join(working_dir, "Linux", "test.yml"),
-            secrets={"azure.token": "azure/token", "jira.token": "jira/token"},
-        )
-        settings.main()
-
-
 if __name__ == "__main__":
-    test_main_set_secret()
     test_secret()
-    test_main()
     test_environ_values()
     test_cli_env_in_yaml()
     test_basic()

devopsdriver-0.1.37/devopsdriver/__init__.py

@@ -1,10 +0,0 @@
-""" DevOps tools """
-
-from .azdo import Azure
-from .settings import Settings
-from .sendmail import send_email
-from .template import Template
-
-__version__ = "0.1.37"
-__author__ = "Marc Page"
-__credits__ = ""

devopsdriver-0.1.37/devopsdriver/azdo/workitem/__init__.py

@@ -1,4 +0,0 @@
-""" init workitem module """
-
-# Re-export symbols to make things make sense
-from .workitem import WorkItem