Kolumbus

Kolumbus allows you to explore your Realm database from within your Android application.

Note: This library is still under heavy development and a lot of improvements has to done. It was made available to collect feedbacks and feature requests.

Screenshots

• List of tables
• Content of the Category table
• Info about the Category table
• Content of the Product table
• Info about the Product table

Installation

In your root build.gradle file, add the Jitpack url to the list of repositories, if you don't have it yet:

allprojects {

  repositories {

maven {

 url "https://jitpack.io"

}

  
}
 
}

In your module build.gradle file, add the Kolumbus dependency:

dependencies {

  compile 'com.github.MGaetan89.Kolumbus:kolumbus:v0.9' 
}

If you only want to use Kolumbus in your debug build, you can use the following configuration instead:

dependencies {

  debugCompile 'com.github.MGaetan89.Kolumbus:kolumbus:v0.9'
  releaseCompile 'com.github.MGaetan89.Kolumbus:kolumbus-no-op:v0.9' 
}

Usage

Check the demo application to see how to use Kolumbus.

The following example assumes that you have two classes named Category and Product in your project, which both inherits from io.realm.RealmModel.

// Kotlin import io.kolumbus.Kolumbus import io.kolumbus.KolumbusModule import io.realm.Realm import io.realm.RealmConfiguration  // Register the Kolumbus module when defining your Realm configuration val realmConfiguration = RealmConfiguration.Builder(context)
  .modules(KolumbusModule())
  .build() Realm.setDefaultConfiguration(realmConfiguration)  // Configure Kolumbus Kolumbus.explore(Category::class.java)
  .explore(Product::class.java)
  .navigate(context)

// Java import io.kolumbus.Kolumbus; import io.kolumbus.KolumbusModule; import io.realm.Realm; import io.realm.RealmConfiguration;  // Register the Kolumbus module when defining your Realm configuration RealmConfiguration realmConfiguration = new RealmConfiguration.Builder(context)
  .modules(new KolumbusModule())
  .build();
 Realm.setDefaultConfiguration(realmConfiguration);
  // Configure Kolumbus Kolumbus.build()
  .explore(Category.class)
  .explore(Product.class)
  .navigate(context);

Customization

Override resources

One way to customize the behavior/display of Kolumbus is to override the public resources in your application.

Create a custom Architect

Kolumbus provides a basic way to customize how the content of a table is displayed. To use this feature, you have to extends from Architect and override the desired methods.

// Kotlin import android.widget.TextView import io.kolumbus.Architect  class MyArchitect: Architect() {

  override fun displayEmpty(textView: TextView) {

textView.text = "Field is empty"
  
}
 
}

// Java import android.widget.TextView; import io.kolumbus.Architect;  public class MyArchitect extends Architect {

  @Override
  public void displayEmpty(@NonNull TextView textView) {

textView.setText("Field is empty")
  
}
 
}

Then, you need to pass an instance of your Architect to Kolumbus, as follow:

// Kotlin import io.kolumbus.Kolumbus  Kolumbus
  // All `explore()` calls you might need
  .withArchitect(MyArchitect())
  .navigate(context)

// Java import io.kolumbus.Kolumbus;  Kolumbus.build()
  // All `explore()` calls you might need
  .withArchitect(new MyArchitect())
  .navigate(context)

Compatibility

The following table presents the compatibility matrix between Kolumbus versions and Realm versions.

TODO

In no particular order:

• Sort the content of the displayed table
• Filter the fields that are displayed
• Filter the data that are displayed

License

Copyright 2016 MGaetan89  Licensed 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.0  Unless required by applicable law or agreed to in writing, software distributed 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 and limitations under the License.