https://github.com/bkirwi/decline

A composable command-line parser for Scala.
https://github.com/bkirwi/decline

Last synced: about 2 months ago
JSON representation

A composable command-line parser for Scala.

• Host: GitHub
• URL: https://github.com/bkirwi/decline
• Owner: bkirwi
• License: apache-2.0
• Created: 2016-10-23T00:30:19.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-01-26T17:39:50.000Z (5 months ago)
• Last Synced: 2024-01-30T23:41:34.292Z (5 months ago)
• Language: Scala
• Homepage: http://monovore.com/decline/
• Size: 2.87 MB
• Stars: 621
• Watchers: 9
• Forks: 66
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Lists

• awesome-scala - **decline** - line parser for Scala. |   (Table of Contents / Command Line Interfaces)
• awesome-scala-native - decline - A composable command-line parser for Scala. (Console)
• awesome-stars - bkirwi/decline - A composable command-line parser for Scala. (Scala)
• awesome-stars - bkirwi/decline - A composable command-line parser for Scala. (Scala)
• awesome-scala - decline ★ 101 - composable command-line parser for Scala, built on Cats (Parsing)

README

        
# decline

[![Build Status](https://img.shields.io/github/actions/workflow/status/bkirwi/decline/ci.yml?branch=main)](https://github.com/bkirwi/decline/actions)

[![Discord](https://img.shields.io/discord/632277896739946517.svg?label=&logo=discord&logoColor=ffffff&color=404244&labelColor=6A7EC2)](https://discord.com/channels/632277896739946517/895394320100761731)

A composable command-line parser, inspired by [`optparse-applicative`][optparse]

and built on [`cats`][cats].

```scala

import cats.implicits._

import com.monovore.decline._

object HelloWorld extends CommandApp(

  name = "hello-world",

  header = "Says hello!",

  main = {

    val userOpt =

      Opts.option[String]("target", help = "Person to greet.")

        .withDefault("world")

    val quietOpt = Opts.flag("quiet", help = "Whether to be quiet.").orFalse

    (userOpt, quietOpt).mapN { (user, quiet) => 

      if (quiet) println("...")

      else println(s"Hello $user!")

    }

  }

)

```

**To get started, please visit [monovore.com/decline](http://monovore.com/decline/)!**

## About the Project

`decline` is a [Typelevel](https://typelevel.org/projects/) project,

and follows the [Scala Code of Conduct](https://typelevel.org/code_of_conduct.html).

This project is released under the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0).

[optparse]: https://github.com/pcapriotti/optparse-applicative

[cats]: https://github.com/typelevel/cats

[decline]: http://ben.kirw.in/decline/