personal web log written by izabeera and dryobates

sphinx

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

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

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

debugging

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

agile

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

django

Tests in Django

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

code review

Reviewing big chunks of code

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

wheel

Virtual drive on one wheel

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

debugging

Navigating in Pdb

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

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
izabeera
izabeera
Iza Kartowicz-Stolarska. IT engineer. I work in programming since 2005. During this time I gained wealth of experience in writing web applications... and loved Python and Vim :) I enjoy working with people which have positive attitude to the world. Email: iza@stolarscy.com