axfelix / putz Goto Github PK

A CLI tool and Python module for putzing around and discovering new Python libraries.

Relies heavily on pypi-search, because PyPI has recently deprecated its main lookup API and retrieving results currently requires screen-scraping 😱!

Currently this (ab)uses PyPI's "Trending" relevance ranking, which is not otherwise exposed or explained, in order to return libraries that are likely to be well-maintained. Right now there is no better way to do a fully serendiptious search of Python packages; results are no doubt somewhat biased by this.

pip install putz

Just run putz. It'll open a browser window to a randomly-selected, not-abandoned library from PyPI.

This is pretty standard stuff, but it doesn't hurt to list it here (requires setuptools, wheel, twine; the usual):

python setup.py sdist bdist_wheel twine upload dist/*

I wanted to ease myself into my first day at the Recurse Center, and I'd never actually shipped a Python CLI library via PyPI before, so I thought I'd figure out how that works!

Also, formatting with Black, because I don't usually organize solo projects very well and wanted the excuse to do that too.

I read the name of the Python time zone library too many times and my brain worked its magic.

MIT. Please see COPYING for full details.