Repository files navigation

Arrow is Lightweight library toolbox for Java and Android Development. Basically it groups utilites and helper classes commonly used for mobile development. Most of them have been extracted from popular java libraries likeGuava orApache Commons plus other stuff added myself. Refer to the Main Features section for a fully explanation of its capabilities.

• Optional<T>: An immutable object that may contain a non-null reference to another object. Each instance of this type either contains a non-null reference, or contains nothing (in which case we say that the reference is "absent"); it is never said to "contain null".Refer to GuavaOptional<T> documentation orHow to useOptional<T> on Java and Android.

• Strings: Static utility methods pertaining to String or CharSequence instances.Refer to GuavaStrings documentation.

• Preconditions: Static convenience methods that help a method or constructor check whether it was invoked correctly (whether its preconditions have been met). These methods generally accept a boolean expression which is expected to be true (or in the case of checkNotNull, an object reference which is expected to be non-null). When false (or null) is passed instead, the Preconditions method throws an unchecked exception, which helps the calling method communicate to its caller that that caller has made a mistake.Refer to GuavaPreconditions documentation.

• Collections: Provides static methods for working with Collection instances.Refer to GuavaCollections documentation.

  • FilteredCollection.class
  • Lists.class
  • CollectPreconditions.class
  • Iterables.class
  • Iterators.class
  • MoreArrays.class
  • MoreCollections.class

• MoreObjects: Helper functions that operate on any Object, and are not already provided inObjects.Refer to GuavaMoreObjects documentation.

• Annotations: These annotations has no side effect in your code, they are only used for decoration purpose, in case you need either to highlight it or to denotate it.

  • @Beta: Class, method or field is declared as Beta functionality
  • @Experimental: Class, method or field is declared as Experimental
  • @Issue: Class, method or field is linked to an issue. A ref value can be added to specify more information.
  • @See: Class, method or field is linked to a link. A ref value should be added in order to specify the link url.
  • @VisibleForTesting: Class, method or field has its visibility relaxed, so that it is more widely visible than otherwise necessary to make code testable.
  • @WorkInProgress: Class, method or field is declared as work in progress.

To enable Arrow, add your dependency in yourbuild.gradle file:

repositories {jcenter()}dependencies {compile'com.fernandocejas:arrow:{latest_version}'}

Copyright 2016 Fernando CejasLicensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License at   http://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.