azure_app_config 0.18.0+1

A Dart package to communicate with Microsoft Azure App Configuration.

example/main.dart

import 'dart:developer' as developer;

import 'package:azure_app_config/azure_app_config.dart';

void main() async {
  const exampleKey = 'example_key';
  const exampleLabel = 'example_label';

  // Creating an instance needs a connection String. This can be
  // obtained through the Azure Portal, under "Access Keys".
  final service = AzureAppConfig(connectionString: '<CONNECTION_STRING>');

  // Getting a keyvalue
  late KeyValue keyValue;

  try {
    keyValue = await service.getKeyValue(key: exampleKey, label: exampleLabel);
  } catch (err) {
    // Handle any exceptions that might occur when interacting with the Azure
    // service
    developer.log('Error occurred while getting key value: $err');
  }

  // Now you can retrieve any property of the keyValue, for instance
  developer.log(keyValue.value);

  // If the KeyValue is a FeatureFlag, you can use .asFeatureFlag()
  // to get the properties of the FeatureFlag
  final featureFlag = keyValue.asFeatureFlag();

  // .asFeatureFlag() will return null if it's unable to parse.
  if (featureFlag != null) {
    // To check if the featureflag is enabled, use
    developer.log('${featureFlag.enabled}');
  }

  try {
    // (!!) Make sure to register a FeatureFilter before using it.
    service.registerFeatureFilter(
      FeatureFilter.targeting(
        user: '[e-mail]',
      ),
    );
    // To check if a FeatureFlag is enabled while parsing FeatureFilters, use
    final isFeatureEnabled =
        await service.getFeatureEnabled(key: exampleKey, label: exampleLabel);

    developer.log('$isFeatureEnabled');
  } catch (err) {
    // Handle any exceptions that might occur when interacting with the Azure
    // service
    developer.log('Error occurred while checking if feature is enabled: $err');
  }

  // To find FeatureFlags based on a key and label filter use findKeyValuesBy().
  // This example searches for the keyValues that start with '.appconfig.'
  // without a label:
  try {
    final keyValues = await service.findKeyValuesBy(
      key: '.appconfig.*',
      label: AzureFilters.noLabel,
    );

    // Loop through the values
    for (final keyValue in keyValues) {
      developer.log(keyValue.value);
    }

    // When an invalid filter has been provided, for example, '.appconfig.**',
    // an [AzureFilterValidationException] is thrown.
  } on AzureFilterValidationException catch (e) {
    developer.log(e.errorResponse.detail ?? 'Error occurred!');
  }
}