io.github.gnuf0rce.github.model.ReposMapper.kt Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of github-helper Show documentation
github-helper
The newest version!
/*
 * Copyright 2021-2022 dsstudio Technologies and contributors.
 *
 *  此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
 *  Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
 *
 *  https://github.com/gnuf0rce/github-helper/blob/master/LICENSE
 */


package io.github.gnuf0rce.github.model

import io.github.gnuf0rce.github.*
import io.github.gnuf0rce.github.entry.*
import io.ktor.http.*
import java.util.*

/**
 * [Repositories](https://docs.github.com/en/rest/repos)
 */
public open class ReposMapper(parent: Url, public val owner: String, public val repo: String) :
    GitHubMapper(parent = parent, path = "$owner/$repo") {

    override val github: GitHubClient = GitHubClient()

    // region Repositories

    public open suspend fun load(): Repo = get()

    public open suspend fun update(context: Temp): Temp = patch(context = context)

    public open suspend fun delete(): Unit = delete()

    public open suspend fun fixes(open: Boolean): Temp = open(open = open, path = "automated-security-fixes")

    public open suspend fun contributors(page: Int, per: Int = 30, anon: Boolean = false): List =
        page(page = page, per = per, context = mapOf("anon" to anon), path = "contributors")

    public open suspend fun dispatches(context: Temp): Unit = post(context = context, path = "dispatches")

    /**
     * [list-repository-languages](https://docs.github.com/en/rest/repos/repos#list-repository-languages)
     */
    public open suspend fun languages(): Map = get(path = "languages")

    public open suspend fun tags(page: Int, per: Int = 30): List = page(page = page, per = per, path = "tags")

    public open suspend fun teams(page: Int, per: Int = 30): List = page(page = page, per = per, path = "teams")

    public open suspend fun topics(page: Int, per: Int = 30): List? =
        get>>("topics")["names"]

    public open suspend fun topics(names: List): List? =
        put>, Map>>(
            context = mapOf("names" to names),
            path = "topics"
        )["names"]

    public open suspend fun transfer(context: Temp): Temp = post(context = context, path = "transfer")

    public open suspend fun alerts(): Unit = get(path = "vulnerability-alerts")

    public open suspend fun alerts(open: Boolean): Unit = open(open = open, path = "vulnerability-alerts")

    public open suspend fun generate(context: Temp): Temp = post(context = context, path = "generate")

    /**
     * [list-commits](https://docs.github.com/en/rest/commits/commits#list-commits)
     */
    public open suspend fun commits(page: Int = 1, per: Int = 30): List =
        page(page = page, per = per, path = "commits")

    /**
     * [list-repository-contributors](https://docs.github.com/en/rest/repos/repos#list-repository-contributors)
     */
    public open suspend fun collaborators(page: Int = 1, per: Int = 30, anonymous: Boolean = false): List =
        page(page = page, per = per, context = mapOf("anon" to anonymous), path = "contributors")

    public open val issues: IssuesMapper = object : IssuesMapper(parent = base) {
        override val github: GitHubClient get() = [email protected]
    }

    public open val pulls: PullsMapper = object : PullsMapper(parent = base) {
        override val github: GitHubClient get() = [email protected]
    }

    public open val branches: BranchesMapper = object : BranchesMapper(parent = base) {
        override val github: GitHubClient get() = [email protected]
    }

    public open val releases: ReleasesMapper = object : ReleasesMapper(parent = base) {
        override val github: GitHubClient get() = [email protected]
    }

    public open val milestones: MilestonesMapper = object : MilestonesMapper(parent = base) {
        override val github: GitHubClient get() = [email protected]
    }

    protected open val commits: MutableMap = WeakHashMap()

    public open fun commit(sha: String): CommitMapper = commits.getOrPut(sha) {
        object : CommitMapper(parent = base, sha = sha) {
            override val github: GitHubClient get() = [email protected]
        }
    }

    // endregion

    // region Autolinks

    public open val autolinks: AutoLinksMapper = object : AutoLinksMapper(parent = base) {
        override val github: GitHubClient get() = [email protected]
    }

    // endregion

    // region Contents

    protected open val contents: MutableMap = WeakHashMap()

    public open fun content(path: String): ContentsMapper = contents.getOrPut(path) {
        object : ContentsMapper(parent = base, path = path) {
            override val github: GitHubClient get() = [email protected]
        }
    }

    /**
     * [get-a-repository-readme-for-a-directory](https://docs.github.com/en/rest/repos/contents#get-a-repository-readme-for-a-directory)
     */
    public open suspend fun readme(dir: String = ""): Readme = get(path = "readme/$dir")

    /**
     * [download-a-repository-archive-tar](https://docs.github.com/en/rest/repos/contents#download-a-repository-archive-tar)
     */
    public open suspend fun tar(ref: String): Readme = get(path = "tarball/$ref")

    /**
     * [download-a-repository-archive-zip](https://docs.github.com/en/rest/repos/contents#download-a-repository-archive-zip)
     */
    public open suspend fun zip(ref: String): Readme = get(path = "zipball/$ref")

    // endregion
}