master_utility 0.0.12

All-in-one utility solution with Size, Navigation, Image Picker, Date Time, Auto Size Text, Toast, Email, Log, Dialog, Cache Image, Validation, API and Shared Preferences.

Master Utility Package

A package that enables you to use a comprehensive set of utilities in a single package with customization. It includes features like Done Keyboard View For Android and IOS, Size Helper, Navigation Helper, Image Picker Helper, Date Time Helper, Auto Size Text Helper, Toast Helper, Email Dispose, Log Helper, Dialog Helper, Cache Network Image Helper, Validation Helper, Api Helper, Shared Preference Helper,image cropper helper, Debounce helper, Read more Text Helper, duble click redundant Helper and Permission handler with custom type Helper.

Support

- Android
- iOS

How to add this package to your project add this dependencies inside your pubspec.yaml file

dependencies:
   master_utility :

Import Package

import 'package:master_utility/master_utility.dart';

Uses

For use this package

MasterUtilityMaterialApp()
Use this as a MaterialApp();

This package contains the below points as of now. We can improve and add new points as per requirements in the future

Done Keyboard View For Android and IOS

You need to add the below line into FocusNode, which you can manage with Custom Text Filed. You have the option to hide the done keyboard, and you can enable the previous and next buttons to focus on the next and previous fields.

---

focusNode: showDoneKeyboard
  ? (focusNode..addListener(() {
        final hasFocus = focusNode.hasFocus;
        if (hasFocus) {
        KeyboardOverlay.showOverlay(
            context: context,
            isNextButton: isNextButton,
            isPrevious: isPrevious,
            isShowButton: (isNextButton || isPrevious),
              );
            } else {
              KeyboardOverlay.removeOverlay();
            }
          })
  ): focusNode,

---

AppTextField(
    focusNode: focusNode,
    label: "TextField to View Done Keyboard",
    showDoneKeyboard: true, // by default done view is false
),

Navigation helper

NavigationHelper.navigatePop();

NavigationHelper.navigatePush(route: routeName());

NavigationHelper.navigatePushReplacement(route: routeName());

NavigationHelper.navigatePushRemoveUntil(route: routeName());

Sizer helper

add below line inside your first widget build method

SizeHelper.setMediaQuerySize();

Container(
    width: 0.03.w,    //It will take a 30% of screen width
    height:0.03.h,     //It will take a 30% of screen height
),

Padding(
    padding: EdgeInsets.symmetric(vertical: 0.05.h, horizontal: 0.05.w),
    child: Container(),
);

Text('Sizer Helper',style: TextStyle(fontSize: 5.5.fs));

Image picker helper

To use In [IOS] add this code in project_directory/ios/Runner/info.plist

`<key>`NSCameraUsageDescription `</key>`
    `<string>`Upload image from camera for screen background `</string>`
    `<key>`NSMicrophoneUsageDescription `</key>`
    `<string>`Post videos to profile `</string>`
    `<key>`NSPhotoLibraryUsageDescription `</key>`
    `<string>`Upload images for screen background `</string>`

• Multimedia picker

  • Take Photo

  • Photo from Gallery

  • Take a Video

  • Video from Gallery

  • Document

    final result = await ImagePickerHelper.multiMediaPicker();

• Custom media picker

  final result = await ImagePickerHelper.customMediaPicker( pickerActionType:PickerActionType.camera);

  use below enum for custom media picker PickerActionType.camera PickerActionType.gallery, PickerActionType.video, PickerActionType.cameraVideo, PickerActionType.document,

Date time helper

we have extension for on dateTime.

DateTime.now().toCustomFormatter(formatter:DateTimeFormatter.HOUR_MINUTE)

Auto size text helper

Widget AutoText AutoText({
    Key? key,
    Key? textKey,
    TextStyle? style,
    StrutStyle? strutStyle,
    double? minFontSize,
    double? maxFontSize,
    List`<double>`? presetFontSizes,
    AutoSizeGroup? group,
    TextAlign? textAlign,
    TextDirection? textDirection,
    Locale? locale,
    bool? softWrap,
    bool wrapWords = true,
    TextOverflow? overflow,
    Widget? overflowReplacement,
    double? textScaleFactor,
    int? maxLines,
    String? semanticsLabel,
    required String text,
    TextSpan? textSpan,
})

Toast helper

Method : 1

showToast({required String message})

Method : 2

void showCustomToast({
        required String message,
        Color? backgroundColor,
        Color? textColor,
        double? fontSize,
        ToastGravity? gravity,
    })

Email Dispose helper

void getEmailDisposeHelper() async {
    final EmailDisposerResModel? result = await EmailDisposeHelper.emailDisposerChecker(email: “[e-mail]”);
    LogHelper.logInfo(“Is Email Disposable? : ${result?.disposable}“);
}

Log helper

LogHelper.logInfo("add log here");

LogHelper.logSuccess("add log here");

LogHelper.logWarning("add log here");

LogHelper.logError("add log here");

Dialog Helper

Show Action Sheet

final PickerActionType? actionType = await DialogHelper.showActionSheet`<PickerActionType>`(
    actions: const [
        SheetAction(key: PickerActionType.camera, label: AppStrings.camera),
        SheetAction(key: PickerActionType.gallery, label: AppStrings.gallery),
    ],
);

Show Dialog

void _showDialogBox() {
    return DialogHelper.showCustomAlertDialog(
       barrierDismissible: false,
       builder: (BuildContext context, widget) {
       return WillPopScope(
        onWillPop: () async => false,
        child: AlertDialog(
          title: const Text(AppStrings.noInternet),
          content: const Text(AppStrings.checkYourInternet),
          contentPadding: EdgeInsets.all(AppPadding.p15),
          titlePadding: EdgeInsets.all(AppPadding.p15),
          actions: [
            AppButton(
              width: AppWidth.w140,
              title: AppStrings.tryAgain,
            )
           ],
          ),
         );
    });
}

Cache network Image Helper

AppNetworkImage(
    url: imageUrl,
    errorWidget: (p0, p1, p2) =>
        Icon(Icons.error),
),

Validation helper

validator: (v) => ValidationHelper.validateEmail(v),

Api Helper

First of all, you want to add the below line to the main method.

dioClient.setConfiguration(APIEndpoints.baseUrl);

FOR GET API CALL

Future`<void>` getApiCall() async {
    final request = APIRequest(
        url: url,
        methodType: MethodType.GET,
    );

final response =
        await APIService().GetApiResponse(request, apiResponse: (dynamic data) {
        return Data.fromJson(data);
    });
    if (response.hasError) {
        ToastHelper.showCustomToast(
        backgroundColor: Colors.red,
        message: response.message.toString());
    } else {
        _newData = response.data;
    }
}

FOR POST API CALL

final request = APIRequest(
   url: url,
   methodType: MethodType.POST,
   params: reqParam,
);

FOR PUT API CALL

final request = APIRequest(
   url: url,
   methodType: MethodType.PUT,
   params: reqParam,
);

FOR DELETE API CALL

final request = APIRequest(
   url: url,
   methodType: MethodType.DELETE,
);

Shared Preference Helper

First of all, you want to add the below line to the main method.

Parameters:

• encryptionKey: A required string parameter used as the key(32 character) for encrypting and decrypting stored data.

  await PreferenceHelper.init(encryptionKey: 'your-encryption-key');

This initialization method must be called before any other methods in the PreferenceHelper class to ensure that the shared preferences instance and encryption key are properly set.

For String SET and GET

await PreferenceHelper().setStringPrefValue(key: key, value: value);

String getValue = await PreferenceHelper().getStringPrefValue(key: key);

For bool SET and GET

await PreferenceHelper().setBoolPrefValue(key: key, value: value);

bool getValue = await PreferenceHelper().getBoolPrefValue(key: key);

For int SET and GET

await PreferenceHelper().setIntPrefValue(key: key, value: value);

int getValue = await PreferenceHelper().getIntPrefValue(key: key);

For double SET and GET

await PreferenceHelper().setDoublePrefValue(key: key, value: value);

double getValue = await PreferenceHelper().getDoublePrefValue(key: key);

For remove single value and clear all from Shared Preference

await PreferenceHelper().removePrefValue(key: key);

String getValue = await PreferenceHelper().clearAll();

Note : Use PreferenceHelper instead of PreferenceServiceHelper

image cropper Helper

croppedImage = await ImageCropperHelper.cropImage(imagePath: fileResult.path);

LogHelper.logInfo("croppedImage result $croppedImage");

Read more and less more text Helper

ReadMoreTextHelper(
    'Flutter is Google’s mobile UI open source framework to build high-quality native (super fast) interfaces for iOS and Android apps with the unified codebase.',
    trimLines: 2,
    colorClickableText: Colors.blue,
    trimMode: TrimMode.Line,
    trimCollapsedText: 'Show more',
    trimExpandedText: 'Show less',
    moreStyle: TextStyle(
    fontSize: 14, fontWeight: FontWeight.bold),
),

Debounce Timer with milliseconds option Helper

final debouncer = DebouncerHelper();

debouncer.run(() {
    /// add your code here
});

double clicked redundant Helper

ElevatedButton(
    onPressed: () {
        DoubleClickReduntHelper.handleDoubleClick();
        ToastHelper.showToast(message: "Default Toast");
    },
    child: const Text("Show Default Toast"),
)

Permission Handler Helper

PermissionHandlerService.handlePermissions(
    type: PermissionType.PHOTO,

/// You can pass custom Dialog
    permissionDeniedDialog: () {
       return showDialog(
            context: context,
            builder: (context) {
             return const AlertDialog(title: Text("Custom Dialog"));
                        },
                    );
                },
        callBack: () async {
             final fileResult = await ImagePickerHelper.customMediaPicker(
                                pickerActionType: PickerActionType.gallery,
                              );
            LogHelper.logInfo("result $fileResult");
            if (fileResult != null) {
                croppedImage.value =await ImageCropperHelper.cropImage(imagePath: fileResult.path);

LogHelper.logInfo("croppedImage result $croppedImage");
                              }
            },
    )

Using the Encryption Extension

This extension provides tools to encrypt map data using RSA and AES encryption algorithms. Below is a quick guide on how to utilize this functionality in your project:

1. Load the Public Key: Ensure you load the public key before using the encryption methods. Call EncryptionService.loadPublicKey() to load the key from preferences.
2. Encrypt Data: Extend a Map object with the MapEncryption extension and call the encrypted() method to encrypt its contents. This method generates a random secret key and IV, encrypts the map data with AES, and then encrypts the secret key with RSA.
3. Access Encrypted Data: The encrypted() method returns a map containing:
   • encryptedData: The AES-encrypted map data in base64 format.
   • encryptedKey: The RSA-encrypted secret key in base64 format.
   • iv: The IV used for AES encryption in base64 format.

Example usage:

await EncryptionService.loadPublicKey(); Map<String, dynamic> myMap = {'key': 'value'}; Map<String, dynamic> encryptedMap = myMap.encrypted(); print(encryptedMap);

By following these steps, you can securely encrypt your map data using the provided extension.