==========
 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.  Since it's too hard to keep that up-to-date, I'll 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.

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>`_.

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>`_.

Most of my style preferences are well supported by `ruff <https://docs.astral.sh/ruff/>`__ and you
can get a sense for these in the ``pyproject.toml`` for my `@public
<https://gitlab.com/warsaw/public/-/blob/main/pyproject.toml#L136>`__ project.  In particular I
greatly prefer ``quote-style = 'single'`` for reasons I'm happy to debate on!  My biggest remaining
complaint is the way ruff `aligns comments <https://github.com/astral-sh/ruff/issues/7684>`__; the
stair-step approach used by `black <https://black.readthedocs.io/en/stable/>`__ and adopted by ruff
is pretty poor for readability, IMHO.


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

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