bind

A function for binding strings with a separator


License
MIT
Install
pip install bind==2.1.0

Documentation

Build Status

bind

bind is a one-line function that joins strings in a way we often need

Usage

from bind import bind
things_to_bind = ['castable', 'to', 's t r i n g.', 45, '"hi"', 0.25]

# defaults for urllib.parse.quote_plus, leaving these out would change nothing
kwargs = dict(safe='', encoding=None, errors=None) 

# by default, use slash separator and urlencoding
bind(*things_to_bind, **kwargs)
'castable/to/s+t+r+i+n+g./45/%22hi%22/0.25'

# turn off url encoding
bind(*things_to_bind, url=False, **kwargs)
'castable/to/s t r i n g./45/"hi"/0.25'

# result is the same if you pass in a list
bind(things_to_bind, url=False, **kwargs)
'castable/to/s t r i n g./45/"hi"/0.25'

# change separator --- note that it strips the other . in things_to_bind[2]
bind(*things_to_bind, sep='.')
'castable.to.s+t+r+i+n+g.45.%22hi%22.0.25'

# pointless but possible, and will strip W, H and Y from items in iterable!
bind(*things_to_bind, sep='WHY', url=True, **kwargs)
'castableWHYtoWHYs+t+r+i+n+g.WHY45WHY%22hi%22WHY0.25'

Aside from url=bool and sep=str, all keyword arguments are passed to urllib.parse.quote_plus

Tests (600% coverage)

coverage run --source='.' -m unittest discover
coverage report --omit=setup.py
Name                Stmts   Miss  Cover
---------------------------------------
bind/__init__.py        1      0   100%
bind/bind.py            2      0   100%
tests/__init__.py       0      0   100%
tests/tests.py         22      0   100%
---------------------------------------
TOTAL                  25      0   100%