lsquic.cr/README.md

51 lines
1.2 KiB
Markdown
Raw Permalink Normal View History

2019-11-13 01:15:43 +00:00
# lsquic
2019-11-16 02:45:05 +00:00
Crystal bindings to the excellent [LSQUIC](https://github.com/litespeedtech/lsquic) library.
2019-11-13 01:15:43 +00:00
2020-07-19 16:00:08 +00:00
Releases track lsquic's versioning starting with `v2.18.1`.
2019-11-16 19:15:26 +00:00
`liblsquic.a` is licensed under `LICENSE.lsquic` and `LICENSE.chrome`.
2020-07-19 16:00:08 +00:00
Lsquic uses [boringssl](https://github.com/google/boringssl), which is licensed under `LICENSE.boringssl`.
2019-11-16 19:15:26 +00:00
This library is available under the MIT license.
2019-11-13 01:15:43 +00:00
## Installation
1. Add the dependency to your `shard.yml`:
```yaml
dependencies:
lsquic:
2020-10-04 11:30:32 +00:00
github: iv-org/lsquic.cr
2019-11-13 01:15:43 +00:00
```
2. Run `shards install`
2019-11-16 19:15:26 +00:00
## Usage
```crystal
require "lsquic"
client = QUIC::Client.new("www.youtube.com")
client.get("/") # => #<HTTP::Client::Response>
client.get("/", headers: HTTP::Headers{
"cookie" => "Some value",
# ...
}) # => #<HTTP::Client::Response>
```
2019-11-13 01:15:43 +00:00
## Contributing
2020-10-04 11:30:32 +00:00
1. Fork it (<https://github.com/iv-org/lsquic.cr/fork>)
2019-11-13 01:15:43 +00:00
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 a new Pull Request
## Contributors
- [Omar Roth](https://github.com/omarroth) - creator and maintainer