Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
know_its_ok-0.5.0.tar.gz (14.8 kB) Copy SHA256 Checksum SHA256 Source Jan 11, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting