Skip to content
box

GitHub Action

Universities and college search in different countries

v1 Latest version

Universities and college search in different countries

box

Universities and college search in different countries

Search country and print universities

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Universities and college search in different countries

uses: bryantson/universities-list-actions@v1

Learn more about this action in bryantson/universities-list-actions

Choose a version

Search for universities and colleges in a country

This fun and useful GitHub Actions plugin lets you search for colleges and universities in a country. Thank you Hipolabs for providing free API endpoint: http://universities.hipolabs.com/search?country=

How to run?

This Actions only take one single input value country, which can be a word separate a single space (e.g. United States). Below shows an example of a GitHub Actions pipeline file named main.yml that can be put under .github/workflows folder to execute.

name: Test custom GitHub Action

on:
  workflow_dispatch:
    inputs:
      country:
        description: Please type in name of country.
        required: true
        default: 'United States'

jobs:
  university_search_job:
    runs-on: ubuntu-latest
    name: A job to search by university
    steps:
      - name: Checkout files
        uses: actions/checkout@v2
        
      - name: University search
        uses: bryantson/universities-list-actions@v1
        id: search-university
        with:
          country: ${{ github.event.inputs.country }}

What output looks like?

Everything gets printed inside a GitHub log. You can find university/college names sorted alphabetically in ascending order and their associated website links. A screenshot below shows a sample output.

Sample output

You can also print total number of univerisites with total output. For example, you can add a print statement in a step like this in your Actions workflow to print that number.

- name: University search
  uses: bryantson/universities-list-actions@v1
  id: search-university
  with:
    country: ${{ github.event.inputs.country }}

- name: Get the output total
  run: echo "The total number of universities is ${{ steps.search-university.outputs.total }}"

How to contribute?

As this is a simple GitHub Actions based on a public API, feel free to fork and to modify based on MIT license :)

License

MIT @ bryantson