Merge pull request #328 from lestrrat-go/topic/jwx-command

Command line tool `jwx`

Author: lestrrat

Changes

@@ -1,6 +1,20 @@
 Changes
 =======
 
+v1.1.0 05 Feb 2021
+[New features]
+  * Command line tool `jwx` has ben completely reworked, and it is
+    now actually useful.
+
+  * JWKs can now be serialized into PEM files with ASN.1 DER format
+    data, which is useful when you need to work between JSON and PEM
+    data formats.
+
+  * Constants in jwa package now have can be listed via functions
+    in each category.
+
+  * jwe.Encrypt and jwe.Decrypt can now handle jwk.Key objects
+
 v1.1.0 31 Jan 2021
   v1.1.0 is a release that attempts to fix as many of the quirky APIs
   that survived the API breaking change of v0.9.x -> v1.0.0. This is

README.md

@@ -1,6 +1,6 @@
 # github.com/lestrrat-go/jwx ![](https://github.com/lestrrat-go/jwx/workflows/CI/badge.svg) [![Go Reference](https://pkg.go.dev/badge/github.com/lestrrat-go/jwx.svg)](https://pkg.go.dev/github.com/lestrrat-go/jwx) [![codecov.io](http://codecov.io/github/lestrrat-go/jwx/coverage.svg?branch=master)](http://codecov.io/github/lestrrat-go/jwx?branch=master)
 
-Implementation of various JWx technologies
+Command line tool [jwx](./cmd/jwx) and libraries implementing various JWx technologies
 
 | Package name                                              | Notes                                           |
 |-----------------------------------------------------------|-------------------------------------------------|
@@ -38,6 +38,18 @@ The API has been reworked quite substantially between pre- and post 1.0.0 releas
 
 The API has gone under some changes for v1.1.0. If you are upgrading, you might want to read the relevant parts in the [Changes](./Changes) file.
 
+# Command Line Tool
+
+Since v1.1.1 we have a command line tool `jwx` (*). With `jwx` you can create JWKs (from PEM files, even), sign and verify JWS message, encrypt and decrypt JWE messages, etc.
+
+(*) Okay, it existed since a long time ago, but it was never useful.
+
+## Installation
+
+```
+go install github.com/lestrrat-go/jwx/cmd/jwx
+```
+
 # Packages
 
 ## JWA [![Go Reference](https://pkg.go.dev/badge/github.com/lestrrat-go/jwx/jwa.svg)](https://pkg.go.dev/github.com/lestrrat-go/jwx/jwa)