Skip to content

Latest commit

 

History

History
944 lines (620 loc) · 29.7 KB

CHANGELOG.md

File metadata and controls

944 lines (620 loc) · 29.7 KB

Change Log

Version 1.0.0-alpha.9

2021-01-04

  • Make runningSideEffect's function accept a CoroutineScope receiver. (#267)
  • Android wrappers for renderWorkflowIn deprecate setContentWorkflow. (#266)
  • Fixes error message when no view binding is found. (#264)
  • Upgrade kotlin to 1.4.21 bug fix. (#261)

Version 1.0.0-alpha.8

2020-12-04

  • Introduce AndroidViewRendering, de-emphasize ViewRegistry (#248)
  • Upgrade kotlin to 1.4.20. (#256)
  • Upgrade coroutines to 1.4.2. (#258)
  • Fix RenderTester kdoc references to deprecated renderTester() function. (#240)

Version 1.0.0-alpha.7

2020-11-16

  • A couple of Worker<Nothing> fixes. (#232)
  • Add IJ/AS file templates for creating new workflows. (#231)

Version 1.0.0-alpha.6

2020-10-27

  • Make snapshots lazy again. (#225)

Version 1.0.0-alpha.5

2020-10-20

  • Introduce RenderContext.eventHandler. (#212)
  • Introduce DecorativeViewFactory. (#183)
  • Introduce helpers for working with EditTexts from LayoutRunners. (#198, #201)
  • Enforce distinct id and inflatedId values. (#182)
  • Add guarded setOutput to enterState ReplaceWith expression. (#191)
  • Disable jetifier. (#193)
  • ViewRegistry, LayoutRunner tidying. (#200)
  • Make core RenderTester.expectWorkflow method internal. (#203)
  • Fix memory leak in ModalContainer. (#220)
  • Fix ungrammatical error message. (#181)
  • Improves exception message for conflicting ids in stubs. (#184)
  • Punch up docs on OverviewDetailScreen.selectDefault. (#185)

Version 1.0.0-alpha.4

2020-08-31

  • Fix expectWorker to match on concrete types of generic workers. (#154)
  • Fix RenderTester workflow class matching for mocked workflow instances. (#156)
  • Remove unused T param for testFromState. (#158)
  • Restore EmittedOutput as a deprecated typealias. (#160)
  • Fix workflow expectation crashing when a worker is ran first. (#164)
  • Disable build config generation. (#166)
  • Allow emitting multiple outputs from root workflow, and consuming multiple outputs from fragments. (#169 – thanks @bnvinay92!)
  • Let WorkflowFragment subclasses override root view's layoutParams. (#169 – thanks @bnvinay92!)
  • Introduce WorkflowViewStub.updatesVisibility. (#178)

Version 1.0.0-alpha.3

2020-07-28

  • Revert "Emit output before next render pass." (#151)
  • Make TreeSnapshot nullable throughout the runtime API and internally. (#148)
  • SimpleLoggingWorkflowInterceptor fixes. (#149)
  • Make workflow-testing coroutine test dependency implementation, not api. (#150)

Version 1.0.0-alpha.2

2020-07-14

General prep for 1.0 release

  • Remove unnecessary data classes from public, non-experimental APIs. (#69)
  • Delete legacy-* modules. (#76)
  • Rename package and Maven group to com.squareup.workflow1. (#113)

"Grand Unified Workflow Theory"

To make the behavior of Workers more consistent between Swift and Kotlin and simplify the core workflow APIs, both languages have eliminated "worker" as a primary concept in the runtime, and changed to implement workers in terms of workflows and the new, more fundamental concept of "side effects". A side effect is simply a coroutine that is always identified by a string key and runs in the context of the workflow that started it. For more information, see the issues workflow/#1021 and workflow/#961. The following changes are related:

  • Introduce RenderContext.runningSideEffect API as a lower-level primitive than workers for launching coroutines from a workflow. (#12)
  • Introduce WorkflowIdentifier and ImposterWorkflow to properly support operator workflows. (#29)
  • Introduce unsnapshottableIdentifier() to allow transient WorkflowIdentifiers for Workers. (#84)
  • Reimplement Workers using side effects. (#110)
  • Update RenderTester to support ImpostorWorkflow. (#89)

Core

  • New: Deprecate asWorker() extension on Deferred and Channel. (#19)
  • New: Remove non-null upper bound for OutputT. (#49)
  • New: Give WorkflowAction access to props. (#81)
  • New: Allow StatefulWorkflow.snapshotState to return null. (#67)
  • New: Rename EmittedOutput to WorkflowOutput, move to workflow-core. (#64, #78)
  • New: Deprecate WorkflowAction.nextState, replace with to state. (#77, #86)
  • New: Pull the deprecated Mutator and associated method into a sub-interface of WorkflowAction. (#128)
  • New: Use inner types for RenderContext to reduce type boilerplate. (#97)
  • New: Convert Updater to an inner class. (#129)
  • Fix: Rename @VeryExperimentalWorkflow opt-in annotation to @ExperimentalWorkflowApi. (#15, #30)
  • Fix: Fix RenderContext kdoc (it doesn't implement Sink). (#34)
  • Docs: Add warnings about some common smells and gotchas to kdoc. (#7)
  • Docs: Tweak kdoc on snapshotState. (#98)
  • Deprecation: Move implementation of deprecated RenderContext.onEvent into extension function. (#65, #127)
  • Deprecation: Extract public interface methods with default implementations into extension methods. (#127)
    • RenderContext.makeActionSink
    • RenderContext.onEvent
  • Deprecation: Deprecate Snapshot.EMPTY and eliminates its use. (#107)

Runtime

  • New: Introduce TreeSnapshot. (#32)
  • New: Introduce WorkflowInterceptor. (#42)
    • Re-implement TracingDiagnosticListener as a WorkflowInterceptor, TracingWorkflowInterceptor. (#45)
    • Remove WorkflowDiagnosticListener. (#48)
  • Fix: Make RealRenderContext internal. (#87)
  • Fix: Change output/rendering order: emit output before next render pass. (#68)
  • Remove launchWorkflowIn and related code. (#47)

Testing

  • Migrate WorkflowTester to renderWorkflowIn. (#46)
  • Improve the RenderTester API. (#95)
    • Cleans up the testing API exposed by WorkflowIdentifier and makes the type checking more precise.
    • Adds descriptions to expectations to allow for more readable error messages.
    • Adds RenderTester methods to match using arbitrary predicate functions.
    • Allows Workflow and side effect expectations to be non-exact – such expectations are optional, not required to be exclusive, and can match multiple times.
  • Extract public interface methods with default implementations into extension methods. (#127)
    • RenderTester.expectWorkflow(KClass)
    • RenderTester.expectWorkflow(WorkflowIdentifier)
  • Fix: Improve naming of testing entry methods and types. (#73)
  • Fix: Fix WorkerTester.assertNoOutput when worker finishes without emitting. (#66)
  • Fix: Make RenderTester throw a more realistic exception if the same workflow/side effect is ran twice. (#130)

UI

  • New: Introduce WorkflowUiExperimentalApi opt-in annotation and mark all UI integration with it. (#91)
  • New: Introduce Snapshot / Parcelable integration. (#93)
  • Docs: Update the BuilderBinding docs to match the constructor. (#101 – thanks @SalvatoreT!)
  • Fix: Revert "Extend ViewGroup in stock Kotlin Container classes". (#106)
  • WorkflowViewStub improvements and fixes:
    • New: Override setBackground() like we do setVisibility() in WorkflowViewStub. (#108 – thanks @afollestad!)
    • Fix: Give WorkflowViewStub parity with Android ViewStub and then some. (#28)
  • Fix: Fix WorkflowFragment under Jetpack navigation. (#39)

Version 1.0.0-alpha.1

2020-06-11

First release from new, Kotlin-only repository.

  • Change RenderTester functionality such that unexpected workers no-op rather than fail. Still fail when multiple workers match. (#1084)
  • Rename all occurences of Master/Detail to Overview/Detail. (#1196)
  • Simplify the entry point into the workflow runtime. (#1180)
  • Extend ViewGroup in stock Kotlin Container classes. (#1193)
  • Upgrade coroutines library to 1.3.7. (#1170)
  • Upgrade to Kotlin 1.3.72. (#1178)

Version 0.28.1

2020-05-20

Kotlin

  • Swift-only release; no changes.

Swift

  • Fix: Added missing libswiftos.dylib to the test target (#1175)

Version 0.28.0

2020-05-12

Kotlin

  • Breaking: Simplify ViewRegistry to act more like a simple map of rendering type to ViewFactory. (#1148)
  • Extracted Compose support into square/workflow-kotlin-compose. (#1147)
    • Artifacts for Compose support will be released separately from now on, which allows us to keep them updated more frequently as the Workflow library stabilizes.
  • Remove RxJava2 dependency from Workflow Android UI integration. (#1150)
  • Fix: Make workflow-ui-android-core declare workflow-runtime as api instead of implementation dependency. (#1144)
  • Fix: Move WorkflowFragment initialization to onViewStateRestored. (#1133 – thanks @ychescale9!)
  • Upgrade coroutines library to 1.3.6. (#1151)

Swift

  • Add os_signpost logs for render() and Workflow and Worker lifecycle. (#1134)

Version 0.27.1

2020-05-11

Kotlin

  • Add insecure checksums gradle flag to fix Nexus release. (#1156)

Swift

  • Kotlin-only release, no changes.

Version 0.27.0

2020-05-04

Kotlin

  • Update Compose to dev10. (#1118)

Swift

  • Remove context.subscribe (#1111)

Version 0.26.0

2020-04-17

Kotlin

  • Upgrade kotlinx.serialization now that KAML supports it. (#1018)
  • Makes BackStackContainer.update protected, required for customization. (#1088)

Swift

  • Vend preferredContentSize through the DescribedViewController (#1051)
  • Add ContainerViewController init with AnyWorkflowConvertable (#1092)
  • Provide empty makeInitialState and workflowDidChange when State is Void (#1094)

Version 0.25.0

2020-03-27

Kotlin

  • Swift-only release. No changes.

Swift

  • Introduce SignalWorker to wrap Signals (#1048)

Version 0.24.0

2020-03-10

Kotlin

  • Introduce a view binding function that works with AndroidX ViewBindings. (#985)
  • Rename ViewBinding to ViewFactory. (#1009)
  • Rename ContainerHints to ViewEnvironment to match Swift. (#1005)
  • Fix type parameter for expectWorker accepting Worker instance. (#969)

Swift

  • Removes ViewRegistry, Introduce ViewControllerDescription. (#974)
  • Introduce ViewEnvironment. (#999)

Version 0.23.3

Kotlin

  • Fix type parameter for expectWorker accepting Worker instance. (#969)

Swift

  • Kotlin-only release, no changes.

Version 0.23.2

Kotlin

  • Make the context used to start workers configurable for tests. (#940, #943, #950)

Swift

  • Kotlin-only release, no changes.

Version 0.23.1

Kotlin

  • Swift-only release, no changes.

Swift

  • Seperate SwiftUI support to a different module: WorkflowSwiftUI. (#929)

Version 0.23.0

2020-01-31

Kotlin

  • Make all workers run on the Unconfined dispatcher. (#851)
  • Paramaterize the return type of Worker.finished() to make it more convenient to use in tests. (#884)
  • Improved animation for BackStackContainer, PanelContainer. (#886)
  • Target JVM 1.8 bytecode for all modules. (#898)
  • Don't call onPropsChanged unless the old and new props are actually unequal. (#887)
  • Use KType instead of KClass in TypedWorker. (#908)
  • Make verifyAction and verifyActionResult support no processed action. (#909)
  • Drastically simplified ModalViewContainer. (#913)
  • Pass acceptOutput function to WorkflowNode constructor instead of every tick pass. (#916)
  • Break UI modules into: (#915)
    • workflow-ui
      • core-common
      • core-android
      • modal-common
      • modal-android
      • backstack-common
      • backstack-android

Swift

  • No changes.

Version 0.22.4

2020-01-15

Kotlin

  • Allow empty snapshots to be passed into launchWorkflowIn (#881)

Swift

  • Flag out WorkflowTesting APIs when in Release mode (#872)

Version 0.22.3

2020-01-10

Kotlin

  • Adds ContainerHints to ShowRenderingTag. (#868)
  • Add an empty ViewRegistry factory function. (#870)

Swift

  • Kotlin-only release, no changes.

Version 0.22.2

2020-01-07

Kotlin

  • Breaking: WorkflowAction.invoke is now action. (#862)
  • Fixes StatelessWorkflow.action. (#861)

Swift

  • Kotlin-only release, no changes.

Version 0.22.1

2019-12-20

Kotlin

  • Make WorkflowAction covariant on OutputT again. (#837)
  • Undo making RenderContext a sink, give it a sink property instead. (#839)

Swift

  • Kotlin-only release, no changes.

Version 0.22.0

2019-12-18

Kotlin

Breaking changes:

  • Safer BackStackScreen construction. (#809)
  • Pass ContainerHints via setContentWorkflow. (#808)
  • ViewRegistry is now a ContainerHint. (#770)
  • Remove deprecated testRender API. (#743)

Non-breaking API changes:

  • Make lifecyclOrNull public. (#747)
  • Give Worker.doesSameWorkAs a default implementation that just compares by concrete type. (#746)
  • Replace WorkflowAction.Mutator API with more ergonomic .Updater (#812, #813)
  • Give RenderTester.render function argument a default no-op value. (#828)
  • Add overload to RenderTester.expectWorker for simple worker comparisons. (#828)
  • Make RenderContext itself a Sink. (#835)
  • Convert ViewRegistry to an interface. (#832)

Other changes:

  • Add variance to StatelessWorkflow type parameters. (#790)
  • Make event sinks queued and reusable instead of throw after going stale. (#742)
  • Optimize re-rendering child workflows. (#800)

Swift

  • Add macOS support (#750)
  • Add ContainerView to enable SwiftUI integration. (#691)

Version 0.21.3

2019-11-18

Kotlin

  • Fix RenderTester not allowing output-less expectations to be specified after one with output. (#756)
  • Fix RenderTester not checking worker keys. (#755)

Swift

  • Kotlin-only release, no changes.

Version 0.21.2

2019-11-7

Kotlin

  • Restore testFromState. (#716)
  • New render testing API for kotlin. (#687)

Swift

  • Kotlin-only release, no changes.

Version 0.21.1

2019-10-30

Kotlin

  • Publish internal-testing-utils artifact that is required by two of the other modules. (#708)
  • Add missing kdoc for TraceLogger (#705)

Swift

  • Kotlin-only release, no changes.

Version 0.21.0

2019-10-29

Kotlin

Core API changes:

  • Add StatefulWorkflow.workflowAction. (#576)
  • Remove runningWorkerUntilFinished. (#589)
  • Remove key from TypedWorker and helpers that use it. (#606, #619)
  • Never pass an empty snapshot to initialState. (#556)
  • Change the return type of Worker.finished from T to Nothing. (#637)
  • Add an RxWorker class so Workers can be implemented without using experimental Flow APIs. (#650)
  • Make RxWorker and Flowable.asWorker use Publisher instead of Flowable. (#654)
  • Make it simpler to provide debugging names for workflow actions. (#696)

Runtime changes:

  • launchWorkflowIn block now takes a WorkflowSession instead of individual parameters. (#612)
  • Introduce WorkflowDiagnosticListener to support various debugging and logging tools. (#628, #634)
  • Implement chrome trace file generation. (#617)

Testing changes:

  • Introduce WorkerSink for writing integration tests that involve worker outputs. (#588)
  • Fix a race in WorkerTester. (#638)
  • Make testing infra run double render passes to suss out side effect code in render methods. (#678)
  • Make it possible to pass just the snapshot for the root workflow into the test methods. (#681)
  • Throw workflow exceptions from test/testFromStart instead of leaking to uncaught exception handler. (#686)

Android changes:

  • Eliminate HandlesBack, introduce View.backPressedHandler. (#614)
  • Introduce WorkflowViewStub. (#657)
  • Adds getRendering, getShowRendering View extensions. (#666)
  • Eliminate WorkflowRunner.onSaveInstanceState. (#679)
  • Compile time assurance that BackStackScreen is not empty. (#688)
  • Introduce ContainerHints for passing view-only hints around LayoutRunners. (#693)

Version changes:

  • Upgrade Kotlin to 1.3.50. (#560)
  • Upgrade coroutines to 1.3.1 stable. (#561, #590)
  • Upgrade a bunch of other dependencies, see the commit history for details.

Other changes:

  • Eliminate ExperimentalWorkflowUi. (#565)
  • Rename Worker<T> to Worker<OutputT>. (#570)
  • Fix "java" being printed instead of class name in Rx2 Reactors. (#607)
  • Fix a worker crash introduced by onReceiveOrClosed. (#630)
  • Make onEvent, makeActionSink, and makeEventSink include what action was lost to when they receive more than one event. (#673)

Swift

  • Update ReactiveSwift to 6.0.0. (#574 – thanks @lechristian!)
    • This also moves everything over to the standard library’s Result with Never (rather than NoError). As of this change, consumers must use Swift 5.
  • Apply child workflow output as an action in RenderTester. (#595)
  • Add WorkflowUI to Package.swift. (#690)

Version 0.20.0

2019-8-21

Kotlin

  • Rename onWorkerOutput to runningWorker (and friends). (#546)
  • Add Kotlin Sink, makeActionSink, makeEventSink. (#537)
  • Rename LifecycleWorker.onCancelled to onStopped. (#550)
  • Create a Worker.transform operator. (#533)
  • Remove all non-test dependencies on Kotlin Reflect. (#551)
  • Rename InputT -> PropsT (#549)
  • Update a bunch of dependency versions.

Swift

  • Plumb file and line to convenience render tester method (#516)

Version 0.19.0

2019-7-29

Swift

  • Update to build with Swift 5.
  • Allow sinks to be reused across render passes if a sink of the same action type is declared. (#443)
  • Support updating the root workflow input on a WorkflowHost. (#351)
  • Add support for RenderTester to expect child workflows and outputs. (#442)

Kotlin

  • WorkflowRunner now delivers single result instead of output stream (#468)
  • Use single object for noAction instead of creating it on every call (#473)
  • Upgrade AGP to 3.5.0-rc01. (#484)
  • Use Java 8 (#492)

Version 0.18.0

2019-7-16

Kotlin

Core API changes:

  • Added builder functions for creating stateful workflows. (#441)
  • Introduce Kotlin Flows:
    • Convert the Worker API to use Flow instead of using its own Emitter type. (#435)
    • Convert InputT streams from channels to Flows. (#433)
  • Add Completable.asWorker() operator. (#423)
  • Rename WorkflowAction.noop() to noAction(). (#420)
  • Change RenderContext.onEvent return type to be a raw function type. (#387)
  • Moves Named.key up to Compatible.compatibilityKey. (#429)

Runtime changes:

  • Replace WorkflowHost with the launchWorkflowIn function. (#447)
  • Delete flatMapWorkflow. (#377)
  • Allow specifying a different CoroutineDispatcher in the WorkflowRunner. (#379)

Version changes:

  • Bump Kotlin to latest version (1.3.41), along with Dokka and detekt. (#451)
  • Migrate to AndroidX. (#59, #469 - thanks @charbgr!)
  • Bump AGP to latest beta version (3.5.0-beta05). (#427)
  • Update coroutines dependency to 1.3.0-M2. (#409)

Other changes:

  • Don't throw from runningWorker when the worker finishes. (#456)
  • Less hacky lifecycle search in ModalContainer. (#448)
  • Fix Worker backpressure (too much buffering). (#446)
  • Set up a teardown hook for dialogs. (#432)
  • Artifact name changes (#419)
    • Add -jvm suffixes to all modules that could be MPP one day.
    • Add the -core suffix to the artifact for workflow-ui-core.
  • Remove (incorrect) manual implementation of ensureActive. (#378)
  • Fix WorkflowPool to work with ConflatedBroadcastChannel. (#475)

Swift

  • Rename AnyWorkflowAction.identity to noAction (#444)

Version 0.17.3

2019-6-12

Kotlin

  • Breaking change: BackStackScreen includes the entire backstack. (#403)
  • Fixes BackStackContainer config change. (#406)
  • Fix snapshots of a non-flat tree being taken too late. (#408)

Swift

  • Kotlin-only release, no changes.

Version 0.17.2

2019-6-6

Kotlin

  • Breaking change: LayoutRunner replaces Coordinator, no more Scene support in ViewBinding. (#383)
  • Allows WorkflowLayout to work from any stream of renderings. (#395)

Swift

  • Kotlin-only release, no changes.

Version 0.17.1

2019-5-30

Kotlin

  • Allow specifying a different CoroutineDispatcher in the WorkflowRunner. (#379)

Swift

  • Kotlin-only release, no changes.

Version 0.17.0

2019-5-29

Kotlin

  • Add a Worker.createSideEffect helper for Nothing-type workers. (#366)
  • Add a Worker.timer function to create simple delay workers. (#368)
  • testRender can now test arbitrary event handlers and automatically calculate initial state. (#372)
  • Allow specifying the CoroutineDispatcher used by WorkflowRunnerViewModel. (#375)

Swift

  • Actions update the Rendering synchronously. (#362, #348)

Version 0.16.1

2019-5-24

Kotlin

  • Make RenderTester not require specific Mock* workflows/workers. (#369)
  • Breaking change: Public WorkflowLayout, tidier WorkflowRunner, bye WorkflowActivityRunner. (#367)

Swift

  • Kotlin-only release, no changes.

Version 0.16.0

2019-5-22

Kotlin

  • Breaking change: remove the CoroutineScope parameter to initialState, remove onTeardown. (#289)
  • Breaking change: made LifecycleWorker methods non-suspending. (#328)
  • Removed must nullability restrictions from parameter types. (#334, #352)
  • Marked workflow-ui-core and workflow-ui-android APIs as experimental. (#345)
  • Breaking change: removed deprecated Screen classes. (#347)
  • Add experimental support for input from Flow streams. (#280)
  • Introduce alternative testing infrastructure to test single render passes. (#349)
  • Add Emitter.emitAll extension to consume RxJava streams from within custom workers. (#354)
  • Breaking change: simpler / richer WorkflowActivityRunner API. PickledWorkflow no longer public. (#355, #358)
  • Breaking change: make the RenderContext parameter to Workflow.stateless the receiver instead. (#357)
  • Introduces WorkflowFragment. (#344, #358)

Swift

  • Add Action and Render testing helpers. (#330)

Version 0.15.0

2019-4-26

Kotlin

  • Introduce Workers as the new and only way to subscribe to external stream and future types. (#289, #321, #322, #323, #324)
  • Rename WorkflowContext to RenderContext. (#309)
  • Fix for stale workflow output handlers being invoked in later render passes. (#314)
  • WorkflowTester improvements:
    • Give WorkflowTester a sendInput method to update the root workflow-under-test's input. (#315)
    • Remove WorkflowTester.with* methods. (#318)
    • Make WorkflowTester the receiver of the lambdas to Workflow.test* methods. (#318)

Swift

  • Rename compose to render and update docs. (#301)

Version 0.14.1

2019-4-18

Kotlin

  • Fix for WorkflowHost.Factory not using baseContext. (#306)

Swift

  • Kotlin-only release, no code changes.

Version 0.14.0

2019-4-16

Kotlin

  • Rename WorkflowContext.compose to composeChild. #274
  • Rename compose and composeChild to render and renderChild. #293
  • Throw if WorkflowContext is accessed after compose returns. #273
  • Pass the workflow's scope into initialState. #286
  • Add the ability to update the input for a WorkflowHost. #282

Swift

  • Kotlin-only release, no code changes.

Version 0.13.0

2019-4-12

Swift

  • Don't allow AnyScreen to wrap itself. (#264)

Kotlin

  • Upgrade Gradle to 5.x (#113)
  • Upgrade AGP to 3.3.0 (#115)

Version 0.12.0

2019-4-10

Swift

  • Improve type safety by removing AnyScreenViewController as a base type. (#200)
    • Replaces AnyScreenViewController with a type erased AnyScreen. This requires the compose method to output either a single typed screen, or explicitly AnyScreen if it may return multiple different screen types.

Kotlin

  • Use kotlinx-coroutines-android and Dispatchers.Main instead of Rx's Android scheduler. (#252)
  • Upgrade okio to 2.2.2.
  • Only allocate one StatefulWorkflow per StatelessWorkflow instance.

Version 0.11.0

2019-4-2

Kotlin

  • Update Kotlin and coroutines to latest versions. (#254)
  • Fixed some broken kdoc links and some warnings. (#232)
  • Add teardown hook on WorkflowContext. (#233)
  • Rename modules:
    • workflow-host -> workflow-runtime (#240)
    • viewregistry-android -> workflow-ui-android (#239)
    • viewregistry -> workflow-ui-core (#239)
  • Fix broken Parcellable implementation in ModalContainer. (#245)
  • Introduce WorkflowActivityRunner. (#248)

Swift

  • Kotlin-only release, no changes.

Version 0.10.0

2019-3-28

Kotlin

  • Factor out a common parent interface for StatelessWorkflow and Workflow (now StatefulWorkflow). (#213)
  • Replace restoreState with a Snapshot param to initialState. (#220)
  • Moves StatelessWorkflow, Workflows.kt methods to Workflow. (#226)

Swift

  • Kotlin-only release, no changes.

Version 0.9.1

2019-3-25

Kotlin

  • Workaround #211 by implementing KType ourselves.

Swift

  • Kotlin-only release, no changes.

Version 0.9.0

2019-3-22

Swift

  • Switch to using expectation from spinning the runloop.
  • Update ReactiveSwift to 5.0.0.
  • Added Xcode 10.2 support.
  • Add convenience extensions for makeSink and awaitResult.
  • Add xcode templates.

Kotlin

  • Reverts Kotlin back to v1.2.61.
  • Make a StatelessWorkflow typealias and a hideState() extension function.
  • Fix the exception thrown by WorkflowTester when an exception is thrown inside test block.
  • Use explicit KType + String parameters instead of Any for idempotence key for subscriptions.
  • Make a EventHandler type to return from makeSink, and rename makeSink to onEvent.

Version 0.8.1

2019-3-15

Kotlin

  • Bumps Kotlin to v1.2.71.

Swift

  • Kotlin-only release, no changes.

Version 0.8.0

2019-3-12

Kotlin

  • Breaking change, ViewBuilder is now ViewBinder. Adds buildScene() method. (#57)
  • BackStackEffect allows configuration of transition effects between BackStackScreens.
  • ModalContainer adds support for AlertDialog and custom views in Dialog windows.
  • Sample app consolidated to two modules, samples/tictactoe/android and samples/tictactoe/common. Various Shell* classes in sample renamed to Main*.
  • Breaking change, EventHandlingScreen interface eliminated. It wasn't useful.
  • Breaking change, workflow-core, workflow-rx2, and workflow-test modules moved to legacy folder, given legacy- prefix (module and maven artifact), and code moved to legacy package. None of these modules should be used in new code, they will be deleted soon.
  • Workflows have been completely rewritten and are now almost identical to Swift workflows.

Swift

  • Initial release.

Version 0.7.0

2019-1-4

Kotlin

  • Breaking change, further API refinement of WorkflowPool and friends. Extracts WorkflowUpdate and WorkflowPool.Handle from the defunct WorkflowHandle. (#114)

Version 0.6.0

2019-1-2

Kotlin

  • Breaking improvements to WorkflowPool API -- Delegating interface replaced by WorkflowHandle sealed class. (#98)
  • Deprecates EventSelectBuilder.onSuccess, replaced by onWorkflowUpdate and onWorkerResult. (#89)
  • Sample code includes unit test of a composite workflow, ShellReactorTest, demonstrating how to keep composites decoupled from their components. (#102)
  • Adds eventChannelOf helper for testing. (#85, #95)

Version 0.5.0

2018-12-11

Kotlin

  • Improvements to switchMapState:
    • Fix: switchMapState now is actually a switch map, was previously behaving like a concat map. (#69, #71)
    • Introduced variation that takes a lambda that returns an RxJava2 Observable, for workflow-rx2 consumers. (#53)
  • Factored the channel and coroutine management out of ReactorWorkflow into a more pure workflow builder function. (d0aef29)
  • Fix: Race condition in WorkflowPool. (#45)
  • makeId functions renamed to makeWorkflowId.
  • ViewStackScreen renamed to StackScreen.
  • Sample of using AlertDialog with ViewBuilder.
  • Improved kdoc and comments on use of Unconfined dispatcher. (#74, #81)
  • Workflow coroutines are now given names by default.
  • Remove some unused code. (#44, #77)

Version 0.4.0

2018-12-04

Kotlin

  • New: ViewBuilder – Android UI integration.
  • New: Worker – Helper to run async tasks via WorkflowPool.
  • Eliminated most of the boilerplate required by WorkflowPool.Type. It's now a concrete class.
  • Renamed ComposedReactor to Reactor, eliminating the old, deprecated Reactor interface.

Version 0.3.0

2018-11-28

Kotlin

  • ReactorWorkflow, WorkflowPool, and related types have been ported to coroutines and moved to the workflow-core module.

Version 0.2.0

2018-11-22

Kotlin

  • Organize everything into com.squareup.workflow* packages.