If you have ever tried to search PyPI via pip you know how difficult it can be. Yip is an attempt to resolve that frustration and create a beautiful and feature rich alternative. Here is an article I wrote about yip on medium.com
- configurable: every option can be set either explicitly or in a config file
- looks better: with saner result formatting and coloring (which you can turn off)
- supports regex: one of the caveat of pip search is the lack of regex support
- more info: apart from the description it can show you the package size, date of last upload, homepage url or package license
- limits results: want only the 10 most relevant result? No problem!
Normal search:
yip <name of package>
Normal search with size and license information:
yip <name of package> --size --license
Regex search with the homepage of the package:
yip <regex search query> --regex --homepage
Normal search with the 10 most relevant results:
yip <name of package> --limit 10
-h, --help
shows information on usage and available flags
-d, --date
shows the upload date of the latest version
-s, --size
shows the size in a human readable format
-L, --license
shows the license of the package
-H, --homepage
shows the homepage (if has any) of the package
-l <number>, --limit <number>
limits to the most relevant result
-r, --regex
allows you to use regex in your search query important: if you use this flag, it will only search in the title, and not in the summary or in the keyword and you cannot combine it with the -limit flag
IMPORTANT: This gif is using the outdated flags which won't work anymore. I
will update it as soon as I can. The usage example/flaglist however updated and
should be used as a reference.
If you want to make some flags default, automatically sudo install or turn off the colors you can use a config file for that. You have to create a .yiprc file in your home directory and paste the example config from this repo. It is heavily commented and lists all the options you can set. You have to include all the options or it won't work!
- OS-wise: Developed and tested on Linux however it should work on OSX
- software-wise: Python 3, pip and requests(will switch to xmlrpc, this is only temporary)
- Licensed under the GPL3
- Suggestions and pull requests are very welcome! See GitHub's project page for TODO-s if you want to contribute. :)
- If you encounter any bug or have any questions you can post it here or send an e-mail to balazs.saros@gmail.com