whatsonpypi

CLI tool to get package info from PyPI and/or manipulate requirements.

• GitHub: https://github.com/viseshrp/whatsonpypi
• PyPI: https://pypi.python.org/pypi/whatsonpypi
• Free software: MIT license
• Documentation: https://whatsonpypi.readthedocs.io.

Installation

pip install -U whatsonpypi

Requirements

1. Python 2.7+

Features

• Find information on a package on PyPI

  Examples:

  $ whatsonpypi django
  NAME
      Django
  LATEST VERSION
      2.1.5
  SUMMARY
      A high-level Python Web framework that encourages rapid development and clean, pragmatic design.
  PACKAGE URL
      https://pypi.org/project/Django/
  AUTHOR
      Django Software Foundation
  LATEST RELEASES
      2.2a1, 2.1rc1, 2.1b1, 2.1a1, 2.1.5
  

• For more information..

  Examples:

  $ whatsonpypi django --more
  ...
  

• Version specific information..

  Examples:

  $ whatsonpypi django==2.1.4 --more
  ...
  

• Launch documentation URL of project in a browser tab

  Examples:

  $ whatsonpypi django --docs
  

• Add packages to your requirements files.

  Examples:

  $ whatsonpypi django --add
  

  By default, it searches for files with names matching requirements*.txt in the current working directory and adds the dependency to the end of the file.

  You can change the filename pattern to search for. The pattern may contain simple shell-style wildcards.

  $ whatsonpypi django --add --req-pattern "*.txt"
  

  If there’s more than one file, you will see a prompt allowing you to select the files that should be modified.

  If you want the dependency to be added to a specific line, mention a comment #wopp on its own line, which will be replaced with the dependency:

  Example:

  Do this in your requirements.txt:

  # Django
  django==2.1.5
  # testing
  pytest==4.1.1
  #wopp
  

  Then running this:

  $ whatsonpypi pytest-runner --add
  

  will produce this:

  # Django
  django==2.1.5
  # testing
  pytest==4.1.1
  pytest-runner==4.2
  

  Existing dependencies will be replaced with newer versions. Dependency version by default is the latest unless specified explicitly like:

  $ whatsonpypi pytest-runner==4.1 --add
  

  Optionally, directory to search for requirement files can be specified with --req-dir. Both absolute and relative paths are allowed. Must be a directory.

  $ whatsonpypi pytest-runner==4.1 --add --req-dir /Users/Me/Documents/GitHub/project/requirements
  

  Default value (if not provided) is the directory where the command is run (cwd).

  Also, optionally, you can specify comments to add before a dependency. Note that the comment will not be added if the dependency already exists in the file.

  For example, running this:

  $ whatsonpypi pytest-runner --add --comment 'testing'
  

  will add this:

  # testing
  pytest-runner==4.2
  

See all options with:

$ whatsonpypi --help

Credits

• Cookiecutter and the audreyr/cookiecutter-pypackage project template for getting me started.