README.md

# HyperAuth
[![Hex.pm](https://img.shields.io/hexpm/l/plug_hyper_auth.svg)](https://hex.pm/packages/plug_hyper_auth)
[![Hex.pm](https://img.shields.io/hexpm/v/plug_hyper_auth.svg)](https://hex.pm/packages/plug_hyper_auth)
[![Hex.pm](https://img.shields.io/hexpm/dt/plug_hyper_auth.svg)](https://hex.pm/packages/plug_hyper_auth)
[![Build Status](https://travis-ci.org/HyperAuth/ExHyperAuth.svg?branch=master)](https://travis-ci.org/HyperAuth/ExHyperAuth)

Plug for HTTP authentication.

ExHyperAuth repository is the version of HyperAuth wrote in Elixir to use with web
applications based on Plug.

## Installation

The package can be installed by adding `plug_hyper_auth` to your list of
dependencies in `mix.exs`:

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

Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
and is published on [HexDocs](https://hexdocs.pm). The docs can be found at
[https://hexdocs.pm/plug_hyper_auth](https://hexdocs.pm/plug_hyper_auth).

## Contribute

Contribution is welcomed. Open a [pull request][pulls] when you are ready to contribute.

If you are planning to contribute documentation, please check the
[best practices for writing documentation of Elixir][writing-docs].

Add tests for the code added and try to keep the code clean. The pull request
need to pass the tests to be accepted.

Finally, remember all interactions in our official spaces follow the
[Elixir Code of Conduct][code-of-conduct].

### Copyright

You hereby assign copyright in this code to the project, to be licensed
under the same terms as the rest of the code.

You're owner of your contribution copyright, but it will be covered under
HyperAuth's license and also it's shared with the rest of authors, all the
contributors are authors of HyperAuth.

Read the license note section to check details about it.

### Useful links

Some useful links if you want to contribute to this repository.

  * [RFC 2617 at ietf.org](http://www.ietf.org/rfc/rfc2617.txt)
  * [RFC 2617 at webdav.org](http://www.webdav.org/specs/rfc2617.html)
  * [RFC 7235 at ietf.org](https://tools.ietf.org/html/rfc7235)
  * [RFC 7235 at webdav.org](http://www.webdav.org/specs/rfc7235.html)
  * [RFC 7616 at ietf.org](https://tools.ietf.org/html/rfc7616)

## License note

HyperAuth is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

HyperAuth is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

Check [NOTICE](NOTICE) and [LICENSE](LICENSE) files for more
information.

  [code-of-conduct]: https://github.com/elixir-lang/elixir/blob/master/CODE_OF_CONDUCT.md
  [writing-docs]: http://elixir-lang.org/docs/stable/elixir/writing-documentation.html