Metadata-Version: 2.1
Name: emojientities
Version: 0.1.4
Summary: provides `string.emojis` (all emoji chars from unicode.org)
Home-page: https://gitlab.com/christoph.fink/python-emojientities
Author: Christoph Fink
Author-email: christoph.fink@helsinki.fi
License: GPLv3
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: requests

# emoji entities

This module downloads the latest list of emoji characters from unicode.org and adds `string.emojis`, a concatenated `str` containing all characters, to be used just as the other string entities (e.g. `string.letters`).

## Dependencies

    requests

## Installation

- *using `pip` or similar:*

```shell
pip install emojientities
```

- *manually:*

    - Clone this repository

    ```shell
    git clone https://gitlab.com/christoph.fink/python-emojientities.git
    ```

    - Change to the cloned directory    
    - Use the Python `setuptools` to install the package:

    ```shell
    python ./setup.py install
    ```
## Usage

This module extends the character classes provided by the `string` standard library to include an `emoji` range. To use it, import `emojientities` and `string` and use `string.emojis` to, for instance, filter emojis in a text:

```python
import emojientities
import string

# example string from: Hiippala et al. (2018) Exploring the linguistic landscape of 
# geotagged social media content in urban environments. Digital Scholarship in the Humanities.
photoCaption = "Great weather in Helsinki!!! On holiday with @username.:-) #helsinki #visitfinland 🤓☀️🛳️"

emojisOnly = "".join(
    [c for c in photoCaption if c in string.emojis]
)
# '🤓☀️🛳️'

photoCaptionWithoutEmojis = "".join(
    [c for c in photoCaption if c not in string.emojis]
)
# 'Great weather in Helsinki!!! On holiday with @username.:-) #helsinki #visitfinland '

```



