pymojis 1.0.1__tar.gz

pymojis-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pallandir
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pymojis-1.0.1/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: pymojis
+Version: 1.0.1
+Summary: A lightweight, type-safe Python library for emoji search, transformation, and detection.
+Author-email: Pallandir <pallandir2@gmail.com>
+Maintainer-email: Pallandir <pallandir2@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/pallandir/pymojis
+Project-URL: Repository, https://github.com/pallandir/pymojis
+Project-URL: Issues, https://github.com/pallandir/pymojis/issues
+Project-URL: Changelog, https://github.com/pallandir/pymojis/releases
+Keywords: emoji,unicode,text,utilities
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Classifier: Natural Language :: English
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: full
+Requires-Dist: pymojis-fulldata==1.0.1; extra == "full"
+Provides-Extra: dev
+Requires-Dist: build~=1.2; extra == "dev"
+Requires-Dist: pre-commit~=4.2; extra == "dev"
+Requires-Dist: pytest~=8.4; extra == "dev"
+Requires-Dist: pytest-cov~=6.0; extra == "dev"
+Requires-Dist: pytest-mock~=3.10; extra == "dev"
+Requires-Dist: twine~=6.1; extra == "dev"
+Requires-Dist: mypy~=1.0; extra == "dev"
+Requires-Dist: ruff~=0.8; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest~=8.4; extra == "test"
+Requires-Dist: pytest-cov~=6.0; extra == "test"
+Requires-Dist: pytest-mock~=3.10; extra == "test"
+Dynamic: license-file
+
+# pymojis
+
+[![PyPI version](https://img.shields.io/pypi/v/pymojis.svg)](https://pypi.org/project/pymojis/)
+[![Python versions](https://img.shields.io/pypi/pyversions/pymojis.svg)](https://pypi.org/project/pymojis/)
+[![License: MIT](https://img.shields.io/pypi/l/pymojis.svg)](https://github.com/pallandir/pymojis/blob/main/LICENSE)
+[![CI](https://github.com/pallandir/pymojis/actions/workflows/github_ci.yaml/badge.svg)](https://github.com/pallandir/pymojis/actions/workflows/github_ci.yaml)
+
+A small, type-safe Python library for working with emojis: search them by
+name / code / character, transform text, detect emojis in strings, and
+convert to HTML.
+
+- **Zero runtime dependencies.**
+- **Two install sizes**: a tiny default (~230 KB of data) or the full
+  Unicode dataset (~1 MB) via the `[full]` extra.
+- **Strict typing** — `py.typed`, full mypy strict compliance.
+- **Fail-fast API** — bad input raises immediately, no silent `None`
+  returns or warnings.
+
+## Install
+
+```bash
+pip install pymojis              # lightweight: ~1900 emojis
+pip install 'pymojis[full]'      # full Unicode coverage: ~3790 emojis
+```
+
+Requires **Python 3.12+**.
+
+## Quick start
+
+```python
+from pymojis import PymojisManager
+
+manager = PymojisManager()
+
+# Pick random emojis
+print([e.emoji for e in manager.get_random(length=3)])
+# → ['😊', '🎉', '🌟']
+
+# Look up by name / code / character
+manager.get_by_name("grinning face with smiling eyes")  # → '😄'
+manager.get_by_code("1F604")                            # → '😄'
+manager.get_by_emoji("😊")                              # → Emoji(...)
+
+# Replace whole-word matches in text
+manager.emojifie("I'm sleepy")
+# → "I'm 😪"
+
+# Detection
+manager.contains_emojis("hello 👋")    # → True
+manager.is_emoji("😄")                 # → True
+manager.is_emoji("😄😊")               # → False
+
+# HTML hex references
+manager.to_html("😵‍💫")
+# → "&#x1F635;&#x200D;&#x1F4AB;"
+```
+
+To use the full Unicode dataset:
+
+```python
+manager = PymojisManager(use_full_dataset=True)
+# Requires `pip install 'pymojis[full]'`. Raises DatasetNotFoundError
+# with installation instructions otherwise.
+```
+
+## API
+
+| Method | Returns | Notes |
+|---|---|---|
+| `get_random(categories=None, length=1, exclude=None)` | `list[Emoji]` | `categories` takes precedence over `exclude`. |
+| `get_all_emojis(exclude=None)` | `list[Emoji]` | `exclude` accepts `"complex"` or a list of categories. |
+| `get_by_code(code)` | `str \| None` | Single-codepoint lookup. Case-insensitive. |
+| `get_by_name(name)` | `str \| None` | Full-name lookup. Case-insensitive. |
+| `get_by_category(category)` | `list[str]` | All emojis in a category. |
+| `get_by_emoji(emoji)` | `Emoji \| None` | Reverse lookup from character to record. |
+| `contains_emojis(text)` | `bool` | True if `text` contains at least one known emoji. |
+| `is_emoji(text)` | `bool` | True if `text.strip()` is a single known emoji. |
+| `emojifie(text)` | `str` | Replace whole words with emojis (whose name *contains* that word). |
+| `to_html(emoji)` | `str` | Encode each codepoint as `&#xHEX;`. |
+
+All methods raise `TypeError` on non-`str` arguments — no silent `None`.
+
+### Categories
+
+```python
+from pymojis import Categories
+
+Categories  # type alias of all valid categories:
+#   "Smileys & Emotion", "People & Body", "Animals & Nature",
+#   "Food & Drink", "Activities", "Travel & Places", "Objects",
+#   "Symbols", "Flags", "Component"
+```
+
+### `Emoji` data model
+
+```python
+from pymojis import Emoji
+
+@dataclass-like
+class Emoji:
+    id: str            # auto-generated UUID
+    emoji: str         # the character itself, e.g. "😄"
+    name: str          # e.g. "grinning face with smiling eyes"
+    code: list[str]    # one or more Unicode codepoints, e.g. ["1F604"]
+                       #   (multi-codepoint emojis like ZWJ sequences have len > 1)
+    category: str      # e.g. "Smileys & Emotion"
+    sub_category: str  # e.g. "face-smiling"
+```
+
+## Notes on `emojifie`
+
+`emojifie` does whole-word matching. Each word in the input is looked up in
+an index of emoji-name tokens. Tokens shorter than 3 characters are skipped
+(otherwise pronouns like "I" and "m" would be replaced by ℹ and Ⓜ). When a
+word matches multiple emojis, the first one (in dataset order) wins.
+
+```python
+manager.emojifie("I'm sleepy")           # → "I'm 😪"  (sleepy → "sleepy face")
+manager.emojifie("zzzz xyzzy")           # → "zzzz xyzzy"  (no match, unchanged)
+```
+
+## Releases (maintainer notes)
+
+This repo publishes **two** packages on every git tag: `pymojis` and
+`pymojis-fulldata`. Both must share the same version.
+
+To cut a release:
+
+```bash
+# 1. Bump version in BOTH pyproject files
+$EDITOR pyproject.toml                                  # version = "X.Y.Z"
+$EDITOR packages/pymojis-fulldata/pyproject.toml        # version = "X.Y.Z"
+# Also bump the [full] extra dependency pin in pyproject.toml.
+
+# 2. Commit, tag, push
+git commit -am "Release vX.Y.Z"
+git tag vX.Y.Z
+git push origin main --tags
+```
+
+CI runs the full `make ci` pipeline (lint, format, typecheck, tests,
+build both wheels, twine check) and publishes via PyPI Trusted Publishing
+(OIDC — no API tokens). One-time setup: register both projects as
+Trusted Publishers on https://pypi.org pointing at this repo and the
+workflow `.github/workflows/github_ci.yaml`.
+
+## Development
+
+A `Makefile` wraps the common workflows:
+
+```bash
+make install       # uv sync --extra dev --frozen
+make lint          # ruff check
+make format-check  # ruff format --check
+make typecheck     # mypy src
+make test          # pytest
+make build         # build both wheels into dist/
+make twine-check   # twine check dist/*
+make ci            # lint + format-check + typecheck + test + build + twine-check
+make clean         # remove dist/, build/, *.egg-info
+```
+
+`pre-commit` is configured: `uv run pre-commit install` once, and the same
+checks run on every commit.
+
+## Contributing
+
+Issues and PRs welcome. Please run the full check suite above before
+opening a PR.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+The bundled emoji metadata derives from the work of
+[Chalda Pnuzig](https://github.com/chalda-pnuzig/emojis.json) (ISC License,
+see `third_party/`).

pymojis-1.0.1/README.md

@@ -0,0 +1,177 @@
+# pymojis
+
+[![PyPI version](https://img.shields.io/pypi/v/pymojis.svg)](https://pypi.org/project/pymojis/)
+[![Python versions](https://img.shields.io/pypi/pyversions/pymojis.svg)](https://pypi.org/project/pymojis/)
+[![License: MIT](https://img.shields.io/pypi/l/pymojis.svg)](https://github.com/pallandir/pymojis/blob/main/LICENSE)
+[![CI](https://github.com/pallandir/pymojis/actions/workflows/github_ci.yaml/badge.svg)](https://github.com/pallandir/pymojis/actions/workflows/github_ci.yaml)
+
+A small, type-safe Python library for working with emojis: search them by
+name / code / character, transform text, detect emojis in strings, and
+convert to HTML.
+
+- **Zero runtime dependencies.**
+- **Two install sizes**: a tiny default (~230 KB of data) or the full
+  Unicode dataset (~1 MB) via the `[full]` extra.
+- **Strict typing** — `py.typed`, full mypy strict compliance.
+- **Fail-fast API** — bad input raises immediately, no silent `None`
+  returns or warnings.
+
+## Install
+
+```bash
+pip install pymojis              # lightweight: ~1900 emojis
+pip install 'pymojis[full]'      # full Unicode coverage: ~3790 emojis
+```
+
+Requires **Python 3.12+**.
+
+## Quick start
+
+```python
+from pymojis import PymojisManager
+
+manager = PymojisManager()
+
+# Pick random emojis
+print([e.emoji for e in manager.get_random(length=3)])
+# → ['😊', '🎉', '🌟']
+
+# Look up by name / code / character
+manager.get_by_name("grinning face with smiling eyes")  # → '😄'
+manager.get_by_code("1F604")                            # → '😄'
+manager.get_by_emoji("😊")                              # → Emoji(...)
+
+# Replace whole-word matches in text
+manager.emojifie("I'm sleepy")
+# → "I'm 😪"
+
+# Detection
+manager.contains_emojis("hello 👋")    # → True
+manager.is_emoji("😄")                 # → True
+manager.is_emoji("😄😊")               # → False
+
+# HTML hex references
+manager.to_html("😵‍💫")
+# → "😵‍💫"
+```
+
+To use the full Unicode dataset:
+
+```python
+manager = PymojisManager(use_full_dataset=True)
+# Requires `pip install 'pymojis[full]'`. Raises DatasetNotFoundError
+# with installation instructions otherwise.
+```
+
+## API
+
+| Method | Returns | Notes |
+|---|---|---|
+| `get_random(categories=None, length=1, exclude=None)` | `list[Emoji]` | `categories` takes precedence over `exclude`. |
+| `get_all_emojis(exclude=None)` | `list[Emoji]` | `exclude` accepts `"complex"` or a list of categories. |
+| `get_by_code(code)` | `str \| None` | Single-codepoint lookup. Case-insensitive. |
+| `get_by_name(name)` | `str \| None` | Full-name lookup. Case-insensitive. |
+| `get_by_category(category)` | `list[str]` | All emojis in a category. |
+| `get_by_emoji(emoji)` | `Emoji \| None` | Reverse lookup from character to record. |
+| `contains_emojis(text)` | `bool` | True if `text` contains at least one known emoji. |
+| `is_emoji(text)` | `bool` | True if `text.strip()` is a single known emoji. |
+| `emojifie(text)` | `str` | Replace whole words with emojis (whose name *contains* that word). |
+| `to_html(emoji)` | `str` | Encode each codepoint as `&#xHEX;`. |
+
+All methods raise `TypeError` on non-`str` arguments — no silent `None`.
+
+### Categories
+
+```python
+from pymojis import Categories
+
+Categories  # type alias of all valid categories:
+#   "Smileys & Emotion", "People & Body", "Animals & Nature",
+#   "Food & Drink", "Activities", "Travel & Places", "Objects",
+#   "Symbols", "Flags", "Component"
+```
+
+### `Emoji` data model
+
+```python
+from pymojis import Emoji
+
+@dataclass-like
+class Emoji:
+    id: str            # auto-generated UUID
+    emoji: str         # the character itself, e.g. "😄"
+    name: str          # e.g. "grinning face with smiling eyes"
+    code: list[str]    # one or more Unicode codepoints, e.g. ["1F604"]
+                       #   (multi-codepoint emojis like ZWJ sequences have len > 1)
+    category: str      # e.g. "Smileys & Emotion"
+    sub_category: str  # e.g. "face-smiling"
+```
+
+## Notes on `emojifie`
+
+`emojifie` does whole-word matching. Each word in the input is looked up in
+an index of emoji-name tokens. Tokens shorter than 3 characters are skipped
+(otherwise pronouns like "I" and "m" would be replaced by ℹ and Ⓜ). When a
+word matches multiple emojis, the first one (in dataset order) wins.
+
+```python
+manager.emojifie("I'm sleepy")           # → "I'm 😪"  (sleepy → "sleepy face")
+manager.emojifie("zzzz xyzzy")           # → "zzzz xyzzy"  (no match, unchanged)
+```
+
+## Releases (maintainer notes)
+
+This repo publishes **two** packages on every git tag: `pymojis` and
+`pymojis-fulldata`. Both must share the same version.
+
+To cut a release:
+
+```bash
+# 1. Bump version in BOTH pyproject files
+$EDITOR pyproject.toml                                  # version = "X.Y.Z"
+$EDITOR packages/pymojis-fulldata/pyproject.toml        # version = "X.Y.Z"
+# Also bump the [full] extra dependency pin in pyproject.toml.
+
+# 2. Commit, tag, push
+git commit -am "Release vX.Y.Z"
+git tag vX.Y.Z
+git push origin main --tags
+```
+
+CI runs the full `make ci` pipeline (lint, format, typecheck, tests,
+build both wheels, twine check) and publishes via PyPI Trusted Publishing
+(OIDC — no API tokens). One-time setup: register both projects as
+Trusted Publishers on https://pypi.org pointing at this repo and the
+workflow `.github/workflows/github_ci.yaml`.
+
+## Development
+
+A `Makefile` wraps the common workflows:
+
+```bash
+make install       # uv sync --extra dev --frozen
+make lint          # ruff check
+make format-check  # ruff format --check
+make typecheck     # mypy src
+make test          # pytest
+make build         # build both wheels into dist/
+make twine-check   # twine check dist/*
+make ci            # lint + format-check + typecheck + test + build + twine-check
+make clean         # remove dist/, build/, *.egg-info
+```
+
+`pre-commit` is configured: `uv run pre-commit install` once, and the same
+checks run on every commit.
+
+## Contributing
+
+Issues and PRs welcome. Please run the full check suite above before
+opening a PR.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+The bundled emoji metadata derives from the work of
+[Chalda Pnuzig](https://github.com/chalda-pnuzig/emojis.json) (ISC License,
+see `third_party/`).

pymojis-1.0.1/pyproject.toml

@@ -0,0 +1,148 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pymojis"
+version = "1.0.1"
+description = "A lightweight, type-safe Python library for emoji search, transformation, and detection."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    {name = "Pallandir", email = "pallandir2@gmail.com"}
+]
+maintainers = [
+    {name = "Pallandir", email = "pallandir2@gmail.com"}
+]
+keywords = ["emoji", "unicode", "text", "utilities"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+    "Natural Language :: English",
+]
+dependencies = []
+
+[project.optional-dependencies]
+full = ["pymojis-fulldata==1.0.1"]
+dev = [
+    "build~=1.2",
+    "pre-commit~=4.2",
+    "pytest~=8.4",
+    "pytest-cov~=6.0",
+    "pytest-mock~=3.10",
+    "twine~=6.1",
+    "mypy~=1.0",
+    "ruff~=0.8",
+]
+test = [
+    "pytest~=8.4",
+    "pytest-cov~=6.0",
+    "pytest-mock~=3.10",
+]
+
+[project.urls]
+Homepage = "https://github.com/pallandir/pymojis"
+Repository = "https://github.com/pallandir/pymojis"
+Issues = "https://github.com/pallandir/pymojis/issues"
+Changelog = "https://github.com/pallandir/pymojis/releases"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["pymojis*"]
+exclude = ["tests*"]
+
+[tool.setuptools.package-data]
+pymojis = ["py.typed", "infrastructure/data/*.json"]
+
+[tool.uv.workspace]
+members = ["packages/*"]
+
+[tool.uv.sources]
+pymojis-fulldata = { workspace = true }
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "-v",
+]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "integration: marks tests as integration tests",
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "T20", # print found
+    "N",   # pep8-naming
+    "S",   # bandit security checks
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+    "B008",  # function calls in argument defaults
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["S101"]  # allow asserts in tests
+"scripts/*" = ["T20"]  # CI scripts may print
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_unreachable = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+
+[tool.coverage.run]
+source = ["src"]
+branch = true
+omit = [
+    "tests/*",
+    "*/tests/*",
+    "*/test_*",
+    "*/conftest.py",
+]
+
+[tool.coverage.report]
+precision = 2
+show_missing = true
+skip_covered = false
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "if typing.TYPE_CHECKING:",
+    "@overload",
+]
+fail_under = 80

pymojis-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pymojis-1.0.1/src/pymojis/__init__.py

@@ -0,0 +1,5 @@
+from .application.pymojis_manager import PymojisManager
+from .domain.entities.emojis import Categories, Emoji
+
+__version__ = "1.0.1"
+__all__ = ["Categories", "Emoji", "PymojisManager", "__version__"]

pymojis-1.0.1/src/pymojis/application/pymojis_manager.py

@@ -0,0 +1,103 @@
+from typing import Literal
+
+from pymojis.domain.entities.emojis import Categories, Emoji
+from pymojis.infrastructure.pymojis_repository import PymojisRepositoryImpl
+
+
+class PymojisManager:
+    """High-level facade for emoji search, transformation, and detection.
+
+    By default the manager loads the lightweight bundled dataset (~228 KB).
+    Pass ``use_full_dataset=True`` to load the full dataset, which requires
+    the optional ``pymojis-fulldata`` package (``pip install 'pymojis[full]'``).
+    """
+
+    def __init__(self, *, use_full_dataset: bool = False) -> None:
+        self.repository = PymojisRepositoryImpl()
+        self.repository.load_emojis(kind="full" if use_full_dataset else "light")
+
+    def get_random(
+        self,
+        categories: list[Categories] | None = None,
+        length: int = 1,
+        exclude: Literal["complex"] | list[Categories] | None = None,
+    ) -> list[Emoji]:
+        """Return ``length`` random ``Emoji`` objects, optionally filtered.
+
+        Args:
+            categories: If provided, only emojis from these categories are
+                considered. Takes precedence over ``exclude``.
+            length: Number of emojis to return. Capped at the size of the pool.
+            exclude: ``"complex"`` to exclude multi-codepoint emojis (skin
+                tones, ZWJ sequences), or a list of categories to skip.
+
+        Example:
+            >>> manager = PymojisManager()
+            >>> [e.emoji for e in manager.get_random(length=2)]  # doctest: +SKIP
+            ['😊', '🌟']
+        """
+        return self.repository.get_random_emojis(categories, length, exclude)
+
+    def get_all_emojis(
+        self, exclude: Literal["complex"] | list[Categories] | None = None
+    ) -> list[Emoji]:
+        """Return every loaded ``Emoji``, optionally filtered by ``exclude``."""
+        return self.repository.get_all(exclude)
+
+    def get_by_code(self, code: str) -> str | None:
+        """Return the emoji character matching the given Unicode codepoint.
+
+        Only single-codepoint emojis are addressable this way. Returns
+        ``None`` if no match.
+        """
+        return self.repository.get_by_code(code)
+
+    def get_by_name(self, name: str) -> str | None:
+        """Return the emoji character whose full name equals ``name``.
+
+        Matching is case-insensitive. Returns ``None`` if no match.
+        """
+        return self.repository.get_by_name(name)
+
+    def get_by_category(self, category: Categories) -> list[str]:
+        """Return all emoji characters in the given category."""
+        return self.repository.get_by_category(category)
+
+    def get_by_emoji(self, emoji: str) -> Emoji | None:
+        """Return the ``Emoji`` object whose character equals ``emoji``."""
+        return self.repository.get_by_emoji(emoji)
+
+    def contains_emojis(self, text: str) -> bool:
+        """Return ``True`` if ``text`` contains at least one known emoji."""
+        return self.repository.contains_emojis(text)
+
+    def is_emoji(self, text: str) -> bool:
+        """Return ``True`` if ``text`` (after stripping) is a single known emoji."""
+        return self.repository.is_emoji(text)
+
+    def emojifie(self, text: str) -> str:
+        """Replace each whole word in ``text`` whose lowercase form is a token
+        of an emoji name with that emoji.
+
+        Tokens are matched against the first word of any emoji's name (e.g.
+        ``"sleepy"`` matches the emoji named ``"sleepy face"``). Words that
+        match no emoji are left unchanged.
+
+        Example:
+            >>> manager = PymojisManager()
+            >>> manager.emojifie("I'm sleepy")  # doctest: +SKIP
+            "I'm 😪"
+        """
+        return self.repository.emojifie(text)
+
+    def to_html(self, emoji: str) -> str:
+        """Return ``emoji`` as a sequence of HTML hex character references.
+
+        Multi-codepoint emojis (ZWJ sequences, variation selectors) are
+        encoded codepoint by codepoint.
+
+        Example:
+            >>> PymojisManager().to_html("😪")  # doctest: +SKIP
+            '😪'
+        """
+        return self.repository.to_html(emoji)