Bijlage: GitHub en PyCharm

8. Bijlage: GitHub en PyCharm#

In deze cursus is het verplicht Git te gebruiken. Hiermee houd je online de versies van je software bij. Ook kunnen wij als begeleiders makkelijk met je meekijken en je vorderingen zien. Uiteindelijk moet je een zip-file van je software vanuit GitHub maken en deze inleveren in je Q-highschool portfolio/inleverbakje. Deze handleiding bestaat uit twee delen. Je kunt kiezen om deel 1 te volgen of deel 2 te volgen. Het resultaat van de instructie is bij allebei hetzelfde. In de les gebruiken we deel 1 van de instructie.

  1. Als eerste een repository in Git aanmaken en die koppelen aan PyCharm.

  2. Als eerste een project in PyCharm aanmaken en die koppelen aan je GitHub.

8.1. Wat is GitHub?#

GitHub is een online platform om versies van je software bij te kunnen houden. Het Git-protocol is in 2005 door de bedenker van Linux, Linus Torvalds gepubliceerd. Hij heeft het gemaakt om het samenwerken in een software team en het bijhouden van de verschillende versies van software mogelijk te maken. Ondertussen is het Git-protocol de standaard bij software ontwikkelaars. Bijna alle Open Source projecten hebben een git-repo.

Binnen Git gebeurt alles in een repository of repo. Dit is de plek waar alle bestanden van je project zich bevinden. Met commando’s als git commit -a, git clone of git push kun je in GitHub met meerdere mensen samenwerken aan hetzelfde project. Zonder dat je bestanden op en neer hoeft te mailen of samen te voegen. In deze module werk je volledig in Git.

Waar staan de bestanden? Op de site van GitHub en op je computer. Met git-commando’s kun je ervoor zorgen dat de bestanden op GitHub en op je computer gesynchroniseerd blijven.

8.2. Eerst Git, dan PyCharm#

  1. Als je het nog niet hebt: maak een account aan op GitHub.

  2. Maak een private repository aan. Geef deze een begrijpelijke naam.

  3. Voeg je docenten toe aan je Git-project, zodat we je voortgang kunnen zien en mee kunnen denken. Dit kan bij Instellingen -> Collaborators -> Add people (by username). Voeg hier Pieter van Engelen toe.

  4. Gefeliciteerd, je hebt nu je een Git-repo aangemaakt. Deze ‘leeft’ alleen nog maar op GitHub.

  5. Kijk even rond in je repo.

  6. Klik uiteindelijk op het groene knopje <> Code.

  7. Kopieer de url die daar staat. Die ziet er ongeveer als volgt uit: https://github.com/qhinf/pythonplus_syllabus.git

  8. Het wordt nu tijd om naar PyCharm te gaan.

  9. Mocht je nog projecten geopend hebben, sluit deze allemaal.

  10. Wanneer er geen projecten meer geopend zijn, krijg je drie keuzes. Een nieuw project aanmaken, een oud project openen of ‘Get from VCS’. Kies voor deze laatste optie.

  11. Plak nu de url, die je bij stap 7 gekopieerd hebt in dit veld.

  12. Klik op Ok en de rest gaat vanzelf.

  13. Mogelijk zal PyCharm je nog vragen om de git-tools te installeren. Doe dit.

8.3. Eerst PyCharm, dan Git#

Voor dit deel heb je al een Git-account nodig en heb je ook de git-gereedschappen geïnstalleerd op je laptop.

  1. Maak een nieuw project aan zoals uitgelegd in {doc}`Bijlage_2.

  2. TODO

8.4. Code commit en push#

TODO

Contents