Metadata-Version: 2.2
Name: sopel-kym
Version: 0.1.3
Summary: Meme definition plugin for Sopel IRC bots.
Author-email: dgw <dgw@technobabbl.es>
License: EFL-2.0
Project-URL: Homepage, https://github.com/dgw/sopel-kym
Project-URL: Bug Tracker, https://github.com/dgw/sopel-kym/issues
Keywords: sopel,plugin,bot,irc
Platform: Linux x86, x86-64
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: Eiffel Forum License (EFL)
Classifier: License :: OSI Approved :: Eiffel Forum License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Communications :: Chat :: Internet Relay Chat
Requires-Python: <4,>=3.8
Description-Content-Type: text/markdown
License-File: COPYING
Requires-Dist: sopel>=8.0
Requires-Dist: culturgen~=0.1.0

# sopel-kym

Meme definition plugin for Sopel IRC bots.

## Installing

Releases are hosted on PyPI, so after installing Sopel, all you need is `pip`:

```shell
$ pip install sopel-kym
```

## Using

`sopel-kym` provides a `.kym` command to search for memes by name, and also
tries to fetch details for `knowyourmeme.com` meme page links:

```
<dgw> .kym false promise juice
<Sopel> [kym] False Promise Juice. False Promises Juice refers to a series of
        object labeled Nanalan' remixes on TikTok in which Mona, labeled
        "Management" attempts to feed juice, labeled "False Promise Juice," to
        a duck stuffed animal, labeled "Burnt employees." The template grew
        popular on the site in the summer of 2024. |
        https://knowyourmeme.com/memes/false-promise-juice

<dgw> https://knowyourmeme.com/memes/all-your-base-are-belong-to-us
<Sopel> [kym] All Your Base Are Belong To Us. "All Your Base Are Belong to Us"
        is a popular engrish catchphrase that grew popular across the internet
        as early as in 1998. An awkward translation of "all of your bases are
        now under our control", the quote originally appeared in the opening
        dialogue of Zero Wing, a 16-bit shoot'em up game released in 1989.
        Marked by poor grammar, the "All Your Base" phrase and the dialogue
        scene went […]
```

## Changelog

### 0.1.3

Changed:

* Switch to my own `culturgen` library
  * This plugin stopped returning results correctly, and `memedict` hasn't seen
    any attention since 2018, so forking the package seemed justified.

### 0.1.2

Changed:

* Allow `http://` links too, and tighten up the pattern matching (#4)

Fixed:

* Catch error if `memedict` library randomly returns `None` for the URL (#3)


### 0.1.1

Fixed:
* "Unexpected TypeError" after the bot says "No results."


### 0.1.0

First release of `sopel-kym`.
