Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

An easy way to debug your code.

Project description

The purpose of Know It’s Ok is to make it as easy as possible to run your tests while you’re debugging your code. In particular, it’s main features are:

  1. It finds your tests from anywhere in your repository.
  2. It runs your tests with arguments tailored towards debugging.
  3. It only requires typing two letters: ok


Know It’s Ok is available from PyPI:

$ pip install know_its_ok

It’s only dependencies are pytest and pytest-cov, which should both be installed automatically.


You can run Know It’s Ok from anywhere in your package’s repository:

$ ok

You can also specify individual tests to run (by default they will all be run). You don’t need to specify the complete name of a test, any substring of a test will be understood. For example, if you have a test called, you can use this command to run it:

$ ok foo

You can also specify arguments that should be passed through to pytest (this won’t work if the argument to pytest also matches the name of one of your tests, but in practice this is never a problem):

$ ok --pdb

In order to discover your tests simply, Know It’s Ok is very opinionated about the organization of your code. In particular:

  1. Your code must be version controlled using git.
  2. Your tests must be stored in a directory called tests/, which itself must be located in the top level of your repository.
  3. Inside the tests/ directory, your tests must match the pattern: ??_test_*.py.
  4. Your tests must be written using the pytest framework.
  5. Your package must be located in a directory containing and file.

If any of these expectations are not met, the code should raise an exception.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
know_its_ok-0.5.0.tar.gz (14.8 kB) Copy SHA256 hash SHA256 Source None Jan 11, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page