# `mix semver.increment`
[🔗](https://gitlab.com/jaybarra/semver_mgr/blob/main/lib/mix/tasks/semver.increment.ex#L1)

The semver mix task: `mix semver.increment`

# `run`

Increment the appropriate field on your project version using Semantic Versioning.

MAJOR.MINOR.PATCH

Incrementing a greater value will reset the lower fields unless the --preserve-lower flag is set.

## Options

    * `patch` (default)
    * `minor`
    * `major`
    * --preserve [optional csv separated list to preserve (currently only `patch` and `minor`)]
                 Used on its own, only the specified field will be incremented.

## Examples

    $ mix semver.increment
    Incremented 0.1.0 -> 0.1.1

    $ mix semver.increment patch
    Incremented 0.1.1 -> 0.1.2

    $ mix semver.increment minor 3
    Incremented 0.1.2 -> 0.4.0

    $ mix semver.increment patch 2
    Incremented 0.4.0 -> 0.4.2

    $ mix semver.increment major --preserve patch
    Incremented 0.4.2 -> 1.0.2
    

---

*Consult [api-reference.md](api-reference.md) for complete listing*
