Metadata-Version: 2.1
Name: twemoji-api
Version: 1.0.1
Summary: A lightweight utility for resolving emojis into file names, local asset paths, and URLs.
Author-email: Gustavo Pedroso Bernardes <gpedrosobernardes@gmail.com>
Project-URL: Homepage, https://github.com/gpedrosobernardes/twemoji_api
Project-URL: Source, https://github.com/gpedrosobernardes/twemoji_api
Project-URL: Issues, https://github.com/gpedrosobernardes/twemoji_api/issues
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic
Requires-Dist: emojis

# Twemoji API

A lightweight utility for resolving emojis into file names, local asset paths, and URLs.
Supports both **PNG** and **SVG** assets using the Twemoji standard.

## Features

* Convert emojis to Unicode-based file names
* Retrieve local file paths for emoji assets
* Get direct URLs to Twemoji files
* Supports **PNG** and **SVG**

## Installation

```bash
pip install twemoji-api
```

## Usage

```python
from twemoji_api.api import get_emoji_path, get_emoji_url, Twemoji

print(get_emoji_path("🔥"))
print(get_emoji_url("🔥"))

emoji = Twemoji("🔥")
print(emoji.file_name)
print(emoji.path)
print(emoji.url)
```

## Functions

### `get_emoji_path(emoji, extension="png")`

Returns the local path for the emoji file.

### `get_emoji_url(emoji, extension="png")`

Returns the URL to the emoji file.

### `get_emoji_file_name(emoji)`

Converts the emoji into its Unicode filename format.

### `Twemoji`

Object-oriented interface providing:

* `file_name`
* `path`
* `url`

## License

MIT


## Twemoji Attribution

This project includes graphics from Twemoji.
Copyright 2019 Twitter, Inc and other contributors.
Licensed under CC-BY 4.0:
https://creativecommons.org/licenses/by/4.0/
No changes were made.
