Many REST frameworks have built in documentation for provided API. Many specialized software exists for centralized API documentation. But if all you need is to include documentation for your project in your regular sphinx documentation then sphinxcontrib-httpdomain can be helpful.
11 Oct 2016 by dryobates
Most of my projects documentation is written in reStructuredText with riv in vim. Same is for all those blog entries here. Until up recently my workflow was traditional: write, save, generate html, preview. Now it has changed...
09 Oct 2016 by dryobates
The most popular use for Python3's annotations are type hints. By default Sphinx can't use that type hints to document modules. Luckily for us Sphinx is easily extensible...
10 Oct 2016 by dryobates
Debugging code run in webservers like gunicorn is not very convenient. Even less convenient is debugging them running in docker. Pudb can give you comfort like GUI debugger but run in TUI remote environment.
29 Sep 2016 by dryobates
Company that I work in has chosen DSDM AgilePM as a method for our current project. I was one of *the chosens* that were sent to AgilePM training. So I have gained some knowledge that should be tested...
03 Oct 2016 by dryobates
When doing Test Driven Development, one of the most difficult thing is to find out how to test different technologies. Breaking that barrier makes TDD dead easy. I wrote some tips on how to test different parts of Django projects to help you start with TDD.
04 Oct 2015 by dryobates
There are two main goals for making code review: making better code and making better programmers. Not only reviewed developer can learn, but reviewer also. I will share my experiences as a reviewer.
31 Dec 2015 by dryobates
Virtualenv is a great software for isolating python environments. Wheel is a great package format for quick installation of packages. Since virtualenv 13.0.0 installs automatically with wheel... I was kicked with dark side of this decision.
30 Jun 2015 by dryobates
I often see programmers, even experienced, that tediously press "n" and "s" few hundreds of times, one after another, only to skip some for loop or get into state where loop is executed n-th time in pdb. Here is a little tip how to do it smarter.
09 Aug 2015 by dryobates
