tdlight-team/TDLightTelegramBots
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update wiki to show how to access AbilityBot.silent in AbilityExtension implemented class, update ExtensionTest to show change

Browse Source
This commit is contained in:
nubdub 2021-12-09 00:23:35 -05:00
parent 2663d01761
commit 7dd0711cdb
2 changed files with 58 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
TelegramBots.wiki/abilities/Ability-Extensions.md
View File

@ -2,23 +2,30 @@
You have around 100 abilities in your bot and you're looking for a way to refactor that mess into more modular classes. `AbillityExtension` is here to support just that! It's not a secret that AbilityBot uses refactoring backstage to be able to construct all of your abilities and map them accordingly. However, AbilityBot searches initially for all methods that return an `AbilityExtension` type. Then, those extensions will be used to search for declared abilities. Here's an example.
```java
public class MrGoodGuy implements AbilityExtension {
private AbilityBot extensionUser;
public MrGoodGuy(AbilityBot extensionUser) { this.extensionUser = extensionUser; }
public Ability nice() {
return Ability.builder()
.name("nice")
.privacy(PUBLIC)
.locality(ALL)
.action(ctx -> silent.send("You're awesome!", ctx.chatId())
.action(ctx -> extensionUser.silent().send("You're awesome!", ctx.chatId())
);
}
}
public class MrBadGuy implements AbilityExtension {
private AbilityBot extensionUser;
public MrBadGuy(AbilityBot extensionUser) { this.extensionUser = extensionUser; }
public Ability notnice() {
return Ability.builder()
.name("notnice")
.privacy(PUBLIC)
.locality(ALL)
.action(ctx -> silent.send("You're horrible!", ctx.chatId())
.action(ctx -> extensionUser.silent().send("You're horrible!", ctx.chatId())
);
}
}
@ -28,11 +35,11 @@ public class MrBadGuy implements AbilityExtension {
// Constructor for your bot
public AbilityExtension goodGuy() {
return new MrGoodGuy();
return new MrGoodGuy(this);
}
public AbilityExtension badGuy() {
return new MrBadGuy();
return new MrBadGuy(this);
}
// Override creatorId
@ -46,7 +53,7 @@ It's also possible to add extensions in the constructor by using the `addExtensi
public YourAwesomeBot() {
super(/* pass required args ... */);
addExtensions(new MrGoodGuy(), new MrBadGuy());
addExtensions(new MrGoodGuy(this), new MrBadGuy(this));
}
// Override creatorId

11
telegrambots-abilities/src/test/java/org/telegram/abilitybots/api/bot/ExtensionTest.java
View File

@ -43,7 +43,7 @@ class ExtensionTest {
public static class ExtensionUsingBot extends AbilityBot {
ExtensionUsingBot() {
super("", "", offlineInstance("testing"));
addExtension(new AbilityBotExtension("addedInConstructor"));
addExtension(new AbilityBotExtension("addedInConstructor", this));
}
@Override
@ -52,11 +52,11 @@ class ExtensionTest {
}
public AbilityBotExtension methodReturningExtensionSubClass() {
return new AbilityBotExtension("returningSubClass");
return new AbilityBotExtension("returningSubClass", this);
}
public AbilityExtension methodReturningExtensionSuperClass() {
return new AbilityBotExtension("returningSuperClass");
return new AbilityBotExtension("returningSuperClass", this);
}
public Ability methodReturningAbility() {
@ -73,9 +73,11 @@ class ExtensionTest {
public static class AbilityBotExtension implements AbilityExtension {
private String name;
private AbilityBot extensionUser;
AbilityBotExtension(String name) {
AbilityBotExtension(String name, AbilityBot extensionUser) {
this.name = name;
this.extensionUser = extensionUser;
}
public Ability abc() {
@ -85,6 +87,7 @@ class ExtensionTest {
.locality(ALL)
.privacy(PUBLIC)
.action(ctx -> {
extensionUser.silent().send("This is a test message.", ctx.chatId());
})
.build();
}