Building a Go RESTful API with design-first OpenAPI contracts (6 mins read).
How to use oapi-codegen to generate an RESTful API using design-first OpenAPI and code generation.
Kind articles
Week Notes 22#27 (3 mins read).
What happened in the week of 2022-07-04?
by 
Jamie Tanna
.
#week-notes.
Pointing to a fork of a Go module (1 mins read).
How to pin your Go modules to a given fork of a repository.
by Jamie Tanna
.
#blogumentation
#go.
Week Notes 22#26 (3 mins read).
What happened in the week of 2022-06-27?
by Jamie Tanna
.
#week-notes.
Running Go tests in Parallel (2 mins read).
How to get Go tests to run in parallel for speed.
Ignoring slow-running tests in Go (1 mins read).
How to use Go's -short testing mode to avoid running slower tests.
Shipping services more quickly with design-first OpenAPI contracts (8 mins read).
How using OpenAPI has led to being able to ship a new service more effectively, by removing the need to write scaffolding, and instead focus on the business logic.
by Jamie Tanna
.
#deliveroo
#openapi
#go
#api.
Week Notes 22#25 (2 mins read).
What happened in the week of 2022-06-20?
by Jamie Tanna
.
#week-notes.
Automating boilerplate/scaffolding code with custom code generation in Go (4 mins read).
How to use Go's code generation tooling to add custom code generation to your project.
by Jamie Tanna
.
#blogumentation
#go.
Describing a multi-value querystring parameter in OpenAPI (1 mins read).
How to define a querystring parameter that has multiple values, in OpenAPI.
Stubbing out the Go http.Client to test an HTTP HandlerFunc (2 mins read).
How to write a unit test to validate your router's HTTP handlers work, by stubbing out the http.Client implementation.
by Jamie Tanna
.
#blogumentation
#go.
Week Notes 22#24 (3 mins read).
What happened in the week of 2022-06-13?
by Jamie Tanna
.
#week-notes.
Automagically determining feeds provided for a given URL on the command-line (1 mins read).
Creating a command-line application to discover feeds for a given URL.
by Jamie Tanna
.
#go
#rss
#feed
#slack.
Managing your Go tool versions with go.mod and a tools.go (3 mins read).
Better dependency management for your tools and without needing to go install the tools before executing them.
by Jamie Tanna
.
#blogumentation
#go.
Week Notes 22#23 (4 mins read).
What happened in the week of 2022-06-06?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#22 (4 mins read).
What happened in the week of 2022-05-30?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#21 (2 mins read).
What happened in the week of 2022-05-23?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#20 (2 mins read).
What happened in the week of 2022-05-16?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#19 (5 mins read).
What happened in the week of 2022-05-09?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#18 (3 mins read).
What happened in the week of 2022-05-02?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#17 (5 mins read).
What happened in the week of 2022-04-25?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#16 (3 mins read).
What happened in the week of 2022-04-18?
by Jamie Tanna
.
#week-notes.
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.
Week Notes 22#15 (4 mins read).
What happened in the week of 2022-04-11?
by Jamie Tanna
.
#week-notes.
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.