Skip to main content
#mamba: the definitive testing tool for Python

[![Build Status](https://travis-ci.org/nestorsalceda/mamba.svg)](https://travis-ci.org/nestorsalceda/mamba)

mamba is the definitive BDD testing framework for Python. Born under the banner of Behavior Driven Development.

##Installation

To install mamba, just:

``` sh
pip install mamba
```

##Overview

```python
# Importing mamba is not needed!
# import mamba

with description('mamba'):
with it('is tested with mamba itself'):
pass

with it('supports python 3'):
pass

with context('when listing features'):
with it('supports example groups'):
pass

with context('hooks'):
with before.all:
print 'This code will be run once, before all examples'

with before.each:
print 'This code will be run before each example'

with after.each:
print 'This code will be run after each example'

with after.all:
print 'This code will be run once, after all examples'

with context('pending tests'):
with _context('when running pending contexts (marked with a underscore)'):
with it('will not run any spec under a pending context'):
pass

with _it('will not run pending specs (marked with underscore)'):
pass

with it('highlights slow tests'):
sleep(10)

with context(ASampleClass):
with it('has an instance in subject property'):
expect(self.subject).to.be.a(ASampleClass)

with context('when writing assertions'):
with it('can be used with plain assertions'):
assert True

with it('can be used with hamcrest style assertions'):
assert_that(True, is_(True))

with it('can be used with should_dsl style assertions'):
True |should| be(True)

with it('can be used with sure style assertions'):
True.should.be.true

expect(True).to.be.true

with it('is assertion framework agnostic'):
pass

with context('when using tests doubles'):
with it('can be used with mockito'):
stub = mock()
when(stub).is_usable_with_mockito().thenReturn(True)

expect(stub.is_usable_with_mockito()).to.be.true

with it('can be used with doublex'):
with Spy() as sender:
sender.is_usable_with_doublex().returns(True)

assert_that(sender.is_usable_with_doublex(), is_(True))
assert_that(sender.is_usable_with_doublex, called())

with it('can be used with mock'):
is_usable_with_mock = Mock(return_value=True)

assert mock()

with it('is test doubles framework agnostic'):
pass

with context('when code coverage measurement is desired'):
with it('collects them if you pass `--enable-coverage`'):
pass

with it('calls `coverage` directly in order to compute it'):
# see https://pypi.python.org/pypi/coverage/
pass

with it('is configured in a `.coveragerc` file at the root of your project'):
# see http://nedbatchelder.com/code/coverage/config.html
pass

```


##Contribute

If you'd like to contribute, fork [repository](http://github.com/nestorsalceda/mamba), and send a pull request.

Metadata

Release files for mamba 0.8.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mamba 0.8.6
File Size Uploaded Provenance Actions
mamba-0.8.6.tar.gz 10.4 kB Without provenance Details for mamba-0.8.6.tar.gz

Release files / mamba-0.8.6.tar.gz

Download URL mamba-0.8.6.tar.gz
Size 10.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8770551c694f8be14c71710b2201d8a64fc630295f77eefce6f23050e0cd644b
BLAKE2b-256 checksum
How to use checksums
45642f81c12e62d6b259a5b305fa2fc5a84d2682f350f0269c55e5e22741f97d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for mamba 0.8.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page