Skip to content

djxzinik/rChileRandom-Bot

Repository files navigation

alt text

r/Chile Random bot

Este es un simple bot diseñado para contar y mantener un registro de la cantidad de comentarios que realiza un usuario en cada Hilo Random Semanal que se realiza en r/Chile

Datos

Todos los datos procesados por el bot se pueden encontrar en la rama Data.

También se pueden visualizar los datos en forma visualmente más atractivo en esta página realizada por u/0x00cl

Con el objetivo de poder procesar los datos correctamente, el bot captura los siguientes datos/parámetros y los almacena en su propia base de datos:

  • Usuarios:
    • Nombre de Usuario de los usuarios
    • Fecha del primer comentario visto por el bot de cada usuario
  • Hilos:
    • ID del hilo
    • Año del hilo
    • Número de semana del hilo
  • Comentarios:
    • ID del comentario
    • Nivel del hilo/conversación del comentario
    • Fecha y hora del comentario
    • Número del comentario en el Hilo

Comandos

El ejecutable del bot no posee ningún comando ni parámetro. Sin embargo, dentro de los Hilos Random, es posible llamar al bot ocupando dos comandos:

  • randombot!top: El bot responderá con el TOP3 del hilo actual hasta el momento. Estos datos son en vivo y pueden diferir con los que sale en la rama Data
  • randombot!info: El bot responderá con los enlaces asociados al bot, tales como los datos del hilo actual, los hilos anterioers, etc.

Uso

Para ocupar este bot, se tienen que cumplir ciertos requisitos:

  1. Tener una base de datos MySQL con una base de datos que contenga la Estructura especial para el bot
  2. Tener Python3 y pip3 instalado.
  3. Ejecutar el comando pip3 install -r requirements.txt
  4. Dependiendo del OS/plataforma, crear un script ejecutable que contenga las variables del entorno que necesita el bot. En el caso de Linux, se puede ocupar el siguiente Script:
#!/bin/bash

export r_client_id=[CLIENT ID FROM REDDIT APPS]
export r_client_secret=[CLIENT SECRET FROM REDDIT APPS]

export r_username=[BOT USER ID FROM REDDIT]
export r_password=[BOT PASSWORD]

export db_host=[DATABASE HOST]
export db_user=[DATABASE USER]
export db_pass=[DATABASE PASS]
export db_database=[DATABASE NAME]

/usr/bin/python3 randomdata.py
  1. Ejecutar el bot ocupando el Script.

Contribuciones

Todo tipo de contribución es bienvenido, ya sean ideas (Issues) o mejoras en el código (Pull Request).

La única condición es que se mantenga el objetivo inicial del bot: Poder contar y procesar los comentarios de los usuarios manteniendo la transparencia y privacidad.

Cualquier idea o aporte que presente un problema para mantener la transparencia o la privacidad, o que tenga como objetivo comercializar, exponer, perjudicar o atacar a uno o varios usuarios será rechazado.

Librerías utilizadas

Licencia

GNU General Public License v3.0

Privacidad

Todos los datos capturados por este programa serán utilizados exclusivamente con fines estadísticos y en ningún momento se venderán a terceros. Agregando a lo anterior, todos los datos extraídos por el programa son de carácter público y en ningún momento se obtendrán, utilizarán ni se guardarán datos privados de los usuarios.

About

Bot de analitica del Random de rChile

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Languages