mirror of
https://github.com/aljazceru/turso.git
synced 2025-12-17 08:34:19 +01:00
## Purpose - Deploy `tech.turso:turso:<version>` to maven central so that users can easily use java bindings - For example : https://repo1.maven.org/maven2/io/github/seonwkim/turso/0.0.1/ ## Requirements - [x] Add the following github secrets. - [x] MAVEN_CENTRAL_USERNAME - [x] MAVEN_CENTRAL_PASSWORD - [x] GPG_PRIVATE_KEY - [x] GPG_PASSPHRASE - [ ] Namespace `tech.turso` must be registered at maven central - [ ] GPG key registration to key servers - Notes - Retrieve MAVEN_CENTRAL_USERNAME and MAVEN_CENTRAL_PASSWORD from [maven central](https://central.sonatype.com/usertoken) - GPG keys should be registered. You should distribute your keys to designated(maven central supported) servers - Refer to [GPG key related docs](https://central.sonatype.org/publ ish/requirements/gpg/#distributing-your-public-key) - Btw, I used `keyserver.ubuntu.com` key server while testing ### [Maven Central Username & Password](https://central.sonatype.com/usertoken) <img width="2878" height="1338" alt="image" src="https://github.com/user- attachments/assets/03e6f967-a7f6-46b8-aef5-d15772bd9eea" /> ### [Maven Central Namespace](https://central.sonatype.com/publishing/namespaces) <img width="1424" height="456" alt="image" src="https://github.com/user- attachments/assets/8c0f4f17-bf5a-4c6a-bc47-748d86cd1f1a" /> ## Future Works - Currently, we depend on gradle.properties to determine the version of our dependency and it's cumbersome to always change the version manually. Let's find a better solution. Closes #3624
Turso JDBC Driver
The Turso JDBC driver is a library for accessing and creating Turso database files using Java.
Project Status
The project is actively developed. Feel free to open issues and contribute.
To view related works, visit this issue.
How to use
Currently, we have not published to the maven central. Instead, you can locally build the jar and deploy it to maven local to use it.
Build jar and publish to maven local
$ cd bindings/java
# Please select the appropriate target platform, currently supports `macos_x86`, `macos_arm64`, `windows` and `linux_x86`
$ make macos_x86
# deploy to maven local
$ make publish_local
Now you can use the dependency as follows:
dependencies {
implementation("tech.turso:turso:0.0.1-SNAPSHOT")
}
Code style
- Favor composition over inheritance. For example,
JDBC4Connectiondoesn't implementTursoConnection. Instead, it includesTursoConnectionas a field. This approach allows us to preserve the characteristics of Turso usingTursoConnectioneasily while maintaining interoperability with the Java world usingJDBC4Connection.