sturdy_http 0.6.0

A strongly typed, event-based, reliable HTTP client that wraps `Dio`.

example/main.dart

import 'package:charlatan/charlatan.dart';
import 'package:sturdy_http/sturdy_http.dart';

void main(List<String> args) async {
  // Set up some fake HTTP responses using Charlatan
  final charlatan = Charlatan()
    ..whenGet('/foo', (request) => CharlatanHttpResponse(body: 'Hello World!'))
    ..whenPost('/foo', (request) => CharlatanHttpResponse(statusCode: 204));

  // Create your client
  final client = SturdyHttp(
    baseUrl: 'api/v1/',
    customAdapter: charlatan.toFakeHttpClientAdapter(),
    eventListener: ExampleEventListener(),
  );

  // A GetRequest. Prints 'Hello World!'.
  await client.execute<Json, void>(
    GetRequest('/foo'),
    onResponse: (r) {
      return switch (r) {
        OkResponse(:final response) => print(response),
        _ => print('GET /foo failed: $r'),
      };
    },
  );

  // A PostRequest.
  //
  // Prints:
  // 'mutative request success' <-- From ExampleEventListener
  // 'success!'
  await client.execute<void, void>(
    PostRequest('/foo', data: EmptyRequestBody()),
    onResponse: (r) {
      return switch (r) {
        OkNoContent() => print('success!'),
        _ => print('POST /foo failed: $r'),
      };
    },
  );
}

class ExampleEventListener implements SturdyHttpEventListener {
  @override
  Future<void> onEvent(SturdyHttpEvent event) async {
    switch (event) {
      case DecodingError():
        print('decoding error');
      case AuthFailure():
        print('auth failure');
      case MutativeRequestSuccess():
        print('mutative request success');
    }
  }
}