Setting up OpenAPI Contract Tests with a Rails and RSpec codebase (2 mins read).
How to run OpenAPI-driven contract tests against a Rails API.
by 
Jamie Tanna
.
#blogumentation
#ruby
#rails
#openapi
#testing
#contract-testing.
Only testing your public API in a Go package (3 mins read).
How to test only exported parts of a package in Go.
API Design tip: use objects for similar data (1 mins read).
Why you should use objects to nest similar data in JSON responses.
by Jamie Tanna
.
#api.
Idea for Open Source/Startup: monetising the supply chain (2 mins read).
An idea I've had for how to better distribute support to Open Source libraries in the supply chain for your software.
Describing JSON Patch operations with OpenAPI (2 mins read).
How to describe your JSON Patch endpoints using OpenAPI.
Weirdness with git diff-index showing 1 file changed, 0 insertions(+), 0 deletions(-) (1 mins read).
Something weird I hit last week with git diff-index, which shows 1 file changed, but no changes.
Introducing a library for OpenAPI contract testing with Go's net/http package (2 mins read).
Creating a Go library that can verify net/http handlers implement an OpenAPI contract, for use with testing.
Testing Go net/http handlers (1 mins read).
How to write unit tests to validate an HTTP handler.
by Jamie Tanna
.
#blogumentation
#go.
Constructing a serialised YAML string in Ruby (1 mins read).
How to convert a YAML document to a string representation, preserving escaped newlines, with Ruby.
Lessons learned from modernising a lesser maintained (Spring Boot) service (16 mins read).
What I learned from taking ownership of a lesser maintained service and bringing it up to a better standard.
by Jamie Tanna
.
#blogumentation
#spring-boot
#supportability
#incident-management
#production
#capital-one
#technical-leadership.
Getting the fingerprint of a certificate in Go (1 mins read).
How to retrieve an X.509 thumbprint from a remote server, in Go.
Getting the OpenID Connect thumbprint for AWS on the command-line with Go (2 mins read).
How to automagically retrieve an OpenID Connect thumbprint for use with AWS' OpenID Connect federated identity.
by Jamie Tanna
.
#blogumentation
#go
#certificates
#aws
#oidc.
Setting up a Go package structure for a combined library and CLI tool (2 mins read).
How to structure a Go repository to be both a library and command-line tool(s).
by Jamie Tanna
.
#blogumentation
#go.
Parsing AWS ALB/ELB access logs into SQLite (2 mins read).
How to take a set of ALB/ELB logs and convert them to an SQLite database for further processing.
When should I use env to start a command with environment variables? (2 mins read).
When you should use the env command to specify environment variables when executing a command on the command-line (TL;DR: always).
Should I commit generated Go code? (1 mins read).
Answering whether go:generated code should be committed (TL;DR is yes).
by Jamie Tanna
.
#blogumentation
#go.
Lessons learned from the recent job hunt (13 mins read).
A recap of the recent interview process with several companies, what I learned, and what others should know.
by Jamie Tanna
.
#job
#interviewing
#recruitment
#monzo
#starling
#gitpod
#deliveroo
#atom-bank
#compensation
#negotiation
#gov.uk
#cddo.
Installing Nokogiri on an M1 Mac (1 mins read).
How to get Nokogiri building on an M1 Mac, when using Bundler.
by Jamie Tanna
.
#blogumentation
#mac
#ruby.
Determining if there are uncommitted changes in Git (1 mins read).
A one-liner to work out whether there are uncommitted changes in a repository.
Building a fault-tolerant work queue for command-line executions with GNU Parallel (2 mins read).
How to use parallel to create a lightweight work queue of commands, with retry logic and a record of what's been executed.
by Jamie Tanna
.
#blogumentation
#command-line
#gnu-parallel.
Extracting Podcast Addict listening history from the SQLite database (2 mins read).
How to get raw listening history from the Podcast Addict database.
Removing 'smart' quotes from a file, on the command-line (2 mins read).
A one-liner with sed to replace 'smart' quotes with regular quotes.
I'm Joining Deliveroo (2 mins read).
Announcing my move into Deliveroo as a Senior Software Engineer.
by Jamie Tanna
.
#personal
#job
#announcement
#cddo
#deliveroo.
Automagically setting the project version for Go projects in SonarQube (2 mins read).
How to automagically set sonar.projectVersion for Go projects, based on Git tags.
Converting a Byte Array to String from a Node.JS Buffer, in Go (1 mins read).
How to convert an array of bytes to a string using Go.
by Jamie Tanna
.
#blogumentation
#go
#nodejs.
Prefactoring: Preparatory Refactoring (2 mins read).
Why I use prefactoring as a means to perform up-front refactoring for codebases, splitting these into separate PRs/MRs where possible.
by Jamie Tanna
.
#blogumentation
#git
#workflow
#refactoring
#code-review.
Protecting an Architect Framework Application with OAuth2 or OpenID Connect Authentication (4 mins read).
How to set up OAuth2/OpenID Connect authentication with an Architect Framework application.
by Jamie Tanna
.
#blogumentation
#architect-framework
#nodejs
#aws-lambda
#oidc
#indieauth
#oauth2.
Getting node-canvas to run on AWS Lambda (3 mins read).
Some common issues that occur when using node-canvas on AWS Lambda, and how to solve them.
by Jamie Tanna
.
#blogumentation
#javascript
#nodejs
#aws-lambda.
Parsing the Cookie and Set-Cookie headers with Go (2 mins read).
How to parse the value of a Cookie or Set-Cookie header to a JSON object.
by Jamie Tanna
.
#blogumentation
#go
#http.
Generating a Go HTTP Client from OpenAPI schemas (2 mins read).
How to generate a Go HTTP client really quickly and easily, with no manual work, using the oapi-codegen project.
Generating Go structs from OpenAPI schemas (2 mins read).
How to generate Go structs really quickly and easily, with no manual work, using the oapi-codegen project.
Setting up GitLab CI for Go projects (2 mins read).
How to set up a basic set of automated builds for Go projects on GitLab CI, for modern Go projects.
Introducing tiktok-mf2.tanna.dev, for converting TikTok video metadata to Microformats2 (1 mins read).
Announcing a hosted service for converting TikTok metadata to a Microformats2 object.
by Jamie Tanna
.
#tiktok
#tiktok-mf2
#indieweb
#microformats2.
Adding a Non-AWS Hosted Custom Domain to an AWS API Gateway without CloudFront (2 mins read).
How to set up a domain name for AWS API Gateway for a domain that isn't managed through AWS Route 53.
by Jamie Tanna
.
#blogumentation
#aws.
Creating a minimal AWS S3 Bucket Policy for deploying with Hugo via hugo deploy. (1 mins read).
How to configure an AWS S3 Bucket for hugo deploy with the minimal access required for a role to write objects to.
by Jamie Tanna
.
#blogumentation
#aws
#hugo.
Automagically deploying Architect Framework applications to AWS uisng GitLab CI (3 mins read).
How to use GitLab's OpenID Connect support with AWS, to allow deployment using the Architect Framework automagically on GitLab CI.
by Jamie Tanna
.
#blogumentation
#oidc
#architect-framework
#aws
#gitlab
#gitlab-ci.
Avoiding Spring context issues when parallelising @Nested Spring integration tests (3 mins read).
Using abstract base classes to reduce risk of Spring context overall issues with Spring (Boot) integration tests.
by Jamie Tanna
.
#blogumentation
#java
#spring
#spring-boot
#testing
#tdd.
Providing a basic implementation of Ruby's ARGF.read in Go (2 mins read).
Creating a Go helper method to read from stdin or a file, inspired by Ruby's ARGF.read method.
by Jamie Tanna
.
#blogumentation
#go
#ruby.
Integration Testing Your Spring WebClients with Wiremock (4 mins read).
How to write integration tests using Wiremock, for use with WebClients.
by Jamie Tanna
.
#blogumentation
#java
#spring-boot
#testing
#tdd.
Accessing the OpenAPI Specification for a Kubernetes Cluster (1 mins read).
How to get the OpenAPI specification for your Kubernetes Cluster.
Solving ConnectExceptions with the Kubernetes Java ApiClient (1 mins read).
How I solved ConnectExceptions in my Kubernetes Java client usage, by moving to cluster mode.
Automagically Auditing GitHub (Actions) Security using OpenSSF Scorecards (6 mins read).
How to use the OpenSSF Scorecards GitHub Action to audit your GitHub and GitHub Actions configuration, and a breakdown of some of the issues raised by it.
by Jamie Tanna
.
#blogumentation
#github
#github-actions
#security.
Introducing opengraph-mf2 a library, and service opengraph-mf2.tanna.dev, for converting OpenGraph metadata to Microformats2 (3 mins read).
Announcing an NPM package and a hosted service for converting OpenGraph metadata to a Microformats2 object.
by Jamie Tanna
.
#opengraph
#opengraph-mf2
#indieweb
#microformats2.
How to fix Failed to load ApplicationContext in Spring (Boot) applications (6 mins read).
Some common issues with Spring dependency injection and how to fix them.
Converting an x5c from a JSON Web Key to a PEM with Node.JS (1 mins read).
How to convert a JWK's x5c to a PEM-formatted certificate with Node.JS.
by Jamie Tanna
.
#blogumentation
#nodejs
#jwks
#jwk
#certificates
#pem
#x509.
Extracting x5cs from a JSON Web Key Set (JWKS) to PEM files with Node.js (1 mins read).
How to extract the full chain of certificates from a JWKS' x5c parameter to files.
by Jamie Tanna
.
#blogumentation
#nodejs
#jwks
#jwk
#certificates
#pem
#x509.
Generate a running mock server from an OpenAPI specification using Prism (3 mins read).
Using Stoplight's prism tool to run a stubbed server from an OpenAPI specification, for better testing.
Gotcha: checked and unchecked exception handling from Spring WebFlux WebClient (2 mins read).
How checked and unchecked exceptions may appear when testing your WebClient code.
by Jamie Tanna
.
#blogumentation
#spring
#spring-boot
#java
#testing.
Accessing the response body with Spring WebFlux WebClient with onStatus (1 mins read).
How to access the body of an (error) response when using WebClient's onStatus method.
by Jamie Tanna
.
#blogumentation
#spring
#spring-boot
#java.
Running a command on a visual selection in Vim (1 mins read).
How to pipe the text in a visual selection to a command, either to run it, or to replace the text in the seletion.
by Jamie Tanna
.
#blogumentation
#vim
#neovim
#command-line.