README.md

# Arguments

Arguments parses command line arguments with a declarative, simple setup

Produces results as a map for super pattern matching argument handling in your app!

`$ cmd new myname --more`
into
`%{new: true, name: "myname", more: true}`

Documentation: [https://hexdocs.pm/arguments/](https://hexdocs.pm/arguments/)

## Installation

Add `arguments` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [{:arguments, "~> 0.1.0"}]
end
```

## Usage

Arguments provides a module with argument parsing through `YourArguments.parse(incoming)`

`use Arguments`

There are two styles of arguments allowed
- [`command`](https://hexdocs.pm/arguments/Arguments.html#command/2) - `$ cmd new project`
- [`flag`](https://hexdocs.pm/arguments/Arguments.html#flag/2) - `$ cmd --dir /etc`

These two styles can be mixed, but the flags will always take priority

### Full Example:
```elixir
module MyArguments do
  use Arguments

  command "new", do: [
    arguments: [:name, :dir]
  ]

  flag "name", do: [
    type: :string,
    alias: :n,
    defaults: fn (n) -> [
      dir: "./#\{n\}"
    ] end
  ]

  flag "more", do: %{
    type: :boolean,
    alias: :m
  }

  flag "more_defaults", do: %{
    type: :boolean,
    alias: :m,
    defaults: [
      something: "else"
    ]
  }

  flag "dir", do: [
    type: :string
  ]
end
```

```elixir
iex> MyArguments.parse(["--name", "myname"])
%{name: "myname", dir: "./myname"}

iex> MyArguments.parse(["new", "myname", "dirhere"])
%{new: true, name: "myname", dir: "dirhere"}

iex> MyArguments.parse(["--more"])
%{more: true}

iex> MyArguments.parse(["-m"])
%{more: true}

iex> MyArguments.parse(["--not-defined"])
%{}
```