Skip to content

Commit

Permalink
extended readme
Browse files Browse the repository at this point in the history
  • Loading branch information
timvw committed Oct 28, 2020
1 parent d459520 commit 30f27dc
Showing 1 changed file with 54 additions and 0 deletions.
54 changes: 54 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
This library automates the task of mapping Strings to Things.
A typical use-case is parsing CSV into a case class.

[![Build Status](https://api.travis-ci.org/timvw/stringmapper.png?branch=master)](https://travis-ci.org/timvw/stringmapper)
[![Maven Central](https://img.shields.io/maven-central/v/be.icteam/stringmapper_2.12.svg)](https://maven-badges.herokuapp.com/maven-central/be.icteam/stringmapper_2.12)

## Usage

```scala
Expand Down Expand Up @@ -48,3 +51,54 @@ val customItemCsvParser = CsvParser[Item]
assert(customItemCsvParser.parse(malformedLeadingSpaceInId) == Right(Item("sir", "MIKE", 3, Some("x"))))
```

## Development

Compile and test:

```bash
sbt +clean; +cleanFiles; +compile; +test
```

Install a snapshot in your local maven repository:

```bash
sbt +publishM2
```

## Release

Set the following environment variables:
- PGP_PASSPHRASE
- PGP_SECRET
- SONATYPE_USERNAME
- SONATYPE_PASSWORD

Leveraging the [ci-release](https://github.com/olafurpg/sbt-ci-release) plugin:

```bash
sbt ci-release
```

Find the most recent release:

```bash
git ls-remote --tags $REPO | \
awk -F"/" '{print $3}' | \
grep '^v[0-9]*\.[0-9]*\.[0-9]*' | \
grep -v {} | \
sort --version-sort | \
tail -n1
```

Push a new tag to trigger a release via [travis-ci](https://travis-ci.org/github/timvw/stringmapper):

```bash
v=v1.0.5
git tag -a $v -m $v
git push origin $v
```

## License

Code is provided under the Apache 2.0 license available at http://opensource.org/licenses/Apache-2.0, as well as in the LICENSE file. This is the same license used as Spark and Frameless.

0 comments on commit 30f27dc

Please sign in to comment.