covertable 1.1.0

Requirements

• Python: 3.3 or later.

  • Tested with 3.7

Installation

$ pip install covertable

Usage

Just import covertable and call make function.

>>> from covertable import make, sorters

>>> machine_list = ['iphone', 'pixel']
>>> os_list = ['ios', 'android']
>>> browser_list = ['FireFox', 'Chrome', 'Safari']

>>> # list input and output
... make(
...     [machine_list, os_list, browser_list],  # list factors
...     length=2,  # default: 2
...     sorter=sorters.greedy,  # default: sorters.sequential
...     sort_kwargs={'seed': 100},  # default: {}
...     pre_filter=lambda row: not(row[1] == 'android' and row[0] != 'pixel'),  # default: None
...     post_filter=lambda row: not(row[1] == 'ios' and row[2] != 'Safari'),  # default: None
... )
[
  ['iphone', 'ios', 'Safari'],
  ['pixel', 'android', 'Safari']
]

>>> # dict input and output
... make(
...     {'machine': machine_list, 'os': os_list, 'browser': browser_list},  # dict factors
...     length=2,  # default: 2
...     sorter=sorters.greedy,  # default: sorters.sequential
...     sort_kwargs={'seed': 100},  # default: {}
...     pre_filter=lambda row: not(row['os'] == 'android' and row['machine'] != 'pixel'),  # default: None
...     post_filter=lambda row: not(row['os'] == 'ios' and row['browser'] != 'Safari'),  # default: None
... )
[
  {'os': 'ios', 'browser': 'Safari', 'machine': 'iphone'},
  {'machine': 'pixel', 'browser': 'Safari', 'os': 'android'}
]

Development

# preparation
$ python3 -m venv venv
$ source venv/bin/activate
(venv) $ pip install -r dev_requirements.txt

# testing
(venv) $ tox # -e py37 -e cov -e black

(venv) $ python setup.py sdist bdist_wheel
(venv) $ twine upload --repository pypi dist/*