fragnums's Introduction

Fragnums

An enum based library to replace fragments, because #perfmatters.

“Frag your app complexity today!” - Zach K.

We all know that Fragments suck, and that #enumsmatter. What if we could replace Fragments with Enums?

What's Fragnums?

Fragnums is the smallest, simplest and most performant Android backstack library:

No reflection, unlike Fragments which are recreated through reflection.
Each enum value is both a screen and a presenter. This means only one instance of each value is created, ever. No useless garbage collection!
Synchronous transitions coz nobody ain't time for Async Fragment Transactions.
Handles configuration changes, for all the landscape nut lovers out there.

Show me the code

Creating a new screen is as simple as adding an enum value:

  MY_SCREEN(R.layout.my_screen_layout, R.string.my_screen_title) {
    @Override protected void onBind() {
      View button = findViewById(R.id.button);
      button.setOnClickListener(new View.OnClickListener() {
        @Override public void onClick(View view) {
          // Do something.
        }
      });
    }
  },

Then you can just do goTo(MY_SCREEN).

Getting started

Copy the three classes from the example.
You're good to go! You can now focus on writing new screens and features, just by adding new enum values.

Why should I use Fragnums?

Ultra small footprint: no dependency. In fact, it's not even a library, just three classes to copy.
It's really hard to test, so test zealots can't force you to write tests. You can therefore focus on writing more features.
All your business logic is in one place, so it's really easy to have a 30,000 feet picture of your code. We suggest you start using a smaller font size in your IDE.