Metadata-Version: 2.0
Name: unicode-mayo
Version: 0.6.5
Summary: UNKNOWN
Home-page: https://github.com/eyalr/unicode_mayo
Author: UNKNOWN
Author-email: UNKNOWN
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7

============
unicode_mayo
============

**unicode_mayo** is the mayo in your unicode sandwich. In your development
environment, use it as a wrapper around unicode strings to see if they're
accidentally coming in to contact with byte strings. This can help catch
unicode encode/decode errors before they happen in production!

Installation
============

Installation via ``pip``::

    pip install unicode_mayo

Usage
=====

Something like::

    >>> import unicode_mayo
    >>> wrapped = unicode_mayo.UnicodeSafetyWrapper(u'safety at last!')
    >>> wrapped.encode('utf-8')
    'safety at last!'
    >>> wrapped + u' woohoo!'
    u'safety at last! woohoo!'
    >>> wrapped + 'evil bytestring'
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
      File "/Users/eyalr/personal_work/unicode_mayo/src/unicode_mayo/__init__.py", line 55, in __add__
        _fail_on_bytes(other)
      File "/Users/eyalr/personal_work/unicode_mayo/src/unicode_mayo/__init__.py", line 90, in _fail_on_bytes
        _fail_on_bytes_helper(other)
      File "/Users/eyalr/personal_work/unicode_mayo/src/unicode_mayo/__init__.py", line 81, in _fail_on_bytes_helper
        'Attempted string formatting without decoding utf-8'
    TypeError: Attempted string formatting without decoding utf-8


