Developing software in the Real World
Over the weekend I released rst2pdf 0.99. The list of changes is quite long as it's been over a year since the last release. There are some key things in this release that I'm particularly pleased about including Python 3.9 and 3.10 & Sphinx 4 support, multiple styles in the class directive and the ability to specify background images in the raw:: pdf directive. There's also a number of bug fixes, particular to math rendering… continue reading.
2021 is over! A very strange year where I have been vaccinated against COVID-19, with an additional booster, yet I caught it and took months to recover. Fortunately, I continued to take a photo every day though my Project 365 which allows me to appreciate what happened during this year of my life. January January started out quietly with a hint of snow. I did a lot of walking, presented at The Online & my… continue reading.
Now that I have a TouchID enabled Mac, I want to be able use TouchID for sudo access. There's a pam module available, so it just needs enabling: Edit /etc/pam.d/sudo Add a new line under line 1 (which is a comment) containing:
|
1 |
auth sufficient pam_tid.so |
(Leave all other lines in this file.) That's it. Now, whenever you use sudo, you have the option of using TouchID to authenticate. Scripting it It turns out that whenever there's an OS… continue reading.
When working on rst2pdf, I use pyenv as I've written about before. Recently, I've found myself needing to recreate virtualenvs for various Python versions and then recreate them to easily reset the list of packages installed into them via pip. To my my life easier, I created a script that I can run from the command line:
|
1 |
$ newenv rst2pdf-dev-py3.9 3.9.5 |
This creates a new virtualenv called rst2pdf-dev-py3.9 from Python version 3.9.5, upgrade pip and install pytest, pytest-xdist… continue reading.
For many years now, I've been using Matthew Weier O'Phinney's changelog_generator script to generate an easy-to-read list of changes for a given milestone. Time has moved on; the Laminas project now uses Laminas Automatic Releases and Matthew hasn't updated his script since 2013. Since PHP 8, warnings have started appear, so it's clear updates were required. While I fully intend to see if I can use Automatic Releases on some projects, I have others where… continue reading.
One thing that's quite convenient is to be able to throw an exception with a valid HTTP code set and have that code sent to the client. For example, you may have:
|
1 |
throw new \RuntimeException("Not Found", 404); |
With the standard Slim 4 error handler, this response is sent to the client:
|
1 2 3 4 5 6 7 8 |
$ curl -i -H "Accept:application/json" http://localhost:8888 HTTP/1.1 500 Internal Server Error Host: localhost:8888 Content-type: application/json { "message": "Slim Application Error" } |
Ideally we want the status code to be 404. Option 1: Use an HttpException The simplest solution is to use one of Slim's HttpException classes:
|
1 2 3 4 5 |
use Slim\Exception\HttpNotFoundException; ... throw new HttpNotFoundException($request); |
This… continue reading.
I don't do that much that's clever with git, but I've found the following helpful. Automatically prune When you do a git fetch or git pull, you can ask it to remove remote tracking branches for a branch that has been removed on the remote by using the –prune flag. This can be automated globally with:
|
1 |
git config --global fetch.prune true |
and if you only want it for a specific repository, you can use:
|
1 |
git config remote.origin.prune true |
One line log I… continue reading.
One of my clients has recently moved to AnyConnect VPN and I've been having routing problems with the official Mac client. As my colleagues on Linux on the project have not had these issues, I investigated and installed the OpenConnect client. These are my notes after scouring the Internet to set it up how I want it. Installation I used Homebrew:
|
1 |
$ brew install openconnect |
OpenConnect is a CLI tool. If you want a GUI in your menu bar,… continue reading.
When writing PHP for AWS Lambda, Bref is the way to do it. One thing I like about Bref is that you can use PSR-15 Request Handlers to respond to API Gateway HTTP events as documented in the API Gateway HTTP events section of the Bref docs. The request handler is the same as used in PSR-7 micro-frameworks like Slim or Mezzio and can be thought of as a controller action. As such, it's really… continue reading.
One thing that has annoyed me about receiving email is so-called tracker pixels. These usually 1x1px transparent images that are remotely loaded into HTML email enable the sender to track information about be. A good resource about them is No To Spy Pixels. As such I've tended to run my email clients with remote resource loading disabled, which isn't the best experience as a surprising number of legitimate email even display the call-to-action link as… continue reading.
Rob Allen is a sofware consultant and developer concentrating on HTTP APIs. He develops in PHP, Python and other interesting languages, contributing to rst2pdf, Slim Framework, Apache OpenWhisk amongst other OSS projects. Based in Worcester, UK, he runs Nineteen Feet and is the author of Zend Framework in Action.
Around the web:
Framing Focus blog
Twitter: @akrabat
Instagram: akrabatic
Flickr: photos
GitHub: Rob Allen
IRC: akrabat on freenode
