mirror of https://gitlab.torproject.org/tpo/core/arti http://git.dilluti0n.com/mirrors/arti.git/atom?h=derive-traits 2022-02-28T16:41:13Z 2022-02-28T16:41:13Z eta tor@eta.st 2022-02-25T18:13:02Z urn:sha1:13ba0ea005ddd87bba2d53ab738ce948f031e1e8 This makes using the `PreferredRuntime` the first-class option inside `arti-client`, freeing users who don't want to think about runtimes from having to do so. `TorClient::create_unbootstrapped` and `builder` now automatically use this runtime, leaving only `builder_custom` for users who wish to manually specify a runtime. This lets us clean up the docs a lot: mentions of using custom runtimes are now relegated to nearer the end of the crate-level documentation, and we mostly just link to `tor_rtcompat`'s docs to explain more there. Instead, we take some more time to explain how you use the builder API to create clients synchronously. Other doc cleanups included getting rid of the explanation of `TorAddr` in the main crate-level doc; this is already well-documented elsewhere, and is something users should discover organically later. fixes arti#326 2022-02-25T13:36:34Z Ian Jackson iwj@torproject.org 2022-02-25T13:36:34Z urn:sha1:0ebab3df0b0e9392bc252e4f24bd1e76ee202fe8 TorClient: Add get_runtime() convenience method See merge request tpo/core/arti!350 2022-02-25T10:45:30Z Ian Jackson ijackson@chiark.greenend.org.uk 2022-02-25T10:45:30Z urn:sha1:310779c39d74b4827a96fd43b15280b4b2745519 As per https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/350#note_2781368 2022-02-24T19:55:59Z eta tor@eta.st 2022-02-18T16:02:18Z urn:sha1:c6fdd7c0037df821a7cfc475993322958c2f006a `StateMgr` got a new `unlock()` method that does what it says on the tin. We now call it from `bootstrap()` using the new `util::StateMgrUnlockGuard`, which works in a manner similar to the `BoolResetter` from `tor_dirmgr`. (A decent small little task in future might be to unify these types in some sort of general arti utility crate?) closes arti#335 2022-02-24T14:33:30Z Ian Jackson ijackson@chiark.greenend.org.uk 2022-02-24T11:08:05Z urn:sha1:82af514926ae6af0b01bd32c1a0aaaadf18a57c3 2022-02-18T20:28:31Z Nick Mathewson nickm@torproject.org 2022-02-18T20:28:31Z urn:sha1:c910226b551a9ffc453e7f4baba0562d3a6d7bdc This is a defensive API choice to protect against the possibility that we'll want to add a bunch of other non-config options in the future. Closes #350 2022-02-16T20:08:38Z eta tor@eta.st 2022-02-16T20:08:38Z urn:sha1:30439f9dc2ffdeaedf01fa4512557bee297fffbc arti-client: add ability to automatically bootstrap Closes #278 See merge request tpo/core/arti!322 2022-02-16T19:29:16Z eta tor@eta.st 2022-02-16T15:57:24Z urn:sha1:790ea4af4bf5223ca81218d0f5508db2bd2db471 The new `BootstrapBehavior` enum controls whether an unbootstrapped `TorClient` will bootstrap itself automatically (`Ondemand`) when an attempt is made to use it, or whether the user must perform bootstrapping themselves (`Manual`). The `lazy-init` example shows how you could write a simple `get_tor_client()` function that used a global `OnceCell` to share a Tor client across an entire application with this API. closes arti#278 2022-02-16T01:04:45Z Yuan Lyu lyuyuan92@gmail.com 2022-02-16T01:04:45Z urn:sha1:98b1a5a2794b204931618185b944fdc69e61a649 2022-02-14T14:59:37Z Nick Mathewson nickm@torproject.org 2022-02-14T14:59:37Z urn:sha1:8ea95aee7ae6b9cd9e78f7d76930ff8e9df35994 Since the only purpose of this function is to make sure that no bootstrapping task is running, a simple futures::lock::Mutex should do the job just fine. Closes #337.