Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings
Dan Corin edited this pageNov 28, 2023 ·4 revisions

How to write a Minimal Working Example

If you read this, you probably were asked to provide a minimal working example (MWE) in theuser group or theissue tracker of thepython-telegram-bot library.

So here is what that means:

Example

When trying to help you with a problem, it's often helpful to see your code instead of a vague description of the issue. Of course, a better description often also helps (seethis article on asking good technical questions).

Working

In order for the example to actually be helpful, it must work. This means that it:

Is ready to run

Code that's not runnable is not very useful to see an issue - at least most times. Make sure that whoever is trying to help you only needs to plug in a bot token, run the script and send/start to the bot for the example to run.

In particular this means that

  • all necessary imports are included
  • no undefined functions are called or undefined modules imported
  • apart from PTB no additional dependencies need to be installed

Reproduces the issue

If the provided example doesn't show the described problem, it's not much of an example.

Minimal

Make sure that your example contains everything needed for the problem to show - and nothing more! Nothing delays finding a bug more than hundreds of unrelated lines of code. Your example should fit in a single short file. Reducing your problematic code to such a minimal example often times already helps to identify the actual issue.

Publishing

Be sure to remove your bot token before publishing the MWE!Always send it along with a concise description of what exactly the problem is and how it can be reproduced with your MWE.

As a final note, if you were asked for an MWE in the user group, please post your code using a pastebin, e.g.https://hastebin.com orhttps://pastebin.com, instead of posting it as plain text in the user group.

Wiki ofpython-telegram-bot © Copyright 2015-2025 – Licensed byCreative Commons

Must read

  1. Introduction to the API
  2. Tutorial: Your first bot
  3. FAQ
  4. How to ask good questions
  5. How to write an MWE

Concepts & Important Elements

  1. Architecture Overview
  2. Builder Pattern forApplication
  3. Types of Handlers
  4. Working with Files and Media
  5. Exceptions, Warnings and Logging
  6. Concurrency in PTB

Notable Features

  1. Advanced Filters
  2. Storing data
  3. Making your bot persistent
  4. Adding Defaults
  5. Job Queue
  6. Arbitrarycallback_data
  7. Avoiding flood limits
  8. Webhooks
  9. Bot API Forward Compatiblity

Code Resources

  1. Frequently requested design patterns
  2. Code snippets
  3. Performance Optimizations
  4. Telegram Passport
  5. Bots built with PTB
  6. Automated Bot Tests

Examples explained

  1. InlineKeyboard Example

Networking

  1. Working Behind a Proxy
  2. Handling network errors

Other resources

  1. Where to host Telegram Bots
  2. How to host your bot
  3. Local API Server
  4. Type Checking with PTB
  5. Press
  6. Notes on GAE
  7. Related Projects
  8. Emoji

Transition Guides

Administration

Clone this wiki locally

[8]ページ先頭

©2009-2025 Movatter.jp