tests

epoxy-annotations/src/main/java/com/airbnb/epoxy/ModelView.java

@@ -17,6 +17,11 @@
 @Retention(RetentionPolicy.CLASS)
 public @interface ModelView {
 
+  /**
+   * Use with {@link #autoLayout()} to declare what layout parameters should be used to size your
+   * view when it is added to a RecyclerView. This maps to the LayoutParams options {@code
+   * layout_width} and {@code layout_height}.
+   */
   enum Size {
     NONE,
     WRAP_WIDTH_WRAP_HEIGHT,
@@ -25,11 +30,20 @@ enum Size {
     MATCH_WIDTH_MATCH_HEIGHT
   }
 
+  /**
+   * If set to an option besides {@link Size#NONE} Epoxy will create an instance of this view
+   * programmatically at runtime instead of inflating the view from xml. This is an alternative to
+   * using {@link #defaultLayout()}, and is a good option if you just need to specify layout
+   * parameters on your view with no other styling.
+   * <p>
+   * The size option you choose will define which layout parameters Epoxy uses at runtime when
+   * creating the view.
+   */
   Size autoLayout() default Size.NONE;
 
   /**
    * The layout file to use in the generated model to inflate the view. This is required unless a
-   * default pattern is set via {@link PackageModelViewConfig}.
+   * default pattern is set via {@link PackageModelViewConfig} or {@link #autoLayout()} is used.
    * <p>
    * Overrides any default set in {@link PackageModelViewConfig}
    */

epoxy-processor/src/main/java/com/airbnb/epoxy/GeneratedModelInfo.java

@@ -65,6 +65,10 @@ abstract class GeneratedModelInfo {
    */
   private ParisStyleAttributeInfo styleBuilderInfo;
 
+  /**
+   * An option set via {@link ModelView#autoLayout()} to have Epoxy create the view programmatically
+   * instead of via xml layout resource inflation.
+   */
   Size layoutParams = Size.NONE;
 
   /**

epoxy-processor/src/main/java/com/airbnb/epoxy/GeneratedModelWriter.java

@@ -458,6 +458,7 @@ private Iterable<MethodSpec> generateProgrammaticViewMethods(GeneratedModelInfo
         break;
       case WRAP_WIDTH_WRAP_HEIGHT:
       default:
+        // This will be used for Styleable views as the default
         layoutWidth = LAYOUT_PARAMS_WRAP_CONTENT;
         layoutHeight = LAYOUT_PARAMS_WRAP_CONTENT;
     }

epoxy-processortest/src/test/java/com/airbnb/epoxy/ViewProcessorTest.java

@@ -700,4 +700,14 @@ public void callbackPropMustBeNullable() {
   public void testModelBuilderInterface() {
     assertGeneration("TestManyTypesView.java", "TestManyTypesViewModelBuilder.java");
   }
+
+  @Test
+  public void testAutoLayout() {
+    assertGeneration("AutoLayoutModelView.java", "AutoLayoutModelViewModel_.java");
+  }
+
+  @Test
+  public void testAutoLayoutMatchParent() {
+    assertGeneration("AutoLayoutModelViewMatchParent.java", "AutoLayoutModelViewMatchParentModel_.java");
+  }
 }

epoxy-processortest/src/test/resources/AutoLayoutModelView.java

@@ -0,0 +1,17 @@
+package com.airbnb.epoxy;
+
+import android.content.Context;
+import android.view.View;
+
+@ModelView(autoLayout = ModelView.Size.WRAP_WIDTH_WRAP_HEIGHT)
+public class AutoLayoutModelView extends View {
+
+  public AutoLayoutModelView(Context context) {
+    super(context);
+  }
+
+  @ModelProp
+  void setValue(int value) {
+
+  }
+}

epoxy-processortest/src/test/resources/AutoLayoutModelViewMatchParent.java

@@ -0,0 +1,19 @@
+package com.airbnb.epoxy;
+
+import android.content.Context;
+import android.view.View;
+
+import com.airbnb.epoxy.ModelView.Size;
+
+@ModelView(autoLayout = Size.MATCH_WIDTH_MATCH_HEIGHT)
+public class AutoLayoutModelViewMatchParent extends View {
+
+  public AutoLayoutModelViewMatchParent(Context context) {
+    super(context);
+  }
+
+  @ModelProp
+  void setValue(int value) {
+
+  }
+}

epoxy-processortest/src/test/resources/AutoLayoutModelViewMatchParentModel_.java

@@ -0,0 +1,254 @@
+package com.airbnb.epoxy;
+
+import android.support.annotation.LayoutRes;
+import android.support.annotation.Nullable;
+import android.view.ViewGroup;
+import java.lang.CharSequence;
+import java.lang.Number;
+import java.lang.Object;
+import java.lang.Override;
+import java.lang.String;
+import java.lang.UnsupportedOperationException;
+import java.util.BitSet;
+
+/**
+ * Generated file. Do not modify! */
+public class AutoLayoutModelViewMatchParentModel_ extends EpoxyModel<AutoLayoutModelViewMatchParent> implements GeneratedModel<AutoLayoutModelViewMatchParent>, AutoLayoutModelViewMatchParentModelBuilder {
+  private final BitSet assignedAttributes_epoxyGeneratedModel = new BitSet(1);
+
+  private OnModelBoundListener<AutoLayoutModelViewMatchParentModel_, AutoLayoutModelViewMatchParent> onModelBoundListener_epoxyGeneratedModel;
+
+  private OnModelUnboundListener<AutoLayoutModelViewMatchParentModel_, AutoLayoutModelViewMatchParent> onModelUnboundListener_epoxyGeneratedModel;
+
+  /**
+   * Bitset index: 0 */
+  private int value_Int = 0;
+
+  @Override
+  public void addTo(EpoxyController controller) {
+    super.addTo(controller);
+    addWithDebugValidation(controller);
+  }
+
+  @Override
+  protected int getViewType() {
+    return 0;
+  }
+
+  @Override
+  protected AutoLayoutModelViewMatchParent buildView(ViewGroup parent) {
+    AutoLayoutModelViewMatchParent v = new AutoLayoutModelViewMatchParent(parent.getContext());
+    v.setLayoutParams(new ViewGroup.MarginLayoutParams(ViewGroup.MarginLayoutParams.MATCH_PARENT, ViewGroup.MarginLayoutParams.MATCH_PARENT));
+    return v;
+  }
+
+  @Override
+  public void handlePreBind(final EpoxyViewHolder holder,
+      final AutoLayoutModelViewMatchParent object, int position) {
+    validateStateHasNotChangedSinceAdded("The model was changed between being added to the controller and being bound.", position);
+  }
+
+  @Override
+  public void bind(final AutoLayoutModelViewMatchParent object) {
+    super.bind(object);
+    object.setValue(value_Int);
+  }
+
+  @Override
+  public void bind(final AutoLayoutModelViewMatchParent object, EpoxyModel previousModel) {
+    if (!(previousModel instanceof AutoLayoutModelViewMatchParentModel_)) {
+      bind(object);
+      return;
+    }
+    AutoLayoutModelViewMatchParentModel_ that = (AutoLayoutModelViewMatchParentModel_) previousModel;
+    super.bind(object);
+
+    if (value_Int != that.value_Int) {
+      object.setValue(value_Int);
+    }
+  }
+
+  @Override
+  public void handlePostBind(final AutoLayoutModelViewMatchParent object, int position) {
+    if (onModelBoundListener_epoxyGeneratedModel != null) {
+      onModelBoundListener_epoxyGeneratedModel.onModelBound(this, object, position);
+    }
+    validateStateHasNotChangedSinceAdded("The model was changed during the bind call.", position);
+  }
+
+  /**
+   * Register a listener that will be called when this model is bound to a view.
+   * <p>
+   * The listener will contribute to this model's hashCode state per the {@link
+   * com.airbnb.epoxy.EpoxyAttribute.Option#DoNotHash} rules.
+   * <p>
+   * You may clear the listener by setting a null value, or by calling {@link #reset()} */
+  public AutoLayoutModelViewMatchParentModel_ onBind(OnModelBoundListener<AutoLayoutModelViewMatchParentModel_, AutoLayoutModelViewMatchParent> listener) {
+    onMutation();
+    this.onModelBoundListener_epoxyGeneratedModel = listener;
+    return this;
+  }
+
+  @Override
+  public void unbind(AutoLayoutModelViewMatchParent object) {
+    super.unbind(object);
+    if (onModelUnboundListener_epoxyGeneratedModel != null) {
+      onModelUnboundListener_epoxyGeneratedModel.onModelUnbound(this, object);
+    }
+  }
+
+  /**
+   * Register a listener that will be called when this model is unbound from a view.
+   * <p>
+   * The listener will contribute to this model's hashCode state per the {@link
+   * com.airbnb.epoxy.EpoxyAttribute.Option#DoNotHash} rules.
+   * <p>
+   * You may clear the listener by setting a null value, or by calling {@link #reset()} */
+  public AutoLayoutModelViewMatchParentModel_ onUnbind(OnModelUnboundListener<AutoLayoutModelViewMatchParentModel_, AutoLayoutModelViewMatchParent> listener) {
+    onMutation();
+    this.onModelUnboundListener_epoxyGeneratedModel = listener;
+    return this;
+  }
+
+  /**
+   * <i>Optional</i>: Default value is 0
+   *
+   * @see AutoLayoutModelViewMatchParent#setValue(int)
+   */
+  public AutoLayoutModelViewMatchParentModel_ value(int value) {
+    assignedAttributes_epoxyGeneratedModel.set(0);
+    onMutation();
+    this.value_Int = value;
+    return this;
+  }
+
+  public int value() {
+    return value_Int;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ id(long id) {
+    super.id(id);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ id(Number... ids) {
+    super.id(ids);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ id(long id1, long id2) {
+    super.id(id1, id2);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ id(CharSequence key) {
+    super.id(key);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ id(CharSequence key, CharSequence... otherKeys) {
+    super.id(key, otherKeys);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ id(CharSequence key, long id) {
+    super.id(key, id);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ layout(@LayoutRes int arg0) {
+    throw new UnsupportedOperationException("Layout resources are unsupported with programmatic views.");
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ spanSizeOverride(@Nullable EpoxyModel.SpanSizeOverrideCallback arg0) {
+    super.spanSizeOverride(arg0);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ show() {
+    super.show();
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ show(boolean show) {
+    super.show(show);
+    return this;
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ hide() {
+    super.hide();
+    return this;
+  }
+
+  @Override
+  @LayoutRes
+  protected int getDefaultLayout() {
+    throw new UnsupportedOperationException("Layout resources are unsupported for views created programmatically.");
+  }
+
+  @Override
+  public AutoLayoutModelViewMatchParentModel_ reset() {
+    onModelBoundListener_epoxyGeneratedModel = null;
+    onModelUnboundListener_epoxyGeneratedModel = null;
+    assignedAttributes_epoxyGeneratedModel.clear();
+    this.value_Int = 0;
+    super.reset();
+    return this;
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (o == this) {
+      return true;
+    }
+    if (!(o instanceof AutoLayoutModelViewMatchParentModel_)) {
+      return false;
+    }
+    if (!super.equals(o)) {
+      return false;
+    }
+    AutoLayoutModelViewMatchParentModel_ that = (AutoLayoutModelViewMatchParentModel_) o;
+    if ((onModelBoundListener_epoxyGeneratedModel == null) != (that.onModelBoundListener_epoxyGeneratedModel == null)) {
+      return false;
+    }
+    if ((onModelUnboundListener_epoxyGeneratedModel == null) != (that.onModelUnboundListener_epoxyGeneratedModel == null)) {
+      return false;
+    }
+    if (value_Int != that.value_Int) {
+      return false;
+    }
+    return true;
+  }
+
+  @Override
+  public int hashCode() {
+    int result = super.hashCode();
+    result = 31 * result + (onModelBoundListener_epoxyGeneratedModel != null ? 1 : 0);
+    result = 31 * result + (onModelUnboundListener_epoxyGeneratedModel != null ? 1 : 0);
+    result = 31 * result + value_Int;
+    return result;
+  }
+
+  @Override
+  public String toString() {
+    return "AutoLayoutModelViewMatchParentModel_{" +
+        "value_Int=" + value_Int +
+        "}" + super.toString();
+  }
+
+  @Override
+  public int getSpanSize(int totalSpanCount, int position, int itemCount) {
+    return totalSpanCount;
+  }
+}