Metadata-Version: 2.0
Name: pyemoji
Version: 1.0.3
Summary: Emoji Convert & Replace & Entities
Home-page: https://github.com/Brightcells/pyemoji
Author: Hackathon
Author-email: kimi.huang@brightcells.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries :: Python Modules

========
pyemoji
========

When MySQL version greater than 5.5.3 have utf8mb4 CHARACTER SET which can store emoji.

But when MySQL version lower than 5.5.3 can't directly store emoji.

And can store emoji by using pyemoji's encode/decode & replace & entities function.

Similar: https://pypi.python.org/pypi/pymoji

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

::

    pip install pyemoji


Usage
=====

encode/decode::

    Python 2.7.5 (default, Mar  9 2014, 22:15:05)
    Type "copyright", "credits" or "license" for more information.

    IPython 4.0.0 -- An enhanced Interactive Python.
    ?         -> Introduction and overview of IPython's features.
    %quickref -> Quick reference.
    help      -> Python's own help system.
    object?   -> Details about 'object', use 'object??' for extra details.

    In [1]: import pyemoji

    In [2]: pyemoji.encode(u'�������������������')
    Out[2]: '\\u7b11\\u8138\\u8868\\u60c5\\uff1a\\U0001f604'

    In [3]: print pyemoji.encode(u'�������������������')
    \u7b11\u8138\u8868\u60c5\uff1a\U0001f604

    In [4]: pyemoji.decode('\\u7b11\\u8138\\u8868\\u60c5\\uff1a\\U0001f604')
    Out[4]: u'\u7b11\u8138\u8868\u60c5\uff1a\U0001f604'

    In [5]: print pyemoji.decode('\\u7b11\\u8138\\u8868\\u60c5\\uff1a\\U0001f604')
    �������������������


replace::

    In [6]: pyemoji.replace(u'�������������������')
    Out[6]: u'\u7b11\u8138\u8868\u60c5\uff1a\ufffd'

    In [7]: print pyemoji.replace(u'�������������������')
    ������������������

    In [8]: pyemoji.replace(u'�������������������', '')
    Out[8]: u'\u7b11\u8138\u8868\u60c5\uff1a'

    In [9]: print pyemoji.replace(u'�������������������', '')
    ���������������


entities::

    In [10]: pyemoji.entities(u'�������������������')
    Out[10]: u'\u7b11\u8138\u8868\u60c5\uff1a&#128516;'

    In [11]: print pyemoji.entities(u'�������������������')
    ���������������&#128516;


Params
======

unic::

    In [4]: import pyemoji

    In [5]: pyemoji.encode('�������������������')
    Out[5]: '\\u7b11\\u8138\\u8868\\u60c5\\uff1a\\U0001f604'

    In [6]: pyemoji.encode(u'�������������������')
    Out[6]: '\\u7b11\\u8138\\u8868\\u60c5\\uff1a\\U0001f604'


