• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..03-May-2022-

.circleci/H16-Aug-2021-

.githooks/H16-Aug-2021-

.github/workflows/H16-Aug-2021-

benchmark/H16-Aug-2021-

docs/H03-May-2022-

example/H16-Aug-2021-

fuzzing/H16-Aug-2021-

http3/H16-Aug-2021-

integrationtests/H16-Aug-2021-

internal/H16-Aug-2021-

interop/H16-Aug-2021-

logging/H16-Aug-2021-

qlog/H16-Aug-2021-

quicvarint/H16-Aug-2021-

.gitignoreH A D16-Aug-2021210

.golangci.ymlH A D16-Aug-2021903

Changelog.mdH A D16-Aug-20214.4 KiB

LICENSEH A D16-Aug-20211.1 KiB

README.mdH A D16-Aug-20212.3 KiB

buffer_pool.goH A D16-Aug-20211.8 KiB

buffer_pool_test.goH A D16-Aug-20211.2 KiB

client.goH A D16-Aug-20219.2 KiB

client_test.goH A D16-Aug-202118.2 KiB

closed_session.goH A D16-Aug-20212.9 KiB

closed_session_test.goH A D16-Aug-20211.4 KiB

codecov.ymlH A D16-Aug-2021567

config.goH A D16-Aug-20214.1 KiB

config_test.goH A D16-Aug-20215.9 KiB

conn.goH A D16-Aug-20211.8 KiB

conn_generic.goH A D16-Aug-2021285

conn_helper_darwin.goH A D16-Aug-2021391

conn_helper_freebsd.goH A D16-Aug-2021245

conn_helper_linux.goH A D16-Aug-2021385

conn_id_generator.goH A D16-Aug-20214.4 KiB

conn_id_generator_test.goH A D16-Aug-20217.3 KiB

conn_id_manager.goH A D16-Aug-20216.5 KiB

conn_id_manager_test.goH A D16-Aug-202114 KiB

conn_oob.goH A D16-Aug-20218.3 KiB

conn_oob_test.goH A D16-Aug-20217.1 KiB

conn_test.goH A D16-Aug-2021888

conn_windows.goH A D16-Aug-20211.2 KiB

conn_windows_test.goH A D16-Aug-2021784

crypto_stream.goH A D16-Aug-20213 KiB

crypto_stream_manager.goH A D16-Aug-20211.5 KiB

crypto_stream_manager_test.goH A D16-Aug-20214.6 KiB

crypto_stream_test.goH A D16-Aug-20215.7 KiB

datagram_queue.goH A D16-Aug-20211.8 KiB

datagram_queue_test.goH A D16-Aug-20212.5 KiB

errors.goH A D16-Aug-20211.9 KiB

frame_sorter.goH A D16-Aug-20215.8 KiB

frame_sorter_test.goH A D16-Aug-202139.5 KiB

framer.goH A D16-Aug-20214.9 KiB

framer_test.goH A D16-Aug-202115.5 KiB

go.modH A D16-Aug-2021646

go.sumH A D16-Aug-202127.9 KiB

interface.goH A D16-Aug-202114.8 KiB

mock_ack_frame_source_test.goH A D16-Aug-20211.6 KiB

mock_batch_conn_test.goH A D16-Aug-20211.4 KiB

mock_crypto_data_handler_test.goH A D16-Aug-20211.6 KiB

mock_crypto_stream_test.goH A D16-Aug-20213.9 KiB

mock_frame_source_test.goH A D16-Aug-20212.8 KiB

mock_mtu_discoverer_test.goH A D16-Aug-20212.6 KiB

mock_multiplexer_test.goH A D16-Aug-20212.1 KiB

mock_packer_test.goH A D16-Aug-20216.6 KiB

mock_packet_handler_manager_test.goH A D16-Aug-20216.6 KiB

mock_packet_handler_test.goH A D16-Aug-20212.7 KiB

mock_packetconn_test.goH A D16-Aug-20214.3 KiB

mock_quic_session_test.goH A D16-Aug-202111.7 KiB

mock_receive_stream_internal_test.goH A D16-Aug-20215.1 KiB

mock_sealing_manager_test.goH A D16-Aug-20213.3 KiB

mock_send_conn_test.goH A D16-Aug-20212.5 KiB

mock_send_stream_internal_test.goH A D16-Aug-20216.3 KiB

mock_sender_test.goH A D16-Aug-20212.7 KiB

mock_session_runner_test.goH A D16-Aug-20214.5 KiB

mock_stream_getter_test.goH A D16-Aug-20212.2 KiB

mock_stream_internal_test.goH A D16-Aug-20219.5 KiB

mock_stream_manager_test.goH A D16-Aug-20218.4 KiB

mock_stream_sender_test.goH A D16-Aug-20212.5 KiB

mock_token_store_test.goH A D16-Aug-20211.7 KiB

mock_unknown_packet_handler_test.goH A D16-Aug-20211.9 KiB

mock_unpacker_test.goH A D16-Aug-20211.5 KiB

mockgen.goH A D16-Aug-20213.2 KiB

mockgen_private.shH A D16-Aug-20211.4 KiB

mtu_discoverer.goH A D16-Aug-20212.2 KiB

mtu_discoverer_test.goH A D16-Aug-20213.4 KiB

multiplexer.goH A D16-Aug-20212.8 KiB

multiplexer_test.goH A D16-Aug-20213.1 KiB

packet_handler_map.goH A D16-Aug-202113.3 KiB

packet_handler_map_test.goH A D16-Aug-202118.4 KiB

packet_packer.goH A D16-Aug-202127.5 KiB

packet_packer_test.goH A D16-Aug-202180.6 KiB

packet_unpacker.goH A D16-Aug-20216.2 KiB

packet_unpacker_test.goH A D16-Aug-202111.7 KiB

quic_suite_test.goH A D16-Aug-2021524

receive_stream.goH A D16-Aug-20218.2 KiB

receive_stream_test.goH A D16-Aug-202121.6 KiB

retransmission_queue.goH A D16-Aug-20213.3 KiB

retransmission_queue_test.goH A D16-Aug-20216.5 KiB

send_conn.goH A D16-Aug-20211.3 KiB

send_conn_test.goH A D16-Aug-2021958

send_queue.goH A D16-Aug-20211.8 KiB

send_queue_test.goH A D16-Aug-20212.9 KiB

send_stream.goH A D16-Aug-202112.9 KiB

send_stream_test.goH A D16-Aug-202139.1 KiB

server.goH A D16-Aug-202120.4 KiB

server_test.goH A D16-Aug-202144.7 KiB

session.goH A D16-Aug-202161.1 KiB

session_test.goH A D16-Aug-2021113.4 KiB

stream.goH A D16-Aug-20214.4 KiB

stream_test.goH A D16-Aug-20213.2 KiB

streams_map.goH A D16-Aug-20219.5 KiB

streams_map_generic_helper.goH A D16-Aug-2021505

streams_map_incoming_bidi.goH A D16-Aug-20215.4 KiB

streams_map_incoming_generic.goH A D16-Aug-20215.4 KiB

streams_map_incoming_generic_test.goH A D16-Aug-20219.8 KiB

streams_map_incoming_uni.goH A D16-Aug-20215.5 KiB

streams_map_outgoing_bidi.goH A D16-Aug-20215.4 KiB

streams_map_outgoing_generic.goH A D16-Aug-20215.5 KiB

streams_map_outgoing_generic_test.goH A D16-Aug-202115.9 KiB

streams_map_outgoing_uni.goH A D16-Aug-20215.5 KiB

streams_map_test.goH A D16-Aug-202117.3 KiB

token_store.goH A D16-Aug-20212.5 KiB

token_store_test.goH A D16-Aug-20213.2 KiB

tools.goH A D16-Aug-2021110

window_update_queue.goH A D16-Aug-20211.8 KiB

window_update_queue_test.goH A D16-Aug-20213.8 KiB

README.md

1# A QUIC implementation in pure Go
2
3<img src="docs/quic.png" width=303 height=124>
4
5[![PkgGoDev](https://pkg.go.dev/badge/github.com/lucas-clemente/quic-go)](https://pkg.go.dev/github.com/lucas-clemente/quic-go)
6[![Travis Build Status](https://img.shields.io/travis/lucas-clemente/quic-go/master.svg?style=flat-square&label=Travis+build)](https://travis-ci.org/lucas-clemente/quic-go)
7[![CircleCI Build Status](https://img.shields.io/circleci/project/github/lucas-clemente/quic-go.svg?style=flat-square&label=CircleCI+build)](https://circleci.com/gh/lucas-clemente/quic-go)
8[![Windows Build Status](https://img.shields.io/appveyor/ci/lucas-clemente/quic-go/master.svg?style=flat-square&label=windows+build)](https://ci.appveyor.com/project/lucas-clemente/quic-go/branch/master)
9[![Code Coverage](https://img.shields.io/codecov/c/github/lucas-clemente/quic-go/master.svg?style=flat-square)](https://codecov.io/gh/lucas-clemente/quic-go/)
10
11quic-go is an implementation of the [QUIC protocol, RFC 9000](https://datatracker.ietf.org/doc/html/rfc9000) protocol in Go.
12In addition to RFC 9000, it currently implements the [IETF QUIC draft-29](https://tools.ietf.org/html/draft-ietf-quic-transport-29). Support for draft-29 will eventually be dropped, as it is phased out of the ecosystem.
13
14## Guides
15
16*We currently support Go 1.16.x and Go 1.17.x.*
17
18Running tests:
19
20    go test ./...
21
22### QUIC without HTTP/3
23
24Take a look at [this echo example](example/echo/echo.go).
25
26## Usage
27
28### As a server
29
30See the [example server](example/main.go). Starting a QUIC server is very similar to the standard lib http in go:
31
32```go
33http.Handle("/", http.FileServer(http.Dir(wwwDir)))
34http3.ListenAndServeQUIC("localhost:4242", "/path/to/cert/chain.pem", "/path/to/privkey.pem", nil)
35```
36
37### As a client
38
39See the [example client](example/client/main.go). Use a `http3.RoundTripper` as a `Transport` in a `http.Client`.
40
41```go
42http.Client{
43  Transport: &http3.RoundTripper{},
44}
45```
46
47## Contributing
48
49We are always happy to welcome new contributors! We have a number of self-contained issues that are suitable for first-time contributors, they are tagged with [help wanted](https://github.com/lucas-clemente/quic-go/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22). If you have any questions, please feel free to reach out by opening an issue or leaving a comment.
50