Merge branch 'hw-script' into 'main'

During this course you will learn unique benefits and concepts of Git as well

as its core features via extensive examples, hands-on exercises and mandatory

homework. The emphasis of the course is to prepare you for working on group

community upstream projects in enterprise. 

community upstream projects in enterprise. We want you to experience what it's

like to work on a Git project where multiple people contribute: this is what we

experience in our jobs every day.

## Lectors

* Irina Gulina (Senior Software Quality Engineer)

Research: Mastering Git with university

students](https://research.redhat.com/blog/2023/02/28/mastering-git-with-university-students/)

And another interview with students:

[Intern Spotlight: Red Hat course helps students unleash the power of Git]

(https://research.redhat.com/blog/2023/09/11/intern-spotlight-red-hat-course-helps-students-unleash-the-power-of-git/)

## Next run

Autumn 2023 at FI MUNI Brno as part of PV177 Laboratory of Advanced Network Technologies

This would be the second run. The first one happened in Autumn 2022.

**IS course info**: https://is.muni.cz/predmet/fi/podzim2023/PV177  

**Lecture time**: TBD  

**Lecture time**: Group 1 10:00-11:40, Group 2 12:00-13:40

**Lecture room**: FI MU S505 Red Hat lab at Faculty of Informatics, Masaryk University (S505, note that the room is only available during lecture time)  

**Grading**: successfully complete 5/6 mandatory homeworks  

**ECTS Credits**: 2  

* Understand basic Computer Science concepts.

* Linux-based operating system is a big plus. You may get bonus points for Fedora Linux 😇

## Homeworks

### Requirements after first class

* Fork this repository

* Upload SSH keys to your account

* Comment your UCO in an issue in this repo for your respective group:

  0. https://gitlab.com/redhat/research/mastering-git/-/issues/2

  1. https://gitlab.com/redhat/research/mastering-git/-/issues/3

### Class 2 homework

* Create a merge request for this repo

* It has to come from your fork, and **not** from the main branch

* Feel free to improve some text, reword something, fix a typo, fix a bug in the homework check script (💰)

* Otherwise give us feedback inside session2_feedback/

  * Create a new file `<UCO>.txt`

* MR doesn't need to be merged to pass this homework

### Class 3 homework

We're gonna create some more MRs!

* [prep] we need to create up front some content that is not valid so people can fix it

* Find a pair & review each others contributions

* There needs to be at least a single interaction: explanation, clarification, request for changes

## Sylabus

(This will be polished during summer 2023 and will include materials)

#!/usr/bin/python3

"""

Homework check script.

Is it a good idea to make it open?

"""

import os

import sys

import ogr

from ogr.abstract import PRStatus

from ogr.exceptions import GitlabAPIException

class Homework:

    pass

class Item:

    def __init__(self, gitlab_service: ogr.GitlabService,  username: str):

        self.gitlab_service = gitlab_service

        self.username = username

        self.project = gitlab_service.get_project(namespace="redhat/research", repo="mastering-git")

class HasForkedMainRepo(Item):

    def check(self):

        try:

            # this doesn't do any calls yet

            fork = self.gitlab_service.get_project(repo="mastering-git", namespace=self.username)

            # this does

            fork.get_branches()

        except GitlabAPIException:

            return False

        else:

            return True

class HasPubkey(Item):

    def check(self):

        user = self.gitlab_service.gitlab_instance.users.list(username=self.username)[0]

        try:

            keys = user.keys.list()

            print(keys)

        except GitlabAPIException:

            return False

        else:

            return bool(keys)

class MRExists(Item):

    def check(self):

        prs = self.project.get_pr_list(PRStatus.all)

        for pr in prs:

            if pr.author == self.username:

                if pr.source_branch == 'main':

                    # we could halt here but there may be more MRs

                    # anyway, the request is to send the MR NOT from main

                    continue

                return True

        return False

class Homework1(Homework):

    items = (HasForkedMainRepo, HasPubkey)

class Homework2(Homework):

    items = (MRExists, )

def check_one(gitlab_username: str):

    gl = ogr.GitlabService(token=os.environ["GITLAB_TOKEN"])

    for HWKls in (Homework1, Homework2):

        for ItKls in HWKls.items:

            item = ItKls(gl, gitlab_username)

            print(f"{item.__class__.__name__}: {item.check()}")

# TODO: run for all course participants

if __name__ == '__main__':

    sys.exit(check_one(sys.argv[1]))

ogr

It's so hard to organize and deliver a University course, I learnt so much from this experience.