Skip to main content

Markdown-based test runner for python. Good for github projects

Project description

Steady Mark

image image image image image image image image image image image image image

Turning your github readme files into python test suites since 2012

Steady Mark was created for python developers that love Github and markdown.

How it works:

Write your documentation using github-flavored markdown, surround your snippets with python code blocks and steadymark will automatically find and run them, if there is a header preceeding your python snippet it will be used as title for your test.

Advantages:

  • Add test coverage to your app/library while documenting it
  • Never have old malfunctional examples on your project's main page in github
  • It uses misaka which is a python-binding of sundown, the markdown engine that github uses in itself

Example

unicode.lower transforms string into lowercase

from sure import expect
assert expect(u"Gabriel Falcao".lower()).equals(u"gabriel falcao")

python can add numbers

assert (2 + 2) == 4, 'oops baby'

Start using steady mark now!

This is the code for the example above, copy and paste in you python project right now and start keeping your documentation up-to-date with the code.

# My project name
`version 0.1`

## unicode.lower transforms string into lowercase

```python
assert "LOWERCaSe".lower() == "lowercase"
```

## python can add numbers

```python
assert (2 + 2) == 5, 'oops baby'
```

Just run with:

$ steadymark README.md

loading a python file before running tests

you can tell steadymark to load a "boot" file before running the tests, it's very useful for hooking up sure or HTTPretty

Steadymark is on version 0.8.3

>>> from sure import expect
>>> from steadymark import version
>>> assert expect(version).should.equal("0.8.3")

Project details


Download files

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

Source Distribution

steadymark-0.8.3.tar.gz (7.6 kB view details)

Uploaded Source

File details

Details for the file steadymark-0.8.3.tar.gz.

File metadata

  • Download URL: steadymark-0.8.3.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.6

File hashes

Hashes for steadymark-0.8.3.tar.gz
Algorithm Hash digest
SHA256 7df35027c6088a4849bcb27e3464a7657f3879e2863f2fa431cb5b8672058e9c
MD5 1689c61d4dd3000988554ffbdc45afc8
BLAKE2b-256 82665547ec1e31d13c0451d2ec1bac6215013c24a9e64bc251d6d8c70618280e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page