quotes_bot

Um bot do telegram para dividir sabedoria com o mundo! Para ver os resultados, basta acessar meu canal do Telegram, o site oficial ou meu canal no Youtube.

Detalhes

• Projeto completo! 🎉🎉🎉
• 1140 frases para você usar onde quiser (e mais algumas quando eu tiver vontade).

Autores

Planos Futuros

• [x] Gerar captions com base em imagem e frases escolhidas aleatoriamente a partir de base de dados.
• [x] Mecanismo para adicionar frases na base de dados a partir da linha de comando.
• [x] Opção para pesquisar na base de dados a partir da linha de comando por frases de um autor
• [x] Opção para pesquisar na base de dados a partir da linha de comando por frases com determinada string.
• [x] Opção para pesquisar na base de dados a partir da linha de comando por frases de um autor com determinada string.
• [x] Gerar caption a partir de imagem, frase e autor especificados na linha de comando
• [x] Opção para verificar estatísticas básicas sobre a base de dados.
• [x] Watermark.
• [x] Novas fontes de letra.
• [x] Extrair estatísticas de visualização diretamente do Telegram
• [X] Agendar envio de mensagens automaticamente.
• [X] Translate code and README to english.
• [ ] Inserir todas as frases sábias escritas pela raça humana.
• [x] Inserir todas as frases sábias escritas pelos golfinhos.

O código

SQLite

O script utiliza uma base de dados chamada citacoes.db, a qual pode ser criada conforme abaixo:

import sqlite3

con = sqlite3.connect('citacoes.db');
cur = con.cursor();

cur.execute("CREATE TABLE images (ultima int, image text, red integer, green integer, blue integer, link text)");
cur.execute("CREATE TABLE "citacoes" (autor text, frase text, enviar int)");
con.commit()

As citações que eu utilizei estão disponíves aqui. Uma lista das imagens está disponível aqui, destaco, porém, que eu não sou proprietário dessas imagens, sendo todas disponibilizadas a partir do unsplash.

Python

O código é bem simples, temos três funções: main, quebra_lista_alt, fazedor_de_imagem.

main

É a responsável por selecionar a frase, a imagem e enviar para o Telegram.
O código abaixo é usado para selecionar a frase, perceba que o campo "enviar" é utilizado como um marcador, para evitar que uma frase já enviada seja enviada novamente. "Mas por que não excluir da BD?", eu preetendo reutilizar algumas frases à medida que eu for adicionando novas imagens.

# Selecionando a frase
rowid, autor, frase = cur.execute(f"select rowid, autor, frase from citacoes where enviar = 0 ORDER BY RANDOM() LIMIT 1;").fetchall()[0];
cur.execute(f"update citacoes set enviar=1 where rowid = {rowid};");
con.commit();

Abaixo, a seleção da frase, mas com o foco de evitar apenas que a mesma imagem seja enviado duas vezes seguidas:

imagem, red, green, blue, link = cur.execute(f"SELECT image, red, green, blue, link FROM images WHERE ultima=0 ORDER BY RANDOM() LIMIT 1;").fetchall()[0];
cur.execute(f"update images set ultima=0 where ultima=1;");
cur.execute(f"update images set ultima=1 where image = '{imagem}';");
con.commit();
color = (red, green, blue);

"Mas por que você não usou uma API de imagem como...", de fato, eu pensei em usar APIs do tipo como a loremflickr e a Lorem Picsum, o problema é que, como as imagens são aleatórias, há o risco de as palavras terem a mesma cor que o fundo da imagem, tornando a caption ilegível. Eu até considerei editar a imagem com um quadrado monocromático e escrever dentro dele, mas os resultados não me agradaram. No momento, o uso de APIs de imagem continua uma meta de desenvolvimento futuro.

O envio da imagem é feito por uma função assíncrona improvisada, o link é só uma forma de agradecer a Unsplash pelas imagens gratuitas:

async def enviando_mensagem():
    await client.send_file('me',"temp.jpg",caption=f"[Foto original]({link})");

with client:
    client.loop.run_until_complete(enviando_mensagem());

fazedor_de_imagem

É a função responsável por escrever a frase selecionada na imagem. Por padrão, a frase é escrita a partir do meio da imagem, utilizando a quebra_lista_alt para quebrar a frase em diferentes linhas (evitando que a frase saia da imagem). No futuro, pretendo adicionar uma variável "offset" com o objetivo de controlar o ponto de início da frase.

Utilização e Opções

Help

Para ver as opções disponíveis, basta acessar a opção "-h"

>python bot.py -h
usage: bot.py [-h] [--autor AUTOR] [--frase FRASE] [--inserir] [--delete DELETE] [--stats] [--teste]

Um bot para gerar imagens e postar no Telegram automaticamente.

options:
  -h, --help       show this help message and exit
  --autor AUTOR    Pesquisar citações de um dado autor.
  --frase FRASE    Pesquisar citações que contenham o termo inserido.
  --inserir        Inserir MANUALMENTE novas frases
  --delete DELETE  Deletar frase com base no rowid
  --stats          Gera relatório sobre as informações na base de dados
  --teste          Gera caption com imagem específica para teste

autor

Essa opção permite visualizar todas as frases escritas pelos autores cujo autor se encaixe no padrão especificado. É interessante notar que a entrada é usada para pesquisar no SQL, ou seja, você pode utilizar o "%" para verificar todos os autores dentro daquele padrão.

>python bot.py --autor "Oscar%"
autor:  Oscar%
rowid      | autor                | frase
------------------------------------------------------------------------------------
232        | Oscar Wilde          | Os loucos às vezes se curam, os imbecis nunca.
------------------------------------------------------------------------------------

Frase

Similar à opção "autor" porém procura por frases contendo a string. Pode ser utilizada em combinação ou separado da função a cima para pesquisar por frases:

>python bot.py --autor "Fried%" --frase "%macaco%"
autor:  Fried%
frase:  %macaco%
rowid      | autor                | frase
------------------------------------------------------------------------------------
125        | Friedrich Nietzsche  | O macaco é um animal demasiado simpático para que o homem descenda dele.
------------------------------------------------------------------------------------

inserir

Usada para inserir frases novas na base de dados e no arquivo json (o qual é usado para exportar as frases para o Github). Após apertar ENTER será exibido um prompt com as strings inseridas. Use a oportunidade para garantir que digitou corretamente e digite "n" caso tenha notado algum erro ou "y" caso tudo certo.

>python bot.py --inserir --autor "Terry Pratchett" --frase "A inteligência de uma criatura conhecida como multidão é a raiz quadrada do número de pessoas dentro dela."

-----------------
autor: Terry Pratchett
frase: A inteligência de uma criatura conhecida como multidão é a raiz quadrada do número de pessoas dentro dela.
-----------------
Posso inserir (y/n)? y
Citações:  299

delete

Usada para deletar frases com base no id:

>python bot.py --delete 299

-----------------
rowid: 299
autor: Terry Pratchett
frase: A inteligência de uma criatura conhecida como multidão é a raiz quadrada do número de pessoas dentro dela.
Deletar?(y/n) y

stats

Fornece estatísticas básicas sobre a base de dados, incluindo número de total de frases, número de frases a ser enviado, número de frases para enviar, autores, dentre outras:

>python bot.py --stats
GERANDO RELATÓRIO. AGUARDE UM POUCO.
========================================================
+------------------------------+------------+
|        TOTAL DE FRASES       | 300        |
|   TOTAL DE FRASES ENVIADAS   | 16         |
| TOTAL DE FRASES NÃO ENVIADAS | 284        |
+------------------------------+------------+
+-------------------------+------------+
| Abraham Lincoln                | 1          |
| Agatha Christie                | 3          |
| Albert Einstein                | 8          |
| Andrew Carnegie                | 1          |
...
| William Blake                  | 1          |
| William Shakespeare            | 16         |
| Zenão de Cítio, pensador grego | 2          |
+-------------------------+------------+
========================================================

watermark

Adiciona watermark à imagem especificada na linha de comando.

>python bot.py --watermark "path_para_sua_imagem\imagem_alvo.jpg"

Autores Disponíveis

Agradecimentos

• Unsplash - Fotos gratuitas para todos os usos.
• Matheus Guerra - 366 frases perfeitas!
• Lonami - criador do projeto Telethon
• Pensador - Frases inspiradoras para todos os gostos!

Fontes

• Automate the Boring Stuff: Breve tutorial sobre o módulo PIL
• Documentação do Pillow
• Documentação do Telethon
• Lore Ipsum: Utilizei para testar diferentes tamanhos das frases.
• Quebrando vetores em vetores menores
• Watermark
• Matheus Guerra