मैंने glaforge/gemini-interactions-api-sdk रिपॉज़िटरी को सैंडबॉक्स एनवायरमेंट में क्लोन कर लिया है. साथ ही, इसके कोडबेस, प्रोजेक्ट लेआउट, और कॉन्फ़िगरेशन फ़ाइलों की जांच कर ली है.
यहां आर्किटेक्ट के विश्लेषण के आधार पर, pom.xml फ़ाइल स्ट्रक्चर के बारे में जानकारी दी गई है. इसमें यह भी बताया गया है कि यह प्रोजेक्ट के बिल्ड, टेस्टिंग, पैकेजिंग, और सीआई/सीडी रिलीज़ के लाइफ़साइकल में कैसे मदद करता है.
यह प्रोजेक्ट, आधुनिक Java लाइब्रेरी के तौर पर बनाया गया है. इसे Google Gemini Interactions API के साथ इंटरफ़ेस करने के लिए डिज़ाइन किया गया है. यह Java 21 (एलटीएस) को टारगेट करता है. इसमें प्रोफ़ाइल-ड्रिवन Maven कॉन्फ़िगरेशन दिखाया गया है. यह कॉन्फ़िगरेशन, कोर कंपाइलेशन से लेकर साइनिंग, Maven Central पर अपने-आप पब्लिश होने, और Google Cloud Run पर सर्वरलेस डिप्लॉयमेंट के लिए एक्सपेरिमेंटल फ़्रंटएंड को पैकेज करने तक के सभी काम करता है.
1. प्रोजेक्ट के कोऑर्डिनेट और मेटाडेटा
फ़ाइल में सबसे ऊपर, Maven प्रोजेक्ट के बुनियादी मेटाडेटा और कोऑर्डिनेट तय किए जाते हैं:
<groupId>io.github.glaforge</groupId>
<artifactId>gemini-interactions-api-sdk</artifactId>
<version>0.10.2-SNAPSHOT</version>
<name>Gemini Interactions API SDK</name>
<description>Google Gemini Interactions API SDK</description>
- टारगेट JDK: प्रॉपर्टी, Java 21 के लिए सोर्स और टारगेट कंपैटिबिलिटी के बारे में बताती हैं. इससे Java की आधुनिक सुविधाओं (रिकॉर्ड, पैटर्न मैचिंग, वर्चुअल थ्रेड वगैरह) को चालू किया जा सकता है:
xml <properties> <maven.compiler.source>21</maven.compiler.source> <maven.compiler.target>21</maven.compiler.target> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> - एट्रिब्यूशन: इसमें Apache License 2.0 के बारे में बताया गया है. साथ ही, इस प्रोजेक्ट का एट्रिब्यूशन डेवलपर Guillaume Laforge (
glaforge) को दिया गया है.
2. डिपेंडेंसी और डिपेंडेंसी मैनेजमेंट
डिपेंडेंसी के विकल्पों में, आने वाले समय में इस्तेमाल होने वाली टेक्नोलॉजी को ध्यान में रखा गया है. इसमें लोकप्रिय लाइब्रेरी के अगली जनरेशन वाले वर्शन को चुना गया है:
A. कोर डिपेंडेंसी और Jackson 3.x माइग्रेशन
एसडीके, JSON प्रोसेसिंग के लिए Jackson 3.0.0 का इस्तेमाल करता है.
```xml
* **Architectural Note:** Jackson is undergoing a major package rename for version 3.x, changing its Maven group ID fromcom.fasterxml.jacksontotools.jackson. This POM imports thejackson-bom(Bill of Materials) version3.0.0and utilizes the newtools.jackson.core:jackson-databind` कोऑर्डिनेट का इस्तेमाल करता है. इससे एसडीके बहुत हल्का रहता है और यह अन्य एसडीके से बेहतर काम करता है.
B. टेस्टिंग और यूटिलिटी डिपेंडेंसी
<scope>test</scope> में, प्रोजेक्ट पुष्टि करने और मॉक सर्वर के लिए टूल पुल करता है:
1. JUnit 6:
xml
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>6.0.2</version>
<scope>test</scope>
</dependency>
यह यूनिट और इंटिग्रेशन टेस्टिंग के लिए, JUnit 6.0.2 का इस्तेमाल करता है.
2. MockWebServer:
xml
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>mockwebserver</artifactId>
<version>4.12.0</version>
<scope>test</scope>
</dependency>
इसका इस्तेमाल, स्थानीय इंटिग्रेशन टेस्टिंग के दौरान Gemini API से मिलने वाले एचटीटीपी रिस्पॉन्स को मॉक करने के लिए किया जाता है.
3. Javelit:
xml
<dependency>
<groupId>io.javelit</groupId>
<artifactId>javelit</artifactId>
<version>0.86.0</version>
<scope>test</scope>
</dependency>
यह एक बेहतरीन और हल्का-फुल्का फ़्रेमवर्क है. इसका इस्तेमाल खास तौर पर टेस्ट फ़ोल्डर में किया जाता है. इससे एसडीके के साथ इंटरैक्ट करने के लिए, वेब पर आधारित यूज़र इंटरफ़ेस ("Research Frontend") बनाया जाता है.
3. प्रोफ़ाइलें: प्रोफ़ाइल के हिसाब से लाइफ़साइकल आर्किटेक्चर
इस pom.xml की मुख्य ताकत, इसकी चार Maven प्रोफ़ाइलों में है. हर प्रोफ़ाइल, आर्किटेक्चर के किसी खास चरण के लिए होती है:
प्रोफ़ाइल 1: deployment
इसे स्टैंडर्ड एसडीके रिलीज़ को पैकेज करने के लिए डिज़ाइन किया गया है. इसमें एपीआई के पूरे दस्तावेज़ और सोर्स शामिल होते हैं.
* स्टेजिंग एरिया: यह <altDeploymentRepository> का इस्तेमाल करके, target/staging-deploy पर लोकल स्टेजिंग डायरेक्ट्री को कॉन्फ़िगर करता है.
* प्लगिन:
* maven-javadoc-plugin (v3.5.0): Javadocs को पैकेज करता है.
* maven-source-plugin (v3.3.0): इसमें Java की सोर्स फ़ाइलें शामिल होती हैं.
प्रोफ़ाइल 2: publication
यह प्रोफ़ाइल, लाइब्रेरी को सार्वजनिक रजिस्ट्री में रिलीज़ करने के लिए बनाई गई है. साथ ही, यह मेवन की रिलीज़ करने की पारंपरिक प्रोसेस के बजाय, JReleaser (v1.22.0) का इस्तेमाल करती है.
* GitHub रिलीज़: यह टूल, कन्वेंशनल कमिट के आधार पर सुंदर और अपने-आप अपडेट होने वाले बदलावों के लॉग जनरेट करता है. अगर ज़रूरी हो, तो यह मौजूदा रिलीज़ को बदल देता है.
* PGP Signing: PGP (<armored>true</armored>) के ज़रिए सभी रिलीज़ आर्टफ़ैक्ट पर अपने-आप हस्ताक्षर करने के लिए कॉन्फ़िगर किया गया है.
* Maven Central Deployment: हस्ताक्षर किए गए आर्टफ़ैक्ट को सीधे target/staging-deploy डायरेक्ट्री से Sonatype Central (https://central.sonatype.com/api/v1/publisher) पर डिप्लॉय करता है.
प्रोफ़ाइल 3: release
यह रिलीज़ फ़्लो के ऑर्केस्ट्रेटर के तौर पर काम करता है. साथ ही, Git टास्क को अपने-आप पूरा करने के लिए maven-release-plugin (v3.3.1) को कॉन्फ़िगर करता है:
* ऑटोमेशन के चरण:
* clean verify की पुष्टि करता है.
* कमिट मैसेज के फ़ॉर्मैट chore: Releasing version... का इस्तेमाल करके, वर्शन बढ़ाता है, बदलावों को कमिट करता है, और रिपॉज़िटरी (v@{project.version}) को टैग करता है.
* -DskipTests के साथ deploy jreleaser:full-release को चलाकर, रिलीज़ को ट्रिगर करता है. इससे deployment और publication, दोनों प्रोफ़ाइलें चालू हो जाती हैं.
प्रोफ़ाइल 4: deploy-frontend
यह एक बेहतरीन प्रोफ़ाइल है, जो एक खास चुनौती को हल करती है: वेब पर आधारित, एक्सपेरिमेंटल टेस्ट क्लास (ResearchFrontend.java में मौजूद src/test/java) को पैकेज करना और उसे सर्वरलेस कंटेनर के तौर पर प्रोडक्शन में डिप्लॉय करना.
* असेंबली प्लगिन: यह कस्टम डिस्क्रिप्टर src/assembly/frontend-deployment.xml के साथ maven-assembly-plugin (v3.6.0) का इस्तेमाल करता है. इससे मुख्य क्लास, टेस्ट क्लास, और टेस्ट के दायरे में आने वाली सभी डिपेंडेंसी (Javelit और OkHttp भी शामिल हैं) को एक ही रन करने लायक Uber-JAR में मर्ज किया जा सकता है.
* टारगेट क्लास: यह Main-Class मेनिफ़ेस्ट एंट्री को io.github.glaforge.gemini.interactions.ResearchFrontend पर पॉइंट करने के लिए कॉन्फ़िगर करता है.
* डिप्लॉयमेंट कॉन्टेक्स्ट: जनरेट किए गए इस JAR को सीधे Google Cloud Run पर कॉपी और डिप्लॉय किया जाता है. इसके लिए, Java 25 की बेस इमेज (us-central1-docker.pkg.dev/serverless-runtimes/google-24/runtimes/java25) का इस्तेमाल किया जाता है. इसके लिए, Dockerfile की ज़रूरत नहीं होती. इसके बारे में researcher-deployment.md में बताया गया है.
4. GitHub Actions (CI/CD) के साथ इंटिग्रेशन
प्रोफ़ाइल का स्ट्रक्चर, .github/workflows/ में मौजूद GitHub वर्कफ़्लो जैसा होता है:
build.yml(CI): यहmainब्रांच में पुल के अनुरोधों या कमिट पर./mvnw verifyको लागू करता है, ताकि यह पक्का किया जा सके कि कंपाइलेशन, टेस्ट, और डिपेंडेंसी साफ़ तौर पर हल हो गई हैं.release.yml(सीडी): इसे मैन्युअल तरीके से ट्रिगर किया जाता है (workflow_dispatch). यह वर्कफ़्लो इन कामों को करता है:bash ./mvnw -ntp -B -Prelease release:prepare release:performयह कमांड,releaseप्रोफ़ाइल पर निर्भर करती है. यह प्रोफ़ाइल, वर्शन को व्यवस्थित तरीके से अपडेट करती है, Git टैग पुश करती है, javadocs और सोर्स बनाती है, आर्टफ़ैक्ट पर हस्ताक्षर करती है, प्रोजेक्ट को कंपाइल करती है, Sonatype पर रिलीज़ पुश करती है, और GitHub रिलीज़ नोट का ड्राफ़्ट बनाती है.
खास जानकारी
gemini-interactions-api-sdk में मौजूद pom.xml, डिक्लेरेटिव DevOps का बेहतरीन उदाहरण है. यह कोर लाइब्रेरी को बहुत छोटा रखता है (सिर्फ़ Jackson 3.x पर निर्भर रहता है). हालांकि, यह जटिल पैकेजिंग, हस्ताक्षर करने, दस्तावेज़ जनरेट करने, और क्लाउड-नेटिव फ़्रंटएंड डिप्लॉयमेंट की क्षमताओं को साफ़ तौर पर फिर से इस्तेमाल की जा सकने वाली प्रोफ़ाइलों में शामिल करता है.