bnfour's (deprecated) (python) telegram bot(s)

New and shiny version available!

This repo is no longer supported, see the new dotnet version at https://github.com/bnfour/tg-bots-dotnet.

Outdated description

Disclaimer: this was written back in 2018, and does not work with the latest async-based version of the Telegram wrapper library used within. I can't be bothered to rewrite this and/or change the library to use, so take this code with a grain of salt.
The 2023 updates are mostly styling and shuffling the same code around, the code itself remains scuffed questionable by standards of 2023 version of me.

Currently there is source for two (very-very-ultra useful) telegram bots.

Ladder bot

Inline bot that generates texts running along horizontal, vertical and diagonal directions simultaneously, for instance:

@bnladder_bot sample text generates prompts for two messages:

1. With spaces:

S A M P L E   T E X T
A A
M   M
P     P
L       L
E         E

T             T
E               E
X                 X
T                   T

2. Without spaces:

SAMPLE TEXT
AA
M M
P  P
L   L
E    E

T      T
E       E
X        X
T         T

Cat macro bot

Inline bot that can be used to post any pictures searchable by defined captions. I use it to store and post cat pictures I used to spam before I moved to Telegram and started spamming stickers.
Here's an example screenshot:

You can also try searching for stuff like cat tech or bread to see the outstanding quality of the pictures I hoarded.

Usage

This bot isn't strictly inline: administrator accounts can manage pictures via chatting:

• Sending a captioned photo will add that photo and make it searchable by provided caption.
• /delete caption instructs bot to delete the image, if it exists.
  (command can be anything starting with /delet)

Deployment

Requires Python 3.10+ for fancy typing annotations. If you remove all type | None annotations, will work on 3.6+. If you need to go even deeper, replace all f-strings with format calls. (I know all of this because my distro is too stable for me going after those fancy new things.)

See requirements.txt for dependencies. python-Levenshtein is optional and may be removed, although fuzzywuzzy will tell you to install it for performance reasons.

Configuration, including tokens for both bots and list of admin accounts, is stored in config_secrets.py file. This file is not tracked in this repo, so you can edit it without accidentally committing debug or even production configs for the world to see.

See provided config_secrets.example.py for a list of things this file should define.

You'll need to provide some kind of SSL-proxy to the bottle app used to host the bots.