Roll-API Dart

Dart library for Roll-API

This icon ↑ indicates if API is working right now

What the hell is Roll-API??

It's a super cool API that allows you to roll a real dice and get it's number! Check it out: https://github.com/TheLastGimbus/Roll-API

How to use

1. Import:

   import 'package:rollapi/rollapi.dart' as roll;
   

2. Simple way - use getRandomNumber():

   print("Rolling a dice...");
   roll.getSimpleResult().then((result) => print("Number: $result"));
   

   It returns pure Future<int>, and throws an exception if something failed

3. More advance way: use makeRequest():

   It returns a Request object, which contains UUID and Stream of values:

   var request = await roll.makeRequest();
   request.stateStream.listen((event) {
    switch (event.key) {
      case roll.RequestState.queued:
        print('Wating...');
        // .queued value is an ETA DateTime - which can be null
        if (event.value != null) {
          var sec = (event.value as DateTime).difference(DateTime.now());
          print('Time left: $sec seconds');
        }
        break;
      case roll.RequestState.failed:
        print('Request failed :(((');
        // .failed value is an exception - you can throw it
        throw event.value;
        break;
      case roll.RequestState.finished:
        print('Finished!!! Number: ${event.value}');
        break;
      default:
        break;
    }
   });
   

If you want to use another instance, because you want to test your own or official is currently down, you can:

import 'package:rollapi/rollapi.dart' as roll;
roll.API_BASE_URL = 'http://192.168.1.100:5000/api/'; 

CLI

This package also offers really nice CLI, that can, for example, generate you a random password! You can either get it with dart pub global activate rollapi, or from GitHub releases: https://github.com/TheLastGimbus/rollapi_dart/releases/

Then, you can run:

$ rollapi roll
Rolling the dice...
1

$ rollapi pwd --numbers -l 6
Generating random password...
0%
8%
...
92%
DONE! Your password: cwgl0r