TelegramAsDatabase 2.1.0

TelegramAsDatabase

The official repository for telegram as database

Now telegram as database (TDB) is availabe on nuget.org: click here

Getting start

1. Create a bot using bot father in telegram (Important: Dont Change the bot description at all)

   

2. Create a channel as a database source in telegram

   

3. Now add your bot that created in the first step to the channel as an administrator and give all premissions to it.

   

4. Goto your appsettings and add TDB config to it.:

   • The api key is key that you get from BotFather in the first step
   • The Channel Id is the id of the channel you can get it by forwarding a message of the channel to @userinfobot bot.

   "TDBConfig": {
       "ApiKey": "7753344678:AAFf4MIQSShxa4djp172DjhDe2_jqRsyOeU",
       "ChannelId": "-1002378130994"
   }
   

5. Now Add Tdb to your service container:

   var configurations = builder.Configuration;
   builder.Services.AddTDB(configurations);
   

6. Done! now you can use the telegram free database

How to use

The example code of using the TDB:

public class MyCustomService
{
    private ITDB _tdbService;

    public MyCustomService(ITDB tdb)
    {
        _tdbService = tdb;
    }

    public async Task MyCustomMethod(CancellationToken cancellationToken)
    {
        // [--------- GetAllKeysAsync ---------]
        var allKeys = await _tdbService.GetAllKeysAsync(cancellationToken);

        // [------------ SaveAsync ------------]
        var saveResult = await _tdbService.SaveAsync(new TDBData<MyTestModel>()
        {
            Key = "item-key",
            Value = new MyTestModel()
            {
                Name = "FirstTest",
                Description = "FirstDescription",
                Type = "FuncTest"
            }
        }, cancellationToken);

        // [--------- UpdateAsync ---------]
        var updateResult = await _tdbService.UpdateAsync("item-key", new TDBData<MyTestModel>()
        {
            Key = "item-key",
            Value = new MyTestModel()
            {
                Name = "FirstTest2",
                Description = "FirstDescription2",
                Type = "FuncTest2"
            }
        }, cancellationToken);

        // [--------- DeleteAsync ---------]
        var deleteResult = await _tdbService.DeleteAsync("item-key", cancellationToken);
    }
}