ahgraber

Git cheatsheet & reminders

Add existing repo to local file structure

# at destination folder:
git init
git remote add origin <git repo https url>

ahgraber

Conda cheatsheet and reminders

Installation

Install miniconda

Mamba

mamba is a faster, drop-in replacement for conda. You can swap almost all commands between conda & mamba...

ahgraber

Python

Learn Python

• https://marko-knoebl.github.io/slides/#python
• Automate Boring Stuff

Pandas

• Minimally Sufficient Pandas
• Advanced Pandas

Matplotlib

ahgraber

Ref: https://docs.github.com/en/github-ae@latest/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent

# generate key
ssh-keygen -t rsa -b 4096 -C "<your_email@example.com>"

# ensure ssh agent is running
eval "$(ssh-agent -s)"

# add key to agent

ahgraber

GOAL: Keep secrets out of plaintext (esp when syncing dockerfile and docker-compose.yaml to repo)

1. Each secret needs to be a single text file with a clear name
2. Edit docker-entrypoint.sh to run per environmental variable
3. (Re)Build docker image with docker-entrypoint.sh as entrypoint
4. Create secrets in docker-compose
5. Call secrets with "_FILE" appended to the name when specifying environmental variable

secret-init.sh:

ahgraber

Logging with Python

Standards

• Prefer logs to print statements
• Logging objects should be named logger
• Refer to boilerplate(s) below for add'l details

Basic logging setup

ahgraber

import os

def isdrive(path):
    """Return `True` if path is the drive root

    Parameters
    ----------
    path : path-like
    """
    path = os.path.abspath(path)

ahgraber

Working with Apple arm64 architecture

For most applications, native vs. emulated modes do not need to be user-managed. However, for development purposes, managing the entire stack's architecture may become necessary.

Emulated terminal environment

For an x86 (Rosetta-emulated) environment, create an emulated Terminal.app:

1. Open Finder

ahgraber

Creating / Managing conda envs

Rules / SOPs:

1. Don't work in base environment
2. Use mamba as a solver
3. Create default environments with pinned packages, and clone / update the default envs as needed

• Creating / Managing conda envs
  • Create a new env

ahgraber

Lint and Format

• Lint and Format
  • Python
    • Installation
    • Lint with ruff
    • Autoformat with black
  • Other file formats
    • Markdown with markdownlint
• YAML (and JSON) with prettier