tcmb_api_client 0.0.2

This Dart package provides a simple and efficient way to interact with the Central Bank of Republic of Türkiye (TCMB) API. It allows you to fetch exchange rates and other related data.

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:tcmb_api_client/tcmb_api_client.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'TCMB API Client Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'TCMB API Client Demo'),
    );
  }
}

// The smallest example of using [TcmbApiClient] to fetch exchange rates from TCMB API
class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final _apiClient = TcmbApiClient();
  late Future<List<Currency>> _ratesFuture;
  late Future<Currency?> _usdRateFuture;

  @override
  void initState() {
    super.initState();

    _ratesFuture = _fetchRates();
    _usdRateFuture = _fetchUsdRate();
  }

  Future<List<Currency>> _fetchRates() async {
    try {
      return await _apiClient.getRates();
    } catch (e) {
      // Handle or rethrow the error as appropriate for your app
      debugPrint('Error fetching rates: $e');
      rethrow;
    }
  }

  Future<Currency?> _fetchUsdRate() async {
    try {
      return await _apiClient.getSingleRate(CurrencyCode.USD);
    } catch (e) {
      // Handle or rethrow the error as appropriate for your app
      debugPrint('Error fetching rates: $e');
      rethrow;
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
        actions: [
          FutureBuilder<Currency?>(
            future: _usdRateFuture,
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.waiting) {
                return const Center(child: CircularProgressIndicator());
              } else if (snapshot.hasError) {
                return Center(child: Text('Error: ${snapshot.error}'));
              } else {
                final usdRate = snapshot.data;
                if (usdRate == null) {
                  return const Center(child: Text('No data'));
                }
                return Padding(
                  padding: const EdgeInsets.all(8.0),
                  child: Text(
                    'USD/TRY: ${usdRate.forexBuying}',
                  ),
                );
              }
            },
          ),
        ],
      ),
      body: FutureBuilder<List<Currency>>(
          future: _ratesFuture,
          builder: (context, snapshot) {
            final rates = snapshot.data;
            if (rates == null) {
              return const Center(child: Text('No data'));
            }
            return ListView.builder(
              itemCount: rates.length,
              itemBuilder: (context, index) {
                final currency = rates[index];
                return ListTile(
                  title: Text(currency.nameInTurkish),
                  subtitle: Text('${currency.code}/TRY'),
                  trailing: Text(
                    currency.forexBuying.toString(),
                    style: Theme.of(context).textTheme.bodyLarge,
                  ),
                );
              },
            );
          }),
    );
  }

  @override
  void dispose() {
    _apiClient.dispose();
    super.dispose();
  }
}

copied to clipboard