README.md

🛑 THIS REPOSITORY IS OFFICIALLY NO LONGER UNDER MAINTENANCE since 10/02/2022 🛑

notils

Never again need a .utils. package yur scurvy sea dogs!

Notils comes in two modules - notils-java contains classes that don't depend on anything from the Android SDK, while notils-android contains classes that do.

Description

notils contains a set of common classes that we use in our projects:

• AndroidUtils, for showing the keyboard, checking running services, etc.
• ClassCaster - to help with listeners between Activitys & Fragments
• No need to cast when finding Fragments
• No need to double type your types when creating collections
• Simple Fade animations in & out done for you
• Simple Log to give to give automatic details of where the Log executed
• StrictMode Management - enable strict mode in one line
• WebViews, allowing custom loading of different scenarios (raw assets, external urls)
• ToastDisplayers for saner displaying of Toast notifications
• SimpleDateFormatThreadSafe allowing you to use date formatting from multiple threads
• DeveloperError - custom exceptions for explicit declaration / faster feedback when something goes wrong
• SimpleTextWatcher - simple implementation of android.text.TextWatcher with stub implementations of each method
• QueryUtils - easily create placeholders for ContentResolver operations selection
• DeviceDetection - to detect whether the user has Amazon or Intel x86 devices.
• AndroidVersion - to check the Android version in a nicer way.

Adding to your project

To start using this library, add these lines to the build.gradle of your project:

repositories {
    jcenter()
}

dependencies {
    compile 'com.novoda:notils-java:3.1.5'
    compile 'com.novoda:notils-android:3.1.5'
}

Simple usage

Here are a few examples.

• Use the Views class to avoid casting your views over and over!

UserFragment userFragment = Fragments.findFragmentById(fragmentmanager, R.id.userFragment);

• Use DeveloperError to let other devs know a problem in the code or prevent potential issues:

switch (menuOptionId) {
    case R.id.menu_take_picture:
        // Start the camera...
    break;
    case R.id.menu_from_gallery:
        // Open the gallery...
    break;
    default:
        throw new DeveloperError("Unhandled case in switch statement!");
}

• Object-oriented Toasts!

Toaster toaster = new Toaster(context);
toaster.popToast("Good morning!"); // Short toast
toaster.popBurntToast("Good night!"); // Long toast
toaster.dropInBath(); // Cancells all active toasts this toaster created

• Check the javadoc for more! The package structure allows you to easily see what's in each package.

Links

Here are a list of useful links:

• We always welcome people to contribute new features or bug fixes, here is how
• If you have a problem check the Issues Page first to see if we are working on it
• For further usage or to delve more deeply checkout the Project Wiki
• Looking for community help, browse the already asked Stack Overflow Questions or use the tag: support-notils when posting a new question