act demo

A ~15min intro to act for linux or macos

Table of Contents

• Installation
• Requirements
• Demo
  • The fine-memes package
  • Getting started with act
• Links
• Thank you

---

Installation

e.g. via homebrew

brew install act

Recommended: Install GitHub Local Actions

GitHub Local Actions is an extension for act on VS code and it is awesome. This is an optional but highly recommended step.

---

Requirements

A running container!

Below is a quick example of installing and starting a docker engine with colima (see colima-demo for more info ☺️)

Install colima

brew install colima

Install docker

brew install docker

Start up docker

colima start

---

Demo

The fine-memes project

It is a dummy package for our demo that retrieves and displays random meme images from imgflip.com.

Installation

#pip install fine-memes
# For development
poetry install

Usage

# import
from fine_memes import random_meme

# open rando meme 
random_meme(
    notebook=False, #default, set to True if wanting to render in jupyter notebook
)

Add changes

e.g.

• create a copy of the yo function in ./fine_memes/__init__.py
• give this new function a name of your choosing and change the img url
• create a copy of the test_yo test in ./tests/test_fine_memes.py as well

Getting started with act

Now let's see some CI/CD in action

1. Run a job

act -j test

2. Trigger an event

act pull_request

3. Now try running jobs from the GitHub Local Actions

Then if happy with act results then actually trigger the GitHub Actions e.g. make a pull_request

---

Links

• act docs
• act GitHub repo
• GitHub Local Actions extension
• intro to ci/cd
• intro to GitHub Actions

Thank you

Thank you to the above resources, imgflip.com, and for your attention :)