[
{
"path": ".github/workflows/build_test.yml",
"content": "name: Build/Test\n\non:\n # Trigger on every pull request\n pull_request:\n\npermissions:\n contents: read\n\njobs:\n build-test:\n runs-on: macos-13\n steps:\n - name: Checkout epoxy\n uses: actions/checkout@v4\n\n - name: Setting up Java 17\n uses: actions/setup-java@v4\n with:\n distribution: temurin\n java-version: '17'\n\n - name: Setup Gradle\n uses: gradle/actions/setup-gradle@v4\n with:\n cache-read-only: ${{ github.ref != 'refs/heads/master' }}\n\n - name: Build / Unit tests / Lint\n run: \"./gradlew check --stacktrace\"\n\n - name: Run UI Tests\n uses: reactivecircus/android-emulator-runner@v2.32.0\n with:\n api-level: 21\n target: default\n arch: x86_64\n emulator-options: -no-skin -no-window -no-audio -no-boot-anim -gpu swiftshader_indirect\n disable-animations: true\n script: ./gradlew :epoxy-composeinterop-maverickssample:connectedDebugAndroidTest --stacktrace\n"
},
{
"path": ".gitignore",
"content": "# macOS\n.DS_Store\n\n# Mobile Tools for Java (J2ME)\n.mtj.tmp/\n\n# Package Files #\n*.war\n*.ear\n\n# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml\nhs_err_pid*\n\n# IntelliJ\n*.iml\n.idea/\n!.idea/codeStyles/\n!.idea/codeStyleSettings.xml\n\n# Android\n.gradle\nbuild/\nlocal.properties\n\n# Kotlin\n.kotlin\n"
},
{
"path": ".idea/codeStyleSettings.xml",
"content": "\n\n \n \n \n \n\n"
},
{
"path": "CHANGELOG.md",
"content": "# 5.2.1\n\nFix some issues in KSP2 when multiple processing rounds occur (https://github.com/airbnb/epoxy/pull/1396)\n\n# 5.2.0\n\nMigrate to KSP 2 (#1393)\n\n# 5.1.4\nChange the way the Compose interop works to avoid Android 12 bug (#1370)\n\n# 5.1.3\nUpdate to kotlin 1.8.21\nFix click listener kapt bug (#1327)\nResolve unchecked call warning for WrappedEpoxyModelClickListener (#1337)\nFix refresh KDoc (#1334)\nepoxy-kspsample : use ksp block to specify arguments (#1347)\n\n# 5.1.2\n\nUpdates kotlin, ksp, and the xprocessing library.\n\nNotably, the androidx.room:room-compiler-processing library (aka xprocessing) has been updated to 2.6.0-alpha01. This version is incompatible with previous versions due to a breaking API change. All annotation processors using this library must be on the same version. Other annotation processors such as Epoxy and Paris also use xprocessing and if you use them you need to use a version of them that also uses xprocessing 2.6.0-alpha01\n\n# 5.1.1\nRemove incorrect ksp symbol validation in processing of @EpoxyModelClass\n\n# 5.1.0\nUpdates Kotlin to 1.7.20 and KSP to 1.7.20-1.0.7, as well as the room compiler processing (xprocessing) library to 2.5.0-beta01.\n\nAlso deletes the epoxy-paging artifact in favor of the newer epoxy-paging3\n\n# 5.0.0\nThis adds support for Kotlin Symbol Processing, while maintaining backwards compatibility with java annotation processing via the xprocessing library from Room.\n\nThis includes a major version bump to 5.0.0 because there may be slight behavior differences with KSP, especially for generic types in generated code. For example, if you previously had an epoxy attribute in java source code with a raw type it may now appear in the generated code with a wildcard type, which may require tweaking the type that is passed to the model.\n\nAdditionally, some type checking was improved, for example more accurate validation of proper equals and hashcode implementations.\n\nTo use Epoxy with KSP, simply apply it with the ksp gradle plugin instead of kapt (https://github.com/google/ksp/blob/main/docs/quickstart.md). See the new epoxy-kspsample module for an example.\n\nNote that unfortunately the databinding processor does NOT support KSP, simply because Android databinding itself uses KAPT and KSP cannot currently depend on KAPT sources. The code changes are in place to enable KSP with databinding once the databinding plugin from Android supports KSP (although this is unlikely) - alternatively it may be possible to configure the KSP plugin to run after KAPT and depend on its outputs (you're on your own if you want to try that).\n\nAlso, parallel processing support was removed because it is not compatible with KSP.\n\nWe have also added easy interop with Jetpack Compose via functions in the `epoxy-composeinterop` artifact.\nSee the epoxy-composesample module for example usage.\n\n# 4.6.4 (September 23, 2021)\n- Clean up dependency for the experimental epoxy module\n\n# 4.6.3 (September 11, 2021)\n- Add EpoxyModel#preBind hook(#1225)\n- Add unbind extension to ItemViewBindingEpoxyHolder (#1223)\n- Add missing loadStateFlow to PagingDataEpoxyController (#1209)\n\n# 4.6.2 (June 11, 2021)\nFix Drag n Drop not working in 4.6.1 (#1195)\n\n# 4.6.1 (May 13, 2021)\nAdds \"epoxyDisableDslMarker\" annotation processor flag which you can use to delay migration to the model building scope DLSMarker introduced in 4.6.0 if it is a large breaking change for your project.\n\nNote that this only applies to your project modules that you apply it to, and does not apply to the handful of models that ship with the Epoxy library (like the Carousel or `group` builder).\n\nFor example:\n```groovy\nproject.android.buildTypes.all { buildType ->\n buildType.javaCompileOptions.annotationProcessorOptions.arguments =\n [\n epoxyDisableDslMarker : \"true\",\n ]\n}\n```\n\n# 4.6.0 (May 12, 2021)\n- View Binder Support (#1175) Bind epoxy models to views outside of a RecyclerView.\n\n### Potentially Breaking\n- Use kotlin dsl marker for model building receivers (#1180)\n\nThis change uses Kotlin's DSL marker annotation to enforce proper usage of model building extension\nfunctions. You may now need to change some references in your model building code to explicitly reference properties with `this`.\n\n# 4.5.0 (April 13, 2021)\n- Fix generated code consistency in builder interfaces (#1166)\n- Provided support to invalidate `modelCache` in `PagingDataEpoxyController` (#1161)\n- Explicitly add public modifier (#1162)\n- Unwrap context to find parent activity in order to share viewpool when using Hilt (#1157)\n\n# 4.4.4 (Mar 24, 2021)\n- Provide support for snapshot() function in PagingDataEpoxyController (#1144)\n\n# 4.4.3 (Mar 17, 2021)\n- Fixed interface model related regression introduced in the previous release.\n\n# 4.4.2 (Mar 1, 2021)\n- Updated package name of the model class generated for an interface\n\n# 4.4.1 (Feb 22, 2021)\n- Support for Paging3 (#1126) (Thanks to @osipxd and @anhanh11001!)\n- Update KotlinPoet to 1.7.2 (#1117)\n\n# 4.4.0 (Feb 18, 2021)\nBad release, don't use\n\n# 4.3.1 (Dec 2, 2020)\n- Fix ANR and view pool resolution in nested group (#1101)\n\n# 4.3.0 (Dec 1, 2020)\n- ModelGroupHolder get recycle pool from parent (#1097)\n- Add support for `EpoxyModelGroup` in the `EpoxyVisibilityTracker` (#1091)\n- Convert EpoxyVisibilityTracker code to Kotlin (#1090)\n\n## Breaking Changes\nNote that due to the conversion of EpoxyVisibilityTracker to kotlin you now need to access `EpoxyVisibilityTracker.partialImpressionThresholdPercentage` as a property\n`epoxyVisibilityTracker.setPartialImpressionThresholdPercentage(value)` -> `epoxyVisibilityTracker.partialImpressionThresholdPercentage = value`\n\nAlso, the ModelGroupHolder improvement required the `ModelGroupHolder#createNewHolder` function to change its signature to accept a `ViewParent` parameter.\n\nIf you override `createNewHolder()` anywhere you will need to change it to `createNewHolder(@NonNull ViewParent parent)`\n\n# 4.2.0 (Nov 11, 2020)\n- Add notify model changed method (#1063)\n- Update to Kotlin 1.4.20-RC and remove dependency on kotlin-android-extensions\n\n# 4.1.0 (Sept 17, 2020)\n- Fix some synchronization issues with the parallel Epoxy processing option\n- Add view visibility checks to EpoxyVisibilityItem and decouple RecyclerView #1052\n\n# 4.0.0 (Sept 5, 2020)\n\n## New\n- Incremental annotation processing for faster builds\n- Support for Android Jetpack Paging v3 library in new `epoxy-paging3` artifact\n- Model group building with Kotlin DSL (#1012)\n- A new annotation processor argument `logEpoxyTimings` can be set to get a detailed breakdown of how long the processors took and where they spent their time (off by default)\n- Another new argument `enableParallelEpoxyProcessing` can be set to true to have the annotation processor process annotations and generate files in parallel (via coroutines).\n\nYou can enable these processor options in your build.gradle file like so:\n```\nproject.android.buildTypes.all { buildType ->\n buildType.javaCompileOptions.annotationProcessorOptions.arguments =\n [\n logEpoxyTimings : \"true\",\n enableParallelEpoxyProcessing : \"true\"\n ]\n}\n```\n\nParallel processing can greatly speed up processing time (moreso than the incremental support), but given the hairy nature of parallel processing it is still incubating.\nPlease report any issues or crashes that you notice.\n(We are currently using parallel mode in our large project at Airbnb with no problems.)\n\n- Add options to skip generation of functions for getters, reset, and method overloads to reduce generated code\n - New annotation processor options are:\n - epoxyDisableGenerateOverloads\n - epoxyDisableGenerateGetters\n - epoxyDisableGenerateReset\n\n\n## Fixes\n- Synchronize ListUpdateCallback and PagedListModelCache functions (#987)\n- Avoid generating bitset checks in models when not needed (reduces code size)\n- Fix minor memory leak\n\n## Breaking\n\n- Annotations that previously targeted package elements now target types (classes or interfaces).\n This includes: `EpoxyDataBindingPattern`, `EpoxyDataBindingLayouts`, `PackageModelViewConfig`, `PackageEpoxyConfig`\n This was necessary to work around an incremental annotation processor issue where annotation on package-info elements are not properly recompiled\n\n- In order to enable incremental annotation processing a change had to be made in how the processor of\n `@AutoModel` annotations work. If you use `@AutoModel` in an EpoxyController the annotated Model types\n must be either declared in a different module from the EpoxyController, or in the same module in the same java package.\n\n Also make sure you have kapt error types enabled.\n\n However, generally `@AutoModel` is considered legacy and is not recommended. It is a relic of Java Epoxy usage\n and instead the current best practice is to use Kotlin with the Kotlin model extension functions to build models.\n\n- Removed support for generating Epoxy models from Litho components\n\n# 4.0.0-beta6 (July 15, 2020)\n- PackageModelViewConfig can now be applied to classes and interfaces in addition to package-info.java\n\n# 4.0.0-beta5 (July 9, 2020)\nFixes:\n- An occasional processor crash when the option to log timings is enabled\n- Incremental annotation processing of databinding models would fail to generate models (#1014)\n\nBreaking!\n- The annotation that support databinding, `EpoxyDataBindingLayouts` and `EpoxyDataBindingPattern`,\nmust now be placed on a class or interface instead of in a `package-info.java` file. The interface\nor class must be in Java, Kotlin is not supported. This is necessary to support incremental processing.\n\nExample usage:\n```java\npackage com.example.app;\n\nimport com.airbnb.epoxy.EpoxyDataBindingLayouts;\nimport com.airbnb.epoxy.EpoxyDataBindingPattern;\n\n@EpoxyDataBindingPattern(rClass = R.class, layoutPrefix = \"my_view_prefix\")\n@EpoxyDataBindingLayouts({R.layout.my_model_layout})\ninterface EpoxyDataBindingConfig {} \n```\n\n# 4.0.0-beta4 (June 1, 2020)\nFixes:\n- Synchronize ListUpdateCallback and PagedListModelCache functions (#987)\n- 4.0.0.beta1 generating duplicate method layout(int) #988\n\n# 4.0.0-beta3 (May 27, 2020)\n- Sort functions in generated kotlin extension function files deterministically to prevent generated sources from changing\n- Avoid generating bitset checks in models when not needed\n- Add options to skip generation of functions for getters, reset, and method overloads to reduce generated code\n\nNew annotation processor options are:\n- epoxyDisableGenerateOverloads\n- epoxyDisableGenerateGetters\n- epoxyDisableGenerateReset\n\nThese can also be controlled (and overridden) on a per package level with the `PackageModelViewConfig` package annotation.\n\n# 4.0.0-beta1 (May 22, 2020)\n- Support for incremental annotation processing as an Aggregating processor (#972)\n- Removed Litho support\n- A new annotation processor argument `logEpoxyTimings` can be set to get a detailed breakdown of how long the processors took and where they spent their time (off by default)\n- Another new argument `enableParallelEpoxyProcessing` can be set to true to have the annotation processor process annotations and generate files in parallel (via coroutines).\n\nYou can enable these processor options in your build.gradle file like so:\n```\nproject.android.buildTypes.all { buildType ->\n buildType.javaCompileOptions.annotationProcessorOptions.arguments =\n [\n logEpoxyTimings : \"true\",\n enableParallelEpoxyProcessing : \"true\"\n ]\n}\n```\n\nParallel processing can greatly speed up processing time (moreso than the incremental support), but given the nature of parallel processing it is still incubating.\nPlease report any issues or crashes that you notice.\n(We are currently using parallel mode in our large project at Airbnb with no problems.)\n\n## Breaking\nIn order to enable incremental annotation processing a change had to be made in how the processor of\n`@AutoModel` annotations work. If you use `@AutoModel` in an EpoxyController the annotated Model types\nmust be either declared in a different module from the EpoxyController, or in the same module in the same java package.\n\nAlso make sure you have kapt error types enabled.\n\nHowever, generally `@AutoModel` is considered legacy and is not recommended. It is a relic of Java Epoxy usage\nand instead the current best practice is to use Kotlin with the Kotlin model extension functions to build models.\n \n# 3.11.0 (May 20, 2020)\n- Introduce partial impression visibility states (#973)\n- Fix sticky header crash (#976)\n\n# 3.10.0 (May 15, 2020)\n- Carousel building with Kotlin DSL (#967)\n- Android ViewBinding: added an example in the sample project. (#939)\n- Fix setter with default value lookup in kotlin 1.4 (#966)\n- Change \"result\" property name in generated model (#965)\n- Add support for Sticky Headers (#842)\n- Use measured width/height if it exists in Carousel. (#915)\n- Add a getter to EpoxyViewHolder.getHolder(). (#952) (#953)\n- Fix visibility tracking during RecyclerView animations (#962)\n- Fix leak in ActivityRecyclerPool ((#906)\n- Rename ResultCallack to ResultCallback in AsyncEpoxyDiffer (#899)\n- Fix incorrect license attributes in POM file (#898)\n\n# 3.9.0 (Dec 17, 2019)\n- Fix reading EpoxyDataBindingPattern enableDoNotHash (#837) \n- Make EpoxyRecyclerView.setItemSpacingPx() open (#829)\n- Use same version for Mockito Core and Inline (#860)\n- Minor documentation and variable name updates. (#870)\n- Move epoxy-modelfactory tests to their own module (#834) \n- Remove executable bit from non-executable files (#864)\n- Various repo clean ups and version bumps\n\n# 3.8.0 (Sept 16, 2019)\n- Add support for Kotlin delegation via annotated interface properties #812\n- Fix checked change crash and improve debug errors #806\n- Remove extra space in Kotlin extensions #777\n- Update project to AGP 3.5, Kotlin 1.3.50, Gradle 5.6\n\n# 3.7.0 (July 1, 2019)\n- **New** Add a method to request visibility check externally (https://github.com/airbnb/epoxy/pull/775)\n\n# 3.6.0 (June 18, 2019)\n- **New** Preloader system with glide extensions https://github.com/airbnb/epoxy/pull/766\n- **Fixed** model click listener crashing on nested model https://github.com/airbnb/epoxy/pull/767\n\n# 3.5.1 (May 21, 2019)\n- Bumped Kotlin to 1.3.31\n\n# 3.5.0 (May 8, 2019)\n- **New** Converted EpoxyRecyclerView to Kotlin (you may need to update your usage for this). Also added built in support for `EpoxyRecyclerView#withModels` for easy inline model building with Kotlin.\n- **Fixed** Crashes in visibility tracking\n\n# 3.4.2 (April 18, 2019)\n- **Fixed** Kotlin default param handling had issues with overloaded functions\n\n# 3.4.1 (April 16, 2019)\n- **New** Support kotlin default parameters in @ModelView classes (https://github.com/airbnb/epoxy/pull/722)\n\n# 3.4.0 (April 10, 2019)\n- **New** Generate OnModelCheckedChangeListener override for props of type `CompoundButton.OnCheckedChangeListener` (https://github.com/airbnb/epoxy/pull/725)\n- **New** Extract ID generation methods to new public IdUtils class (https://github.com/airbnb/epoxy/pull/724)\n- **Changed** Reset controller state on failed model build (https://github.com/airbnb/epoxy/pull/720)\n- **Changed** Disabled the auto-detach behavior on Carousels by default (https://github.com/airbnb/epoxy/pull/688)\n\n# 3.3.0 (Feb 5, 2019)\n- **Fixed** Two issues related to the recent EpoxyModelGroup changes (https://github.com/airbnb/epoxy/pull/676)\n\n# 3.2.0 (Jan 21, 2019)\n- **New** Enable recycling of views within EpoxyModelGroup (https://github.com/airbnb/epoxy/pull/657)\n- **New** Add support to tracking visibility in nested RecyclerViews (https://github.com/airbnb/epoxy/pull/633)\n- **New** Add method to clear cache in paging controller (https://github.com/airbnb/epoxy/pull/586)\n- **Fix** Crashes from synchronization in PagedListEpoxyController (https://github.com/airbnb/epoxy/pull/656)\n- **Fix** Get onSwipeProgressChanged callbacks on return to original item position (https://github.com/airbnb/epoxy/pull/654)\n\n# 3.1.0 (Dec 4, 2018)\n- **Fix** Memory leak in debug mode is removed (https://github.com/airbnb/epoxy/pull/613)\n- **Fix** For visibility callbacks, wrong visibility when the view becomes not visible (https://github.com/airbnb/epoxy/pull/619)\n\n# 3.0.0 (Nov 13, 2018)\n\n- **Breaking** Migrated to androidx packages (Big thanks to jeffreydelooff!)\n\n- **Breaking** The `Carousel.Padding` class changed the ordering of its parameters to match Android's ordering of \"left, top, right, bottom\". (https://github.com/airbnb/epoxy/pull/536 thanks to martinbonnin)\n \n This change won't break compilation, so you _must_ manually change your parameter ordering, otherwise you will get unexpected padding results.\n\n# 2.19.0 (Oct 18, 2018)\nThis release adds built in support for monitoring visibility of views in the RecyclerView. (https://github.com/airbnb/epoxy/pull/560)\n\nUsage instructions and details are in the wiki - https://github.com/airbnb/epoxy/wiki/Visibility-Events\n\nHuge thanks to Emmanuel Boudrant for contributing this!\n\n# 2.18.0 (Sep 26, 2018)\n- **New** A new `PagedListEpoxyController` to improve integration with the Android Paging architecture component (#533 Thanks to Yigit!)\n With this change the old `PagingEpoxyController` has been deprecated, and [the wiki](https://github.com/airbnb/epoxy/wiki/Paging-Support) is updated.\n\n- **New** Add databinding option to not auto apply DoNotHash (#539)\n- **Fixed** Fix AsyncEpoxyController constructor to correctly use boolean setting (#537)\n- **Fixed** `app_name` is removed from module manifests (#543 Thanks @kettsun0123!)\n\n\n# 2.17.0 (Sep 6, 2018)\n- **New** Add support for setting the Padding via resource or directly in dp (https://github.com/airbnb/epoxy/pull/528 Thanks to pwillmann!)\n- **Fixed** Strip kotlin metadata annotation from generated classes (https://github.com/airbnb/epoxy/pull/523)\n- **Fixed** Reflect the annotations declared in constructor params (https://github.com/airbnb/epoxy/pull/519 Thanks to Shaishav Gandhi!)\n\n# 2.16.4 (Aug 29, 2018)\n- **New** `EpoxyAsyncUtil` and `AsyncEpoxyController` make it easier to use Epoxy's async behavior out of the box\n- **New** Epoxy's background diffing posts messages back to the main thread asynchronously so they are not blocked by waiting for vsync\n\n# 2.16.3 (Aug 24, 2018)\n- **New** Add `AsyncEpoxyController` for easy access to async support. Change background diffing to post asynchronously to the main thread (https://github.com/airbnb/epoxy/pull/509)\n\n# 2.16.2 (Aug 23, 2018)\n- **Fix** Kotlin lambdas can be used in model constructors (https://github.com/airbnb/epoxy/pull/501)\n- **New** Added function to check whether a model build is pending (https://github.com/airbnb/epoxy/pull/506)\n\n# 2.16.1 (Aug 15, 2018)\n- **Fix** Update EpoxyController async model building so threading works with tests (https://github.com/airbnb/epoxy/pull/504)\n\n# 2.16.0 (Aug 7, 2018)\n- **New** EpoxyController now supports asynchronous model building and diffing by allowing you to provide a custom Handler to run these tasks. See the [wiki](https://github.com/airbnb/epoxy/wiki/Epoxy-Controller#asynchronous-support) for more details.\n\n- **New** The `EpoxyController#addModelBuildListener` method was added to support listening for when model changes are dispatched to the recyclerview.\n\n# 2.15.0 (July 29, 2018)\n- **New** Added kotlin sample code for building models. Updated wiki with info (https://github.com/airbnb/epoxy/wiki/Kotlin-Model-Examples)\n\n- **Fix** Generated kotlin extension functions now work with Models with type variables (https://github.com/airbnb/epoxy/pull/478)\n- **Fix** Backup is not enabled in manifest now (https://github.com/airbnb/epoxy/pull/481)\n- **Fix** Click listener setter on generated model has correct nullability annotation (https://github.com/airbnb/epoxy/pull/458)\n- **Fix** Avoid kotlin crash using toString on lambdas (https://github.com/airbnb/epoxy/pull/482)\n- **Fix** If EpoxyModelGroup has annotations the generated class now calls super methods correctly. (https://github.com/airbnb/epoxy/pull/483)\n\n# 2.14.0 (June 27, 2018)\n- **New** Experimental support for creating Epoxy models from arbitrary data formats (#450)\n\n# 2.13.0 (June 19, 2018)\n- **Fix** Reduce memory usage in model groups and differ (#433)\n- **Fix** Support for wildcards in private epoxy attributes (#451)\n- **Fix** Generated Kotlin Extensions Don't Adhere to Constructor Nullability (#449)\n- **Fix** Infinite loop in annotation processor (#447)\n\n# 2.12.0 (April 18, 2018)\n\n- **Breaking** Several updates to the Paging Library integration were made (https://github.com/airbnb/epoxy/pull/421)\n - The `PagingEpoxyController` class had the methods `setNumPagesToLoad` and `setPageSizeHint` removed\n - Page hints are now taken from the `Config` object off of the PagedList. See the `setConfig` javadoc for information on how config values are used: https://github.com/airbnb/epoxy/blob/master/epoxy-paging/src/main/java/com/airbnb/epoxy/paging/PagingEpoxyController.java#L220\n - Several tweaks were made to how the page size and prefetch distance affect model rebuilding. Take some time to make sure your config values make sense and produce good results for your use case\n - A crash on empty list was fixed (https://github.com/airbnb/epoxy/issues/420)\n\n- **New** The [Paris](https://github.com/airbnb/paris) library is now officially supported to allow dynamically styling RecyclerView items though Epoxy models. See [the wiki](https://github.com/airbnb/epoxy/wiki/Paris-Integration-(Dynamic-Styling)) for more info.\n\n\n# 2.11.0 (April 7, 2018)\n\n- **Fix** Make databinding work with Android Studio 3.1 (https://github.com/airbnb/epoxy/pull/418)\n- Make `EpoxyController#isBuildingModels` public (https://github.com/airbnb/epoxy/pull/406\n\n\n# 2.10.0 (February 25, 2018)\n\n- **Improved** Allow the `Model_` class suffix for models generated via `@ModelView` to be customized (https://github.com/airbnb/epoxy/pull/402 Big thanks to geralt-encore!)\n\n# 2.9.0 (January 29, 2018)\n- **Improved** Global defaults for EpoxyController settings. Set duplicate filtering and exception handlers for all your controllers. (https://github.com/airbnb/epoxy/pull/394)\n- **Improved** Add `@NonNull` annotations in EpoxyModel for better Kotlin interop\n\n- **Fixed** Model click listeners now rebind correctly on partial model diffs (https://github.com/airbnb/epoxy/pull/393)\n- **Fixed** Update Android Paging library to fix placeholder support (Thanks @wkranich! https://github.com/airbnb/epoxy/pull/360)\n- **Fixed** Improve error message for inaccessible private fields (https://github.com/airbnb/epoxy/pull/388)\n\n# 2.8.0 (December 22, 2017)\n\n- **New** Use `@ModelProp` directly on fields to avoid creating a setter (https://github.com/airbnb/epoxy/pull/343)\n- **New** Set EpoxyRecyclerView item spacing via xml attribute (https://github.com/airbnb/epoxy/pull/364)\n- **New** More flexibility over setting Carousel padding values (https://github.com/airbnb/epoxy/pull/369)\n- **New** Allow custom EpoxyModelGroup root view (https://github.com/airbnb/epoxy/pull/370)\n\n- **Fixed** Public visibility settings of the Carousel snap helper settings (https://github.com/airbnb/epoxy/pull/356)\n- **Fixed** Add more nullability annotations to better support Kotlin\n- **Fixed** Saving view state now works better (https://github.com/airbnb/epoxy/pull/367)\n\n# 2.7.3 (November 21, 2017)\n\n- **Fixed** When a model changed and a partial update was bound to an existing view the wrong values could be set for prop groups (https://github.com/airbnb/epoxy/pull/347)\n\n# 2.7.2 (October 28, 2017)\n\n- **Fixed** Using `EpoxyDataBindingPattern` could result in the wrong package being used for the BR class in generated models.\n\n# 2.7.1 (October 24, 2017)\nSeveral fixes:\n\n- https://github.com/airbnb/epoxy/pull/332\n- https://github.com/airbnb/epoxy/pull/329\n- https://github.com/airbnb/epoxy/pull/330\n- https://github.com/airbnb/epoxy/pull/331\n\n# 2.7.0 (October 17, 2017)\n\n* **New** If a `@ModelView` generated model has a custom base class the generated model will now inherit constructors from the base class (https://github.com/airbnb/epoxy/pull/315)\n* **New** Use the `EpoxyDataBindingPattern` annotation to specify a naming pattern for databinding layouts. This removes the need to declare every databinding layout explicitly ([Wiki](https://github.com/airbnb/epoxy/wiki/Data-Binding-Support#automatic-based-on-naming-pattern) - https://github.com/airbnb/epoxy/pull/319)\n* **New** If a view with `@ModelView` implements an interface then the generated model will implement a similar interface, enabling polymorphism with models. [Wiki](https://github.com/airbnb/epoxy/wiki/Generating-Models-from-View-Annotations#view-interfaces)\n\n* **Improvement** `PagingEpoxyController` now has getters to access the underlying data lists (Thanks to @pcqpcq - https://github.com/airbnb/epoxy/pull/317)\n* **Improvement** `EpoxyModelGroup` now supports partial rebinds (https://github.com/airbnb/epoxy/pull/316)\n\n# 2.6.0 (October 10, 2017)\n* **Improvement** If a `OnModelClickListener` is used it will not be called if a view is clicked while it is being removed or otherwise has no position (https://github.com/airbnb/epoxy/issues/293 - Thanks @niccorder!)\n\n* **New** `EpoxyRecyclerView` and `Carousel` provide out of the box integration with Epoxy along with other enhancements over regular RecyclerView (https://github.com/airbnb/epoxy/wiki/EpoxyRecyclerView)\n* **New** `EpoxyPagingController` provides integration with the Android Paging architecture component as well as normal, large lists of items (https://github.com/airbnb/epoxy/wiki/Large-Data-Sets)\n\n#### Kotlin\n* **Improvement** Disable kotlin extension function generation with the annotation processor flag `disableEpoxyKotlinExtensionGeneration` (https://github.com/airbnb/epoxy/pull/309)\n* **Fix** If a model has a non empty constructor the generated extension function will now use it.\n\n\n# 2.5.1 (October 2, 2017)\n* **Fixed** The wrong import was being generated for models using a view holder in 2.5.0 (https://github.com/airbnb/epoxy/pull/294)\n* **Fixed** Fix generated code failing to compile if a subclass of View.OnClickListener is used as an attribute (https://github.com/airbnb/epoxy/pull/296)\n\n\n# 2.5.0 (September 14, 2017)\n* **New Feature** Epoxy now generates a Kotlin DSL to use when building models in your EpoxyController! See [the wiki](https://github.com/airbnb/epoxy/wiki/Epoxy-Controller#usage-with-kotlin) for details\n* **New Feature** You can use the `autoLayout` parameter in `@ModelView` instead of needing to create a layout resource for `defaultLayout`. Epoxy will then create your view programmatically (https://github.com/airbnb/epoxy/pull/282).\n\n**Breaking**\n* The `onSwipeProgressChanged` callback in `EpoxyTouchHelper` had a `Canvas` parameter added (https://github.com/airbnb/epoxy/pull/280). You will need to update any of your usages to add this. Sorry for the inconvenience; this will hopefully help you add better swipe animations.\n\n\n# 2.4.0 (September 4, 2017)\n* **Improvement** If you are setting options on a @ModelProp and have no other annotation parameters you can now omit the explicit `options = ` param name (https://github.com/airbnb/epoxy/pull/268)\n* **Improvement** If you are using `@TextProp` you can now specify a default string via a string resource (https://github.com/airbnb/epoxy/pull/269)\n\n* **Fixed** EpoxyModelGroup was not binding model click listeners correctly (https://github.com/airbnb/epoxy/pull/267)\n* **Fixed** A model created with @ModelView could fail to compile if it had nullable prop overloads (https://github.com/airbnb/epoxy/pull/274)\n\n#### Potentially Breaking Fix\nA model created with @ModelView with a click listener had the wrong setter name for the model click listener overload (https://github.com/airbnb/epoxy/pull/275)\n\nIf you were setting this you will need to update the setter name. If you were setting the click listener to null you may now have to cast it.\n\n\n# 2.3.0 (August 16, 2017)\n* **New** An `AfterPropsSet` annotation for use in `@ModelView` classes. This allows initialization work to be done after all properties are bound from the model. (https://github.com/airbnb/epoxy/pull/242)\n* **New** Annotations `TextProp` and `CallbackProp` as convenient replacements for `ModelProp`. (https://github.com/airbnb/epoxy/pull/260)\n* **New** Easy support for dragging and swiping via the `EpoxyTouchHelper` class. https://github.com/airbnb/epoxy/wiki/Touch-Support\n* **Change** Added the method `getRootView` to the view holder class in `EpoxyModelGroup` and made the bind methods on `EpoxyModelGroup` non final. This allows access to the root view of the group.\n* **Change** Generated models will now inherit class annotations from the base class (https://github.com/airbnb/epoxy/pull/255 Thanks geralt-encore!)\n\n# 2.2.0 (June 19, 2017)\n* **Main Feature** Models can now be completely generated from a custom view via annotations on the view. This should completely remove the overhead of creating a model manually in many cases! For more info, see [the wiki](https://github.com/airbnb/epoxy/wiki/Generating-Models-from-View-Annotations)\n\n* **New** Lowered the minimum SDK from 16 to 14.\n* **New** Models that have a `View.OnLongClickListener` as an EpoxyAttribute will now have an overloaded setter on the generated model that allows you to set a long click listener that will return the model, view, and adapter position. This is very similar to the `View.OnClickListener` support added in 2.0.0, but for long click listeners. **Upgrade Note** If you were setting a long click listener value to null anywhere you will need to now cast that to `View.OnLongClickListener` because of the new overloaded method.\n* **New** `id` overload on EpoxyModel to define a model id with multiple strings\n* **New** Option in `EpoxyAttribute` to not include the attribute in the generated `toString` method (Thanks to @geralt-encore!)\n* **New** @AutoModel models are now inherited from usages in super classes (Thanks to @geralt-encore!)\n* **Fixed** Generated getters could recursively call themselves (Thanks to @geralt-encore!)\n\n# 2.1.0 (May 9, 2017)\n\n* **New**: Support for Android Data Binding! Epoxy will now generate an EpoxyModel directly from a Data Binding xml layout, and handle all data binding details automatically. Thanks to @geralt-encore for helping with this! See more details in [the wiki](https://github.com/airbnb/epoxy/wiki/Data-Binding-Support).\n* **New**: Support for Litho. Epoxy will now generate an EpoxyModel for Litho Layout Specs. See more details in [the wiki](https://github.com/airbnb/epoxy/wiki/Litho-Support).\n* **New**: Support for implicitly adding AutoModels to an EpoxyController, this let's you drop the extra `.addTo(this)` line. More details and instructions [here](https://github.com/airbnb/epoxy/wiki/Epoxy-Controller#implicit-adding)\n\n# 2.0.0 (March 25, 2017)\n\n* **New**: The `EpoxyController` class helps you manage even models better. This should be used instead of the original `EpoxyAdapter` in most places. Read more about `EpoxyController` in [the wiki](https://github.com/airbnb/epoxy/wiki/Epoxy-Controller).\n* **Change**: In the new EpoxyController, the diffing algorithm uses both `equals` and `hashCode` on each model to check for changes. This is a change from the EpoxyAdapter where only `hashCode` was used. Generated models have both hashCode and equals implemented properly already, but if you have any custom hashCode implementations in your models make sure you have equals implemented as well.\n* **New**: Models that have a `View.OnClickListener` as an EpoxyAttribute will now have an overloaded setter on the generated model that allows you to set a click listener that will return the model, view, and adapter position. **Upgrade Note** If you were setting a click listener value to null anywhere you will need to now cast that to `View.OnClickListener` because of the new overloaded method.\n* **New**: Attach an onBind/onUnbind listener directly to a model instead of overriding the onModelBound method. Generated models will have methods created to set this listener and handle the callback for you.\n* **New**: Support for creating models in Kotlin (Thanks to @geralt-encore! https://github.com/airbnb/epoxy/pull/144)\n* **New**: `EpoxyModelWithView` supports creating a View programmatically instead of inflating from XML.\n* **New**: `EpoxyModelGroup` supports grouping models together in arbitrary formations.\n* **New**: Instead of setting attribute options like `@EpoxyAttribute(hash = false)` you should now do `@EpoxyAttribute(DoNotHash)`. You can also set other options like that.\n* **New**: Annotation processor options can now be set via gradle instead of with `PackageEpoxyConfig`\n* **New**: In an EpoxyController, if a model with the same id changes state Epoxy will include its previous state as a payload in the change notification. The new model will have its `bind(view, previouslyBoundModel)` method called so it can compare what changed since the previous model, and so it can update the view with only the data that changed.\n\n# 1.7.5 (Feb 21, 2017)\n\n* **New**: Models inherit layouts specified in superclass `@EpoxyModelClass` annotations [#119](https://github.com/airbnb/epoxy/pull/119)\n* **New**: Support module configuration options [#124](https://github.com/airbnb/epoxy/pull/124)\n\n# 1.6.2 (Feb 8, 2017)\n\n* New: Support layout resource annotations in library projects (https://github.com/airbnb/epoxy/pull/116)\n\n# 1.6.1 (Feb 6, 2017)\n\n* Allow the default layout resource to be specified in the EpoxyModelClass class annotation [(#109)](https://github.com/airbnb/epoxy/pull/109) [(#111)](https://github.com/airbnb/epoxy/pull/111)\n* Allow the `createNewHolder` method to be omitted and generated automatically [(#105)](https://github.com/airbnb/epoxy/pull/105)\n* Generate a subclass for abstract model classes if the EpoxyModelClass annotation is present [(#105)](https://github.com/airbnb/epoxy/pull/105)\n* Allow strings as model ids [(#107)](https://github.com/airbnb/epoxy/pull/107)\n* Add instructions to readme for avoiding memory leaks [(#106)](https://github.com/airbnb/epoxy/pull/106)\n* Add model callbacks for view attached/detached from window, and onFailedToRecycleView [(#104)](https://github.com/airbnb/epoxy/pull/104)\n* Improve documentation on model unbind behavior [(#103)](https://github.com/airbnb/epoxy/pull/103)\n* Fix generated methods from super classes that have var args [(#100)](https://github.com/airbnb/epoxy/pull/100)\n* Remove apt dependency [(#95)](https://github.com/airbnb/epoxy/pull/95)\n* Add `removeAllModels` method to EpoxyAdapter [(#94)](https://github.com/airbnb/epoxy/pull/94)\n* Use actual param names when generating methods from super classes [(#85)](https://github.com/airbnb/epoxy/pull/85)\n\n# 1.5.0 (11/21/2016)\n\n* Fixes models being used in separate modules\n* Generates a `reset()` method on each model to reset annotated fields to their defaults.\n* Changes `@EpoxyAttribute(hash = false)` to still differentiate between null and non null values in the hashcode implementation\n* Adds a `notifyModelChanged` method to EpoxyAdapter that allows a payload to be specified\n* Generates a `toString()` method on all generated model classes that includes the values of all annotated fields.\n\n# 1.4.0 (10/13/2016)\n\n* Optimizations to the diffing algorithm\n* Setters on generated classes are not created if an @EpoxyAttribute field is marked as `final`\n* Adds @EpoxyModelClass annotation to force a model to have a generated class, even if it doesn't have any @EpoxyAttribute fields\n* Fix to not generate methods for package private @EpoxyAttribute fields that are in a different package from the generated class\n* Have generated classes duplicate any super methods that have the model as the return type to help with chaining\n\n# 1.3.0 (09/15/2016)\n\n* Add support for using the view holder pattern with models. See the readme for more information.\n* Throw an exception if `EpoxyAdapter#notifyDataSetChanged()` is called when diffing is enabled. It doesn't make sense to allow this alongside diffing, and calling this is most likely to be an accidental mixup with `notifyModelsChanged()`.\n* Some performance improvements with the diffing algorithm.\n\n# 1.2.0 (09/07/2016)\n\n* Change signature of `EpoxyAdapter#onModelBound` to include the model position\n* Fix EpoxyModel hashcode to include the layout specified by `getDefaultLayout`\n* Enforce that the id of an `EpoxyModel` cannot change once it has been added to the adapter\n* Add optional hash parameter to the `EpoxyAttribute` annotation to exclude a field from being included in the generated hashcode method.\n\n# 1.1.0 (08/24/2016)\n\n* Initial release\n"
},
{
"path": "CONTRIBUTING.MD",
"content": "# Epoxy is an Open Source Project\n\nPull requests are welcome! We'd love help improving this library.\n\nWe have a code style setting for the project (checkstyle for Java, ktlint for Kotlin). Please run `Reformat Code` in Android Studio (or Intellij) on changed files before pushing them. Alternatively for Kotlin you can use [ktlint](https://ktlint.github.io/) tasks: check Kotlin code formatting with`./gradlew ktlint` and reformat all Kotlin code with `./gradlew ktlintformat`.\n\nAlso, run `./gradlew check` locally to make sure that style checks and tests pass.\n\nIf you update the model annotation processor you may find the `UpdateProcessorTestResults.kt` script very useful for updating the existing tests with your changes. (run it with kscript)\n - Run ./gradlew testDebug first to get test failures, then run `kscript UpdateProcessorTestResources.kt` to updates sources\n - You may have to repeat this cycle several times for all tests to be updated."
},
{
"path": "LICENSE",
"content": " Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"{}\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright 2018 Airbnb, Inc.\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n"
},
{
"path": "README.md",
"content": "[](https://travis-ci.com/github/airbnb/epoxy)\n[](https://maven-badges.herokuapp.com/maven-central/com.airbnb.android/epoxy)\n[](https://github.com/airbnb/epoxy/blob/master/LICENSE)\n\n\n# Epoxy\n\nEpoxy is an Android library for building complex screens in a RecyclerView. Models are automatically generated from custom views or databinding layouts via annotation processing. These models are then used in an EpoxyController to declare what items to show in the RecyclerView.\n\nThis abstracts the boilerplate of view holders, diffing items and binding payload changes, item types, item ids, span counts, and more, in order to simplify building screens with multiple view types. Additionally, Epoxy adds support for saving view state and automatic diffing of item changes.\n\n[We developed Epoxy at Airbnb](https://medium.com/airbnb-engineering/epoxy-airbnbs-view-architecture-on-android-c3e1af150394#.xv4ymrtmk) to simplify the process of working with RecyclerViews, and to add the missing functionality we needed. We now use Epoxy for most of the main screens in our app and it has improved our developer experience greatly.\n\n* [Installation](#installation)\n* [Basic Usage](#basic-usage)\n* [Documentation](#documentation)\n* [Min SDK](#min-sdk)\n* [Contributing](#contributing)\n* [Sample App](https://github.com/airbnb/epoxy/wiki/Sample-App)\n\n## Installation\n\nGradle is the only supported build configuration, so just add the dependency to your project `build.gradle` file:\n\n```groovy\ndependencies {\n implementation \"com.airbnb.android:epoxy:$epoxyVersion\"\n // Add the annotation processor if you are using Epoxy's annotations (recommended)\n annotationProcessor \"com.airbnb.android:epoxy-processor:$epoxyVersion\"\n}\n```\n\nReplace the variable `$epoxyVersion` with the latest version : [](https://maven-badges.herokuapp.com/maven-central/com.airbnb.android/epoxy)\n\nSee the [releases page](https://github.com/airbnb/epoxy/releases) for up to date release versions and details\n\n#### Kotlin with KAPT\nIf you are using Kotlin with KAPT you should also add\n```groovy\napply plugin: 'kotlin-kapt'\n\nkapt {\n correctErrorTypes = true\n}\n```\n\nso that `AutoModel` annotations work properly. More information [here](https://github.com/airbnb/epoxy/wiki/Epoxy-Controller#usage-with-kotlin)\n\nAlso, make sure to use `kapt` instead of `annotationProcessor` in your dependencies in the `build.gradle` file.\n\n#### Kotlin with KSP (Recommended)\nKSP (Kotlin Symbol Processing) is recommended over KAPT as it is significantly faster.\n\nAdd the KSP plugin to your root `build.gradle`:\n```groovy\nplugins {\n id 'com.google.devtools.ksp' version \"$KSP_VERSION\" apply false\n}\n```\n\nThen apply it in your module's `build.gradle`:\n```groovy\nplugins {\n id 'com.android.application'\n id 'kotlin-android'\n id 'com.google.devtools.ksp'\n}\n\ndependencies {\n implementation \"com.airbnb.android:epoxy:$epoxyVersion\"\n ksp \"com.airbnb.android:epoxy-processor:$epoxyVersion\"\n}\n```\n\nYou can configure KSP processor options:\n```groovy\nksp {\n // Validation and debugging\n arg(\"validateEpoxyModelUsage\", \"true\") // Validate model usage at runtime (default: true)\n arg(\"logEpoxyTimings\", \"false\") // Log annotation processing timings (default: false)\n\n // Code generation options\n arg(\"epoxyDisableGenerateReset\", \"false\") // Disable reset() method generation (default: false)\n arg(\"epoxyDisableGenerateGetters\", \"false\") // Disable getter generation (default: false)\n arg(\"epoxyDisableGenerateOverloads\", \"false\") // Disable builder overload generation (default: false)\n arg(\"disableEpoxyKotlinExtensionGeneration\", \"false\") // Disable Kotlin extension generation (default: false)\n arg(\"epoxyDisableDslMarker\", \"false\") // Disable DSL marker annotation (default: false)\n\n // Model requirements\n arg(\"requireHashCodeInEpoxyModels\", \"false\") // Require hashCode/equals in models (default: false)\n arg(\"requireAbstractEpoxyModels\", \"false\") // Require abstract model classes (default: false)\n arg(\"implicitlyAddAutoModels\", \"false\") // Auto-add models to controllers (default: false)\n}\n```\n\n**Important:** DataBinding models are **not supported** with KSP, as Android's DataBinding library itself uses KAPT. If you need DataBinding support, you must continue using KAPT. For custom views with `@ModelView` or ViewHolder models, KSP works perfectly.\n\nSee the [epoxy-kspsample](https://github.com/airbnb/epoxy/tree/master/epoxy-kspsample) module for a complete working example.\n\n## Library Projects\nIf you are using layout resources in Epoxy annotations then for library projects add [Butterknife's gradle plugin](https://github.com/JakeWharton/butterknife#library-projects) to your `buildscript`.\n\n```groovy\nbuildscript {\n repositories {\n mavenCentral()\n }\n dependencies {\n classpath 'com.jakewharton:butterknife-gradle-plugin:10.1.0'\n }\n}\n```\n\nand then apply it in your module:\n```groovy\napply plugin: 'com.android.library'\napply plugin: 'com.jakewharton.butterknife'\n```\n\nNow make sure you use R2 instead of R inside all Epoxy annotations.\n```java\n@ModelView(defaultLayout = R2.layout.view_holder_header)\npublic class HeaderView extends LinearLayout {\n ....\n}\n```\n\nThis is not necessary if you don't use resources as annotation parameters, such as with [custom view models](https://github.com/airbnb/epoxy/wiki/Generating-Models-from-View-Annotations).\n\n## Basic Usage\nThere are two main components of Epoxy:\n\n1. The `EpoxyModel`s that describe how your views should be displayed in the RecyclerView.\n2. The `EpoxyController` where the models are used to describe what items to show and with what data.\n\n### Creating Models\nEpoxy generates models for you based on your view or layout. Generated model classes are suffixed with an underscore (`_`) are used directly in your EpoxyController classes.\n\n#### From Custom Views\nAdd the `@ModelView` annotation on a view class. Then, add a \"prop\" annotation on each setter method to mark it as a property for the model.\n\n```java\n@ModelView(autoLayout = Size.MATCH_WIDTH_WRAP_HEIGHT)\npublic class HeaderView extends LinearLayout {\n\n ... // Initialization omitted\n\n @TextProp\n public void setTitle(CharSequence text) {\n titleView.setText(text);\n }\n}\n```\n\nA `HeaderViewModel_` is then generated in the same package.\n\n[More Details](https://github.com/airbnb/epoxy/wiki/Generating-Models-from-View-Annotations)\n\n#### From DataBinding\n\nIf you use Android DataBinding you can simply set up your xml layouts like normal:\n\n```xml\n\n \n \n \n\n \n\n```\n\nThen, create an interface or class in any package and add an `EpoxyDataBindingLayouts` annotation to declare your databinding layouts.\n\n```java\npackage com.airbnb.epoxy.sample;\n\nimport com.airbnb.epoxy.EpoxyDataBindingLayouts;\n\n@EpoxyDataBindingLayouts({R.layout.header_view, ... // other layouts })\ninterface EpoxyConfig {}\n```\n\nFrom this layout name Epoxy generates a `HeaderViewBindingModel_`.\n\n[More Details](https://github.com/airbnb/epoxy/wiki/Data-Binding-Support)\n\n#### From ViewHolders\nIf you use xml layouts without databinding you can create a model class to do the binding.\n\n```java\n@EpoxyModelClass(layout = R.layout.header_view)\npublic abstract class HeaderModel extends EpoxyModelWithHolder {\n @EpoxyAttribute String title;\n\n @Override\n public void bind(Holder holder) {\n holder.header.setText(title);\n }\n\n static class Holder extends BaseEpoxyHolder {\n @BindView(R.id.text) TextView header;\n }\n}\n```\n\nA `HeaderModel_` class is generated that subclasses HeaderModel and implements the model details.\n\n[More Details](https://github.com/airbnb/epoxy/wiki/ViewHolder-Models)\n\n### Using your models in a controller\n\nA controller defines what items should be shown in the RecyclerView, by adding the corresponding models in the desired order.\n\n The controller's `buildModels` method declares which items to show. You are responsible for calling `requestModelBuild` whenever your data changes, which triggers `buildModels` to run again. Epoxy tracks changes in the models and automatically binds and updates views.\n\nAs an example, our `PhotoController` shows a header, a list of photos, and a loader (if more photos are being loaded). The controller's `setData(photos, loadingMore)` method is called whenever photos are loaded, which triggers a call to `buildModels` so models representing the state of the new data can be built.\n\n```java\npublic class PhotoController extends Typed2EpoxyController, Boolean> {\n @AutoModel HeaderModel_ headerModel;\n @AutoModel LoaderModel_ loaderModel;\n\n @Override\n protected void buildModels(List photos, Boolean loadingMore) {\n headerModel\n .title(\"My Photos\")\n .description(\"My album description!\")\n .addTo(this);\n\n for (Photo photo : photos) {\n new PhotoModel()\n .id(photo.id())\n .url(photo.url())\n .addTo(this);\n }\n\n loaderModel\n .addIf(loadingMore, this);\n }\n }\n```\n\n#### Or with Kotlin\nAn extension function is generated for each model so we can write this:\n```kotlin\nclass PhotoController : Typed2EpoxyController, Boolean>() {\n\n override fun buildModels(photos: List, loadingMore: Boolean) {\n header {\n id(\"header\")\n title(\"My Photos\")\n description(\"My album description!\")\n }\n\n photos.forEach {\n photoView {\n id(it.id())\n url(it.url())\n }\n }\n\n if (loadingMore) loaderView { id(\"loader\") }\n }\n}\n```\n\n### Integrating with RecyclerView\n\nGet the backing adapter off the EpoxyController to set up your RecyclerView:\n```java\nMyController controller = new MyController();\nrecyclerView.setAdapter(controller.getAdapter());\n\n// Request a model build whenever your data changes\ncontroller.requestModelBuild();\n\n// Or if you are using a TypedEpoxyController\ncontroller.setData(myData);\n```\n\nIf you are using the [EpoxyRecyclerView](https://github.com/airbnb/epoxy/wiki/EpoxyRecyclerView) integration is easier.\n\n```java\nepoxyRecyclerView.setControllerAndBuildModels(new MyController());\n\n// Request a model build on the recyclerview when data changes\nepoxyRecyclerView.requestModelBuild();\n```\n\n#### Kotlin\nOr use [Kotlin Extensions](https://github.com/airbnb/epoxy/wiki/EpoxyRecyclerView#kotlin-extensions) to simplify further and remove the need for a controller class.\n```kotlin\nepoxyRecyclerView.withModels {\n header {\n id(\"header\")\n title(\"My Photos\")\n description(\"My album description!\")\n }\n\n photos.forEach {\n photoView {\n id(it.id())\n url(it.url())\n }\n }\n\n if (loadingMore) loaderView { id(\"loader\") }\n }\n}\n```\n\n\n### More Reading\nAnd that's it! The controller's declarative style makes it very easy to visualize what the RecyclerView will look like, even when many different view types or items are used. Epoxy handles everything else. If a view only partially changes, such as the description, only that new value is set on the view, so the system is very efficient\n\nEpoxy handles much more than these basics, and is highly configurable. See [the wiki](https://github.com/airbnb/epoxy/wiki) for in depth documentation.\n\n## Documentation\nSee examples and browse complete documentation at the [Epoxy Wiki](https://github.com/airbnb/epoxy/wiki)\n\nIf you still have questions, feel free to create a new issue.\n\n## Min SDK\nWe support a minimum SDK of 14. However, Epoxy is based on the v7 support libraries so it should work with lower versions if you care to override the min sdk level in the manifest.\n\n## Contributing\nPull requests are welcome! We'd love help improving this library. Feel free to browse through open issues to look for things that need work. If you have a feature request or bug, please open a new issue so we can track it.\n\n## License\n\n```\nCopyright 2016 Airbnb, Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n"
},
{
"path": "RELEASING.md",
"content": "Releasing\n========\n\n1. Bump the VERSION_NAME property in `gradle.properties` based on Major.Minor.Patch naming scheme\n2. Update `CHANGELOG.md` for the impending release.\n3. `git commit -am \"Prepare for release X.Y.Z.\"` (where X.Y.Z is the version you set in step 1)\n4. Add your sonatype login information under gradle properties mavenCentralUsername and mavenCentralPassword in your local user gradle.properties file\n5. Make sure you have a gpg signing key configured (https://vanniktech.github.io/gradle-maven-publish-plugin/central/#secrets)\n5. Run `./gradlew publish` to build the artifacts and publish them to maven\n7. Open PR on Github, merge, and publish release through Github UI.\n\nPublishing a release to an internal repository\n========\n\nTo publish an internal release to an Artifactory repository:\n\n1. Set credential values for ARTIFACTORY_USERNAME and ARTIFACTORY_PASSWORD in your local gradle.properties\n2. Set values for ARTIFACTORY_RELEASE_URL (and optionally ARTIFACTORY_SNAPSHOT_URL if you are publishing a snapshot)\n3. ./gradlew publishAllPublicationsToAirbnbArtifactoryRepository -PdoNotSignRelease=true --no-configuration-cache\n4. \"-PdoNotSignRelease=true\" is optional, but we don't need to sign artifactory releases and this allows everyone to publish without setting up a gpg key\n\nIf you need to publish to a different repository, look at the configuration in 'publishing.gradle'\nto see how to configure additional repositories.\n\nMaven Local Installation\n=======================\n\nIf testing changes locally, you can install to mavenLocal via `./gradlew publishToMavenLocal`"
},
{
"path": "UpdateProcessorTestResources.kt",
"content": "#!/usr/bin/env kscript\n@file:DependsOn(\"org.jsoup:jsoup:1.13.1\")\n\nimport org.jsoup.Jsoup\nimport org.jsoup.nodes.Document\nimport java.io.File\n\n\nfun main() {\n val testResultHtmlRegex = Regex(\"/build/reports/tests/.*/classes/.*\\\\.html\")\n File(\".\")\n .walk()\n .filter { it.isFile }\n .filter { it.path.contains(testResultHtmlRegex) }\n .forEach { updateTestClass(it) }\n}\n\nfun updateTestClass(testReport: File) {\n val doc: Document = Jsoup.parse(testReport, \"UTF-8\")\n\n // Failing processor tests have their output in a block\n doc.getElementsByTag(\"pre\")\n .filter { element ->\n // A failing block contains the text \"Source declared the same top-level types of an expected source, but\n // didn't match exactly.\"\n element.text().contains(\"Source declared the same top-level types of an expected source\")\n }.map { it.text() }\n .forEach { failingTestText ->\n updateIndividualTest(failingTestText)\n }\n}\n\nprivate fun updateIndividualTest(failingTestText: String) {\n val expectedFile = expectedFileRegex\n .find(failingTestText)\n ?.groupValues\n ?.getOrNull(1)\n\n ?.let { filePath ->\n // The test copies the source file to the build folder. We need to modify the original file to update its expected source\n File(\n filePath.replace(\n \"/build/intermediates/sourceFolderJavaResources/debug/\",\n \"/src/test/resources/\"\n )\n )\n }\n ?.takeIf { it.isFile }\n ?: error(\"Count not find expected file in $failingTestText\")\n\n // The error message includes the source code that was generated.\n // Actual Source:\n //=================\n // [code here]\n //\n // javaSources was: [com.google.testing.compile.JavaFileObjects$ResourceSourceJavaFileObject[file:/Users/elihart/repos/epoxy/epoxy-modelfactorytest/build/intermediates/sourceFolderJavaResources/debug/GroupPropMultipleSupportedAttributeDifferentNameModelView.java]]\n // at com.airbnb.epoxy.ProcessorTestUtils.assertGeneration(ProcessorTestUtils.kt:33)\n // ...\n\n val actualSource = failingTestText.substringAfter(\n \"\"\"\n Actual Source:\n =================\n\n \"\"\".trimIndent()\n ).substringBefore(\"javaSources was:\")\n .substringBefore(\"object was:\")\n\n expectedFile.writeText(actualSource)\n\n println(\"Updated test source ${expectedFile.path.substringAfter(\"/epoxy/\")}\")\n}\n\n// We expect to see a line like:\n// Expected file: \n// Which tells us where the original processor test file lives\nval expectedFileRegex = Regex(\"Expected file: <(.*)>\")\n"
},
{
"path": "blessedDeps.gradle",
"content": "/**\n * \"Blessed\" dependencies give us the ability to force a dependency(s) version to be consistent\n * for packaging a library. In turn, this also allows the ability to retract the forced update\n * based off build type/flavor which reduces regressions caused by conflicts.\n *\n * As an added bonus, we don't bloat our project build file by abstracting dependencies into its own\n * gradle file, then applying it back in as necessary.\n */\n\nrootProject.ext.TARGET_SDK_VERSION = 30\nrootProject.ext.COMPILE_SDK_VERSION = 33\nrootProject.ext.MIN_SDK_VERSION = 14\nrootProject.ext.COMPOSE_MIN_SDK_VERSION = 21\nrootProject.ext.PARIS_MIN_SDK_VERSION = 21\n\nrootProject.ext.ANDROIDX_ANNOTATION = \"1.5.0\"\nrootProject.ext.ANDROIDX_APPCOMPAT = \"1.5.1\"\nrootProject.ext.ANDROIDX_CARDVIEW = \"1.0.0\"\nrootProject.ext.ANDROIDX_CORE_KTX = \"1.3.2\"\nrootProject.ext.ANDROIDX_DATABINDING_ADAPTERS = \"3.2.1\"\nrootProject.ext.ANDROIDX_DATABINDING_COMPILER = \"3.2.1\"\nrootProject.ext.ANDROIDX_DATABINDING_LIBRARY = \"3.2.1\"\nrootProject.ext.ANDROIDX_ESPRESSO_CORE = \"3.5.1\"\nrootProject.ext.ANDROIDX_FRAGMENT_TESTING = \"1.3.3\"\nrootProject.ext.ANDROIDX_LEGACY = \"1.0.0\"\nrootProject.ext.ANDROIDX_MATERIAL = \"1.3.0\"\nrootProject.ext.ANDROIDX_PAGING = \"2.0.0\"\nrootProject.ext.ANDROIDX_PAGING3 = \"3.1.1\"\nrootProject.ext.ANDROIDX_RECYCLERVIEW = \"1.3.0-rc01\"\nrootProject.ext.ANDROIDX_ROOM = \"2.5.0-beta01\"\nrootProject.ext.ANDROIDX_RUNTIME = \"2.3.1\"\nrootProject.ext.ANDROIDX_VERSIONED_PARCELABLE = \"1.1.1\"\nrootProject.ext.ANDROID_ARCH_TESTING = \"2.1.0\"\nrootProject.ext.ANDROID_DATA_BINDING = \"1.3.1\"\nrootProject.ext.ANDROID_RUNTIME_VERSION = \"4.1.1.4\"\nrootProject.ext.ANDROID_TEST_RUNNER = \"1.5.2\"\nrootProject.ext.ANDROID_TEST_RULES = \"1.5.0\"\nrootProject.ext.ASSERTJ_VERSION = \"1.7.1\"\nrootProject.ext.AUTO_VALUE_VERSION = \"1.7.4\"\nrootProject.ext.GLIDE_VERSION = \"4.12.0\"\nrootProject.ext.GOOGLE_TESTING_COMPILE_VERSION = \"0.23.0\"\nrootProject.ext.INCAP_VERSION = \"0.3\"\nrootProject.ext.JUNIT_VERSION = \"4.13.2\"\nrootProject.ext.KOTLIN_COROUTINES_VERSION = \"1.6.4\"\nrootProject.ext.LOTTIE_VERSION = \"2.8.0\"\nrootProject.ext.MOCKITO_VERSION = \"5.20.0\"\nrootProject.ext.PARIS_VERSION = \"2.2.1\"\nrootProject.ext.ROBOLECTRIC_VERSION = \"4.9.2\"\nrootProject.ext.SQUARE_JAVAPOET_VERSION = \"1.13.0\"\nrootProject.ext.SQUARE_KOTLINPOET_VERSION = \"1.12.0\"\nrootProject.ext.COMPOSE_VERSION = \"1.4.2\"\nrootProject.ext.COMPOSE_ACTIVITY_VERSION = \"1.6.0\"\nrootProject.ext.KOTLINX_LIFECYCLE_RUNTIME_VERSION = \"2.5.1\"\nrootProject.ext.XPROCESSING_VERSION = \"2.8.4\"\nrootProject.ext.KOTLIN_TESTING_COMPILE_VERSION = '0.11.0'\nrootProject.ext.LIFECYCLE_VIEWMODEL = '2.6.1'\n\nrootProject.ext.deps = [\n activityCompose : \"androidx.activity:activity-compose:$COMPOSE_ACTIVITY_VERSION\",\n androidAnnotations : \"androidx.annotation:annotation:$ANDROIDX_ANNOTATION\",\n androidAppcompat : \"androidx.appcompat:appcompat:$ANDROIDX_APPCOMPAT\",\n androidArchCoreTesting : \"androidx.arch.core:core-testing:$ANDROID_ARCH_TESTING\",\n androidCardView : \"androidx.cardview:cardview:$ANDROIDX_CARDVIEW\",\n androidCoreKtx : \"androidx.core:core-ktx:$ANDROIDX_CORE_KTX\",\n androidDesignLibrary : \"com.google.android.material:material:$ANDROIDX_MATERIAL\",\n androidEspressoCore : \"androidx.test.espresso:espresso-core:$ANDROIDX_ESPRESSO_CORE\",\n androidFragmentTesting : \"androidx.fragment:fragment-testing:$ANDROIDX_FRAGMENT_TESTING\",\n androidLifecycleRuntimeKtx : \"androidx.lifecycle:lifecycle-runtime-ktx:$KOTLINX_LIFECYCLE_RUNTIME_VERSION\",\n androidPaging3Component : \"androidx.paging:paging-runtime:$ANDROIDX_PAGING3\",\n androidPagingComponent : \"androidx.paging:paging-runtime:$ANDROIDX_PAGING\",\n androidRecyclerView : \"androidx.recyclerview:recyclerview:$ANDROIDX_RECYCLERVIEW\",\n androidRuntime : \"com.google.android:android:$ANDROID_RUNTIME_VERSION\",\n androidTestCore : \"androidx.test:core:1.3.0\",\n androidTestExtJunitKtx : \"androidx.test.ext:junit-ktx:1.1.2\",\n androidTestRules : \"androidx.test:rules:$ANDROID_TEST_RULES\",\n androidTestRunner : \"androidx.test:runner:$ANDROID_TEST_RUNNER\",\n assertj : \"org.assertj:assertj-core:$ASSERTJ_VERSION\",\n autoValue : \"com.google.auto.value:auto-value:$AUTO_VALUE_VERSION\",\n composeMaterial : \"androidx.compose.material:material:$COMPOSE_VERSION\",\n composeUi : \"androidx.compose.ui:ui:$COMPOSE_VERSION\",\n composeUiTooling : \"androidx.compose.ui:ui-tooling:$COMPOSE_VERSION\",\n dataBindingAdapters : \"androidx.databinding:databinding-adapters:$ANDROIDX_DATABINDING_ADAPTERS\",\n dataBindingLibrary : \"androidx.databinding:databinding-library:$ANDROIDX_DATABINDING_LIBRARY\",\n glide : \"com.github.bumptech.glide:glide:$GLIDE_VERSION\",\n googleTestingCompile : \"com.google.testing.compile:compile-testing:$GOOGLE_TESTING_COMPILE_VERSION\",\n incapProcessor : \"net.ltgt.gradle.incap:incap-processor:$INCAP_VERSION\",\n incapRuntime : \"net.ltgt.gradle.incap:incap:$INCAP_VERSION\",\n junit : \"junit:junit:$JUNIT_VERSION\",\n kotlinCoroutines : \"org.jetbrains.kotlinx:kotlinx-coroutines-core:$KOTLIN_COROUTINES_VERSION\",\n kotlinCoroutinesTest : \"org.jetbrains.kotlinx:kotlinx-coroutines-test:$KOTLIN_COROUTINES_VERSION\",\n kotlinxMetadata : \"org.jetbrains.kotlin:kotlin-metadata-jvm:$KOTLIN_VERSION\",\n lottie : \"com.airbnb.android:lottie:$LOTTIE_VERSION\",\n mockito : \"org.mockito:mockito-core:$MOCKITO_VERSION\",\n paris : \"com.airbnb.android:paris:$PARIS_VERSION\",\n parisProcessor : \"com.airbnb.android:paris-processor:$PARIS_VERSION\",\n robolectric : \"org.robolectric:robolectric:$ROBOLECTRIC_VERSION\",\n squareJavaPoet : \"com.squareup:javapoet:$SQUARE_JAVAPOET_VERSION\",\n squareKotlinPoet : \"com.squareup:kotlinpoet:$SQUARE_KOTLINPOET_VERSION\",\n kotlinPoetJavaInterop : \"com.squareup:kotlinpoet-javapoet:$SQUARE_KOTLINPOET_VERSION\",\n kotlinPoetKspInterop : \"com.squareup:kotlinpoet-ksp:$SQUARE_KOTLINPOET_VERSION\",\n versionedParcelable : \"androidx.versionedparcelable:versionedparcelable:$ANDROIDX_VERSIONED_PARCELABLE\",\n ksp : \"com.google.devtools.ksp:symbol-processing-api:$KSP_VERSION\",\n kspAaEmbeddable : \"com.google.devtools.ksp:symbol-processing-aa-embeddable:$KSP_VERSION\",\n kspImpl : \"com.google.devtools.ksp:symbol-processing:$KSP_VERSION\",\n xProcessing : \"androidx.room:room-compiler-processing:$XPROCESSING_VERSION\",\n xProcessingTesting : \"androidx.room:room-compiler-processing-testing:$XPROCESSING_VERSION\",\n kotlinCompileTesting : \"dev.zacsweers.kctfork:ksp:$KOTLIN_TESTING_COMPILE_VERSION\",\n kotlinAnnotationProcessingEmbeddable: \"org.jetbrains.kotlin:kotlin-annotation-processing-embeddable:$KOTLIN_VERSION\",\n lifecycleViewmodel : \"androidx.lifecycle:lifecycle-viewmodel:$LIFECYCLE_VIEWMODEL\",\n lifecycleViewmodelKtx : \"androidx.lifecycle:lifecycle-viewmodel-ktx:$LIFECYCLE_VIEWMODEL\",\n]\n"
},
{
"path": "build.gradle",
"content": "// Top-level build file where you can add configuration options common to all sub-projects/modules.\nbuildscript {\n\n ext.KOTLIN_VERSION = \"2.2.21\"\n ext.ANDROID_PLUGIN_VERSION = '8.13.0'\n ext.KSP_VERSION = '2.3.3'\n\n repositories {\n google()\n mavenCentral()\n gradlePluginPortal()\n }\n dependencies {\n classpath \"com.android.tools.build:gradle:$ANDROID_PLUGIN_VERSION\"\n classpath \"org.jetbrains.kotlin:kotlin-gradle-plugin:$KOTLIN_VERSION\"\n classpath \"org.jetbrains.kotlin:compose-compiler-gradle-plugin:$KOTLIN_VERSION\"\n // Upload with: (see RELEASING.md)\n // ./gradlew publishAllPublicationsToMavenCentral --no-configuration-cache\n classpath 'com.vanniktech:gradle-maven-publish-plugin:0.35.0'\n // Dokka is needed on classpath for vanniktech publish plugin\n classpath \"org.jetbrains.dokka:dokka-gradle-plugin:1.6.10\"\n }\n}\n\nplugins {\n // Run ./gradlew dependencyUpdates to see available version updates\n id 'com.github.ben-manes.versions' version '0.42.0'\n id \"com.google.devtools.ksp\" version \"$KSP_VERSION\"\n}\n\nallprojects {\n\n repositories {\n google()\n mavenCentral()\n }\n\n // Prevent javadoc task complaining about errors with kotlin files\n tasks.withType(Javadoc) {\n excludes = ['**/*.kt']\n }\n}\n\nsubprojects { project ->\n apply from: \"$rootDir/blessedDeps.gradle\"\n apply plugin: 'com.github.ben-manes.versions'\n apply from: \"${project.rootDir}/ktlint.gradle\"\n\n afterEvaluate {\n if (project.tasks.findByName('check')) {\n check.dependsOn('ktlint')\n }\n\n if (project.extensions.findByType(com.android.build.gradle.LibraryExtension.class) != null) {\n project.android.libraryVariants.all { variant ->\n def outputFolder = new File(\"build/generated/ksp/${variant.name}/kotlin\")\n variant.addJavaSourceFoldersToModel(outputFolder)\n android.sourceSets.getAt(variant.name).java {\n srcDir(outputFolder)\n }\n }\n } else if (project.extensions.findByType(com.android.build.gradle.AbstractAppExtension.class) != null) {\n project.android.applicationVariants.all { variant ->\n def outputFolder = new File(\"build/generated/ksp/${variant.name}/kotlin\")\n variant.addJavaSourceFoldersToModel(outputFolder)\n android.sourceSets.getAt(variant.name).java {\n srcDir(outputFolder)\n }\n }\n }\n }\n}\n\ndef isNonStable = { String version ->\n def stableKeyword = ['RELEASE', 'FINAL', 'GA'].any { it -> version.uppercase().contains(it) }\n def regex = /^[0-9,.v-]+(-r)?$/\n return !stableKeyword && !(version ==~ regex)\n}\n\ntasks.named(\"dependencyUpdates\").configure {\n // disallow release candidates as upgradable versions from stable versions\n rejectVersionIf {\n isNonStable(it.candidate.version) && !isNonStable(it.currentVersion)\n }\n}\n"
},
{
"path": "epoxy-adapter/.gitignore",
"content": "/build\n"
},
{
"path": "epoxy-adapter/build.gradle",
"content": "apply plugin: 'com.android.library'\napply plugin: 'kotlin-android'\napply plugin: 'kotlin-kapt'\napply plugin: 'kotlin-parcelize'\napply from: '../publishing.gradle'\n\nandroid {\n namespace 'com.airbnb.viewmodeladapter'\n\n defaultConfig {\n compileSdk rootProject.COMPILE_SDK_VERSION\n minSdkVersion rootProject.MIN_SDK_VERSION\n targetSdkVersion rootProject.TARGET_SDK_VERSION\n consumerProguardFiles 'proguard-rules.pro'\n }\n\n testOptions.unitTests.includeAndroidResources = true\n\n buildTypes.all { buildType ->\n buildType.javaCompileOptions.annotationProcessorOptions.arguments =\n [\n logEpoxyTimings: \"true\"\n ]\n }\n}\n\nkotlin {\n jvmToolchain(11)\n}\n\nconfigurations.all { strategy ->\n strategy.resolutionStrategy.force rootProject.deps.androidAnnotations, rootProject.deps.androidRecyclerView,\n rootProject.deps.androidDesignLibrary, rootProject.deps.androidAppcompat, rootProject.deps.junit,\n rootProject.deps.robolectric, rootProject.deps.mockito\n}\n\ndependencies {\n implementation rootProject.deps.androidAppcompat\n implementation rootProject.deps.androidAnnotations\n implementation rootProject.deps.androidRecyclerView\n implementation rootProject.deps.androidDesignLibrary\n api project(':epoxy-annotations')\n\n kapt project(':epoxy-processor')\n kaptTest project(':epoxy-processor')\n\n testImplementation rootProject.deps.junit\n testImplementation rootProject.deps.robolectric\n testImplementation rootProject.deps.mockito\n testImplementation rootProject.deps.androidTestCore\n}\n"
},
{
"path": "epoxy-adapter/gradle.properties",
"content": "POM_NAME=Epoxy\nPOM_ARTIFACT_ID=epoxy\nPOM_PACKAGING=jar"
},
{
"path": "epoxy-adapter/lint.xml",
"content": "\n\n \n \n \n \n \n \n\n"
},
{
"path": "epoxy-adapter/proguard-rules.pro",
"content": "# The generated ControllerHelper classes are needed when using AutoModel annotations.\n# Each ControllerHelper is looked up reflectively, so we need to make sure it is\n# kept and its name not obfuscated so the reflective lookup works.\n-keep class * extends com.airbnb.epoxy.EpoxyController { *; }\n-keep class * extends com.airbnb.epoxy.ControllerHelper { *; }\n-keepclasseswithmembernames class * { @com.airbnb.epoxy.AutoModel ; }"
},
{
"path": "epoxy-adapter/src/main/AndroidManifest.xml",
"content": "\n\n \n\n"
},
{
"path": "epoxy-adapter/src/main/java/com/airbnb/epoxy/ActivityRecyclerPool.kt",
"content": "package com.airbnb.epoxy\n\nimport android.app.Activity\nimport android.content.Context\nimport android.content.ContextWrapper\nimport android.os.Build\nimport androidx.core.view.ViewCompat\nimport androidx.lifecycle.Lifecycle\nimport androidx.lifecycle.LifecycleObserver\nimport androidx.lifecycle.LifecycleOwner\nimport androidx.lifecycle.OnLifecycleEvent\nimport androidx.recyclerview.widget.RecyclerView\nimport java.lang.ref.WeakReference\nimport java.util.ArrayList\n\ninternal class ActivityRecyclerPool {\n\n /**\n * Store one unique pool per activity. They are cleared out when activities are destroyed, so this\n * only needs to hold pools for active activities.\n */\n private val pools = ArrayList(5)\n\n @JvmOverloads\n fun getPool(\n context: Context,\n poolFactory: () -> RecyclerView.RecycledViewPool\n ): PoolReference {\n\n val iterator = pools.iterator()\n var poolToUse: PoolReference? = null\n\n while (iterator.hasNext()) {\n val poolReference = iterator.next()\n when {\n poolReference.context === context -> {\n if (poolToUse != null) {\n throw IllegalStateException(\"A pool was already found\")\n }\n poolToUse = poolReference\n // finish iterating to remove any old contexts\n }\n poolReference.context.isActivityDestroyed() -> {\n // A pool from a different activity that was destroyed.\n // Clear the pool references to allow the activity to be GC'd\n poolReference.viewPool.clear()\n iterator.remove()\n }\n }\n }\n\n if (poolToUse == null) {\n poolToUse = PoolReference(context, poolFactory(), this)\n context.lifecycle()?.addObserver(poolToUse)\n pools.add(poolToUse)\n }\n\n return poolToUse\n }\n\n fun clearIfDestroyed(pool: PoolReference) {\n if (pool.context.isActivityDestroyed()) {\n pool.viewPool.clear()\n pools.remove(pool)\n }\n }\n\n private fun Context.lifecycle(): Lifecycle? {\n if (this is LifecycleOwner) {\n return lifecycle\n }\n\n if (this is ContextWrapper) {\n return baseContext.lifecycle()\n }\n\n return null\n }\n}\n\ninternal class PoolReference(\n context: Context,\n val viewPool: RecyclerView.RecycledViewPool,\n private val parent: ActivityRecyclerPool\n) : LifecycleObserver {\n private val contextReference: WeakReference = WeakReference(context)\n\n val context: Context? get() = contextReference.get()\n\n fun clearIfDestroyed() {\n parent.clearIfDestroyed(this)\n }\n\n @OnLifecycleEvent(Lifecycle.Event.ON_DESTROY)\n fun onContextDestroyed() {\n clearIfDestroyed()\n }\n}\n\ninternal fun Context?.isActivityDestroyed(): Boolean {\n if (this == null) {\n return true\n }\n\n if (this !is Activity) {\n return (this as? ContextWrapper)?.baseContext?.isActivityDestroyed() ?: false\n }\n\n if (isFinishing) {\n return true\n }\n\n return if (Build.VERSION.SDK_INT >= 17) {\n isDestroyed\n } else {\n // Use this as a proxy for being destroyed on older devices\n !ViewCompat.isAttachedToWindow(window.decorView)\n }\n}\n"
},
{
"path": "epoxy-adapter/src/main/java/com/airbnb/epoxy/AsyncEpoxyController.java",
"content": "package com.airbnb.epoxy;\n\nimport android.os.Handler;\n\nimport static com.airbnb.epoxy.EpoxyAsyncUtil.MAIN_THREAD_HANDLER;\nimport static com.airbnb.epoxy.EpoxyAsyncUtil.getAsyncBackgroundHandler;\n\n/**\n * A subclass of {@link EpoxyController} that makes it easy to do model building and diffing in\n * the background.\n *
\n * See https://github.com/airbnb/epoxy/wiki/Epoxy-Controller#asynchronous-support\n */\npublic abstract class AsyncEpoxyController extends EpoxyController {\n\n /**\n * A new instance that does model building and diffing asynchronously.\n */\n public AsyncEpoxyController() {\n this(true);\n }\n\n /**\n * @param enableAsync True to do model building and diffing asynchronously, false to do them\n * both on the main thread.\n */\n public AsyncEpoxyController(boolean enableAsync) {\n this(enableAsync, enableAsync);\n }\n\n /**\n * Individually control whether model building and diffing are done async or on the main thread.\n */\n public AsyncEpoxyController(boolean enableAsyncModelBuilding, boolean enableAsyncDiffing) {\n super(getHandler(enableAsyncModelBuilding), getHandler(enableAsyncDiffing));\n }\n\n private static Handler getHandler(boolean enableAsync) {\n return enableAsync ? getAsyncBackgroundHandler() : MAIN_THREAD_HANDLER;\n }\n}\n"
},
{
"path": "epoxy-adapter/src/main/java/com/airbnb/epoxy/AsyncEpoxyDiffer.java",
"content": "package com.airbnb.epoxy;\n\nimport android.os.Handler;\n\nimport java.util.Collections;\nimport java.util.List;\nimport java.util.concurrent.Executor;\n\nimport androidx.annotation.AnyThread;\nimport androidx.annotation.NonNull;\nimport androidx.annotation.Nullable;\nimport androidx.recyclerview.widget.DiffUtil;\nimport androidx.recyclerview.widget.DiffUtil.ItemCallback;\n\n/**\n * An adaptation of Google's {@link androidx.recyclerview.widget.AsyncListDiffer}\n * that adds support for payloads in changes.\n *
\n * Also adds support for canceling an in progress diff, and makes everything thread safe.\n */\nclass AsyncEpoxyDiffer {\n\n interface ResultCallback {\n void onResult(@NonNull DiffResult result);\n }\n\n private final Executor executor;\n private final ResultCallback resultCallback;\n private final ItemCallback> diffCallback;\n private final GenerationTracker generationTracker = new GenerationTracker();\n\n AsyncEpoxyDiffer(\n @NonNull Handler handler,\n @NonNull ResultCallback resultCallback,\n @NonNull ItemCallback> diffCallback\n ) {\n this.executor = new HandlerExecutor(handler);\n this.resultCallback = resultCallback;\n this.diffCallback = diffCallback;\n }\n\n @Nullable\n private volatile List> list;\n\n /**\n * Non-null, unmodifiable version of list.\n *
\n * Collections.emptyList when list is null, wrapped by Collections.unmodifiableList otherwise\n */\n @NonNull\n private volatile List> readOnlyList = Collections.emptyList();\n\n /**\n * Get the current List - any diffing to present this list has already been computed and\n * dispatched via the ListUpdateCallback.\n *
\n * If a null List, or no List has been submitted, an empty list will be returned.\n *
\n * The returned list may not be mutated - mutations to content must be done through\n * {@link #submitList(List)}.\n *\n * @return current List.\n */\n @AnyThread\n @NonNull\n public List> getCurrentList() {\n return readOnlyList;\n }\n\n /**\n * Prevents any ongoing diff from dispatching results. Returns true if there was an ongoing\n * diff to cancel, false otherwise.\n */\n @SuppressWarnings(\"WeakerAccess\")\n @AnyThread\n public boolean cancelDiff() {\n return generationTracker.finishMaxGeneration();\n }\n\n /**\n * @return True if a diff operation is in progress.\n */\n @SuppressWarnings(\"WeakerAccess\")\n @AnyThread\n public boolean isDiffInProgress() {\n return generationTracker.hasUnfinishedGeneration();\n }\n\n /**\n * Set the current list without performing any diffing. Cancels any diff in progress.\n *
\n * This can be used if you notified a change to the adapter manually and need this list to be\n * synced.\n */\n @AnyThread\n public synchronized boolean forceListOverride(@Nullable List> newList) {\n // We need to make sure that generation changes and list updates are synchronized\n final boolean interruptedDiff = cancelDiff();\n int generation = generationTracker.incrementAndGetNextScheduled();\n tryLatchList(newList, generation);\n return interruptedDiff;\n }\n\n /**\n * Set a new List representing your latest data.\n *
\n * A diff will be computed between this list and the last list set. If this has not previously\n * been called then an empty list is used as the previous list.\n *
\n * The diff computation will be done on the thread given by the handler in the constructor.\n * When the diff is done it will be applied (dispatched to the result callback),\n * and the new List will be swapped in.\n */\n @AnyThread\n @SuppressWarnings(\"WeakerAccess\")\n public void submitList(@Nullable final List> newList) {\n final int runGeneration;\n @Nullable final List> previousList;\n\n synchronized (this) {\n // Incrementing generation means any currently-running diffs are discarded when they finish\n // We synchronize to guarantee list object and generation number are in sync\n runGeneration = generationTracker.incrementAndGetNextScheduled();\n previousList = list;\n }\n\n if (newList == previousList) {\n // nothing to do\n onRunCompleted(runGeneration, newList, DiffResult.noOp(previousList));\n return;\n }\n\n if (newList == null || newList.isEmpty()) {\n // fast simple clear all\n DiffResult result = null;\n if (previousList != null && !previousList.isEmpty()) {\n result = DiffResult.clear(previousList);\n }\n onRunCompleted(runGeneration, null, result);\n return;\n }\n\n if (previousList == null || previousList.isEmpty()) {\n // fast simple first insert\n onRunCompleted(runGeneration, newList, DiffResult.inserted(newList));\n return;\n }\n\n final DiffCallback wrappedCallback = new DiffCallback(previousList, newList, diffCallback);\n\n executor.execute(new Runnable() {\n @Override\n public void run() {\n DiffUtil.DiffResult result = DiffUtil.calculateDiff(wrappedCallback);\n onRunCompleted(runGeneration, newList, DiffResult.diff(previousList, newList, result));\n }\n });\n }\n\n private void onRunCompleted(\n final int runGeneration,\n @Nullable final List> newList,\n @Nullable final DiffResult result\n ) {\n\n // We use an asynchronous handler so that the Runnable can be posted directly back to the main\n // thread without waiting on view invalidation synchronization.\n MainThreadExecutor.ASYNC_INSTANCE.execute(new Runnable() {\n @Override\n public void run() {\n final boolean dispatchResult = tryLatchList(newList, runGeneration);\n if (result != null && dispatchResult) {\n resultCallback.onResult(result);\n }\n }\n });\n }\n\n /**\n * Marks the generation as done, and updates the list if the generation is the most recent.\n *\n * @return True if the given generation is the most recent, in which case the given list was\n * set. False if the generation is old and the list was ignored.\n */\n @AnyThread\n private synchronized boolean tryLatchList(@Nullable List> newList,\n int runGeneration) {\n if (generationTracker.finishGeneration(runGeneration)) {\n list = newList;\n\n if (newList == null) {\n readOnlyList = Collections.emptyList();\n } else {\n readOnlyList = Collections.unmodifiableList(newList);\n }\n\n return true;\n }\n\n return false;\n }\n\n /**\n * The concept of a \"generation\" is used to associate a diff result with a point in time when\n * it was created. This allows us to handle list updates concurrently, and ignore outdated diffs.\n *
\n * We track the highest start generation, and the highest finished generation, and these must\n * be kept in sync, so all access to this class is synchronized.\n *
\n * The general synchronization strategy for this class is that when a generation number\n * is queried that action must be synchronized with accessing the current list, so that the\n * generation number is synced with the list state at the time it was created.\n */\n private static class GenerationTracker {\n\n // Max generation of currently scheduled runnable\n private volatile int maxScheduledGeneration;\n private volatile int maxFinishedGeneration;\n\n synchronized int incrementAndGetNextScheduled() {\n return ++maxScheduledGeneration;\n }\n\n synchronized boolean finishMaxGeneration() {\n boolean isInterrupting = hasUnfinishedGeneration();\n maxFinishedGeneration = maxScheduledGeneration;\n return isInterrupting;\n }\n\n synchronized boolean hasUnfinishedGeneration() {\n return maxScheduledGeneration > maxFinishedGeneration;\n }\n\n synchronized boolean finishGeneration(int runGeneration) {\n boolean isLatestGeneration =\n maxScheduledGeneration == runGeneration && runGeneration > maxFinishedGeneration;\n\n if (isLatestGeneration) {\n maxFinishedGeneration = runGeneration;\n }\n\n return isLatestGeneration;\n }\n }\n\n private static class DiffCallback extends DiffUtil.Callback {\n\n final List> oldList;\n final List> newList;\n private final ItemCallback> diffCallback;\n\n DiffCallback(List> oldList, List> newList,\n ItemCallback> diffCallback) {\n this.oldList = oldList;\n this.newList = newList;\n this.diffCallback = diffCallback;\n }\n\n @Override\n public int getOldListSize() {\n return oldList.size();\n }\n\n @Override\n public int getNewListSize() {\n return newList.size();\n }\n\n @Override\n public boolean areItemsTheSame(int oldItemPosition, int newItemPosition) {\n return diffCallback.areItemsTheSame(\n oldList.get(oldItemPosition),\n newList.get(newItemPosition)\n );\n }\n\n @Override\n public boolean areContentsTheSame(int oldItemPosition, int newItemPosition) {\n return diffCallback.areContentsTheSame(\n oldList.get(oldItemPosition),\n newList.get(newItemPosition)\n );\n }\n\n @Nullable\n @Override\n public Object getChangePayload(int oldItemPosition, int newItemPosition) {\n return diffCallback.getChangePayload(\n oldList.get(oldItemPosition),\n newList.get(newItemPosition)\n );\n }\n }\n}\n"
},
{
"path": "epoxy-adapter/src/main/java/com/airbnb/epoxy/BaseEpoxyAdapter.java",
"content": "package com.airbnb.epoxy;\n\nimport android.os.Bundle;\nimport android.view.View;\nimport android.view.ViewGroup;\n\nimport com.airbnb.epoxy.stickyheader.StickyHeaderCallbacks;\n\nimport org.jetbrains.annotations.NotNull;\n\nimport java.util.Collections;\nimport java.util.List;\n\nimport androidx.annotation.CallSuper;\nimport androidx.annotation.NonNull;\nimport androidx.annotation.Nullable;\nimport androidx.recyclerview.widget.GridLayoutManager.SpanSizeLookup;\nimport androidx.recyclerview.widget.RecyclerView;\n\npublic abstract class BaseEpoxyAdapter\n extends RecyclerView.Adapter\n implements StickyHeaderCallbacks {\n\n private static final String SAVED_STATE_ARG_VIEW_HOLDERS = \"saved_state_view_holders\";\n\n private int spanCount = 1;\n\n private final ViewTypeManager viewTypeManager = new ViewTypeManager();\n /**\n * Keeps track of view holders that are currently bound so we can save their state in {@link\n * #onSaveInstanceState(Bundle)}.\n */\n private final BoundViewHolders boundViewHolders = new BoundViewHolders();\n private ViewHolderState viewHolderState = new ViewHolderState();\n\n private final SpanSizeLookup spanSizeLookup = new SpanSizeLookup() {\n\n @Override\n public int getSpanSize(int position) {\n try {\n return getModelForPosition(position)\n .spanSize(spanCount, position, getItemCount());\n } catch (IndexOutOfBoundsException e) {\n // There seems to be a GridLayoutManager bug where when the user is in accessibility mode\n // it incorrectly uses an outdated view position\n // when calling this method. This crashes when a view is animating out, when it is\n // removed from the adapter but technically still added\n // to the layout. We've posted a bug report and hopefully can update when the support\n // library fixes this\n // TODO: (eli_hart 8/23/16) Figure out if this has been fixed in new support library\n onExceptionSwallowed(e);\n return 1;\n }\n }\n };\n\n public BaseEpoxyAdapter() {\n // Defaults to stable ids since view models generate unique ids. Set this to false in the\n // subclass if you don't want to support it\n setHasStableIds(true);\n spanSizeLookup.setSpanIndexCacheEnabled(true);\n }\n\n /**\n * This is called when recoverable exceptions happen at runtime. They can be ignored and Epoxy\n * will recover, but you can override this to be aware of when they happen.\n */\n protected void onExceptionSwallowed(RuntimeException exception) {\n\n }\n\n @Override\n public int getItemCount() {\n return getCurrentModels().size();\n }\n\n /** Return the models currently being used by the adapter to populate the recyclerview. */\n abstract List> getCurrentModels();\n\n public boolean isEmpty() {\n return getCurrentModels().isEmpty();\n }\n\n @Override\n public long getItemId(int position) {\n // This does not call getModelForPosition so that we don't use the id of the empty model when\n // hidden,\n // so that the id stays constant when gone vs shown\n return getCurrentModels().get(position).id();\n }\n\n @Override\n public int getItemViewType(int position) {\n return viewTypeManager.getViewTypeAndRememberModel(getModelForPosition(position));\n }\n\n @Override\n public EpoxyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {\n EpoxyModel model = viewTypeManager.getModelForViewType(this, viewType);\n View view = model.buildView(parent);\n return new EpoxyViewHolder(parent, view, model.shouldSaveViewState());\n }\n\n @Override\n public void onBindViewHolder(EpoxyViewHolder holder, int position) {\n onBindViewHolder(holder, position, Collections.emptyList());\n }\n\n @Override\n public void onBindViewHolder(EpoxyViewHolder holder, int position, List