mirrors/arti.git/crates/tor-rtcompat/src/async_std.rs, branch arti-v0.2.0

add udp to runtime

2022-03-14T19:59:33Z

tor-rtcompat: refactor PreferredRuntime, clean up docs

2022-02-25T17:34:05Z

`PreferredRuntime` is now an opaque wrapper struct that contains the "actual" preferred runtime as a type alias. The `current_user_runtime` and `create_runtime` functions become `PreferredRuntime::current` and `PreferredRuntime::create`, respectively. This removes the dependence on `impl Trait`, meaning we can now name the returned runtime (yay!). In addition, the documentation was cleaned up a bit to make it (hopefully) flow better. Items that don't make sense to publicize, like testing implementation details, have been marked #[doc(hidden)] and semver warnings added.

tor-rtcompat: Provide TLS wrapping for all streams

2022-02-24T14:26:38Z

Now all of the runtime types we provide all impl ~~TlsProvider ~~where S: ... rather than merely TlsProvider. And we document and intent to perhaps require this in the future.~~~~

tor-rtcompat: Add some miscellaneous tests

2022-01-27T20:48:30Z
These probably aren't for things that will fail IRL, but it's nice to have coverage on the code, just in case.

Rename `SpawnBlocking` trait to `BlockOn`.

2022-01-26T19:06:58Z
This avoids a future confusion with the new `SpawnBlocking` trait in async_executors v0.5, and better describes what the trait provides.

Make test_with_all_runtimes cover _all_ the runtimes.

2022-01-26T19:06:58Z
This took some refactoring, so that I wouldn't need to define 9 different versions of the function. It also required that we change the behavior of test_with_all_runtimes slightly, so that it asserts on _any_ failure rather than asserting on most but returning Err() for others. That in turn required changes to a few of its callers. There's probably a better way to do all of this macro business, but this is the best I could find.

Make the native-tls crate optional.

2022-01-26T19:06:58Z
This commit puts the native-tls crate behind a feature. The feature is off-by-default in the tor-rtcompat crate, but can be enabled either from arti or arti-client. There is an included script that I used to test that tor-rtcompat could build and run its tests with all subsets of its features. Closes #300

Define aliases for "the best enabled runtime".

2022-01-26T19:06:58Z
This helps us simplify our code in a few ways, and will help even more once native_tls is optional.

Make current/create functions into runtime member functions.

2022-01-26T19:06:58Z
This should help avoid some amount of temptation towards API proliferation.

Rename FooRuntime to FooNativeTlsRuntime for consistency.

2022-01-26T19:06:58Z