{"id":19340055,"url":"https://github.com/damienaicheh/azdevops-cli","last_synced_at":"2025-04-23T02:31:09.991Z","repository":{"id":63667936,"uuid":"566213528","full_name":"damienaicheh/azdevops-cli","owner":"damienaicheh","description":null,"archived":false,"fork":false,"pushed_at":"2023-03-07T08:52:25.000Z","size":161,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-15T18:49:37.374Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/damienaicheh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-15T07:45:53.000Z","updated_at":"2023-01-06T08:48:09.000Z","dependencies_parsed_at":"2024-11-10T03:25:12.214Z","dependency_job_id":"d8bf698e-1b64-4662-9fa7-5c6155e29cf7","html_url":"https://github.com/damienaicheh/azdevops-cli","commit_stats":{"total_commits":16,"total_committers":3,"mean_commits":5.333333333333333,"dds":0.375,"last_synced_commit":"9f930fee831d58100369106a1381afcf44eccfd4"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damienaicheh%2Fazdevops-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damienaicheh%2Fazdevops-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damienaicheh%2Fazdevops-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damienaicheh%2Fazdevops-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/damienaicheh","download_url":"https://codeload.github.com/damienaicheh/azdevops-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250357599,"owners_count":21417310,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T03:24:47.477Z","updated_at":"2025-04-23T02:31:09.696Z","avatar_url":"https://github.com/damienaicheh.png","language":"Python","readme":"# AzDevOps CLI\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/gwendallg/rsql4net/blob/develop/LICENSE) [![Pypi](https://img.shields.io/pypi/v/PACKAGE?label=azdevops-cli)]()\n\n## I.Continuous integration\n\n| Branch  | Build                                                                                                                                                                                                                                        | Quality Gate |\n| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |\n| main    | [![Build Status](https://dev.azure.com/damienaicheh0990/azdevops-cli/_apis/build/status/damienaicheh.azdevops-cli?branchName=main)](https://dev.azure.com/damienaicheh0990/azdevops-cli/_build/latest?definitionId=95\u0026branchName=main)       |              |\n| develop | [![Build Status](https://dev.azure.com/damienaicheh0990/azdevops-cli/_apis/build/status/damienaicheh.azdevops-cli?branchName=develop)](https://dev.azure.com/damienaicheh0990/azdevops-cli/_build/latest?definitionId=95\u0026branchName=develop) |              |\n\n## II.Introduction\n\nThis project is used to update all selected repositories in one single script define by a `config.yml` file.\nThe python script will automatically clone the repositories, modify it and propose a pull request on each repository inside Azure DevOps.\n\n## III. Getting Started\n\nCreate a dev environment for the project:\n\n```sh\npython3 -m venv .venv\n```\n\nActivate the dev environment for Linux:\n\n```sh\nsource .venv/bin/activate\n```\n\nActivate the dev environment for Windows:\n\n```sh\n.\\.venv\\Scripts\\activate\n```\n\nInstall python packages for the project:\n```sh\npip install -r requirements.txt\n```\n\nSave the packages used in the project into the `requirements.txt`:\n```sh\npip freeze \u003e requirements.txt\n```\n\nExport credentials as environment variable to be able to run the API calls:\n```\nexport AZDEVOPS_ORGANIZATION_URL='\u003cyour_azure_devops_organisation_url\u003e'\nexport AZDEVOPS_PAT_TOKEN='\u003cyour_pat\u003e'\n```\n\n## IV - Models generation\n\nTransform the `config.yml` into json with this website for instance:\nhttps://jsonformatter.org/yaml-to-json\n\nThen copy the generated json and paste it inside this other website:\nhttps://app.quicktype.io/\n\nChoose default settings with the Python language.\n\n## V - Install locally for testing only\n\n```\npython3 -m pip install --editable .\n```\n\n## VI - Run the CLI\n\n```\nazdevops repo-updater run --configuration-file \u003cpath-to\u003e/config.yml -o \u003coutput-path\u003e\n```\n\n```\nazdevops release-manager changelog -p \u003cyour-project-path\u003e -o \u003coutput-path\u003e\n```\n\n## VII - Unit tests\n\n### Run unit tests:\n\n```\npython3 -m unittest\n```\n\nor\n\n```\ncoverage run -m unittest discover\n```\n\n### Generate covrage locally\n\n```\ncoverage report\n```\n\n### Generate a changelog\n\n```\nazdevops release-manager changelog (-p \u003cproject-path\u003e) (-o \u003coutput\u003e)\n```\n\nUsing Docker:\n\n```shell\ndocker run -v $(Build.SourcesDirectory):/app \\ \n           -t aichehda/azdevops-cli:latest \\\n                   release-manager changelog \\\n                   (-p \u003cproject-path\u003e) \\\n                   (-o \u003coutput\u003e) \\\n```\n\n### Generate a summary\n\n```\nazdevops release-manager summary -pn \u003cproject-name\u003e (-r \u003cregex\u003e)\n```\n\nazdevops release-manager summary -pn 'MyProject' -r '^digital(.*)_apply' \n\nUsing Docker:\n\n```shell\ndocker run -v $(Build.SourcesDirectory):/app \\ \n           -e AZDEVOPS_ORGANIZATION_URL=$AZDEVOPS_ORGANIZATION_URL \\\n           -e AZDEVOPS_PAT_TOKEN=$AZDEVOPS_PAT_TOKEN \\\n           -t aichehda/azdevops-cli:latest \\\n                   release-manager summary \\\n                   -r '^digital(.*)_apply' \\\n                   -pn MyProject \\\n                   (-p \u003cproject-path\u003e) \\\n                   (-o \u003coutput\u003e) \\\n```\n\n### Generate manifest\n\n```\nazdevops release-manager manifest -an \u003capplication-name\u003e\n```\n\nUsing Docker on Azure DevOps:\n\n```shell\ndocker run  -v $(Build.SourcesDirectory):/app \\\n                -e BUILD_DEFINITIONNAME=$BUILD_DEFINITIONNAME \\\n                -e BUILD_BUILDID=$BUILD_BUILDID \\\n                -e BUILD_BUILDNUMBER=$BUILD_BUILDNUMBER \\\n                -e BUILD_SOURCEBRANCHNAME=$BUILD_SOURCEBRANCHNAME \\\n                -e BUILD_REPOSITORY_NAME=$BUILD_REPOSITORY_NAME \\\n                -t aichehda/azdevops-cli:latest \\\n                        release-manager manifest \\\n                        -an my_app\n                        (-p \u003cproject-path\u003e) \\\n                        (-o \u003coutput\u003e) \\\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdamienaicheh%2Fazdevops-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdamienaicheh%2Fazdevops-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdamienaicheh%2Fazdevops-cli/lists"}