# tdda Test-Driven Data Analysis Functions
Installation
The simplest way to install all of the TDDA Python modules is using pip:
pip install tdda
But note that it is not particularly easy to run through the examples using a PyPi binary installation like that. The full set of sources, including all examples, will be downloadable from PyPi with:
pip download –no-binary :all: tdda
The sources are also publicly available from Github:
git clone git@github.com:tdda/tdda.git
Level 0:
The tdda.referencetest library is used to support the creation of reference tests, based on either unittest or pytest.
These are like other tests except:
They have special support for comparing strings to files and files to files.
That support includes the ability to provide exclusion patterns (for things like dates and versions that might be in the output).
When a string/file assertion fails, it spits out the command you need to diff the output.
If there were exclusion patterns, it also writes modified versions of both the actual and expected output and also prints the diff command needed to compare those.
They have special support for handling CSV files.
It supports flags (-w and -W) to rewrite the reference (expected) results once you have confirmed that the new actuals are correct.
For usage details:
>>> import tdda.referencetest >>> help(tdda.referencetest)
For more details from a source distribution or checkout, see the README.md file and examples in the referencetest subdirectory.
An older implementation of these ideas is available as a unittest wrapper class, WritableTestCase, in writabletestcase.py. This can be imported directly with from tdda.writabletestcase import WritableTestCase. Examples of using this are currently available in the deprecated subdirectory. This older version will be fully deprecated and removed soon.
Level 1:
The tdda.constraints library is used to ‘discover’ constraints from a (pandas) DataFrame, write them out as JSON, and to verify that datasets meet the constraints in the constraints file.
For usage details:
>>> import tdda.constraints >>> help(tdda.constraints)
For more details from a source distribution or checkout, see the README.md file and examples in the constraints subdirectory.
Resources
Resources on these topics include:
TDDA Blog: http//www.tdda.info
Notes on WritableTestCase: http://tdda.info/writabletestcase-example-use
General Notes on Constraints and Assertions
Notes on using the Pandas constraints library: http://www.tdda.info/constraint-discovery-and-verification-for-pandas-dataframes
- PyCon UK Talk on TDDA:
Slides and Rough Transcript: http://www.tdda.info/slides-and-rough-transcript-of-tdda-talk-from-pycon-uk-2016
All examples, tests and code should run under Python2 and Python3.
The tdda repository also includes rexpy, a tool for automatically inferring regular expressions from a single field of data examples.
For usage details:
>>> import tdda.rexpy >>> help(tdda.rexpy)
1 maintainer
Release files for tdda 0.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tdda-0.2.4.tar.gz | 115.6 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tdda-0.2.4-py3-none-any.whl | Python 3 | none | any | Details |
| tdda-0.2.4-py2-none-any.whl | Python 2 | none | any | Details |
Total release size: 265.2 kB
Release files / tdda-0.2.4.tar.gz
| Download URL | tdda-0.2.4.tar.gz |
|---|---|
| Size | 115.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0582d8a3d49125ff3fcf90e86d2675104e6f1360dbd21e55d54003732a2f8a8b
|
|
BLAKE2b-256 checksum How to use checksums |
594429f0e1478af1a05c3d3df1e51d0aa646a1f724571494aded883a35edbcd9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / tdda-0.2.4-py3-none-any.whl
| Download URL | tdda-0.2.4-py3-none-any.whl |
|---|---|
| Size | 74.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8314b917634358689e44fa646a88c0856d6e667f7ee770549fa662ec42e4fcd8
|
|
BLAKE2b-256 checksum How to use checksums |
23d9bdb22d18b0743354ebb83748219fd04f4219d72b94b6f50bd52154fc0371
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / tdda-0.2.4-py2-none-any.whl
| Download URL | tdda-0.2.4-py2-none-any.whl |
|---|---|
| Size | 74.8 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
33d360b3d6402d67b8ec701d59020772c84bcab24b2ec7269945155f24e9cfb6
|
|
BLAKE2b-256 checksum How to use checksums |
ebecc3461d7d9982b02362a14d697e00a6351a5cdaec26208b53fef811930be9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
