Hmmm

.gitignore

@@ -3,7 +3,25 @@ __pycache__
 
 *.session
 *.session-journal
+*.DB
+*.DB-journal
+
 data/
-config.py
+config.env
 sessions/
 
+*.jpg
+*.mp4
+*.pyc
+*.txt
+
+Manjari*
+
+stdplugins/auto_destruct_read_messages.py
+stdplugins/cheat_tg.py
+stdplugins/deleted_messages_watcher.py
+stdplugins/quotlybot.py
+stdplugins/tb_button.py
+stdplugins/auto_pp*.py
+stdplugins/ban_channels*.py
+stdplugins/annoy_mention_796.py

Dockerfile

@@ -0,0 +1,78 @@
+#  creates a layer from the base Docker image.
+FROM python:3.9-slim-buster
+
+WORKDIR /app
+
+# https://shouldiblamecaching.com/
+ENV PIP_NO_CACHE_DIR 1
+
+# fix "ephimeral" / "AWS" file-systems
+RUN sed -i.bak 's/us-west-2\.ec2\.//' /etc/apt/sources.list
+
+# to resynchronize the package index files from their sources.
+RUN apt -qq update
+
+# base required pre-requisites before proceeding ...
+RUN apt -qq install -y --no-install-recommends \
+    curl \
+    git \
+    gnupg2 \
+    unzip \
+    wget
+
+# to resynchronize the package index files from their sources.
+RUN apt -qq update
+
+# http://bugs.python.org/issue19846
+# https://github.com/SpEcHiDe/PublicLeech/pull/97
+ENV LANG C.UTF-8
+
+# we don't have an interactive xTerm
+ENV DEBIAN_FRONTEND noninteractive
+
+# install google chrome
+RUN mkdir -p /tmp/ && \
+    cd /tmp/ && \
+    wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb && \
+    # -f ==> is required to --fix-missing-dependancies
+    dpkg -i ./google-chrome-stable_current_amd64.deb; apt -fqqy install && \
+    # clean up the container "layer", after we are done
+    rm ./google-chrome-stable_current_amd64.deb
+
+# install chromedriver
+RUN mkdir -p /tmp/ && \
+    cd /tmp/ && \
+    wget -O /tmp/chromedriver.zip http://chromedriver.storage.googleapis.com/$(curl -sS chromedriver.storage.googleapis.com/LATEST_RELEASE)/chromedriver_linux64.zip  && \
+    unzip /tmp/chromedriver.zip chromedriver -d /usr/bin/ && \
+    # clean up the container "layer", after we are done
+    rm /tmp/chromedriver.zip
+
+# install required packages
+RUN apt -qq install -y --no-install-recommends \
+    # this package is required to fetch "contents" via "TLS"
+    apt-transport-https \
+    # install coreutils
+    build-essential coreutils jq pv \
+    # install gcc [ PEP 517 ]
+    gcc \
+    # install encoding tools
+    ffmpeg mediainfo \
+    unzip zip \
+    # miscellaneous helpers
+    megatools && \
+    # clean up the container "layer", after we are done
+    rm -rf /var/lib/apt/lists /var/cache/apt/archives /tmp
+
+# each instruction creates one layer
+# Only the instructions RUN, COPY, ADD create layers.
+# copies 'requirements', to inside the container
+# ..., there are multiple '' dependancies,
+# requiring the use of the entire repo, hence
+# adds files from your Docker client’s current directory.
+COPY . .
+
+# install requirements, inside the container
+RUN pip3 install --no-cache-dir -r requirements.txt
+
+# specifies what command to run within the container.
+CMD ["python3", "-m", "kopp"]

Procfile

@@ -1 +1 @@
-worker: python3 -m stdborg
+worker: python3 -m kopp

README.md

@@ -4,57 +4,58 @@ Pluggable [``asyncio``](https://docs.python.org/3/library/asyncio.html)
 [Telegram](https://telegram.org) userbot based on
 [Telethon](https://github.com/LonamiWebs/Telethon).
 
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+Mozilla Public License for more details.
+
+
+## disclaimer
+
+⚠️ This fork uses "requests" module in various places, instead of the async alternative. ⚠️
+
+- This was an attempt to learn userbot development using Telethon, __this project is now no longer usable__, and is FORKed and MODIFied to suit MY needs, so **use at your own risk**.
+
+
 ## installing
 
-#### The Easy Way
+#### The Easiest Way
 
-[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)
+- Install Docker by following the [official docker docs](https://docs.docker.com/engine/install/debian/)
+
+- Start docker daemon [skip if already running]:
+```sh
+dockerd
+```
+- Build Docker image:
+```sh
+docker build . -t uniborg
+```
+- Run the image:
+```sh
+docker run uniborg
+```
+
+It is not recommended to use "sudo", while using Docker.
+GNU/Linux Permissions are highly customisable, and it is generally not required to have "ROOT" permission, ~~unless you know what you are doing~~.
+You can still install all the dependencies in your system [with ROOT permissions],
+but please be aware of the potential issues when doing so. The installed packages
+may conflict with the system package manager's installed packages, which can
+cause trouble down the road and errors when upgrading conflicting packages.
+**You have been warned.**
 
 #### The Legacy Way
 Simply clone the repository and run the main file:
 ```sh
 git clone https://github.com/udf/uniborg.git
 cd uniborg
-virtualenv -p /usr/bin/python3 venv
+python3 -m venv venv
 . ./venv/bin/activate
 pip install -r requirements.txt
-# <Create config.py with variables as given below>
-python3 -m stdborg YourSessionName
-```
-
-An example `config.py` file could be:
-
-**Not All of the variables are mandatory**
-
-__The UniBorg should work by setting only these variables__
-
-```python3
-from sample_config import Config
-
-class Development(Config):
-  APP_ID = 6
-  API_HASH = "eb06d4abfb49dc3eeb1aeb98ae0f581e"
-  TG_BOT_TOKEN_BF_HER = ""
-  TG_BOT_USER_NAME_BF_HER = ""
-  UB_BLACK_LIST_CHAT = [
-    -1001220993104,
-    -1001365798550,
-    -1001158304289,
-    -1001212593743,
-    -1001195845680,
-    -1001330468518,
-    -1001221185967,
-    -1001340243678,
-    -1001311056733,
-    -1001135438308,
-    -1001038774929,
-    -1001070622614,
-    -1001119331451,
-    -1001095401841
-  ]
-  # specify LOAD and NO_LOAD
-  LOAD = []
-  NO_LOAD = []
+cp sample_config.env config.env
+# <edit config.env with appropriate values>
+python3 -m kopp
 ```
 
 ## internals
@@ -63,15 +64,15 @@ The core features offered by the custom `TelegramClient` live under the
 [`uniborg/`](https://github.com/SpEcHiDe/uniborg/tree/master/uniborg)
 directory, with some utilities, enhancements, the `_core` plugin, and the `_inline_bot` plugin.
 
-
-## [@SpEcHlDe](https://telegram.dog/ThankTelegram)
-
-- Only two of the environment variables are mandatory.
-- This is because of `telethon.errors.rpc_error_list.ApiIdPublishedFloodError`
-    - `APP_ID`:   You can get this value from https://my.telegram.org
-    - `API_HASH`:   You can get this value from https://my.telegram.org
-- The userbot will work without setting the non-mandatory environment variables.
-- Please report any issues to the support group: [@SpEcHlDe](https://t.me/joinchat/AHAujEjG4FBO-TH-NrVVbg)
+- Only five of the environment variables are mandatory.
+- Please read the [WiKi](https://github.com/SpEcHiDe/UniBorg/wiki) to understand the use of the variables.
+- This is because of `telethon.errors.ApiIdPublishedFloodError`
+    - `APP_ID`: 
+    - `API_HASH`:
+    - `TG_BOT_TOKEN_BF_HER`: 
+    - `TG_BOT_USER_NAME_BF_HER`: 
+    - `DATABASE_URL`: 
+- The userbot should work without setting the non-mandatory environment variables.
 
 
 ## design
@@ -80,25 +81,25 @@ The modular design of the project enhances your Telegram experience
 through [plugins](https://github.com/SpEcHiDe/uniborg/tree/master/stdplugins)
 which you can enable or disable on demand.
 
-Each plugin gets the `borg`, `logger`, `Config`, `tgbot` magical
+Each plugin gets the `borg`, `logger`, `Config` magical
 [variables](https://github.com/spechide/UniBorg/blob/488eff632e65103ba7017d4f52777d22ddd52ea2/uniborg/uniborg.py#L76-L80)
 to ease their use. Thus creating a plugin as easy as adding
 a new file under the plugin directory to do the job:
 
 ```python
 # stdplugins/myplugin.py
-from telethon import events
-from uniborg.util import admin_cmd
-
-@borg.on(admin_cmd(pattern="hi"))
+@borg.on(slitu.admin_cmd(pattern="hi"))
 async def handler(event):
-    await event.reply("hey")
+    await event.client.send_message(
+        event.chat_id,
+        "hey"
+    )
 ```
 
 
 ## learning
 
-Check out the already-mentioned [plugins](https://github.com/SpEcHiDe/UniBorg/tree/master/stdplugins) directory, or some third-party [plugins](https://telegram.dog/UniBorg) to learn how to write your own, and consider reading [Telethon's documentation](http://telethon.readthedocs.io/).
+Check out the already-mentioned [plugins](https://github.com/SpEcHiDe/UniBorg/tree/master/stdplugins) directory, or some third-party [plugins](https://telegram.dog/UniBorg) to learn how to write your own, and consider reading [Telethon's documentation](http://docs.telethon.dev/).
 
 
 ## credits
@@ -107,4 +108,3 @@ Check out the already-mentioned [plugins](https://github.com/SpEcHiDe/UniBorg/tr
 Thanks to:
 - [lonami](https://lonami.dev) for creating [Telethon](https://github.com/lonamiwebs/Telethon)
 - [![CopyLeft](https://telegra.ph/file/b514ed14d994557a724cb.jpg)](https://telegra.ph/file/fab1017e21c42a5c1e613.mp4 "CopyLeft Credit Video")
-