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

..03-May-2022-

.circleci/H04-Dec-2020-

.github/workflows/H04-Dec-2020-

.travis/H04-Dec-2020-

benchmark/H04-Dec-2020-

docs/H03-May-2022-

example/H04-Dec-2020-

fuzzing/H04-Dec-2020-

http3/H04-Dec-2020-

integrationtests/H04-Dec-2020-

internal/H04-Dec-2020-

interop/H04-Dec-2020-

logging/H04-Dec-2020-

metrics/H04-Dec-2020-

qlog/H04-Dec-2020-

quictrace/H04-Dec-2020-

.editorconfigH A D04-Dec-202052

.gitignoreH A D04-Dec-2020210

.golangci.ymlH A D04-Dec-2020950

.travis.ymlH A D04-Dec-2020829

Changelog.mdH A D04-Dec-20203.6 KiB

LICENSEH A D04-Dec-20201.1 KiB

README.mdH A D04-Dec-20202.8 KiB

buffer_pool.goH A D04-Dec-20201.8 KiB

buffer_pool_test.goH A D04-Dec-20201.2 KiB

client.goH A D04-Dec-20209 KiB

client_test.goH A D04-Dec-202018.9 KiB

closed_session.goH A D04-Dec-20202.9 KiB

closed_session_test.goH A D04-Dec-20201.4 KiB

codecov.ymlH A D04-Dec-2020584

config.goH A D04-Dec-20203.4 KiB

config_test.goH A D04-Dec-20205 KiB

conn.goH A D04-Dec-20201.6 KiB

conn_ecn.goH A D04-Dec-20203.1 KiB

conn_ecn_test.goH A D04-Dec-20203.6 KiB

conn_generic.goH A D04-Dec-2020229

conn_helper_darwin.goH A D04-Dec-2020240

conn_helper_linux.goH A D04-Dec-2020206

conn_id_generator.goH A D04-Dec-20204.5 KiB

conn_id_generator_test.goH A D04-Dec-20206.7 KiB

conn_id_manager.goH A D04-Dec-20206.8 KiB

conn_id_manager_test.goH A D04-Dec-202013.9 KiB

conn_test.goH A D04-Dec-2020889

conn_windows.goH A D04-Dec-2020749

crypto_stream.goH A D04-Dec-20202.9 KiB

crypto_stream_manager.goH A D04-Dec-20201.5 KiB

crypto_stream_manager_test.goH A D04-Dec-20204.6 KiB

crypto_stream_test.goH A D04-Dec-20205.4 KiB

frame_sorter.goH A D04-Dec-20205.8 KiB

frame_sorter_test.goH A D04-Dec-202039.5 KiB

framer.goH A D04-Dec-20204.2 KiB

framer_test.goH A D04-Dec-202014.4 KiB

go.modH A D04-Dec-2020814

go.sumH A D04-Dec-202027.1 KiB

interface.goH A D04-Dec-202013.2 KiB

mock_ack_frame_source_test.goH A D04-Dec-20201.6 KiB

mock_crypto_data_handler_test.goH A D04-Dec-20201.6 KiB

mock_crypto_stream_test.goH A D04-Dec-20203.9 KiB

mock_frame_source_test.goH A D04-Dec-20202.8 KiB

mock_multiplexer_test.goH A D04-Dec-20202.1 KiB

mock_packer_test.goH A D04-Dec-20204.8 KiB

mock_packet_handler_manager_test.goH A D04-Dec-20206.7 KiB

mock_packet_handler_test.goH A D04-Dec-20202.7 KiB

mock_packetconn_test.goH A D04-Dec-20204.3 KiB

mock_quic_session_test.goH A D04-Dec-202010.2 KiB

mock_receive_stream_internal_test.goH A D04-Dec-20205.1 KiB

mock_sealing_manager_test.goH A D04-Dec-20203.3 KiB

mock_send_conn_test.goH A D04-Dec-20202.6 KiB

mock_send_stream_internal_test.goH A D04-Dec-20206.4 KiB

mock_session_runner_test.goH A D04-Dec-20204.5 KiB

mock_stream_getter_test.goH A D04-Dec-20202.2 KiB

mock_stream_internal_test.goH A D04-Dec-20209.7 KiB

mock_stream_manager_test.goH A D04-Dec-20207.7 KiB

mock_stream_sender_test.goH A D04-Dec-20202.5 KiB

mock_token_store_test.goH A D04-Dec-20201.7 KiB

mock_unknown_packet_handler_test.goH A D04-Dec-20202 KiB

mock_unpacker_test.goH A D04-Dec-20201.5 KiB

mockgen.goH A D04-Dec-20202.8 KiB

mockgen_private.shH A D04-Dec-2020500

multiplexer.goH A D04-Dec-20202.8 KiB

multiplexer_test.goH A D04-Dec-20203.1 KiB

packet_handler_map.goH A D04-Dec-202010.9 KiB

packet_handler_map_test.goH A D04-Dec-202014.8 KiB

packet_packer.goH A D04-Dec-202025.2 KiB

packet_packer_test.goH A D04-Dec-202076.3 KiB

packet_unpacker.goH A D04-Dec-20206.3 KiB

packet_unpacker_test.goH A D04-Dec-202011.8 KiB

quic_suite_test.goH A D04-Dec-2020524

receive_stream.goH A D04-Dec-20208.2 KiB

receive_stream_test.goH A D04-Dec-202022 KiB

retransmission_queue.goH A D04-Dec-20203.3 KiB

retransmission_queue_test.goH A D04-Dec-20206.5 KiB

send_conn.goH A D04-Dec-2020598

send_conn_test.goH A D04-Dec-2020957

send_queue.goH A D04-Dec-20201.1 KiB

send_queue_test.goH A D04-Dec-20202.6 KiB

send_stream.goH A D04-Dec-202012.8 KiB

send_stream_test.goH A D04-Dec-202038.6 KiB

server.goH A D04-Dec-202020.5 KiB

server_test.goH A D04-Dec-202045 KiB

session.goH A D04-Dec-202055.1 KiB

session_test.goH A D04-Dec-2020101.7 KiB

stream.goH A D04-Dec-20204.4 KiB

stream_deadline_error.goH A D04-Dec-2020280

stream_deadline_error_go115.goH A D04-Dec-2020120

stream_deadline_error_test.goH A D04-Dec-2020456

stream_test.goH A D04-Dec-20202.9 KiB

streams_map.goH A D04-Dec-20207.8 KiB

streams_map_generic_helper.goH A D04-Dec-2020467

streams_map_incoming_bidi.goH A D04-Dec-20205.3 KiB

streams_map_incoming_generic.goH A D04-Dec-20205.4 KiB

streams_map_incoming_generic_test.goH A D04-Dec-20209.6 KiB

streams_map_incoming_uni.goH A D04-Dec-20205.4 KiB

streams_map_outgoing_bidi.goH A D04-Dec-20205 KiB

streams_map_outgoing_generic.goH A D04-Dec-20205.1 KiB

streams_map_outgoing_generic_test.goH A D04-Dec-202015.6 KiB

streams_map_outgoing_uni.goH A D04-Dec-20205 KiB

streams_map_test.goH A D04-Dec-202015.7 KiB

token_store.goH A D04-Dec-20202.5 KiB

token_store_test.goH A D04-Dec-20203.2 KiB

window_update_queue.goH A D04-Dec-20201.8 KiB

window_update_queue_test.goH A D04-Dec-20203.8 KiB

zero_rtt_queue.goH A D04-Dec-20201.6 KiB

zero_rtt_queue_test.goH A D04-Dec-20203.6 KiB

README.md

1# A QUIC implementation in pure Go
2
3<img src="docs/quic.png" width=303 height=124>
4
5[![Godoc Reference](https://img.shields.io/badge/godoc-reference-blue.svg?style=flat-square)](https://godoc.org/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](https://en.wikipedia.org/wiki/QUIC) protocol in Go. It implements the [IETF QUIC draft-29](https://tools.ietf.org/html/draft-ietf-quic-transport-29) and [draft-32](https://tools.ietf.org/html/draft-ietf-quic-transport-32).
12
13## Version compatibility
14
15Since quic-go is under active development, there's no guarantee that two builds of different commits are interoperable. The QUIC version used in the *master* branch is just a placeholder, and should not be considered stable.
16
17If you want to use quic-go as a library in other projects, please consider using a [tagged release](https://github.com/lucas-clemente/quic-go/releases). These releases expose [experimental QUIC versions](https://github.com/quicwg/base-drafts/wiki/QUIC-Versions), which are guaranteed to be stable.
18
19## Guides
20
21*We currently support Go 1.14+, with [Go modules](https://github.com/golang/go/wiki/Modules) support enabled.*
22
23Running tests:
24
25    go test ./...
26
27### QUIC without HTTP/3
28
29Take a look at [this echo example](example/echo/echo.go).
30
31## Usage
32
33### As a server
34
35See the [example server](example/main.go). Starting a QUIC server is very similar to the standard lib http in go:
36
37```go
38http.Handle("/", http.FileServer(http.Dir(wwwDir)))
39http3.ListenAndServeQUIC("localhost:4242", "/path/to/cert/chain.pem", "/path/to/privkey.pem", nil)
40```
41
42### As a client
43
44See the [example client](example/client/main.go). Use a `http3.RoundTripper` as a `Transport` in a `http.Client`.
45
46```go
47http.Client{
48  Transport: &http3.RoundTripper{},
49}
50```
51
52## Contributing
53
54We 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.
55