blog.nshephard.dev

Author

Neil Shephard

Categories

All (27)

R (3)

amend (1)

analysis (5)

bash (2)

blame (1)

browser (1)

ci (1)

code (7)

data analysis (1)

data science (1)

documentation (3)

domain (1)

dotfiles (1)

emacs (1)

extensions (1)

firefox (1)

fixup (1)

git (11)

github (9)

github actions (3)

gitlab (9)

gpx (1)

hiking (1)

holiday (1)

keychain (1)

linting (5)

linux (1)

literate programming (1)

matplotlib (1)

opera (1)

packaging (3)

pennine way (1)

pre-commit (6)

pypi (1)

pytest (3)

pytest-mpl (1)

python (10)

quarto (5)

running (1)

scientific python (1)

setuptools (1)

sphinx (1)

ssh (1)

statistics (2)

testing (3)

virtual environments (2)

vivaldi (1)

website (1)

worktrees (1)

Quarto Custom domain on GitHub Pages

quarto

github

website

domain

This blog is published using the excellent Quarto framework to GitHub Pages which offers free website hosting. However, astute readers familiar with this sort of setup will…

Pytest Matplotlib

python

testing

pytest

matplotlib

pytest-mpl

Pytest is an excellent framework for writing tests in Python. Sometimes the code you want to test will generate images using Matplotlib or related libraries based around it…

Pennine Way 2024

holiday

hiking

pennine way

gpx

statistics

This summer I decided to hike the iconic Pennine Way a 431 kilometre (261 miles) national trail stretching between Kirk Yetholm in the North and Edale in the South.…

virtualenvwrapper hooks

python

virtual environments

bash

dotfiles

I’ve written previously about virtualenvwrapper which I use to manage my Python Virtual Environments and mentioned the possibility of using hooks but didn’t go into detail.

Pytest Fail and Skip

python

testing

pytest

Pytest is an excellent framework for writing tests in Python. Sometimes tests don’t pass though and you might want to mark them as failing or skip them.

Git - Worktrees

git

worktrees

A common task in Git workflow is the need to switch/checkout branches and check work that has been done on another branch, running tests, perhaps contributing to code that…

Git - Making Amends and Fixing things up

git

amend

fixup

Git is the world’s most popular version control software out there at the moment and if you write code and version control it the chances are you are using it. It’s a…

Git Remotes Revisited

git

github

gitlab

I’ve written before about Git Remotes but in my on-going effort to improve my understanding of the tools I use daily I’ve discovered that it is possible to have a single remo…

Pytest Parameterisation

python

testing

pytest

Pytest is an excellent framework for writing tests in Python. One of the neat features it includes is the ability to parameterise your tests which means you can write one…

virtualenvwrapper

python

virtual environments

If you use Python heavily you will likely be familiar with Virtual Environments. These provide isolated installs of specific packages that take precedence over any packages…

Repository Review with Scientific Python

pre-commit

packaging

scientific python

python

I’ve written before about Python Packaging and pre-commit which I’m a big fan of. Today I discovered a really useful tool for checking your packaging configuration and…

R Resources

R

documentation

data science

statistics

data analysis

R is a statistical programming languages and one of the most popular languages for data analysis, statistics and plotting in academia and industry. Learning a new language…

Git Remotes

git

github

gitlab

Git and various forges such as GitHub GitLab are useful collaborative tools for version controlling, sharing and working collaboratively. Normally a repository resides on…

GitLab CI - Automatic Publishing to PyPI

python

documentation

packaging

gitlab

ci

I’ve written previously on Python Packaging and in that article included details of how to automate publishing to PyPI from GitHub. This article details how to automatically…

Pre-commit and R Packaging

quarto

R

git

pre-commit

github actions

This post is aimed at getting you up and running with the R precommit Package. This shouldn’t be confused with the Python pre-commit Package although as you might suspect…

Pre-Commit : Useful Hooks

code

analysis

linting

git

github

gitlab

pre-commit

I’m a big fan of pre-commit and have written about it before (see posts on pre-commit, pre-commit CI and pre-commit updating). This post discusses some of the hooks that I…

Sphinx Documentation

quarto

python

documentation

sphinx

github actions

How to generate documentation websites for your Python package using Sphinx, including generating API documentation automatically, build multiple versions across releases…

Python Packaging

quarto

python

packaging

setuptools

github actions

pypi

This post describes steps in creating a Python package. If you are looking for information on installing packages this is done using Python PIP.

Browser Extensions

browser

firefox

opera

vivaldi

extensions

Most people use web-browsers a fair bit. There are a number of extensions available which make their use more stream-lined and efficient. This post covers those that I use.…

Pre-Commit.ci : Integrating Pre-Commit into CI/CD

code

analysis

linting

git

github

gitlab

pre-commit

NB If you’ve not read it already I would recommend reading my previous post on using pre-commit as the contents described herein assume that you are already using pre-commit …

Running in 2022

quarto

running

emacs

literate programming

I started running 🏃 in 2019. It never used to appeal but I wanted to get more regular exercise easily from my doorstep as despite commuting by bike for most of my life and…

Who’s to Blame

code

analysis

git

github

gitlab

blame

Git blame shows who made changes to which line of code for a given point in its history.

Pre-Commit : Customising and Updating

code

analysis

linting

git

github

gitlab

pre-commit

Pre-commit is a tool for running hooks prior to making commits to your Git history. If you’re not familiar with it then you may want to read the earlier post Pre-Commit …

Linux Command Line Alternatives

code

linux

bash

The command line is my second home when sat at a computer (Emacs is my first ;-) and the UNIX Philosophy is the key to the huge amount of highly productive tools that are…

Git : Custom SSH credentials for git repositories

ssh

git

github

gitlab

keychain

How to configure individual Git repositories to use specific SSH keys. This is useful if you have more than one account on a forge, for example a personal and work account.

Pre-Commit : Protecting your future self

code

analysis

linting

git

github

gitlab

pre-commit

Pre-commit is a powerful tool for executing a range of hooks prior to making commits to your Git history. This is useful because it means you can automatically run a range…

Linting - What is all the fluff about?

code

linting

python

R

NB This article originally appeared on RSE University of Sheffield but is updated here.