Gotcha: testable examples in Go need an output comment (2 mins read).
Beware that your Go Example tests may not actually be running.
Introducing the tidied tool, to more easily check whether go mod tidy has been run (2 mins read).
Why I've created a command-line application called tidied to check go mod tidy has been run.
by 
Jamie Tanna
.
#go.
Converting HTTP requests to Wiremock stubs, with Go (2 mins read).
How to take an HTTP request and convert it into a Wiremock JSON mapping, on the command-line, in Go.
The first script I write in a new job: gg (2 mins read).
Why writing a script to easily git clone repos is my first step as a new starter.
by Jamie Tanna
.
#automation
#scripting.
Learning a new language, or how I gained familiarity with Go (10 mins read).
How I've eased into a new language, Go, as a Senior Software Engineer, and some initial thoughts on the language.
by Jamie Tanna
.
#go.
Releasing a set of test cases for Content Negotiation (2 mins read).
Introducing a repo for test cases to validate how you're performing server-driven content negotiation.
Releasing a Go library for content-type negotiation (2 mins read).
Introducing a new Go library for performing server-driven content negotiation.
Using generics to get a pointer to any type, in Go (1 mins read).
How to use Go generics to create a helper method for getting a pointer to any type.
by Jamie Tanna
.
#blogumentation
#go.
Optional configuration for configuring Go code (2 mins read).
How to use optional types to allow configuring your library's Go code.
by Jamie Tanna
.
#blogumentation
#go.
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.
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.
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.
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.
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.
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.