feat: initial api & client implementation

.github/workflows/build.yml

@@ -28,10 +28,10 @@ jobs:
           - 21
           - 25
         module:
-          - api
-          - client
-          - testing
-          - testcontainers
+          - docling-serve-api
+          - docling-serve-client
+          - docling-testing
+          - docling-testcontainers
     name: jvm-build-test-${{ matrix.module }}-java${{ matrix.java }}
     steps:
       - uses: actions/checkout@v5
@@ -46,7 +46,7 @@ jobs:
       - name: build-test-${{ matrix.module }}-java${{ matrix.java }}
         run: |
           ./gradlew --no-daemon -Pjava.version=${{ matrix.java }} \
-            :docling-${{ matrix.module }}:clean :docling-${{ matrix.module }}:build
+            :${{ matrix.module }}:clean :${{ matrix.module }}:build
 
   docs:
     runs-on: ubuntu-latest
@@ -68,4 +68,4 @@ jobs:
           cache: gradle
 
       - name: Generate documentation
-        run: ./gradlew --console=plain clean :docling-docs:mkdocsBuild
+        run: ./gradlew --console=plain clean :docs:mkdocsBuild

.github/workflows/docs.yml

@@ -45,7 +45,7 @@ jobs:
           cache: gradle
 
       - name: Generate documentation
-        run: ./gradlew --console=plain clean :docling-docs:mkdocsBuild
+        run: ./gradlew --console=plain clean :docs:mkdocsBuild
 
       - name: Setup pages
         uses: actions/configure-pages@v5

README.md

@@ -26,31 +26,32 @@ This is repository for Docling Java, a Java API for using [Docling](https://gith
 
 This project aims to provide the following artifacts:
 
-* [`docling-api`](api): The core API for interacting with Docling. Should be framework-agnostic.
-* [`docling-client`](client): A reference implementation of the [`docling-api`](api) using Java's [`HttpClient`](https://openjdk.org/groups/net/httpclient/intro.html) and [Jackson](https://github.com/FasterXML/jackson).
-* [`docling-testing`](testing): Utilities for testing Docling
-* [`docling-testcontainers`](testcontainers): A [Testcontainers module](https://testcontainers.com/) for running Docling in a Docker container.
+* [`docling-serve-api`](docling-serve/docling-serve-api): The core API for interacting with Docling. Should be framework-agnostic.
+* [`docling-serve-client`](docling-serve/docling-serve-client): A reference implementation of the [`docling-serve-api`](docling-serve/docling-serve-api) using Java's [`HttpClient`](https://openjdk.org/groups/net/httpclient/intro.html) and [Jackson](https://github.com/FasterXML/jackson) to connect to a [Docling Serve](https://github.com/docling-project/docling-serve) endpoint.
+* [`docling-testing`](docling-testing): Utilities for testing Docling integration.
+* [`docling-testcontainers`](docling-testcontainers): A [Testcontainers module](https://testcontainers.com/) for running Docling in a Docker container.
 
 ## Getting started
 
 Use `DoclingApi.convertSource()` to convert individual documents. For example:
 
 ```java
-import ai.docling.api.DoclingApi;
-import ai.docling.api.convert.request.ConvertDocumentRequest;
-import ai.docling.api.convert.response.ConvertDocumentResponse;
-import ai.docling.client.DoclingClient;
-
-DoclingApi doclingApi = DoclingClient.builder()
-    .baseUrl("<location of docling server>")
+import ai.docling.api.serve.DoclingServeApi;
+import ai.docling.api.serve.convert.request.ConvertDocumentRequest;
+import ai.docling.api.serve.convert.request.source.HttpSource;
+import ai.docling.api.serve.convert.response.ConvertDocumentResponse;
+import ai.docling.client.serve.DoclingServeClientBuilderFactory;
+
+DoclingServeApi doclingServeApi = DoclingServeClientBuilderFactory.newBuilder()
+    .baseUrl("<location of docling serve instance>")
     .build();
 
-ConvertDocumentRequest request = ConvertDocumentRequest.builder()
-    .addHttpSources(URI.create("https://arxiv.org/pdf/2408.09869"))
+ConvertDocumentRequest request = new ConvertDocumentRequest()
+    .withSources(List.of(new HttpSource().withUrl(URI.create("https://arxiv.org/pdf/2408.09869"))))
     .build();
 
 ConvertDocumentResponse response = doclingApi.convertSource(request);
-System.out.println(response.document().markdownContent());
+System.out.println(response.getDocument().getMarkdownContent());
 ```
 
 More [usage information](https://docling-project.github.io/docling-java) are available in the docs.
@@ -59,7 +60,6 @@ More [usage information](https://docling-project.github.io/docling-java) are ava
 
 Please feel free to connect with us using the [discussion section](https://github.com/docling-project/docling-java/discussions).
 
-
 ## Contributing
 
 Please read [Contributing to Docling Java](CONTRIBUTING.md) for details.