Skip to content

axfelix/putz

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

putz

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.

Installation

pip install putz

Usage

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

Building and Releasing

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/*

FAQ

Why did you start this project?

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.

Why did you give it such a stupid name?

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

License

MIT. Please see COPYING for full details.

Releases

No releases published

Packages

No packages published

Languages