PDS 2024 - Python

Parallel and Distributed Systems primiteves using Python. Created as a part of KMI/PDS 2024 course at UPOL University in Olomouc.

---

General info

This repository serves as a a colaboration space for students selected to present Python as a part of the PDS 2024 course at UPOL University in Olomouc. The main goal is to provide a comprehensive overview of parallel and distributed systems primitives using Python programming language. The repository is divided into several sections, each of which covers a specific topic. The topics are presented in the form of a presentation, code examples, and web-handout.

How do I...?

...view the presentation?

Open the latest release and download the attached pdf file. Alternatively, you can generate the pdf presentation yourself.

...view the code examples?

Navigate to the codes directory in the web-handout and select the desired topic.

...embed code snippets in my presentation?

Open the Carbon Code Visualizer in the browser of your choice. Roughly match the settings to the ones used in the repository. Copy over your code and generate the image.

...generate the pdf presentation?

Make sure you have TeX Live package installed on your system (texlive-latex-base, texlive-latex-recommended, texlive-fonts-recommended, texlive-latex-extra and texlive-lang-czechslovak). Then run the following commands in the root directory of the repository.

  pdflatex -file-line-error -output-directory=presentation presentation/prezentace.tex
  pdflatex -file-line-error -output-directory=presentation presentation/prezentace.tex

That is not a typo, you need to run the command twice to generate the table of contents.

...generate the web-handout?

Firstly make sure to generate markdown from code snippets using provided py2md.sh script.

  ./web-handout/py2md.sh codes/ web-handout/quartz/content/codes/

Then you can proceed with generating the web-handout as a whole. Navigate to the web-handout directory and run the following commands. Make sure you have Node.js installed on your system.

  npm install
  npx quartz build
  # or if you want to serve the web-handout locally
  npx quartz build --serve

...contribute with least effort?

Simply open new pull request with your changes. Make sure to follow the repository structure and naming conventions. The CI/CD pipeline will take care of the rest.

---

Technologies

• Presentation:
  • Latex
  • Beamer
• Code:
  • Python
  • Carbon Code Visualizer
• Web-Handout:
  • Markdown
  • Quartz 4