μscala is a set of general purpose micro libraries written in Scala.

In this project you'll find a set of general purpose micro libraries written in scala.

List is as follows:

• headed: an ultra simple "list" that ensures the existence of at least an element (i.e. a non-empty list).
• i18n: message internationalization scala micro library with no dependencies for the JVM.
• resources: helps dealing with resources in the classpath, allowing null-safe access and listing resources from packages.
• result: a right biased union type that holds a value for a successful computation or a value for a failed one.
• result-async: a right biased union type that holds a value for an asynchronous/future successful computation or a value for a failed one.
• result-specs2: specs2 matchers for the result type
• retry: small utility that retries a computation until it is successful using a backoff algorithm (exponential backoff by default).
• timeout: class that allows to query if a specific amount of time has elapsed or not.
• try-ops: small library that adds some useful methods to Try like sequence.
• typed-env: allows to retrieve environment variables safely and with types.
• url: immutable URL class with some useful methods to construct it, get the params, convert it to other types...

Sometimes the Scala/Java ecosystem forces you to include huge libraries when you only want to get a small piece of functionality. It's not strange to find projects that include Cats, Scalaz, Guava or Apache Commons (or all of them!) just because they want to use a simple piece of functionality from each of those projects.

The idea behind μscala is to create a set of very small libraries that offer some of the most common used functionality that is missing from the standard Scala & Java standard libraries.

It's important to note that μscala is not and will never be a replacement for any of the above libraries. They are excellent libraries that I use in lots of projects.

In order to be included in μscala, a library must fulfill the following requisites:

• Shall be composed by a single functionality (oversimplifying, 1 single file)
• Shall not have any external dependency, except for:
  • Test libraries
  • A maximum of 2 μ-libraries
• Shall cover a very common functionality
• Shall be well tested
• Shall be MIT licensed unless for licensing compatibility issues a different open source license is needed.

Yes, of course, any contribution is welcome. You can contribute either by:

1. Adding a new μ-library
2. Adding some function to an existing one

Just fork the repo and raise a PR.