DEVOPS-64 add-all-github-organization-repos-to-a-github-team initial commit

Author: githubofkrishnadhas

.github/dependabot.yml

@@ -0,0 +1,29 @@
+version: 2
+updates:
+- package-ecosystem: "pip"
+  directory: /
+  schedule:
+    interval: weekly
+  # Assignees to set on pull requests
+  assignees:
+  - "githubofkrishnadhas"
+  # prefix specifies a prefix for all commit messages. When you specify a prefix for commit messages,
+  # GitHub will automatically add a colon between the defined prefix and the commit message provided the
+  # defined prefix ends with a letter, number, closing parenthesis, or closing bracket.
+  commit-message:
+    prefix: "dependabot python package"
+  # Use reviewers to specify individual reviewers or teams of reviewers for all pull requests raised for a package manager.
+#  reviewers:
+#  - "devwithkrishna/admin"
+  # Raise pull requests for version updates to pip against the `main` branch
+  target-branch: "main"
+  # Labels on pull requests for version updates only
+  labels:
+  - "pip"
+  - "dependancies"
+  # Increase the version requirements for Composer only when required
+  versioning-strategy: increase-if-necessary
+  # Dependabot opens a maximum of five pull requests for version updates. Once there are five open pull requests from Dependabot,
+  # Dependabot will not open any new requests until some of those open requests are merged or closed.
+  # Use open-pull-requests-limit to change this limit.
+  open-pull-requests-limit: 10

.github/workflows/add-all-github-organization-repos-to-a-github-team.yaml

@@ -0,0 +1,46 @@
+name: add-all-github-organization-repos-to-a-github-team
+on:
+  workflow_dispatch:
+    inputs:
+      organization:
+        description: 'GitHub organization name'
+        type: string
+        required: true
+      github_team_name:
+        description: 'GithHub team name'
+        type: string
+        required: true
+      permission:
+        required: true
+        description: 'Permissions for Github teams across repository'
+        type: choice
+        options:
+          - admin
+          - push
+          - pull
+          - triage
+          - maintain
+
+jobs:
+  add-all-github-organization-repos-to-a-github-team:
+    runs-on: ubuntu-latest
+    env:
+      GH_TOKEN: ${{ secrets.DEVWITHKRISHNA_PERSONAL_ACCESS_TOKEN }}
+    steps:
+      - name: Git checkout
+        uses: actions/checkout@v4
+      - name: set up python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+      - name: Pipenv venv installation
+        run: |
+          pip install pipenv 
+          pipenv install --skip-lock
+      - name: Execute python program
+        run: |
+          pipenv run python3 add_repos_to_gh_teams.py --organization ${{ inputs.organization }} \
+          --github_team_name ${{ inputs.github_team_name }} --permission ${{ inputs.permission }}
+      - name: program execution completed
+        run: echo "program execution completed"
+

.gitignore

@@ -157,4 +157,4 @@ cython_debug/
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+.idea/

Pipfile

@@ -0,0 +1,13 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+requests = "==2.31.0"
+argparse = "=1.4.0"
+python-dotenv = "=1.0.1"
+
+
+[requires]
+python_version = "3"

Pipfile.lock

@@ -1,2 +1,44 @@
 # automation-to-add-all-repos-to-a-github-teams
 GitHub automation to add all repos to a specific team across GitHub org
+
+# use case
+* Security team may need to monitor all repos 
+* core team need to be added as a reviewer for PP's, so they need to add the teams to repos
+
+# How code works
+
+* This repository contains code to add all repositories in a github organization to a specific github teams
+
+* Uses Github REST API along with python.
+
+* This will add all repos in organization to the team thats specfied returning 204 status code.
+
+
+## GitHub API Calls
+The program makes several API calls to the GitHub API using the requests module to list repositories, list teams, and add repositories to teams. It uses the Authorization header with a GitHub token (os.getenv('GH_TOKEN')) for authentication.
+
+# Program Inputs
+
+The program requires 3 Inputs which are passed as inputs
+
+* organization --> GitHub Organization name
+* github_team_name --> GithHub team name
+* permission --> Permissions for Github teams across repository `admin`,`push`,`pull`,`maintain`,`triage`
+
+# dot env file
+
+```markdown
+GH_TOKEN="<your github token here>"
+```
+
+# Run code in local
+1. clone the repository to your local
+2. Change directory to the cloned repository
+3. set up the .env file and pass the auth token there.
+4. Run `python3 add_repos_to_gh_teams.py --organization <organization name> --github_team_name <github team name> --permission <permission required>`
+
+
+>[!NOTE]
+> This Program uses Personal Access token for GitHub authentication 
+> On local testing python-dotenv with .env file is used
+> On GitHub Workflow, passed as a environment variable in from GitHub Secrets.