Refactoring, add Kotlin Notebook (#20)

This pull request includes several changes to improve code consistency,
add new features, and clean up the repository. The most important
changes include the renaming of modules, updates to documentation,
addition of linting tools, and removal of outdated test files.

### Module Renaming:
* Renamed `langchain4j-core-kotlin` module to `langchain4j-kotlin` and
updated references in `pom.xml` and source files accordingly.
[[1]](diffhunk://#diff-988dd67f6a0de416687ee39291f2713a8229de37918339f305c4ec8ae58e539bL2-R12)
[[2]](diffhunk://#diff-86cfcde484068926e474ebf795f51332ad7f830a07465ac97aea6f887d026b25L1-R1)
[[3]](diffhunk://#diff-a767044c70bcc37001555b8e9ad4479ead9a4e0b45fe1107fb666affe030c55dL1-R5)
[[4]](diffhunk://#diff-fb4b6067883a6e0b3179329be99cfe11aef1c673ab8fcdb4d96d1f28bb05ac48L1-R11)

### Documentation Updates:
* Updated `README.md` to reflect the new artifact ID for Maven and
Gradle dependencies. Also, added instructions for running linting before
submitting changes.
[[1]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L28-R28)
[[2]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L50-R50)
[[3]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L116-R124)

### Linting Tools:
* Added `.editorconfig` settings for XML files and Kotlin specific
settings.
* Introduced linting commands in `Makefile` and added external
dependencies for linting in `.idea/externalDependencies.xml`.
[[1]](diffhunk://#diff-76ed074a9305c04054cdebb9e9aad2d818052b07091de1f20cad0bbac34ffb52R3-R8)
[[2]](diffhunk://#diff-28f6bd7cae82cae961bd9e592c97303c3fcbee726488ffeb5353710114b94659R1-R10)

### Test Files Cleanup:
* Removed outdated integration test files and environment configuration
files.
[[1]](diffhunk://#diff-bf22a8e4a133639655c76accff8d4890f5b2039ff577f0e32cb85dc3aaee3b49L1-L96)
[[2]](diffhunk://#diff-b1bcb0799c4402f3288a7949cb2a16a9ef4593810b438586cb7ac0b15e426bdcL1-L80)
[[3]](diffhunk://#diff-caf79976057a1796247141661e8d2ecf64678198930c7d55e5ddb8790048df20L1-L18)

### New Features:
* Added a new Jupyter notebook for `langchain4j-kotlin` to demonstrate
usage examples.

---------

Co-authored-by: Konstantin Pavlov <{ID}+{username}@users.noreply.github.com>

Author: kpavlov

.editorconfig

@@ -19,11 +19,13 @@ insert_final_newline = true
 [*.md]
 trim_trailing_whitespace = false
 
-[pom.xml]
+[*.xml]
 indent_size = 4
 
 [*.kt]
 indent_size = 4
 max_line_length = 100
 ij_kotlin_name_count_to_use_star_import = 999
 ij_kotlin_name_count_to_use_star_import_for_members = 999
+# noinspection EditorConfigKeyCorrectness
+ktlint_function_naming_ignore_when_annotated_with = "Test"

.idea/externalDependencies.xml

@@ -1,2 +1,8 @@
 build:
 	mvn clean verify site
+
+lint:
+	# brew install ktlint
+	ktlint --format
+  # https://docs.openrewrite.org/recipes/maven/bestpractices
+  mvn rewrite:run -P lint

Makefile

@@ -25,7 +25,7 @@ Add the following dependencies to your `pom.xml`:
     <!-- LangChain4j Kotlin Extensions -->
     <dependency>
         <groupId>me.kpavlov.langchain4j.kotlin</groupId>
-        <artifactId>langchain4j-core-kotlin</artifactId>
+        <artifactId>langchain4j-kotlin</artifactId>
         <version>[LATEST_VERSION]</version>
     </dependency>
 
@@ -47,7 +47,7 @@ Add the following to your `build.gradle.kts`:
 
 ```kotlin
 dependencies {
-    implementation("me.kpavlov.langchain4j.kotlin:langchain4j-core-kotlin:$LATEST_VERSION")
+    implementation("me.kpavlov.langchain4j.kotlin:langchain4j-kotlin:$LATEST_VERSION")
     implementation("dev.langchain4j:langchain4j-core")
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core-jvm")
 }
@@ -113,11 +113,15 @@ Using Make:
 make build
 ```
 
-
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
+Run before submitting your changes
+```shell
+make lint
+```
+
 ## Acknowledgements
 
 - [LangChain4j](https://github.com/langchain4j/langchain4j) - The core library this project enhances

README.md

@@ -0,0 +1,94 @@
+{
+ "cells": [
+  {
+   "metadata": {},
+   "cell_type": "markdown",
+   "source": "# Welcome to LangChain4j-Kotlin Notebook!"
+  },
+  {
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2024-11-13T08:41:13.973072Z",
+     "start_time": "2024-11-13T08:41:11.937475Z"
+    }
+   },
+   "cell_type": "code",
+   "source": [
+    "import dev.langchain4j.model.chat.generateAsync\n",
+    "import dev.langchain4j.model.openai.OpenAiChatModel\n",
+    "import dev.langchain4j.data.message.SystemMessage\n",
+    "import dev.langchain4j.data.message.UserMessage\n",
+    "import kotlinx.coroutines.runBlocking\n",
+    "\n",
+    "val model = OpenAiChatModel\n",
+    "  .builder()\n",
+    "  .apiKey(\"demo\")\n",
+    "  .modelName(\"gpt-4o-mini\")\n",
+    "  .temperature(0.0)\n",
+    "  .maxTokens(1024)\n",
+    "  .build()\n",
+    "\n",
+    "runBlocking {\n",
+    "  val result = model.generateAsync(\n",
+    "    listOf(\n",
+    "      SystemMessage.from(\"You are helpful assistant\"),\n",
+    "      UserMessage.from(\"Make a joke about Kotlin, Langchani4j and LLM\"),\n",
+    "    )\n",
+    "  )\n",
+    "  \n",
+    "  println(result.content().text())\n",
+    "}\n",
+    "\n",
+    "    \n",
+    "   "
+   ],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Why did the Kotlin developer break up with Langchain4j?\n",
+      "\n",
+      "Because they found a new love in LLM that could handle their \"null\" feelings without throwing any exceptions!\n"
+     ]
+    }
+   ],
+   "execution_count": 36
+  },
+  {
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2024-11-13T08:39:55.837900Z",
+     "start_time": "2024-11-13T08:39:55.836524Z"
+    }
+   },
+   "cell_type": "code",
+   "source": "",
+   "outputs": [],
+   "execution_count": null
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Kotlin",
+   "language": "kotlin",
+   "name": "kotlin"
+  },
+  "language_info": {
+   "name": "kotlin",
+   "version": "1.9.23",
+   "mimetype": "text/x-kotlin",
+   "file_extension": ".kt",
+   "pygments_lexer": "kotlin",
+   "codemirror_mode": "text/x-kotlin",
+   "nbconvert_exporter": ""
+  },
+  "ktnbPluginMetadata": {
+   "projectDependencies": [
+    "langchain4j-kotlin"
+   ]
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 0
+}