Skip to main content

This library from easy work with aiogram

Project description

aiodgram

What is this?

The module makes it easier for you to use the basic functions of AIOGRAM, such as sending messages/photos/video and start your bot.

Using

Let's import it first: First, import class TgBot and types from the library (use the 'from ... import TgBot, types' construct). Second, create a object from class TgBot (use 'name = TgBot()' construct) Third, You must write arguments to this object, token: string, admin_username: string

from `...` import TgBot

bot = TgBot(`token`, `admin_username`)

AFTER object_botname = bot

Use in asyng defines

Examples:

@`bot`.dispatcher.message_handler()
async def test:
  await bot.send_message(`chat_id`, `text`)

or

@`bot`.dispatcher.message_handler()
async def test:
  await bot.send_photo(`chat_id`, `photo_url`, caption=`text`)

or

@`bot`.dispatcher.message_handler()
async def test:
  await bot.send_video(`chat_id`, `video_url`, caption=`text`)

Beautiful messages to console

You can create your beautiful messages to console with color!

First, import class MyMessages from the library (use the 'from ... import MyMessages' construct)

Second, create a object from class MyMessages (use 'name = MyMessage()' construct)

Third, you must use a message define based on this object (use, 'name.message()' construct)

Fourth, You must write arguments to this define, clear: bool, message:string, colors:string.

Example:

from `...` import MyMessages

my_msg = MyMessage()

print(my_msg.message(clear=`bool`, text=`text`, color=`[green, blue]`))

Download a videos from YouTube

You can download a video from YouTube using this library!

First, import class DownloadVideo from the library (use the 'from ... import DownloadVideo' construct)

Second, create a object from class DownloadVideo (use 'name = DownloadVideo()' construct)

Third, you must use a Download_This_Video define based on this object (use, 'name.Download_This_Video()' construct)

Fourth, you must write arguments to this define, link_on_video: string, video_name: string, resolution: int

Example:

from `...` import DownloadVideo

video = DownloadVideo()

video.download_This_Video(link_on_video=`link`, video_name=`name of file`, resolution=`720p`)

Create your buttons

You can create buttons for your messages!

For reply_markup

Example:

from `...` import Button

btns = Button()

keyboard = [
  [
    btns.add_button(`text`)
  ],
  [
    btns.add_button(`text`)
  ]
]

reply_btns = btns.add_markup(keyboard)

And, you must add object from fourth point to send_message ; send_photo ; send_video in reply_markup argument

For inline_markup

Example:

from `...` import Button

btns = Button()

keyboard = [
  [
    btns.add_inline_button(`text`, `callback`)
  ],
  [
    btns.add_inline_button(`text`, `callback`)
  ]
]

reply_btns = btns.add_inline_markup(keyboard)

And, you must add object from fourth point to send_message or send_photo or send_video in reply_markup argument

Show loading animation in your bot

First, you must use a define from TgBot (use 'bot.loading()')

Second, you must write argumets to this define, chat_id: int, percentages: int

Example:

bot = TgBot(`token`)

@`bot`.dispatcher.message_handler()
async def test:
  await bot.loading(`chat_id`, `percentages`)

Easy work with SQL

Example:

from `...` import Database

db = Database(`filename db`)

db.create_data(`table`, columns=`list`, values=`list`) #Creating a cell in a DB table

db.select_data(`table`, column=`str`, search_column=`str`, search_data=`str`) #Return list with your datas

db.edit_data(`table`, column=`str`, new_data=`any`, search_column=`str`, search_data=`str`) #Edit data in your DB

db.delete_data(`table`, search_column=`str`, search_data=`str`) #Delete data fro DB

Your custom exceptions

Example:

from `...` import MyException

MyException(message='', extra_info=any)

Logging your project

Example:

from `...` import Logged

`log` = Logged(type_logging='info', filename='log.log')

`log`.info(message='')
`log`.error(message='')
`log`.warning(message='')
`log`.critical(message='')
`log`.debug(message='')

Password maker

Example:

from `...` import PasswordMaker, TgBot, types
bot = TgBot(`token`, `admin_username`)

password = PasswordMaker(bot=bot)

@bot.dispatcher.message_handler()
async def password_maker(message: types.Message):
  await password.make(message.from_user.id, 'Input a password lenght')

Edit text in your message

Example:

from `...` inport TgBot

bot = TgBot(`token`, `admin_username`)

@dp.message_handler()
async def a(message: types.Message):
  text = message.text
  chat_id = message.chat.id

  await bot.edit_message_text(text=text, chat_id=chat_id)

Edit inline markup in your message

Example:

from `...` inport TgBot

bot = TgBot(`token`, `admin_username`)
your_inline_markup = 'your markup'

@dp.message_handler()
async def a(message: types.Message):
  chat_id = message.chat.id
  message_id = message.message_id

  await bot.edit_message_markup(chat_id=chat_id, message_id=message_id, reply_markup=your_inline_markup)

For start your bot, you need

bot.start_polling(dispatcher=bot Dispatcher, skip_updates=True or False, on_startup=define for start, on_shutdown=define for shutdown).

Example:

from `...` import TgBot
bot = TgBot()

bot.start_polling(`nothing arguments or your arguments`)

Developers

authors: Darkangel, Arkeep

authors telegrams: t.me/darkangel58414 and t.me/Stillcrayg

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

aiodgram-2.6.3-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

File details

Details for the file aiodgram-2.6.3-py3-none-any.whl.

File metadata

  • Download URL: aiodgram-2.6.3-py3-none-any.whl
  • Upload date:
  • Size: 17.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for aiodgram-2.6.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0b78c7a19aba15e8e6ed59825619846954cbc6070de7c0aa13a95568900e29ba
MD5 11ed7969c6df61fd3b7bb96285f76126
BLAKE2b-256 9dd806f6e7140e7dbdac10a8d6b6480b5c5e26ec1fefe1946ecdd0cc687001e3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page