commonMain.github.Gh.kt Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of kommandline Show documentation
Kotlin DSL for popular CLI commands.
There is a newer version: 0.0.87
@file:Suppress("ClassName", "SpellCheckingInspection", "unused", "EnumEntryName")

package pl.mareklangiewicz.kommand.github

import pl.mareklangiewicz.bad.*
import pl.mareklangiewicz.kground.*
import pl.mareklangiewicz.kommand.*
import pl.mareklangiewicz.udata.strf

fun ghHelp(init: GhHelp.() -> Unit = {}) = GhHelp().apply(init)
fun ghVersion(init: GhVersion.() -> Unit = {}) = GhVersion().apply(init)
fun ghStatus(init: GhStatus.() -> Unit = {}) = GhStatus().apply(init)

/** [gh manual](https://cli.github.com/manual/index) */
abstract class GhKommand : Kommand {

  val ghKommandNameWords get() = classSimpleWords().also { it.first().chkEq("gh") }

  val nonopts: MutableList = mutableListOf()
  val opts: MutableList = mutableListOf()

  override val name get() = ghKommandNameWords.first()
  override val args get() = ghKommandNameWords.drop(1) + nonopts + opts.toArgsFlat()

  operator fun String.unaryPlus() = nonopts.add(this)
  operator fun KOptGhT.unaryMinus() = opts.add(this)
}

class GhHelp : GhKommand()
class GhVersion : GhKommand()
class GhStatus : GhKommand()
class GhSecretList : GhKommand()
class GhSecretSet : GhKommand()
class GhSecretDelete : GhKommand()
class GhRepoView : GhKommand()
class GhRepoList : GhKommand()

abstract class GhOpt(val arg: String? = null) : KOptGh {
  override fun toArgs(): List = listOf("--" + classSimpleWords().joinToString("-")) plusIfNN arg
}


// Reversed hierarhy of options to mark which GhKommand accepts which options.
// KOptGh prefix chosen to be clearly distinct from normal implementation tree prefixes: GhKommand, GhXXX: GhKommand, GhOpt

interface KOptGh : KOpt
interface KOptGhStatus : KOptGh
interface KOptGhRepoView : KOptGh
interface KOptGhRepoList : KOptGh
interface KOptGhRepo : KOptGh, KOptGhRepoList, KOptGhRepoView
interface KOptGhSecretList : KOptGh
interface KOptGhSecretSet : KOptGh
interface KOptGhSecretDelete : KOptGh
interface KOptGhSecret : KOptGh, KOptGhSecretList, KOptGhSecretSet, KOptGhSecretDelete
interface KOptGhCommon : KOptGh, KOptGhStatus, KOptGhSecret


data object Help : GhOpt(), KOptGhCommon

/**
 * It's impossible to use anyway because we always have mandatory GhCmd in Gh class.
 * But let's leave it anyway to signal that actual gh command accepts such (unnecessary) option.
 */
@Deprecated("Use version command instead of option.", ReplaceWith("ghVersion"))
data object Version : GhOpt("version")

/** @param path [HOST/]OWNER/REPO */
data class Repo(val path: String) : GhOpt(path), KOptGhSecret

/** @param ghApp {actions|codespaces|dependabot} */
data class App(val ghApp: String) : GhOpt(ghApp), KOptGhSecret

data class Env(val ghEnv: String) : GhOpt(ghEnv), KOptGhSecret

data class Org(val ghOrganization: String) : GhOpt(ghOrganization), KOptGhSecret, KOptGhStatus

data object User : GhOpt(), KOptGhSecret

data class Visibility(val vis: String) : GhOpt(vis), KOptGhSecretSet, KOptGhRepoList

/** @param repos list of repos to exclude in owner/name format */
data class Exclude(val repos: List) : GhOpt(repos.joinToString(",")), KOptGhStatus {
  constructor(vararg repos: String) : this(repos.toList())
}

data object Web : GhOpt(), KOptGhRepoView

data class Branch(val name: String) : GhOpt(name), KOptGhRepoView

data object Archived : GhOpt(), KOptGhRepoList
data object NoArchived : GhOpt(), KOptGhRepoList
data object Fork : GhOpt(), KOptGhRepoList
data object Source : GhOpt(), KOptGhRepoList // means NotFork

data class Language(val name: String) : GhOpt(name), KOptGhRepoList

data class Limit(val max: Int) : GhOpt(max.strf), KOptGhRepoList

data class Topic(val name: String) : GhOpt(name), KOptGhRepoList

/**
 * [gh help formatting](https://cli.github.com/manual/gh_help_formatting)
 * @param fields JSON fields separated by comma. null just prints available fields, no actual data */
data class Json(val fields: String? = null) : GhOpt(fields), KOptGhRepo {
  constructor(vararg fields: String) : this(fields.joinToString(",").takeIf { it.isNotEmpty() })
}

/** [jq lang manual](https://jqlang.github.io/jq/manual/v1.6/) */
data class Jq(val expression: String) : GhOpt(expression), KOptGhRepo

/** [go templates](https://pkg.go.dev/text/template) */
data class Template(val template: String) : GhOpt(template), KOptGhRepo