1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
sure
====
.. image:: https://img.shields.io/pypi/dm/sure
:target: https://pypi.org/project/sure
.. image:: https://github.com/gabrielfalcao/sure/workflows/Sure%20Tests/badge.svg
:target: https://github.com/gabrielfalcao/sure/actions?query=workflow%3A%22Sure+Tests%22
.. image:: https://img.shields.io/readthedocs/sure
:target: https://sure.readthedocs.io/
.. image:: https://img.shields.io/github/license/gabrielfalcao/sure?label=Github%20License
:target: https://github.com/gabrielfalcao/sure/blob/master/LICENSE
.. image:: https://img.shields.io/pypi/v/sure
:target: https://pypi.org/project/sure
.. image:: https://img.shields.io/pypi/l/sure?label=PyPi%20License
:target: https://pypi.org/project/sure
.. image:: https://img.shields.io/pypi/format/sure
:target: https://pypi.org/project/sure
.. image:: https://img.shields.io/pypi/status/sure
:target: https://pypi.org/project/sure
.. image:: https://img.shields.io/pypi/pyversions/sure
:target: https://pypi.org/project/sure
.. image:: https://img.shields.io/pypi/implementation/sure
:target: https://pypi.org/project/sure
.. image:: https://img.shields.io/github/v/tag/gabrielfalcao/sure
:target: https://github.com/gabrielfalcao/sure/releases
.. image:: https://img.shields.io/badge/pydoc-web-ff69b4.svg
:target: http://pydoc.net/sure
An idiomatic testing library for python with powerful and flexible assertions, created by `Gabriel Falcão <https://github.com/gabrielfalcao>`_.
Sure's developer experience is inspired and modeled after `RSpec Expectations
<http://rspec.info/documentation/3.5/rspec-expectations/>`_ and
`should.js <https://github.com/shouldjs/should.js>`_.
Installing
----------
.. code:: bash
$ pip install sure
Documentation
-------------
Available in the `website <https://sure.readthedocs.io/en/latest/>`__ or under the
``docs`` directory.
You can also build the documentation locally using sphinx:
.. code:: bash
make docs
Here is a tease
---------------
Equality
~~~~~~~~
(number).should.equal(number)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code:: python
import sure
(4).should.be.equal(2 + 2)
(7.5).should.eql(3.5 + 4)
(3).shouldnt.be.equal(5)
Assert dictionary and its contents
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code:: python
{'foo': 'bar'}.should.equal({'foo': 'bar'})
{'foo': 'bar'}.should.have.key('foo').which.should.equal('bar')
"A string".lower().should.equal("a string") also works
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code:: python
"Awesome ASSERTIONS".lower().split().should.equal(['awesome', 'assertions'])
|
