# PlugHyperAuth
[![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/ExPlugHyperAuth.svg?branch=master)](https://travis-ci.org/HyperAuth/ExPlugHyperAuth)
Plug for HTTP authentication.
ExPlugHyperAuth repository is a plug to use the version of HyperAuth wrote
in Elixir in 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
PlugHyperAuth's license and also it's shared with the rest of authors, all the
contributors are authors of PlugHyperAuth.
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
PlugHyperAuth 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.
PlugHyperAuth 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