Skip to content

Commit

Permalink
Add readthedocs.io
Browse files Browse the repository at this point in the history
  • Loading branch information
steven5538 committed Jun 17, 2018
1 parent 4f4d245 commit ac8ad17
Show file tree
Hide file tree
Showing 2 changed files with 64 additions and 0 deletions.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
![PyPI](https://img.shields.io/pypi/v/emotlib.svg)
![Travis branch](https://img.shields.io/travis/steven5538/emotlib/master.svg)
![Coveralls github](https://img.shields.io/coveralls/github/steven5538/emotlib.svg)
![Read the Docs](https://img.shields.io/readthedocs/emotlib.svg)
![PyPI - License](https://img.shields.io/pypi/l/emotlib.svg)


Expand Down
63 changes: 63 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
# emotlib: Python emoji + emoticon Library


![PyPI - Python Version](https://img.shields.io/pypi/pyversions/emotlib.svg)
![PyPI](https://img.shields.io/pypi/v/emotlib.svg)
![Travis branch](https://img.shields.io/travis/steven5538/emotlib/master.svg)
![Coveralls github](https://img.shields.io/coveralls/github/steven5538/emotlib.svg)
![Read the Docs](https://img.shields.io/readthedocs/emotlib.svg)
![PyPI - License](https://img.shields.io/pypi/l/emotlib.svg)


Installation
------------

To install emotlib, simply use [pipenv](http://pipenv.org/) (or pip, of course):
```
$ pipenv install emotlib
🍩🎉
```
Satisfaction guaranteed.

Example
-------------

Note: In python2.x, your string need to be unicode. Ex: u'I\'m :elf:'
``` python
>> import emotlib
>> print(emotlib.emoji())
🧙‍
>> print(emotlib.emoji(category='food-fruit'))
🍉
>> print(emotlib.emoji(num=3))
👨‍🚀👨‍🚀👨‍🚀
>> print(emotlib.emoji(num=3, sep= ' ~ '))
🤸 ~ 🤸 ~ 🤸 ~
>> print(emotlib.emojify('I\'m :man_technologist:'))
I'm 👨‍💻
>> print(emotlib.emojify('I\'m :man~technologist:', alias='~'))
I'm 👨‍💻
>> print(emotlib.demojify('I\'m 👨‍💻'))
I'm :man_technologist:
>> print(emotlib.demojify('I\'m 👨‍💻', alias='~'))
I'm :man~technologist:


>> print(emotlib.emoticon())
( ´ ▽ ` )ノ
>> print(emotlib.emoticon(feel='confused'))
(´−`) ンー
>> print(emotlib.emoticon(num=3))
┌(★o☆)┘┌(★o☆)┘┌(★o☆)┘
>> print(emotlib.emoticon(num=3, sep=' ~ '))
(´∇ノ`*)ノ ~ (´∇ノ`*)ノ ~ (´∇ノ`*)ノ ~
>> print(emotlib.emoticonify('I\'m a happy developer.'))
I'm a happy developer. *(*´∀`*)☆
```

Check categories & feels
```python
>> import emotlib
>> emotlib.emoji_categories
>> emotlib.emoticon_feels
```

0 comments on commit ac8ad17

Please sign in to comment.