steffo/patched-porobot
steffo/patched-porobot
1
Fork 0
mirror of https://github.com/Steffo99/patched-porobot.git synced 2024-12-23 01:54:22 +00:00
Code Activity

Document deck queries in the bot's instructions

Browse source
This commit is contained in:
Steffo 2022-08-22 18:01:32 +02:00
parent 323265ed72
commit bbfb146087
Signed by: steffo
GPG key ID: 6965406171929D01
1 changed files with 17 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
src/bin/patched_porobot_telegram.rs
View file

@ -1,12 +1,12 @@
//! # [@patchedporobot] //! # [@patchedporobot]
//! //!
//! Inline bot for searching and sending Legends of Runeterra cards in Telegram chats //! Inline bot for searching and sending Legends of Runeterra cards and decks in Telegram chats
//! //!
//! ## Usage //! ## Usage
//! //!
//! [@patchedporobot] is a inline bot: this means that you can use it everywhere, without having to add it to chats. //! [@patchedporobot] is a inline bot: this means that you can use it everywhere, without having to add it to chats.
//! //!
//! ### Basic queries //! ### Card queries
//! //!
//! You can search for a card by entering in the "Write a message..." bot the username of the bot, followed by the card you want to search for: //! You can search for a card by entering in the "Write a message..." bot the username of the bot, followed by the card you want to search for:
//! //!
@ -26,7 +26,7 @@
//! @patchedporobot piltover poro //! @patchedporobot piltover poro
//! ``` //! ```
//! //!
//! ### Conjunctions //! #### Conjunctions
//! //!
//! By default, all terms in the query are joined by `AND` conjuctions, meaning that only cards containing **all** of the terms are retrieved. //! By default, all terms in the query are joined by `AND` conjuctions, meaning that only cards containing **all** of the terms are retrieved.
//! //!
@ -42,7 +42,7 @@
//! @patchedporobot von AND yipp OR cat //! @patchedporobot von AND yipp OR cat
//! ``` //! ```
//! //!
//! ### Fields //! #### Fields
//! //!
//! You can perform searches about specific card properties: //! You can perform searches about specific card properties:
//! //!
@ -56,11 +56,11 @@
//! @patchedporobot name:Bard OR description:Chime //! @patchedporobot name:Bard OR description:Chime
//! ``` //! ```
//! //!
//! #### Supported fields //! ##### Supported fields
//! //!
//! [@patchedporobot] supports the various fields for searching cards: see [**this table**](patched_porobot::search::cardsearch::CardSearchEngine::schema) for a list of all of them! //! [@patchedporobot] supports the various fields for searching cards: see [**this table**](patched_porobot::search::cardsearch::CardSearchEngine::schema) for a list of all of them!
//! //!
//! ### Ranges //! #### Ranges
//! //!
//! Finally, you can request specific ranges for your search using square brackets and the `TO` keyword: //! Finally, you can request specific ranges for your search using square brackets and the `TO` keyword:
//! //!
@ -68,10 +68,20 @@
//! @patchedporobot attack:[8 TO 12] //! @patchedporobot attack:[8 TO 12]
//! ``` //! ```
//! //!
//! ### Query parser //! #### Query parser
//! //!
//! Since [@patchedporobot] uses [`tantivy`] internally, you might find more information on even more advanced queries in the [documentation of their `QueryParser`](tantivy::query::QueryParser)! //! Since [@patchedporobot] uses [`tantivy`] internally, you might find more information on even more advanced queries in the [documentation of their `QueryParser`](tantivy::query::QueryParser)!
//! //!
//! ### Deck queries
//!
//! You can have [@patchedporobot] display a deck and its cards by pasting the deck code after the bot's username:
//!
//! ```text
//! @patchedporobot CIBQCAICAQAQGBQIBEBAMBAJBMGBUHJNGE4AEAIBAIYQEAQGEU2QCAIBAIUQ
//! ```
//!
//! Then, select the "Deck with N cards" option to send the deck's card list in the chat!
//!
//! //!
//! [@patchedporobot]: https://t.me/patchedporobot //! [@patchedporobot]: https://t.me/patchedporobot