tokio-core travis-ci

I/O primitives and event loop for async I/O in Rust

3 years after

tokio-core

Core I/O and event loop abstraction for asynchronous I/O in Rust built on futures and mio.

Build Status Build status

Documentation

Usage

First, add this to your Cargo.toml:

[dependencies]
tokio-core = "0.1"

Next, add this to your crate:

extern crate tokio_core;

Examples

There are a few small examples showing off how to use this library:

  • echo.rs - a simple TCP echo server
  • socks5.rs - an implementation of a SOCKSv5 proxy server

What is tokio-core?

This crate is a connection futures, a zero-cost implementation of futures in Rust, and mio and a crate for zero-cost asynchronous I/O. The types and structures implemented in tokio-core implement Future and Stream traits as appropriate. For example connecting a TCP stream returns a Future resolving to a TCP stream, and a TCP listener implements a stream of TCP streams (accepted connections).

This crate also provides facilities such as:

  • TCP streams
  • TCP listeners
  • UDP sockets
  • Timeouts
  • Data owned and local to the event loop
  • An Executor implementation for a futures' Task

The intention of tokio-core is to provide a concrete implementation for crates built on top of asynchronous I/O. For example you can easily turn a TCP stream into a TLS/SSL stream with the tokio-tls crate or use the combinators to compose working with data on sockets.

Check out the documentation for more information, and more coming here soon!

License

tokio-core is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), with portions covered by various BSD-like licenses.

See LICENSE-APACHE, and LICENSE-MIT for details.

Related Repositories

mio

mio

Metal IO library for Rust ...

tarpc

tarpc

An RPC framework for Rust with a focus on ease of use. ...

gotips

gotips

golang tips ...

tokio

tokio

Asynchronous I/O for Rust ...

mysql-proxy-rs

mysql-proxy-rs

A highly scalable MySQL Proxy framework written in Rust ...


Top Contributors

alexcrichton oberien aturon rrichardson frewsxcv dwrensha dpc 3Hren carllerche tailhook rotty oconnor663 k4rtik sbstp danburkert aidanhs norcalli bheesham jeandudey reem kamalmarhubi debris spinda NeoLegends nbigaouette plietar Archytaus sdroege ghotiphud colindjk

Releases

-   0.1.1 zip tar
-   0.1.0 zip tar