Communication between GitHub and ungh-kt - The Kotlin driver for unjs/ungh

GradientTim — Tue, 30 Apr 2024 18:00:26 +0000

In this article I will introduce you to my Kotlin library ungh-kt and show you how to use it.

What is unjs/ungh and what is it for?

UNGH gives each of us the opportunity to use the GitHub API on an "unlimited" basis. The public service provided by unjs opens many more doors to do some things related to GitHub.

learn more about unjs/ungh here

How can we use the ungh-kt driver?

Download the driver from Maven Central
Once we have implemented the driver, we can use the class Ungh to access all available functions.

Get information about a user

val user: User? = Ungh.user("GradientTim")
if (user == null) {
    println("User 'GradientTim' not found")
    return
}
val id: Int = user.id
val username: String = user.username
val name: String? = user.name
val twitter: String? = user.twitter
val avatar: String? = user.avatar

Receive all public repositories from a user

val repositories = Ungh.userRepositories("GradientTim")
repositories.forEach {
    println("Repository id: ${it.id}")
    println("Repository name: ${it.name}")
}

Search for a user by email or name

val query: User? = Ungh.userQuery("pooya@pi0.io")
if (query != null) {
    println("User found!")
}

Get the number of stars from repositories

val stars = Ungh.stars(listOf(
    "unjs/ungh",
    "unjs/nitro",
))
if (stars != null) {
    println("Total stars: ${stars.totalStars}")
    stars.stars.forEach { (key, value) ->
        println("$key has $value stars")
    }
}

Receive information about an organization

val organization: Organization? = Ungh.organization("unjs")
if (organization == null) {
    println("Organization 'unjs' not found")
    return
}
val id: Int = organization.id
val name: String = organization.name
val description: String = organization.description

Receive all public repositories from an organization

val repositories = Ungh.organizationRepositories("unjs")
repositories.forEach {
    println("Repository id: ${it.id}")
    println("Repository name: ${it.name}")
}

Receive information about a repository

val repository: Repository? = Ungh.repository("unjs", "ungh")
if (repository == null) {
    println("Repository 'unjs/ungh' not found")
    return
}
val id: Int = repository.id
val name: String = repository.name
val repo: String = repository.repo
val description: String? = repository.description
val createdAt: String = repository.createdAt
val updatedAt: String = repository.updatedAt
val pushedAt: String = repository.pushedAt
val stars: Int = repository.stars
val watchers: Int = repository.watchers
val forks: Int = repository.forks
val defaultBranch: String = repository.defaultBranch

Get all contributors from a repository

val contributors = Ungh.repositoryContributors("unjs", "ungh")
contributors.forEach {
    val id: Int = it.id
    val username: String = it.username
    val amount: Int = it.contributions
    println("$username has in this repository $amount contributions")
}

List all files in a repository branch

val branchFiles = Ungh.repositoryBranchFiles("unjs", "ungh", "main")
if (branchFiles == null) {
    println("Branch or repository not found")
    return
}
val meta: FileMeta = branchFiles.meta
val files: MutableList<BranchFile> = branchFiles.files
val sha: String = meta.sha
files.forEach {
    val path: String = it.path
    val mode: String = it.mode
    val sha: String = it.sha
    val size: Int = it.size
}

Receive file content in a repository branch

val branchFile = Ungh.repositoryBranchFile(
    "unjs", // organization name
    "ungh", // repository name
    "main", // repository branch
    "README.md" // path to file
)
val meta: SimpleFileMeta = branchFile.meta
val file: SimpleFile = branchFile.file
val url: String = meta.url
val markdownContent: String = file.contents
val htmlContent: String? = file.html

Receive ReadMe from a repository

val readMe = Ungh.repositoryReadMe("unjs", "ungh")
if (readMe == null) {
    println("ReadMe file not found")
    return
}
val html: String = readMe.html
val markdown: String = readMe.markdown

List all releases of a repository

val releases = Ungh.repositoryReleases("JetBrains", "Kotlin")
releases.forEach {
    val id: Int = it.id
    val tag: String = it.tag
    val author: String = it.author
    val name: String = it.name
    val draft: Boolean = it.draft
    val preRelease: Boolean = it.preRelease
    val createdAt: String = it.createdAt
    val publishedAt: String = it.publishedAt
    val markdown: String = it.markdown
    val html: String = it.html
}

Receive the latest release from a repository

val release: Repository? = Ungh.repositoryLatestRelease(
    "JetBrains", // organization name
    "Kotlin" // repository name
)
if (release == null) {
    println("This repository has no releases")
    return
}
val id: Int = release.id
val tag: String = release.tag
val author: String = release.author
// ...

List all branches from a repository

val branches = Ungh.repositoryBranches("unjs", "ungh")
branches.forEach {
    val name: String = it.name
    val protected: Boolean = it.protected
    val commit: BranchCommit = it.commit
    val commitSha: String = commit.sha
    val commitUrl: String = commit.url
}

These were all the functions provided by the library ungh-kt.
Enjoy and have fun 😊

Contact: GitHub - Twitter/X

Forem: GradientTim