==========
 Software
==========

I used to list a bunch of free software things I'd written over the years,
both for and in Python, and for Emacs/XEmacs.  Most of that's pretty seriously
out of date now, so let me just point you to my public repositories.


Source repositories
===================

I develop most of my personal stuff on `GitLab <https://gitlab.com/warsaw>`_
just because I really like the UI, it has great support for the entire
software lifecycle, it has an open source edition, and it has some great
features, such as "merge when CI completes".

I do also use `GitHub <https://github.com/warsaw>`_ quite a bit too of course.
GitHub is more popular, and of course `Python itself is developed on GitHub
<https://github.com/python>`_.  Often, when I collaborate, GitHub is the
chosen hosting provider.

I also have a bunch of packages on the `Python Cheeseshop
<https://pypi.org/user/barry/>`_ (the Python Package Index -- PyPI -- for the
humor or `Monty Python <https://en.wikipedia.org/wiki/Monty_python>`_
impaired).


Style guide
===========

You might also find my personal `Python style guide <STYLEGUIDE.txt>`_
interesting.  It's based on `PEP 8
<https://www.python.org/dev/peps/pep-0008/>`_ of course, and it forms the
basis of the `GNU Mailman style guide
<https://mailman.readthedocs.io/en/latest/src/mailman/docs/STYLEGUIDE.html>`_.

These days, I prefer to use the `Blue
<https://blue.readthedocs.io/en/latest/>`_ auto-formatter, which I help
maintain with my colleague `Grant Jenks <https://github.com/grantjenks>`_.


Warsaw's Laws
=============

`Warsaw's Laws <laws.html>`_ are my guiding principles for the software I
develop.