-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
b364bb8
commit f8bbf49
Showing
10 changed files
with
27 additions
and
85 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,71 +1,18 @@ | ||
Librarian is a library to help building Kotlin libraries. | ||
[![Slack](https://img.shields.io/static/v1?label=gradle-community&message=gradleup&color=A97BFF&logo=slack&style=flat-square)](https://gradle-community.slack.com/archives/C07GJEMUZDH) | ||
|
||
Features: | ||
[![Maven Central](https://img.shields.io/maven-central/v/com.gradleup.librarian/librarian-gradle-plugin?style=flat-square)](https://central.sonatype.com/namespace/com.gradleup.librarian) | ||
[![OSS Snapshots](https://img.shields.io/nexus/s/com.gradleup.librarian/librarian-gradle-plugin?server=https%3A%2F%2Foss.sonatype.org&label=oss-snapshots&style=flat-square)](https://oss.sonatype.org/content/repositories/snapshots/com/gradleup/librarian/) | ||
|
||
- Java/Kotlin compatibility flags | ||
- [Maven Central](https://central.sonatype.com/) publishing | ||
- [Dokkatoo](https://github.com/adamko-dev/dokkatoo) configuration | ||
- [BCV](https://github.com/Kotlin/binary-compatibility-validator) configuration | ||
- Maven pom compatibility for KMP projects | ||
- [Maven sympathy for transitive dependencies](https://jakewharton.com/nonsensical-maven-is-still-a-gradle-problem/) | ||
- Autogenerated lib version constant | ||
</div> | ||
|
||
## Quickstart | ||
## 🚀 Librarian | ||
|
||
Work in progress... | ||
An opiniated toolkit to help you build libraries. | ||
|
||
Add `librarian` to your Gradle buildscript classpath: | ||
## 📚 Documentation | ||
|
||
```kotlin | ||
plugins { | ||
id("com.gradleup.librarian").version("0.0.6") | ||
} | ||
``` | ||
|
||
Call `librarianRoot` in your root module: | ||
|
||
```kotlin | ||
librarianRoot() | ||
``` | ||
|
||
And `librarianModule` in each library module: | ||
|
||
```kotlin | ||
librarianModule() | ||
``` | ||
|
||
Librarian uses Gradle properties for configuration options and environment variables for secrets: | ||
|
||
```properties | ||
# gradle properties | ||
|
||
# compatibility | ||
librarian.javaCompatibility=8 | ||
librarian.kotlinCompatibility=2.0.0 | ||
|
||
# kdoc | ||
librarian.kdoc.aggregator=kdoc | ||
librarian.kdoc.olderVersions= | ||
|
||
# version | ||
librarian.version.packageName=com.apollographql.mockserver | ||
|
||
# publishing | ||
librarian.sonatype.backend=S01 | ||
librarian.pom.groupId=com.apollographql.mockserver | ||
librarian.pom.version=0.0.1 | ||
librarian.pom.description=Apollo Mockserver | ||
librarian.pom.vcsUrl=https://github.com/apollographql/apollo-kotlin-mockserver | ||
librarian.pom.developer=Apollo Kotlin Mockserver contributors | ||
librarian.pom.license=MIT License | ||
librarian.pom.licenseUrl=https://raw.githubusercontent.com/apollographql/apollo-kotlin-mockserver/main/LICENSE | ||
``` | ||
|
||
```shell | ||
export LIBRARIAN_SIGNING_PRIVATE_KEY=your_gpg_key | ||
export LIBRARIAN_SIGNING_PRIVATE_KEY_PASSWORD=your_gpg_key_password | ||
|
||
export LIBRARIAN_SONATYPE_USERNAME=your_sonatype_username | ||
export LIBRARIAN_SONATYPE_PASSWORD=your_sonatype_password | ||
``` | ||
See the project website for documentation:<br/> | ||
[https://gradleup.github.io/librarian/](https://apollographql.github.io/librarian/) | ||
|
||
The Kdoc API reference can be found at:<br/> | ||
[https://gradleup.github.io/librarian/kdoc](https://apollographql.github.io/librarian/kdoc) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters