em-keyboard


Nameem-keyboard JSON
Version 4.1.0 PyPI version JSON
download
home_page
SummaryThe CLI Emoji Keyboard
upload_time2023-09-28 21:02:24
maintainerHugo van Kemenade
docs_urlNone
author
requires_python>=3.8
licenseISC
keywords cli emoji keyboard search
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # em: the cli emoji keyboard

[![PyPI version](https://img.shields.io/pypi/v/em-keyboard.svg?logo=pypi&logoColor=FFE873)](https://pypi.org/project/em-keyboard/)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/em-keyboard.svg?logo=python&logoColor=FFE873)](https://pypi.org/project/em-keyboard/)
[![PyPI downloads](https://img.shields.io/pypi/dm/em-keyboard.svg)](https://pypistats.org/packages/em-keyboard)
[![GitHub Actions status](https://github.com/hugovk/em-keyboard/workflows/Test/badge.svg)](https://github.com/hugovk/em-keyboard/actions)
[![codecov](https://codecov.io/gh/hugovk/em-keyboard/branch/main/graph/badge.svg)](https://codecov.io/gh/hugovk/em-keyboard)
[![GitHub](https://img.shields.io/github/license/hugovk/em-keyboard.svg)](LICENSE)

**Emoji your friends and colleagues from the comfort of your own
terminal.**

**em** is a nifty command-line utility for referencing emoji characters
by name. Provide the names of a few emoji, and those lucky chosen emojis
will be displayed in your terminal, then copied to your clipboard.
Automagically.

Emoji can be also searched by both categories and aspects.

## Example Usage

Let's serve some delicious cake:

<!-- [[[cog
from scripts.run_command import run
run("em sparkles shortcake sparkles")
]]] -->

```console
$ em sparkles shortcake sparkles
Copied! ✨ 🍰 ✨
```

<!-- [[[end]]] -->

Let's skip the copying (for scripts):

<!-- [[[cog run("em 'chocolate bar' --no-copy") ]]] -->

```console
$ em 'chocolate bar' --no-copy
🍫
```

<!-- [[[end]]] -->

Let's find some emoji, by color:

<!-- [[[cog run("em -s yellow") ]]] -->

```console
$ em -s yellow
πŸ’›  yellow_heart
🌼  blossom
πŸŒ•  full_moon
⭐  star
🚸  children_crossing
🟑  yellow_circle
🟨  yellow_square
```

<!-- [[[end]]] -->

If there's only a single search result, it's copied:

<!-- [[[cog run("em -s ukraine") ]]] -->

```console
$ em -s ukraine
Copied! πŸ‡ΊπŸ‡¦  flag_ukraine
```

<!-- [[[end]]] -->

## Installation

At this time, **em** requires Python and pip:

```sh
python3 -m pip install em-keyboard
```

That's it!

## Tests

If you wanna develop, you might want to write and run tests:

```sh
python3 -m pip install tox
tox
```

## Have fun!

✨🍰✨

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "em-keyboard",
    "maintainer": "Hugo van Kemenade",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "CLI,emoji,keyboard,search",
    "author": "",
    "author_email": "Kenneth Reitz <me@kennethreitz.org>",
    "download_url": "https://files.pythonhosted.org/packages/b3/ef/96c4e7411d489e1c67594580a7abb416370ba7235ed31afcafa02a2146e2/em_keyboard-4.1.0.tar.gz",
    "platform": null,
    "description": "# em: the cli emoji keyboard\n\n[![PyPI version](https://img.shields.io/pypi/v/em-keyboard.svg?logo=pypi&logoColor=FFE873)](https://pypi.org/project/em-keyboard/)\n[![Supported Python versions](https://img.shields.io/pypi/pyversions/em-keyboard.svg?logo=python&logoColor=FFE873)](https://pypi.org/project/em-keyboard/)\n[![PyPI downloads](https://img.shields.io/pypi/dm/em-keyboard.svg)](https://pypistats.org/packages/em-keyboard)\n[![GitHub Actions status](https://github.com/hugovk/em-keyboard/workflows/Test/badge.svg)](https://github.com/hugovk/em-keyboard/actions)\n[![codecov](https://codecov.io/gh/hugovk/em-keyboard/branch/main/graph/badge.svg)](https://codecov.io/gh/hugovk/em-keyboard)\n[![GitHub](https://img.shields.io/github/license/hugovk/em-keyboard.svg)](LICENSE)\n\n**Emoji your friends and colleagues from the comfort of your own\nterminal.**\n\n**em** is a nifty command-line utility for referencing emoji characters\nby name. Provide the names of a few emoji, and those lucky chosen emojis\nwill be displayed in your terminal, then copied to your clipboard.\nAutomagically.\n\nEmoji can be also searched by both categories and aspects.\n\n## Example Usage\n\nLet's serve some delicious cake:\n\n<!-- [[[cog\nfrom scripts.run_command import run\nrun(\"em sparkles shortcake sparkles\")\n]]] -->\n\n```console\n$ em sparkles shortcake sparkles\nCopied! \u2728 \ud83c\udf70 \u2728\n```\n\n<!-- [[[end]]] -->\n\nLet's skip the copying (for scripts):\n\n<!-- [[[cog run(\"em 'chocolate bar' --no-copy\") ]]] -->\n\n```console\n$ em 'chocolate bar' --no-copy\n\ud83c\udf6b\n```\n\n<!-- [[[end]]] -->\n\nLet's find some emoji, by color:\n\n<!-- [[[cog run(\"em -s yellow\") ]]] -->\n\n```console\n$ em -s yellow\n\ud83d\udc9b  yellow_heart\n\ud83c\udf3c  blossom\n\ud83c\udf15  full_moon\n\u2b50  star\n\ud83d\udeb8  children_crossing\n\ud83d\udfe1  yellow_circle\n\ud83d\udfe8  yellow_square\n```\n\n<!-- [[[end]]] -->\n\nIf there's only a single search result, it's copied:\n\n<!-- [[[cog run(\"em -s ukraine\") ]]] -->\n\n```console\n$ em -s ukraine\nCopied! \ud83c\uddfa\ud83c\udde6  flag_ukraine\n```\n\n<!-- [[[end]]] -->\n\n## Installation\n\nAt this time, **em** requires Python and pip:\n\n```sh\npython3 -m pip install em-keyboard\n```\n\nThat's it!\n\n## Tests\n\nIf you wanna develop, you might want to write and run tests:\n\n```sh\npython3 -m pip install tox\ntox\n```\n\n## Have fun!\n\n\u2728\ud83c\udf70\u2728\n",
    "bugtrack_url": null,
    "license": "ISC",
    "summary": "The CLI Emoji Keyboard",
    "version": "4.1.0",
    "project_urls": {
        "Changelog": "https://github.com/hugovk/em-keyboard/releases",
        "Homepage": "https://github.com/hugovk/em-keyboard",
        "Source": "https://github.com/hugovk/em-keyboard"
    },
    "split_keywords": [
        "cli",
        "emoji",
        "keyboard",
        "search"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cdf6bffba2a48ea4dd2db7441bc62527c8f984d142f91faf7e263f1e2e157646",
                "md5": "5f52c883d2818df2ad1bfba58ac5d269",
                "sha256": "83550443bc31c7a04f3eae22aaa04fe60469102470bad669b6fd5b1984c7aa35"
            },
            "downloads": -1,
            "filename": "em_keyboard-4.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5f52c883d2818df2ad1bfba58ac5d269",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 73389,
            "upload_time": "2023-09-28T21:02:22",
            "upload_time_iso_8601": "2023-09-28T21:02:22.911374Z",
            "url": "https://files.pythonhosted.org/packages/cd/f6/bffba2a48ea4dd2db7441bc62527c8f984d142f91faf7e263f1e2e157646/em_keyboard-4.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b3ef96c4e7411d489e1c67594580a7abb416370ba7235ed31afcafa02a2146e2",
                "md5": "3898ec9969c20c8ec729663a728d814f",
                "sha256": "951752828ce10315bfe0eafec53ca41cb08ac5dab842a481089e766479fabb45"
            },
            "downloads": -1,
            "filename": "em_keyboard-4.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "3898ec9969c20c8ec729663a728d814f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 78209,
            "upload_time": "2023-09-28T21:02:24",
            "upload_time_iso_8601": "2023-09-28T21:02:24.487606Z",
            "url": "https://files.pythonhosted.org/packages/b3/ef/96c4e7411d489e1c67594580a7abb416370ba7235ed31afcafa02a2146e2/em_keyboard-4.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-28 21:02:24",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "hugovk",
    "github_project": "em-keyboard",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "tox": true,
    "lcname": "em-keyboard"
}
        
Elapsed time: 0.11709s