Skip to content

Latest commit

 

History

History
91 lines (61 loc) · 2.49 KB

README.md

File metadata and controls

91 lines (61 loc) · 2.49 KB
Raw

Tool Scrapper

What it does

This scraper tools goes through github Organizations and gets the repositories and their topics and outputs them in a formathe that the UI can display.

NOTE: This whole process is manual and not interative wiht the UI, to be able to see the changes you want you need to run this scrapper to update wht the UI shows.

Step by Step

  1. The scraper requires a GitHub read-only oauth token as environment variable GITHUB_AUTH_TOKEN
  2. The scraper will read the organizations.json file in the public folder
  3. It will also configure what to ignore bassed on ignored-repositories.json and ignored-topics.json files in public folder
  4. It will loop through all organizations and all repositories to generate the structure the UI needs to display the data.

JSON example:

{
  "repos": [
    {
      "org": "redhat-performance",
      "name": "aimlperf_reg_tests",
      "description": "",
      "url": "https://github.com/redhat-performance/aimlperf_reg_tests",
      "labels": []
    }
  ]
}

Building and Running

First

go mod download

To build:

go build main.go

To run:

go run main.go

Configuration

To configure the tool add the dessired Organizations and Filters you want to apply.

Organizations

The organizations.json file is a simple JSON string array. Add or remove organizations as you need.

Example

["cloud-bulldozer", "redhat-performance"]

Ignore Repositories

The ignored-repositories.json file has a format of an Organization key with a string array to input the names of the repositories you want to ignore.

Example

{
  "cloud-bulldozer": [
    ".github"
  ],
  "redhat-performance": [
    "cloud-governance"
  ]
}

At the moment there is not a way to ignore a repository name globably.

Ignore Topics

The ignored-topics.json file is the same format as the Organizations file, a JSON string array, add topics that you want to ignore from your results.

Example

["topic-one", "topic-two"]

Applying changes

To persist your changes for the moment the config files are being commited. If you add new ignore rules or new organizations make sure to run the scraper to get the latest repository list in this repo, and then commit all files.