Merge pull request #259 from theapache64/master

Added library version

Author: wuseal

.gitignore

@@ -1,4 +1,9 @@
 language: java
+before_install:
+  - chmod +x library/gradlew
+  - chmod +x library/gradle/wrapper/gradle-wrapper.jar
+script:
+  - cd library && ./gradlew build test
 deploy:
 - provider: releases
   api_key:

.travis.yml

@@ -0,0 +1,110 @@
+# JsonToKoltinBuilder - Java/Kotlin Library
+
+We also have a `Java/Kotlin` library. With this you can convert `JSON` to `Kotlin` code programmatically.
+
+## Installation
+
+Download `jar` file from [here](library/output/JsonToKotlinClassLibrary-v3.5.1.jar) and add it to your project
+
+## Usage
+
+```kotlin
+val actualOutput = JsonToKotlinBuilder()
+    .setPackageName("com.my.package.name")
+    .enableVarProperties(false) // optional, default : false
+    .setPropertyTypeStrategy(PropertyTypeStrategy.AutoDeterMineNullableOrNot) // optional, default :  PropertyTypeStrategy.NotNullable
+    .setDefaultValueStrategy(DefaultValueStrategy.AvoidNull) // optional, default : DefaultValueStrategy.AvoidNull
+    .setAnnotationLib(TargetJsonConverter.MoshiCodeGen) // optional, default: TargetJsonConverter.None
+    .enableComments(true) // optional, default : false
+    .enableOrderByAlphabetic(true) // optional : default : false
+    .enableInnerClassModel(true) // optional, default : false
+    .enabelMapType(true)// optional, default : false
+    .enableCreateAnnotationOnlyWhenNeeded(true) // optional, default : false
+    .setIndent(4)// optional, default : 4
+    .setParentClassTemplate("android.os.Parcelable") // optional, default : ""
+    .enableKeepAnnotationOnClass(true) // optional, default : false
+    .enableKeepAnnotationOnClassAndroidX(true) // optional, default : false
+    .enableAnnotationAndPropertyInSameLine(true) // optional, default : false
+    .enableParcelableSupport(true) // optional, default : false
+    .setPropertyPrefix("MyPrefix") // optional, default : ""
+    .setPropertySuffix("MySuffix") // optional, default : ""
+    .setClassSuffix("MyClassSuffix")// optional, default : ""
+    .enableForceInitDefaultValueWithOriginJsonValue(true) // optional, default : false
+    .enableForcePrimitiveTypeNonNullable(true) // optional, default : false
+    .build(json1, "GlossResponse") // finally, get KotlinClassCode string
+```
+
+## Demo
+
+**Code**
+
+```kotlin
+
+fun main() {
+
+
+    val json1 = """{ "programmers": [
+                { "isFirstName": "Brett", "lastName":"McLaughlin", "email": "aaaa" },
+                { "firstName": "Jason", "lastName":"Hunter", "email": "bbbb" },
+                { "firstName": "Elliotte", "lastName":"Harold", "email": "cccc" }
+                ],
+                "authors": [
+                { "firstName": null, "lastName": "Asimov", "genre": "science fiction" },
+                { "firstName": "Tad", "lastName": "Williams", "genre": "fantasy" },
+                { "firstName": "Frank", "lastName": "Peretti", "genre": "christian fiction" }
+                ],
+                "musicians": [
+                { "firstName": "Eric", "lastName": "Clapton", "instrument": "guitar" },
+                { "firstName": "Sergei", "lastName": "Rachmaninoff", "instrument": "piano" }
+                ] } """
+
+    val output = JsonToKotlinBuilder()
+            .build(json1, "GlossResponse") 
+
+    println(output)
+}
+```
+
+**Output**
+
+```kotlin
+data class GlossResponse(
+    val programmers: List<Programmer>,
+    val authors: List<Author>,
+    val musicians: List<Musician>
+)
+
+data class Programmer(
+    val isFirstName: String,
+    val lastName: String,
+    val email: String,
+    val firstName: String
+)
+
+data class Author(
+    val lastName: String,
+    val genre: String,
+    val firstName: String?
+)
+
+data class Musician(
+    val firstName: String,
+    val lastName: String,
+    val instrument: String
+)
+```
+
+## Custom Annotation
+
+To set custom annotation, you can call the `JsonToKotlinBuilder#setCustomAnnotation` method.
+
+```kotlin
+val output = JsonToKotlinBuilder()
+    .setCustomAnnotation(
+        "import kotlinx.serialization.SerialName\n" +
+                "import kotlinx.serialization.Serializable" + "\n" + "import kotlinx.serialization.Optional",
+        "@Serializable",
+        "@Optional\n@SerialName(\"%s\")"
+    )
+    .build(input, "MyResponse")
+```

ChangeLog.md

@@ -671,4 +671,4 @@ into proprietary programs.  If your program is a subroutine library, you
 may consider it more useful to permit linking proprietary applications with
 the library.  If this is what you want to do, use the GNU Lesser General
 Public License instead of this License.  But first, please read
-<http://www.gnu.org/philosophy/why-not-lgpl.html>.
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

LIBRARY.md

@@ -13,7 +13,9 @@
 
 # JsonToKotlinClass
 
-Hi, Welcome! This is a plugin to generate Kotlin `data class` from JSON string, in another word, a plugin that converts JSON string to Kotlin `data class` (Json to Kotlin)
+Hi, Welcome! This is a plugin to generate Kotlin `data class` from JSON string, in another word, a plugin that converts JSON string to Kotlin `data class` (Json to Kotlin).
+We also have a `Java/Kotlin` [library](LIBRARY.md). With this you can generate Kotlin `data class` from JSON string **programmatically**. 
+
 
 ### Overview