While writing software, we are faced with lots and lots of interfaces. The public interface for some tool or module or package or whatever is usually referred to as the API, the CLI, or simply the user interface. In this post, when considering an interface, I am specifically referring to APIs and CLIs. Sometimes, we find a software component that does exactly what we want, but the interface is not what we want. That’s where software interface adapters come to the rescue. Adapters are helpful in many stages of the design and development of just about anything. ...

To explore the concepts of functional testing using python and python testing frameworks, I’m building a project to test, markdown.py on github. In this post, I’m discussing the stub implementation that I will use to set up the testing frameworks. ...

I’ve decided to write my own Markdown script, possibly for dubious reasons. I’m getting antsy to code. But before I get started on the testing and implementation, I need to: write the requirements write a simple stub implementation write a testing strategy explore test frameworks Then, FINALLY, I can start testing and implementing. I will talk about the term ‘testing and implementing’ in a future post. Let’s take a look at the requirements. ...

Markdown has very little to do with python testing. But I need a project to test, so I’m writing my own Markdown script. This is a brief introduction to Markdown from my perspective. Writing HTML sucks. Use Markdown. I think it’s reasonably safe to say that HTML is very, very cool. It’s the basis, the foundation, of the web. I think one of the goals for it was that humans could reasonably easily edit it. If that was one of the goals, we’ve kind of failed. Because writing stuff in HTML by hand really, really sucks. ...