PyPI - devopsdriver - Versions diffs - 0.1.48__tar.gz → 0.1.50__tar.gz - Mend

devopsdriver 0.1.48tar.gz → 0.1.50tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (52) hide show

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: devopsdriver
-Version: 0.1.48
+Version: 0.1.50
 Summary: DevOps tools
 Author-email: Marc Page <marcallenpage@gmail.com>
 License: This is free and unencumbered software released into the public domain.
@@ -33,7 +33,7 @@ Project-URL: Documentation, https://github.com/marcpage/devops-driver
 Project-URL: Repository, https://github.com/marcpage/devops-driver.git
 Project-URL: Issues, https://github.com/marcpage/devops-driver/issues
 Project-URL: Changelog, https://github.com/marcpage/devops-driver/releases
-Keywords: azure,devops,jira,confluence,email,pipelines,tools
+Keywords: azure,devops,jira,confluence,email,pipelines,tools,github
 Classifier: Development Status :: 1 - Planning
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -46,11 +46,12 @@ Classifier: Topic :: Software Development
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: PyYAML==6.0.2
-Requires-Dist: keyring==25.3.0
-Requires-Dist: setuptools==74.0.0
+Requires-Dist: PyYAML==6.0.3
+Requires-Dist: keyring==25.6.0
+Requires-Dist: setuptools==80.9.0
 Requires-Dist: azure-devops==7.1.0b4
-Requires-Dist: Mako==1.3.5
+Requires-Dist: Mako==1.3.10
+Requires-Dist: PyGithub==2.5.0
 Provides-Extra: dev
 Requires-Dist: black>=24.3.0; extra == "dev"
 Requires-Dist: pylint>=3.1.0; extra == "dev"
@@ -58,9 +59,12 @@ Provides-Extra: test
 Requires-Dist: pytest>=8.1.1; extra == "test"
 Requires-Dist: coverage>=7.4.4; extra == "test"
 Provides-Extra: doc
+Dynamic: license-file
+# devops-driver
 ![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.48&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.48/)
+[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.50&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.50/)
 [![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)
@@ -71,7 +75,7 @@ Provides-Extra: doc
 [![size sheild](https://img.shields.io/github/languages/code-size/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver)
 [![example workflow](https://github.com/marcpage/devops-driver/actions/workflows/pr.yml/badge.svg)](https://github.com/marcpage/devops-driver/actions/workflows/pr.yml)
-[![status sheild](https://img.shields.io/static/v1?label=test+coverage&message=99%&color=active&style=plastic)](https://github.com/marcpage/devops-driver/blob/main/Makefile#L4)
+[![status sheild](https://img.shields.io/static/v1?label=test+coverage&message=98%&color=active&style=plastic)](https://github.com/marcpage/devops-driver/blob/main/Makefile#L4)
 [![issues sheild](https://img.shields.io/github/issues-raw/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver/issues)
 [![GitHub pull requests](https://img.shields.io/github/issues-pr/marcpage/devops-driver?style=flat)](https://github.com/marcpage/devops-driver/pulls)
@@ -82,13 +86,11 @@ Provides-Extra: doc
 [![Azure](https://img.shields.io/static/v1?label=&message=Supports%20Microsoft%20Azure&color=blue&style=plastic&logo=microsoftazure)](https://azure.microsoft.com/)
 [![Gmail](https://img.shields.io/static/v1?label=&message=Supports%20Google%20Gmail&color=white&style=plastic&logo=gmail)](https://gmail.com/)
-OS:
+OS:
 [![Windows](https://img.shields.io/static/v1?label=&message=Windows&color=blue&style=plastic&logo=windows)](https://microsoft.com/)
 [![macOS](https://img.shields.io/static/v1?label=&message=macOS&color=white&logoColor=black&style=plastic&logo=apple)](https://apple.com/)
 [![Linux](https://img.shields.io/static/v1?label=&message=Linux&color=seashell&logoColor=black&style=plastic&logo=linux)](https://linux.org/)
-# devops-driver
 Devops-driver is a collection of tools to help streamline developer's experience and gain insights into various processes.
 ## Tools
@@ -107,6 +109,7 @@ To allow seamless work in both pipelines as well as in the development environme
 Say you want a pipeline that looks for User Stories that are newer than 3 days and send out an email.
 ### \<platform dependent path\>/devopsdriver.yml
 ```yaml
 smtp:
     sender: JohnDoe@company.com
@@ -116,7 +119,7 @@ secrets:
     smtp.password: smtp/password
 ```
-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.
+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.
 | Platform | Global Directory       |
 |----------|------------------------|
@@ -127,6 +130,7 @@ This file is in a global place (location varies by OS) and stores information th
 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
@@ -138,16 +142,21 @@ secret: azure.token  key: azure/token
 smtp.password (azure/token): ****
 $ settings --secrets
 secret: azure.token  key: azure/token
-	Value set
+    Value set
 secret: smtp.password  key: smtp/password
-	Value set
+    Value set
 $
 ```
 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 `settings` will verify that all the values have been set in the keychain.
+**Note**: If your `secrets`, `cli`, or `env` are in a yaml file named after your script,
+you can call `settings --secrets --script my_script.py`.
 ### devopsdriver.yml
 ```yaml
 azure:
     url: https://dev.azure.com/MyCompany
@@ -173,15 +182,18 @@ The `cli` and `env` map command line switches and environment variables to those
 This allows for many options for setting values depending on your needs.
 ### new_stories.yml
 ```yaml
 scrum masters:
     - JohnDoe@company.com
     - JaneDoe@company.com
 ```
 This file is specific to your script and not shared.
 These are values that you want to use in your script but have them here for easy adjustment.
 ### new_stories.html.mako
 ```html
 <h1>Stories created in the last ${days} days</h1>
 <ul>
@@ -194,6 +206,7 @@ These are values that you want to use in your script but have them here for easy
 This file is the template for the email body.
 ### new_stories.py
 ```python
 from datetime import date, timedelta
@@ -229,9 +242,9 @@ send_email(
 ### The email sent
-**From**: JohnDoe@company.com
+**From**: `JohnDoe@company.com`
-**To**: JohnDoe@company.com, JaneDoe@company.com
+**To**: `JohnDoe@company.com`, `JaneDoe@company.com`
 **Subject**: Stories created in the last 3 days
@@ -246,4 +259,3 @@ send_email(
 - 754 frontend - store to schema
 - 755 Transfer job to production. Setup migrations to move to production
 - 756 Query subscription status from App

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/README.md RENAMED Viewed

@@ -1,5 +1,7 @@
+# devops-driver
 ![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.48&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.48/)
+[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.50&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.50/)
 [![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)
@@ -10,7 +12,7 @@
 [![size sheild](https://img.shields.io/github/languages/code-size/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver)
 [![example workflow](https://github.com/marcpage/devops-driver/actions/workflows/pr.yml/badge.svg)](https://github.com/marcpage/devops-driver/actions/workflows/pr.yml)
-[![status sheild](https://img.shields.io/static/v1?label=test+coverage&message=99%&color=active&style=plastic)](https://github.com/marcpage/devops-driver/blob/main/Makefile#L4)
+[![status sheild](https://img.shields.io/static/v1?label=test+coverage&message=98%&color=active&style=plastic)](https://github.com/marcpage/devops-driver/blob/main/Makefile#L4)
 [![issues sheild](https://img.shields.io/github/issues-raw/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver/issues)
 [![GitHub pull requests](https://img.shields.io/github/issues-pr/marcpage/devops-driver?style=flat)](https://github.com/marcpage/devops-driver/pulls)
@@ -21,13 +23,11 @@
 [![Azure](https://img.shields.io/static/v1?label=&message=Supports%20Microsoft%20Azure&color=blue&style=plastic&logo=microsoftazure)](https://azure.microsoft.com/)
 [![Gmail](https://img.shields.io/static/v1?label=&message=Supports%20Google%20Gmail&color=white&style=plastic&logo=gmail)](https://gmail.com/)
-OS:
+OS:
 [![Windows](https://img.shields.io/static/v1?label=&message=Windows&color=blue&style=plastic&logo=windows)](https://microsoft.com/)
 [![macOS](https://img.shields.io/static/v1?label=&message=macOS&color=white&logoColor=black&style=plastic&logo=apple)](https://apple.com/)
 [![Linux](https://img.shields.io/static/v1?label=&message=Linux&color=seashell&logoColor=black&style=plastic&logo=linux)](https://linux.org/)
-# devops-driver
 Devops-driver is a collection of tools to help streamline developer's experience and gain insights into various processes.
 ## Tools
@@ -46,6 +46,7 @@ To allow seamless work in both pipelines as well as in the development environme
 Say you want a pipeline that looks for User Stories that are newer than 3 days and send out an email.
 ### \<platform dependent path\>/devopsdriver.yml
 ```yaml
 smtp:
     sender: JohnDoe@company.com
@@ -55,7 +56,7 @@ secrets:
     smtp.password: smtp/password
 ```
-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.
+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.
 | Platform | Global Directory       |
 |----------|------------------------|
@@ -66,6 +67,7 @@ This file is in a global place (location varies by OS) and stores information th
 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
@@ -77,16 +79,21 @@ secret: azure.token  key: azure/token
 smtp.password (azure/token): ****
 $ settings --secrets
 secret: azure.token  key: azure/token
-	Value set
+    Value set
 secret: smtp.password  key: smtp/password
-	Value set
+    Value set
 $
 ```
 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 `settings` will verify that all the values have been set in the keychain.
+**Note**: If your `secrets`, `cli`, or `env` are in a yaml file named after your script,
+you can call `settings --secrets --script my_script.py`.
 ### devopsdriver.yml
 ```yaml
 azure:
     url: https://dev.azure.com/MyCompany
@@ -112,15 +119,18 @@ The `cli` and `env` map command line switches and environment variables to those
 This allows for many options for setting values depending on your needs.
 ### new_stories.yml
 ```yaml
 scrum masters:
     - JohnDoe@company.com
     - JaneDoe@company.com
 ```
 This file is specific to your script and not shared.
 These are values that you want to use in your script but have them here for easy adjustment.
 ### new_stories.html.mako
 ```html
 <h1>Stories created in the last ${days} days</h1>
 <ul>
@@ -133,6 +143,7 @@ These are values that you want to use in your script but have them here for easy
 This file is the template for the email body.
 ### new_stories.py
 ```python
 from datetime import date, timedelta
@@ -168,9 +179,9 @@ send_email(
 ### The email sent
-**From**: JohnDoe@company.com
+**From**: `JohnDoe@company.com`
-**To**: JohnDoe@company.com, JaneDoe@company.com
+**To**: `JohnDoe@company.com`, `JaneDoe@company.com`
 **Subject**: Stories created in the last 3 days
@@ -185,4 +196,3 @@ send_email(
 - 754 frontend - store to schema
 - 755 Transfer job to production. Setup migrations to move to production
 - 756 Query subscription status from App

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/__init__.py RENAMED Viewed

@@ -1,11 +1,12 @@
-""" DevOps tools """
+"""DevOps tools"""
 from .settings import Settings
 from .sendmail import send_email
 from .template import Template
 from .azdo.clients import Azure
+from .github.client import Github
-__version__ = "0.1.48"
+__version__ = "0.1.50"
 __author__ = "Marc Page"
 __credits__ = ""

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/__init__.py RENAMED Viewed

@@ -1,4 +1,4 @@
-""" initialize azure module """
+"""initialize azure module"""
 # re export symbols for easier use
 from .azureobject import AzureObject

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/azureobject.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" An Azure Devops WorkItem """
+"""An Azure Devops WorkItem"""
 from msrest.serialization import Model

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/builds/build.py RENAMED Viewed

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
-""" Azure Build """
+"""Azure Build"""
 from azure.devops.v7_1.build.models import Build as AzureBuild
 from azure.devops.v7_1.build import BuildClient

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/builds/client.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Azure Build Client """
+"""Azure Build Client"""
 from datetime import datetime
@@ -16,7 +16,7 @@ class Client:  # pylint: disable=too-few-public-methods
     def __init__(self, client: BuildClient):
         self.client = client
-    def list(  # pylint: disable=too-many-arguments
+    def list(  # pylint: disable=too-many-positional-arguments,too-many-arguments
         self,
         project: str,
         pipelines: list[int] = None,

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/clients.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Establish a connection to Azure Devops
+"""Establish a connection to Azure Devops
 API Documented here:
 https://github.com/microsoft/azure-devops-python-api

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/pipeline/client.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Pipeline client """
+"""Pipeline client"""
 from azure.devops.v7_1.pipelines import PipelinesClient

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/pipeline/log.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Azure Pipeline Run Log """
+"""Azure Pipeline Run Log"""
 from azure.devops.v7_1.pipelines.models import Log as AzureLog

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/pipeline/pipeline.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Azure Pipeline """
+"""Azure Pipeline"""
 from azure.devops.v7_1.pipelines.models import Pipeline as AzurePipeline

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/pipeline/run.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Pipeline Run """
+"""Pipeline Run"""
 from azure.devops.v7_1.pipelines.models import Pipeline

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/timestamp.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Tools that help when working with Azure """
+"""Tools that help when working with Azure"""
 from datetime import datetime, timezone, timedelta

devopsdriver-0.1.50/devopsdriver/azdo/workitem/__init__.py ADDED Viewed

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

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/workitem/client.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Azure WorkItem Client """
+"""Azure WorkItem Client"""
 from azure.devops.v7_1.work_item_tracking.models import Wiql as AzureWiql
@@ -43,7 +43,7 @@ class Client:
             top=top,
         )
-    def get_history(  # pylint: disable=too-many-arguments
+    def get_history(  # pylint: disable=too-many-positional-arguments,too-many-arguments
         self,
         wi_id: int,
         project: str = None,

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/azdo/workitem/wiql.py RENAMED Viewed

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

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/dataobject.py RENAMED Viewed

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
-""" Data Objects """
+"""Data Objects"""
 from json import dumps

devopsdriver-0.1.50/devopsdriver/github/__init__.py ADDED Viewed

File without changes

devopsdriver-0.1.50/devopsdriver/github/client.py ADDED Viewed

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+"""Manages GitHub connection"""
+from github import Github as Github_connection, Auth
+from devopsdriver.settings import Settings
+class Github:
+    """Manages the GitHub connection"""
+    def __init__(self, settings: Settings):
+        self.settings: Settings = settings
+        self.connection: Github_connection | None = None
+        assert settings.get("github.token") is not None, "github.token not set"
+    def __enter__(self) -> Github_connection:
+        self.connection = Github_connection(
+            auth=Auth.Token(self.settings["github.token"])
+        )
+        return self.connection
+    def __exit__(self, exception_type, exception_value, exception_traceback):
+        if self.connection is not None:
+            self.connection.close()

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/manage_settings.py RENAMED Viewed

@@ -1,10 +1,10 @@
 #!/usr/bin/env python3
-""" Module Doc """
+"""Module Doc"""
-from os.path import dirname, join
+from os.path import dirname, join, abspath
 from sys import argv as sys_argv
 from getpass import getpass as os_getpass
@@ -31,7 +31,14 @@ def main() -> None:
         )
         return
-    settings = Settings(__file__, dirname(dirname(__file__))).key("secrets")
+    position = args.index("--script") if "--script" in args else len(args)
+    script = __file__
+    if position + 1 < len(args):
+        args.pop(position)
+        script = abspath(args.pop(position))
+    settings = Settings(script, dirname(dirname(__file__))).key("secrets")
     if "--secrets" in args:
         args.remove("--secrets")

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/sendmail.py RENAMED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-""" Ability to send emails with embedded images """
+"""Ability to send emails with embedded images"""
 from smtplib import SMTP as OS_SMTP, SMTP_SSL as OS_SMTP_SSL

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/settings.py RENAMED Viewed

@@ -1,78 +1,78 @@
 #!/usr/bin/env python3
-""" Settings that can be in files, environment, or on the command line
-    Settings can be set on the command line, environment, in the code, or in files.
-    Priority order:
-    - in code
-    - command line
-    - environment
-    - files
-    Files can be JSON or YAML.
-    They must have .json, .yml, or .yaml extension.
-    Files can be named after the file passed in (__file__) or "devopsdriver".
-    All files named after the file passed in have priority over "devopsdriver".
-    This allows for shared settings for multiple scripts as well as specific settings.
-    Files can be in an OS-specific preferences location, a series of specified directories,
-        or next to the file passed in (__file__).
-    This allows for secrets, keys, and tokens to be stored on the machine and not in the repo.
-    Files in the OS specific directories have priority over other files and are stored in:
-    - macOS: ~/Library/Preferences/
-    - Windows: %APPDATA%/
-    - Linux: ~/.devopsdriver/
-    You can have environment variable substitutions in the values in the files.
-    For instance, you can specify:
-    output: ${home}/reports
-    The `${home}` will be replaced with the value of the HOME environment variable, if it exists.
-    If the environment variable does not exist, no change is made.
-    Use case 1: Secrets not in repo
-        tokens, passwords, etc can be stored in <pref>/devopsdriver.yml
-        This will allow for all scripts to access those secrets
-            but they are not in the repo.
-        For pipeline runs these secrets can be passed on the command line or in the environment.
-    Use case 2: common settings among scripts
-        Store your common settings in devopsdriver.yml next to your script.
-        All scripts in this directory will have access to these settings.
-        For instance, say you want all emails sent from the same person.
-        You could set 'email: me@domain.com' in devopsdriver.html.
-        You could also, store report paths, emails, groups, holidays, etc.
-        Any data all scripts may want to have access to.
-    Use case 3: configurable settings
-        Any settings in your script that you may want to configure.
-        If your script is `cool_script.py` then put the settings in `cool_script.yml` next to it.
-        This could be colors, emails, repos, queries, whatever.
-    Use case 4: override secrets for specific script
-        Overriding secrets stored in `<pref>/devopsdriver.yml` for specific scripts.
-        If your script is `cool_script.py` save them to `<pref>/cool_script.yml`.
-    *Note*: You can override a specific setting in a sub-dictionary.
-    For instance, say `<pref>/devopsdriver.yml`:
-    ```yaml
-    api:
-        user: johndoe
-        password: Setec Astronomy
-    ```
-    You could override this for `cool_script.py` be adding `<pref>/cool_script.yml`:
-    ```yaml
-    api:
-        user: janedoe
-    ```
-    johndoe and janedoe share the same password, so you just need to update the `user`
+"""Settings that can be in files, environment, or on the command line
+Settings can be set on the command line, environment, in the code, or in files.
+Priority order:
+- in code
+- command line
+- environment
+- files
+Files can be JSON or YAML.
+They must have .json, .yml, or .yaml extension.
+Files can be named after the file passed in (__file__) or "devopsdriver".
+All files named after the file passed in have priority over "devopsdriver".
+This allows for shared settings for multiple scripts as well as specific settings.
+Files can be in an OS-specific preferences location, a series of specified directories,
+    or next to the file passed in (__file__).
+This allows for secrets, keys, and tokens to be stored on the machine and not in the repo.
+Files in the OS specific directories have priority over other files and are stored in:
+- macOS: ~/Library/Preferences/
+- Windows: %APPDATA%/
+- Linux: ~/.devopsdriver/
+You can have environment variable substitutions in the values in the files.
+For instance, you can specify:
+output: ${home}/reports
+The `${home}` will be replaced with the value of the HOME environment variable, if it exists.
+If the environment variable does not exist, no change is made.
+Use case 1: Secrets not in repo
+    tokens, passwords, etc can be stored in <pref>/devopsdriver.yml
+    This will allow for all scripts to access those secrets
+        but they are not in the repo.
+    For pipeline runs these secrets can be passed on the command line or in the environment.
+Use case 2: common settings among scripts
+    Store your common settings in devopsdriver.yml next to your script.
+    All scripts in this directory will have access to these settings.
+    For instance, say you want all emails sent from the same person.
+    You could set 'email: me@domain.com' in devopsdriver.html.
+    You could also, store report paths, emails, groups, holidays, etc.
+    Any data all scripts may want to have access to.
+Use case 3: configurable settings
+    Any settings in your script that you may want to configure.
+    If your script is `cool_script.py` then put the settings in `cool_script.yml` next to it.
+    This could be colors, emails, repos, queries, whatever.
+Use case 4: override secrets for specific script
+    Overriding secrets stored in `<pref>/devopsdriver.yml` for specific scripts.
+    If your script is `cool_script.py` save them to `<pref>/cool_script.yml`.
+*Note*: You can override a specific setting in a sub-dictionary.
+For instance, say `<pref>/devopsdriver.yml`:
+```yaml
+api:
+    user: johndoe
+    password: Setec Astronomy
+```
+You could override this for `cool_script.py` be adding `<pref>/cool_script.yml`:
+```yaml
+api:
+    user: janedoe
+```
+johndoe and janedoe share the same password, so you just need to update the `user`
 """

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver/template.py RENAMED Viewed

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

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: devopsdriver
-Version: 0.1.48
+Version: 0.1.50
 Summary: DevOps tools
 Author-email: Marc Page <marcallenpage@gmail.com>
 License: This is free and unencumbered software released into the public domain.
@@ -33,7 +33,7 @@ Project-URL: Documentation, https://github.com/marcpage/devops-driver
 Project-URL: Repository, https://github.com/marcpage/devops-driver.git
 Project-URL: Issues, https://github.com/marcpage/devops-driver/issues
 Project-URL: Changelog, https://github.com/marcpage/devops-driver/releases
-Keywords: azure,devops,jira,confluence,email,pipelines,tools
+Keywords: azure,devops,jira,confluence,email,pipelines,tools,github
 Classifier: Development Status :: 1 - Planning
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -46,11 +46,12 @@ Classifier: Topic :: Software Development
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: PyYAML==6.0.2
-Requires-Dist: keyring==25.3.0
-Requires-Dist: setuptools==74.0.0
+Requires-Dist: PyYAML==6.0.3
+Requires-Dist: keyring==25.6.0
+Requires-Dist: setuptools==80.9.0
 Requires-Dist: azure-devops==7.1.0b4
-Requires-Dist: Mako==1.3.5
+Requires-Dist: Mako==1.3.10
+Requires-Dist: PyGithub==2.5.0
 Provides-Extra: dev
 Requires-Dist: black>=24.3.0; extra == "dev"
 Requires-Dist: pylint>=3.1.0; extra == "dev"
@@ -58,9 +59,12 @@ Provides-Extra: test
 Requires-Dist: pytest>=8.1.1; extra == "test"
 Requires-Dist: coverage>=7.4.4; extra == "test"
 Provides-Extra: doc
+Dynamic: license-file
+# devops-driver
 ![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.48&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.48/)
+[![status sheild](https://img.shields.io/static/v1?label=released&message=v0.1.50&color=active&style=plastic)](https://pypi.org/project/devopsdriver/0.1.50/)
 [![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)
@@ -71,7 +75,7 @@ Provides-Extra: doc
 [![size sheild](https://img.shields.io/github/languages/code-size/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver)
 [![example workflow](https://github.com/marcpage/devops-driver/actions/workflows/pr.yml/badge.svg)](https://github.com/marcpage/devops-driver/actions/workflows/pr.yml)
-[![status sheild](https://img.shields.io/static/v1?label=test+coverage&message=99%&color=active&style=plastic)](https://github.com/marcpage/devops-driver/blob/main/Makefile#L4)
+[![status sheild](https://img.shields.io/static/v1?label=test+coverage&message=98%&color=active&style=plastic)](https://github.com/marcpage/devops-driver/blob/main/Makefile#L4)
 [![issues sheild](https://img.shields.io/github/issues-raw/marcpage/devops-driver?style=plastic)](https://github.com/marcpage/devops-driver/issues)
 [![GitHub pull requests](https://img.shields.io/github/issues-pr/marcpage/devops-driver?style=flat)](https://github.com/marcpage/devops-driver/pulls)
@@ -82,13 +86,11 @@ Provides-Extra: doc
 [![Azure](https://img.shields.io/static/v1?label=&message=Supports%20Microsoft%20Azure&color=blue&style=plastic&logo=microsoftazure)](https://azure.microsoft.com/)
 [![Gmail](https://img.shields.io/static/v1?label=&message=Supports%20Google%20Gmail&color=white&style=plastic&logo=gmail)](https://gmail.com/)
-OS:
+OS:
 [![Windows](https://img.shields.io/static/v1?label=&message=Windows&color=blue&style=plastic&logo=windows)](https://microsoft.com/)
 [![macOS](https://img.shields.io/static/v1?label=&message=macOS&color=white&logoColor=black&style=plastic&logo=apple)](https://apple.com/)
 [![Linux](https://img.shields.io/static/v1?label=&message=Linux&color=seashell&logoColor=black&style=plastic&logo=linux)](https://linux.org/)
-# devops-driver
 Devops-driver is a collection of tools to help streamline developer's experience and gain insights into various processes.
 ## Tools
@@ -107,6 +109,7 @@ To allow seamless work in both pipelines as well as in the development environme
 Say you want a pipeline that looks for User Stories that are newer than 3 days and send out an email.
 ### \<platform dependent path\>/devopsdriver.yml
 ```yaml
 smtp:
     sender: JohnDoe@company.com
@@ -116,7 +119,7 @@ secrets:
     smtp.password: smtp/password
 ```
-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.
+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.
 | Platform | Global Directory       |
 |----------|------------------------|
@@ -127,6 +130,7 @@ This file is in a global place (location varies by OS) and stores information th
 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
@@ -138,16 +142,21 @@ secret: azure.token  key: azure/token
 smtp.password (azure/token): ****
 $ settings --secrets
 secret: azure.token  key: azure/token
-	Value set
+    Value set
 secret: smtp.password  key: smtp/password
-	Value set
+    Value set
 $
 ```
 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 `settings` will verify that all the values have been set in the keychain.
+**Note**: If your `secrets`, `cli`, or `env` are in a yaml file named after your script,
+you can call `settings --secrets --script my_script.py`.
 ### devopsdriver.yml
 ```yaml
 azure:
     url: https://dev.azure.com/MyCompany
@@ -173,15 +182,18 @@ The `cli` and `env` map command line switches and environment variables to those
 This allows for many options for setting values depending on your needs.
 ### new_stories.yml
 ```yaml
 scrum masters:
     - JohnDoe@company.com
     - JaneDoe@company.com
 ```
 This file is specific to your script and not shared.
 These are values that you want to use in your script but have them here for easy adjustment.
 ### new_stories.html.mako
 ```html
 <h1>Stories created in the last ${days} days</h1>
 <ul>
@@ -194,6 +206,7 @@ These are values that you want to use in your script but have them here for easy
 This file is the template for the email body.
 ### new_stories.py
 ```python
 from datetime import date, timedelta
@@ -229,9 +242,9 @@ send_email(
 ### The email sent
-**From**: JohnDoe@company.com
+**From**: `JohnDoe@company.com`
-**To**: JohnDoe@company.com, JaneDoe@company.com
+**To**: `JohnDoe@company.com`, `JaneDoe@company.com`
 **Subject**: Stories created in the last 3 days
@@ -246,4 +259,3 @@ send_email(
 - 754 frontend - store to schema
 - 755 Transfer job to production. Setup migrations to move to production
 - 756 Query subscription status from App

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver.egg-info/SOURCES.txt RENAMED Viewed

@@ -28,6 +28,8 @@ devopsdriver/azdo/pipeline/run.py
 devopsdriver/azdo/workitem/__init__.py
 devopsdriver/azdo/workitem/client.py
 devopsdriver/azdo/workitem/wiql.py
+devopsdriver/github/__init__.py
+devopsdriver/github/client.py
 devopsdriver/templates/manage_settings.txt.mako
 tests/test_azure_azureobject.py
 tests/test_azure_build.py

{devopsdriver-0.1.48 → devopsdriver-0.1.50}/devopsdriver.egg-info/requires.txt RENAMED Viewed

@@ -1,8 +1,9 @@
-PyYAML==6.0.2
-keyring==25.3.0
-setuptools==74.0.0
+PyYAML==6.0.3
+keyring==25.6.0
+setuptools==80.9.0
 azure-devops==7.1.0b4
-Mako==1.3.5
+Mako==1.3.10
+PyGithub==2.5.0
 [dev]
 black>=24.3.0

devopsdriver-0.1.50/pyproject.toml ADDED Viewed

@@ -0,0 +1,65 @@
+[project]
+name = "devopsdriver"
+description = "DevOps tools"
+readme = "README.md"
+license = { file = "LICENSE" }
+dynamic = ["version"]
+requires-python = ">= 3.10"
+dependencies = [
+  "PyYAML==6.0.3",
+  "keyring==25.6.0",
+  "setuptools==80.9.0",    # neded for azure-devops to use 7.1 API
+  "azure-devops==7.1.0b4",
+  "Mako==1.3.10",
+  "PyGithub==2.5.0",
+]
+keywords = [
+  "azure",
+  "devops",
+  "jira",
+  "confluence",
+  "email",
+  "pipelines",
+  "tools",
+  "github",
+]
+classifiers = [
+  "Development Status :: 1 - Planning",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: The Unlicense (Unlicense)",
+  "Programming Language :: Python :: 3.10",
+  "Topic :: Utilities",
+  "Topic :: Software Development",
+]
+authors = [{ name = "Marc Page", email = "marcallenpage@gmail.com" }]
+[project.scripts]
+settings = "devopsdriver.manage_settings:main"
+[tool.setuptools.package-data]
+"*" = ["*.mako"]
+[tool.setuptools.packages.find]
+include = ["devopsdriver*"]
+[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"
+Repository = "https://github.com/marcpage/devops-driver.git"
+Issues = "https://github.com/marcpage/devops-driver/issues"
+Changelog = "https://github.com/marcpage/devops-driver/releases"
+[tool.setuptools.dynamic]
+version = { attr = "devopsdriver.__version__" }
+[build-system]
+requires = ["setuptools >= 69.2"]
+build-backend = "setuptools.build_meta"

devopsdriver-0.1.48/devopsdriver/azdo/workitem/__init__.py DELETED Viewed

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

devopsdriver-0.1.48/pyproject.toml DELETED Viewed

@@ -1,64 +0,0 @@
-[project]
-name = "devopsdriver"
-description = "DevOps tools"
-readme = "README.md"
-license = {file = "LICENSE"}
-dynamic = ["version"]
-requires-python = ">= 3.10"
-dependencies = [
-  "PyYAML==6.0.2",
-  "keyring==25.3.0",
-  "setuptools==74.0.0",  # neded for azure-devops to use 7.1 API
-  "azure-devops==7.1.0b4",
-  "Mako==1.3.5",
-]
-keywords = ["azure", "devops", "jira", "confluence", "email", "pipelines", "tools"]
-classifiers=[
-    "Development Status :: 1 - Planning",
-    "Environment :: Console",
-    "Intended Audience :: Developers",
-    "Programming Language :: Python",
-    "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: The Unlicense (Unlicense)",
-    "Programming Language :: Python :: 3.10",
-    "Topic :: Utilities",
-    "Topic :: Software Development",
-]
-authors = [
-  {name = "Marc Page", email = "marcallenpage@gmail.com"},
-]
-[project.scripts]
-settings = "devopsdriver.manage_settings:main"
-[tool.setuptools.package-data]
-"*" = ["*.mako"]
-[tool.setuptools.packages.find]
-include = ["devopsdriver*"]
-[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"
-Repository = "https://github.com/marcpage/devops-driver.git"
-Issues = "https://github.com/marcpage/devops-driver/issues"
-Changelog = "https://github.com/marcpage/devops-driver/releases"
-[tool.setuptools.dynamic]
-version = {attr = "devopsdriver.__version__"}
-[build-system]
-requires = ["setuptools >= 69.2"]
-build-backend = "setuptools.build_meta"