duolingo4d 0.0.4

A most easily usable Duolingo API wrapper in Dart. With Duolingo4D, you can easily integrate your application with the Duolingo API.

example/example.dart

// Copyright (c) 2021, Kato Shinya. All rights reserved.
// Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import 'package:duolingo4d/duolingo4d.dart';

class DemoDuolingo4D {
  void main() async {
    // Get the singleton instance.
    final duolingo = Duolingo.instance;

    //! ---------- ↓ Authentication Does Not Required ↓ ----------

    // You can fetch metadata about the configuration of Duolingo.
    // ignore: unused_local_variable
    final versionInfoResponse = await duolingo.versionInfo();

    // You can authenticate user with this api.
    // You can use registered email address as a username.
    final authResponse = await duolingo.authenticate(
      username: 'test_username',
      password: 'test_password',
    );

    if (authResponse.status.isNotOk) {
      // Client or Server error or something.
      authResponse.status.reasonPhrase;
      authResponse.headers;
      return;
    }

    if (authResponse.hasError) {
      // When there is an error on authentication.
      final authError = authResponse.error!;
      authError.code;
      authError.reason;

      authError.isInvalidUser; // Returns true if user is invalid.
      authError.isInvalidPassword; // Returns true if password is invalid.
      return;
    }

    // You can fetch hint of word.
    // It is possible to specify not only words but also sentences in bulk.
    // ignore: unused_local_variable
    final wordHintResponse = await duolingo.wordHint(
      fromLanguage: 'en',
      learningLanguage: 'es',
      sentence: 'boligrafos',
    );

    for (final token in wordHintResponse.tokens) {
      final headers = token.table.headers;
      for (final header in headers) {
        // ignore: avoid_print
        print(header.token);
      }

      final rows = token.table.rows;
      for (final row in rows) {
        for (final cell in row.cells) {
          // ignore: avoid_print
          print(cell.hint);
        }
      }
    }

    //! ---------- ↑ Authentication Does Not Required ↑ ----------

    //! -------------- ↓ Authentication Required ↓ --------------

    // You can fetch user information based on user id.
    // ignore: unused_local_variable
    final userResponse = await duolingo.user(userId: authResponse.userId);

    // You can fetch all vocabularies you learned in Duolingo.
    // ignore: unused_local_variable
    final overviewResponse = await duolingo.overview();

    for (final vocabulary in overviewResponse.vocabularies) {
      // ignore: avoid_print
      print(vocabulary.word);
    }

    final switchLanguageResponse = await duolingo.switchLanguage(
      fromLanguage: 'es',
      learningLanguage: 'en',
    );

    // ignore: avoid_print
    print(switchLanguageResponse.status.code);
    // ignore: avoid_print
    print(switchLanguageResponse.status.reasonPhrase);

    //! -------------- ↑ Authentication Required ↑ --------------
  }
}