You’re given the task of writing a microservice AND providing a documentation in OpenAPI format. You already know that there are two main approaches:

  • code-first : write the code, using OpenAPI annotations, and then generate the OpenAPI document
  • design-first : write the OpenAPI document (a.k.a. the openapi.yaml file) and then generate the code

This article reviews the code first approach, the design-first approach will follow in a second article at a later time.


Read More ...

envvc

Did you ever have the need to use different versions of Microsofts Visual C++ compiler from the command line? Did you wish you wouldn’t have to constantly call vcvars32.bat or change your environment (PATH, INCLUDE and LIB variables)? In comes a little tool called envvc.exe. It sets the environment for the chosen version and then calls any chosen executable. As additional feature it verifies that you have installed the latest service pack for the chosen version. Read More ...

There are already many solutions to the “Santa Claus Problem” by John Trono1. It’s a “problem simple to understand and yet far from easy to solve”; the author’s original solution (based on semaphores) was only partly correct. The probably most known analysis of the problem was written by Mordechai Ben-Ari2, who also provided solutions in Ada95 and Java. This is the original problem description: Santa Claus sleeps in his shop up at the North Pole, and can only be wakened by either all nine reindeer being back from their year long vacation on the beaches of some tropical island in the South Pacific, or by some elves who are having some difficulties making the toys. Read More ...

At work, we started using dmake in 1991 (or even earlier) for building the firmware for the Vending Machine Controller Euro'90. The firmware consisted mostly of PL/M and C code and the compilers suffered from the DOS limitation of 127 characters per command line. Dennis Vadura’s dmake 3.70 (hosted by the University of Waterloo and available as DOS version) featured the $(mktmp ) macro that let me create any needed temporary config and response files. Read More ...

Peter Steiner

Software Developer and Opinionated Citizen

Switzerland