personal web log written by izabeera and dryobates

sphinx httpdomain rest

Documenting Flask REST API in Sphinx

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

reStructuredText typehints sphinx

Python3's typehints in Sphinx documenation

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

vim reStructuredText instantrst

Realtime reStructuredText preview in browser with Vim and InstantRst

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

agile agilepm dsdm

DSDM Agile PM - How good you are?

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

gunicorn docker pudb python debugging docker-compose

Debugging gunicorn on docker with pudb

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

dryobates
dryobates
Jakub Stolarski. Software engineer. I work professionally as programmer since 2005. Speeding up software development with Test Driven Development, task automation and optimization for performance are things that focus my mind from my early career up to now. If you ask me for my religion: Python, Vim and FreeBSD are my trinity ;) Email: jakub@stolarscy.com

Archive

Tag cloud