# normalize_url [![Build Status](https://travis-ci.org/johnotander/normalize_url.svg?branch=master)](https://travis-ci.org/johnotander/normalize_url)
[Normalize](https://en.wikipedia.org/wiki/URL_normalization) a url. This is useful for displaying, storing, sorting, etc.
## Usage
```elixir
NormalizeUrl.normalize_url("https://www.google.com?b=b&a=a")
# => "https://google.com?a=a&b=b"
NormalizeUrl.normalize_url("//foo.bar#about")
# => "http://foo.bar"
```
## Installation
Add.normalize_url_url to your list of dependencies in `mix.exs`
```elixir
def deps do
[{.normalize_url_url, "~> 0.0.1"}]
end
```
Ensure.normalize_url_url is started before your application
```elixir
def application do
[applications: [.normalize_url_url]]
end
```
#### Options
##### strip_www
Type: `boolean`
Default: `true`
Remove `www.` from the url
```elixir
NormalizeUrl.normalize_url("http://www.johnotander.com")
# => "http://johnotander.com"
NormalizeUrl.normalize_url("http://www.johnotander.com", [strip_www: false])
# => "http://www.johnotander.com"
```
##### strip_fragment
Type: `boolean`
Default: `true`
Remove `#framents` from the url
```elixir
NormalizeUrl.normalize_url("http://johnotander.com#about.html")
# => "http://johnotander.com"
NormalizeUrl.normalize_url("http://www.johnotander.com", [strip_fragment: false])
# => "http://johnotander.com#about.html"
```
#####.normalize_url_protocol
Type: `boolean`
Default: `true`
Normalize relative protocols
```elixir
NormalizeUrl.normalize_url("//johnotander.com#about")
# => "http://johnotander.com"
NormalizeUrl.normalize_url("//www.johnotander.com", .normalize_url_protocol: false])
# => "//johnotander.com"
```
## Development
```
mix test
```
## Related
* Elixir port from the [node module](https://github.com/sindresorhus.normalize_url-url) by [Sindre Sorhus](https://github.com/sindresorhus).
## License
MIT
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
Crafted with <3 by [John Otander](http://johnotander.com) ([@4lpine](https://twitter.com/4lpine)).