you can add an if key to a job to conditionally run jobs. you also have a lot of metadata available in github actions regarding the event that triggered it and the repo it is on.
put together you can add a condition like:
alias uvr = "uv run"i just set up a new alias to save some time when using uv
because uv supports running scripts with dependencies declared in inline metadata and typer can turn any function into a cli you can put both of them together and build some really powerful small utilities. all you need is to define a function and wrap it in typer.run() in a script with typer as a dependency in the inline metadata.
after some iterations, this is the final script (so far):
# /// script
# dependencies = [
# "typer",
# "rich",
# "pyyaml",
# ]
# ///
import json
import re
from datetime import datetime
from pathlib import Path
from zoneinfo import ZoneInfo
import typer
import yaml
from rich import print
from typing_extensions import Annotated
def generate_post_from_issue(
issue_title: Annotated[str, typer.Option("--title", "-t")],
issue_body: Annotated[str, typer.Option("--body", "-b")],
issue_labels: Annotated[str, typer.Option("--labels", "-l")],
issue_created_at: Annotated[str, typer.Option("--created-at", "-c")],
base_dir: Annotated[str, typer.Option("--base-dir", "-d")] = "blog/posts",
):
# Convert labels to a list of tags
tags = [label["name"] for label in json.loads(issue_labels)]
# Convert ISSUE_CREATED_AT to PST and format as YYYY-MM-DD
utc_time = datetime.strptime(issue_created_at, "%Y-%m-%dT%H:%M:%SZ")
pst_time = utc_time.astimezone(ZoneInfo("America/Los_Angeles"))
created_at_pst = pst_time.date()
# Extract the category from the part of the title before the first colon, default to "project" if none
category = (
issue_title.split(":")[0].strip().lower() if ":" in issue_title else "project"
)
# Extract the title content after the first colon
title = (
issue_title.split(":", 1)[1].strip()
if ":" in issue_title
else issue_title.strip()
)
# Determine directory based on category
dir_path = Path(base_dir) / ("til" if category == "til" else "")
dir_path.mkdir(parents=True, exist_ok=True)
# Generate a slugified version of the title for the filename
slug = re.sub(r"[^a-z0-9]+", "-", title.lower()).strip("-")
# Create the front matter dictionary
front_matter = {
"title": title,
"date": created_at_pst,
"categories": [category],
"tags": tags,
}
# Prepare YAML front matter and issue body
yaml_front_matter = yaml.dump(front_matter, default_flow_style=False)
content = f"---\n{yaml_front_matter}---\n\n{issue_body}"
# Define filename
filename = dir_path / f"{slug}.md"
# Write content to file
filename.write_text(content, encoding="utf-8")
print(f"Markdown file created: {filename}")
if __name__ == "__main__":
typer.run(generate_post_from_issue)
feels like a micro-package.
you can automate creating a new markdown file in a directory in your repo with front matter metadata from github issues. you can then create a pull request to deploy those changes to your main branch. my plan is to use this to capture more ideas on the go (on my phone).
name: Create Post from Issue
permissions:
contents: write
pull-requests: write
on:
issues:
types: [opened]
jobs:
create-post:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Generate Post from Issue
env:
ISSUE_NUMBER: ${{ github.event.issue.number }}
ISSUE_TITLE: ${{ github.event.issue.title }}
ISSUE_BODY: ${{ github.event.issue.body }}
ISSUE_LABELS: ${{ toJson(github.event.issue.labels) }}
ISSUE_CREATED_AT: ${{ github.event.issue.created_at }}
run: |
# Convert labels to a list of tags
TAGS=$(echo $ISSUE_LABELS | jq -r '.[] | .name' | paste -sd, -)
# Convert ISSUE_CREATED_AT to PST and format as YYYY-MM-DD
CREATED_AT_PST=$(TZ="America/Los_Angeles" date -d "${ISSUE_CREATED_AT}" +"%Y-%m-%d")
# Extract the category from the part of the title before the first colon, default to "project" if none
CATEGORY=$(echo "$ISSUE_TITLE" | awk -F: '{print $1}' | tr -d '[:space:]' | tr '[:upper:]' '[:lower:]')
if [ -z "$CATEGORY" ]; then
CATEGORY="project"
fi
# Extract the title content after the first colon
TITLE=$(echo "$ISSUE_TITLE" | sed 's/^[^:]*: *//')
# Determine directory based on category
if [ "$CATEGORY" = "til" ]; then
DIR="blog/posts/til"
else
DIR="blog/posts"
fi
echo $DIR >> $GITHUB_STEP_SUMMARY
echo $CATEGORY >> $GITHUB_STEP_SUMMARY
# Generate a slugified version of the title for the filename
SLUG=$(echo "$TITLE" | tr '[:upper:]' '[:lower:]' | tr -cs '[:alnum:]' '-' | sed 's/^-//;s/-$//')
echo $SLUG >> $GITHUB_STEP_SUMMARY
# Create the front matter with category, tags, and formatted date
FRONT_MATTER="---\ntitle: \"$TITLE\"\ndate: ${CREATED_AT_PST}\ncategories: [${CATEGORY}]\ntags: [${TAGS}]\n---"
# Prepare content for markdown file
CONTENT="$FRONT_MATTER\n\n$ISSUE_BODY"
# Save the content to a markdown file
FILENAME="${DIR}/${SLUG}.md"
echo $FILENAME >> $GITHUB_STEP_SUMMARY
echo -e "$CONTENT" > "$FILENAME"
- name: Commit and push changes
env:
ISSUE_TITLE: ${{ github.event.issue.title }}
ISSUE_NUMBER: ${{ github.event.issue.number }}
GH_TOKEN: ${{ github.token }}
run: |
git config --local user.name "github-actions[bot]"
git config --local user.email "github-actions[bot]@users.noreply.github.com"
git checkout -b add-post-$ISSUE_NUMBER
git add .
git commit -m "Add post for Issue: $ISSUE_TITLE"
git push -u origin add-post-$ISSUE_NUMBER
gh pr create --title "#$ISSUE_NUMBER - $ISSUE_TITLE" --body "Adding new post. Closes #$ISSUE_NUMBER"
you can configure your VPS / server to be able to run sudo commands without being asked for your password. you just need to create a sudoers file.
first you have to create sudoers file
when i asked chatgpt for this i found you can just run
sudo visudoand it’ll open the sudoers file.
now, let’s say you have a user app that you want to be able to run apt update and apt upgrade without asking for sudo password. you need to add this line to your sudoers file
app - the username on the system ALL=(ALL) - this means this rule to all hosts and allows acting as any userNOPASSWD - no password/usr/bin/apt update - you must pass the full path for the commands you want to run without a password.