Merge pull request #164 from modelix/feature/document-local-testing-with-model-api

docs(model-api): explain local testing

Author: languitar

docs/global/modules/core/pages/howto/testing-against-model-api.adoc

@@ -0,0 +1,19 @@
+= How-To test `model-api` client code without a model-server
+:navtitle: Test `model-api` client code without a model-server
+
+If you want to test code that processes `model-api` instances, you can do this in-process without a running (light-) model-server.
+Use the following pattern to set up your test fixture containing `model-api` instances:
+
+[source,kotlin]
+--
+val branch = ModelFacade.toLocalBranch(ModelFacade.newLocalTree())
+branch.runWrite {
+    val root = branch.getRootNode()
+    val someRootNode = root.addNewChild(null, C_SomeConcept.untyped()).typed<N_SomeConcept>()
+    someRootNode.member.addNew(-1, C_OtherConcept).apply {
+        name = "some test property value"
+    }
+}
+--
+
+All classes of the pattern `C_*` and `N_*` are generated using the `model-api-gen`.

docs/global/modules/core/partials/nav-howto.adoc

@@ -1,4 +1,5 @@
 * xref:core:howto/usage-model-server.adoc[]
 * xref:core:howto/usage-model-api-gen-gradle.adoc[]
 * xref:core:howto/usage-light-model-client.adoc[]
+* xref:core:howto/testing-against-model-api.adoc[]