2021-11-11 15:35:38 +00:00
|
|
|
# Semver tracking
|
|
|
|
|
|
|
|
This is a helpful file that we use for checking which crates will have
|
|
|
|
breaking or nonbreaking API changes in the next release of Arti.
|
|
|
|
|
|
|
|
For each crate, please write "BREAKING" if there is an API change that counts
|
|
|
|
as breaking in semver, and "MODIFIED" if there is a backward-compatible API
|
|
|
|
change.
|
|
|
|
|
|
|
|
You can change from MODIFIED to BREAKING, but never from BREAKING to
|
|
|
|
MODIFIED.
|
|
|
|
|
|
|
|
You don't need to list details; this isn't the changelog.
|
|
|
|
|
|
|
|
Don't document other changes in this file.
|
|
|
|
|
|
|
|
We can delete older sections here after we bump the releases.
|
|
|
|
|
2022-04-01 16:18:35 +01:00
|
|
|
## Since Arti 0.2.0
|
2021-11-11 15:35:38 +00:00
|
|
|
|
2022-04-25 18:31:06 +01:00
|
|
|
### All crates
|
|
|
|
|
|
|
|
BREAKING: Requiring Rust 1.56, edition 2021.
|
|
|
|
|
2022-05-05 10:20:56 +01:00
|
|
|
### configuration (affecting arti, arti-client, tor-dirmgr, tor-guardmgr)
|
2022-04-22 17:22:24 +01:00
|
|
|
|
|
|
|
BREAKING: Configuration of fallback directories overhauled; now uses FalllbadkDirBuilder more.
|
2022-04-25 17:07:48 +01:00
|
|
|
BREAKING: Configuration of directory authoorities overhauled; now uses AuthorityListBuilder.
|
|
|
|
BREAKING: Configuration of preemptive ports overhauled; now uses PredictedPortsListBuilder..
|
2022-04-26 15:19:52 +01:00
|
|
|
BREAKING: Configuration of download schedules overhauled; now uses builders
|
|
|
|
BREAKING: download schedules: "num_retries" configuration field renamed to (accurate) "attempts"
|
|
|
|
BREAKING: download schedules: Setting zero values for attempts or parallelism is now rejected
|
2022-05-05 10:20:43 +01:00
|
|
|
BREAKING: Validated configuration structs are no longer Deseralize.
|
|
|
|
MODIFIED: Configuration builder structs are now all Serialize+Deseralize+Debug.
|
2022-04-22 17:22:24 +01:00
|
|
|
|
2022-04-22 17:39:42 +01:00
|
|
|
### arti
|
|
|
|
|
|
|
|
BREAKING: Replaced LoggingConfigBuilder::file (taking Vec) with LoggingConfigBuilder::files
|
|
|
|
BREAKING: LoggingConfigBuilder::build() throws ConfigBuildError, not a bespoke error
|
|
|
|
MODIFIED: LoggingConfigBuilder is now Deserialize
|
|
|
|
|
2022-04-04 15:27:51 +01:00
|
|
|
### tor-basic-util
|
|
|
|
|
|
|
|
MODIFIED: Added `reset()` method to RetrySchedule.
|
|
|
|
|
2022-04-07 15:01:19 +01:00
|
|
|
### tor-chanmgr
|
|
|
|
|
|
|
|
BREAKING: Added members to `Error::Proto`
|
2022-04-07 15:43:04 +01:00
|
|
|
BREAKING: Added `ChanProvenance` to `ChanMgr::get_or_launch`.
|
2022-04-07 15:01:19 +01:00
|
|
|
|
2022-03-31 19:51:02 +01:00
|
|
|
### tor-circmgr
|
2022-04-02 17:01:20 +01:00
|
|
|
|
2022-03-31 19:51:02 +01:00
|
|
|
MODIFIED: Added a new variant in tor_circmgr::Error.
|
2022-04-12 14:04:10 +01:00
|
|
|
BREAKING: Made internal scheduled entry points non-public.
|
2022-04-02 20:48:41 +01:00
|
|
|
|
2022-04-25 12:32:23 +01:00
|
|
|
### tor-dirmgr
|
|
|
|
|
|
|
|
BREAKING: AuthorityBuilder::build now throws ConfigBuildError, not a custom error type
|
2022-04-26 15:19:52 +01:00
|
|
|
BREAKING: DownloadSchedule::new() replaced with DownloadScheduleBuilder
|
|
|
|
BREAKING: DownloadScheduleConfigBuilder now has accessors for the schedules, not setters
|
2022-04-26 15:28:02 +01:00
|
|
|
BREAKING: DirMgrCfg: schedule and network fields rename (`_config` removed)
|
2022-04-25 12:32:23 +01:00
|
|
|
|
2022-04-07 21:03:25 +01:00
|
|
|
### tor-guardmgr
|
|
|
|
|
2022-04-26 16:20:08 +01:00
|
|
|
BREAKING: FallbackDirBuilder::orport() removed, and orports() now gives &mut SocketAddrListBuilder
|
2022-04-07 21:03:25 +01:00
|
|
|
MODIFIED: New functions to get estimated clock skew.
|
|
|
|
MODIFIED: New functions to report observed clock skew.
|
2022-05-04 16:19:09 +01:00
|
|
|
BREAKING: Guard restriction builder interface changed to new list builder API.
|
2022-04-07 21:03:25 +01:00
|
|
|
|
2022-04-25 20:39:26 +01:00
|
|
|
### tor-llcrypto
|
|
|
|
|
|
|
|
BREAKING: AES implementations now implement cipher 0.4 traits.
|
|
|
|
|
2022-04-06 20:29:24 +01:00
|
|
|
### tor-proto
|
|
|
|
|
|
|
|
MODIFIED: New accessors in tor_proto::Channel.
|
2022-04-07 15:01:19 +01:00
|
|
|
BREAKING: Removed clock skew from Error::HandshakeCertsExpired.
|
2022-04-07 21:03:25 +01:00
|
|
|
MODIFIED: New functions on ClockSkew.
|
2022-04-06 20:29:24 +01:00
|
|
|
|
2022-04-02 20:48:41 +01:00
|
|
|
### tor-rtmock
|
|
|
|
|
|
|
|
MODIFIED: Added add_blackhole to MockNetwork.
|
|
|
|
|
2022-04-05 15:48:51 +01:00
|
|
|
### tor-socksproto
|
|
|
|
|
|
|
|
BREAKING: Removed some unused accessors.
|
2022-04-25 18:31:06 +01:00
|
|
|
|
2022-04-25 18:18:28 +01:00
|
|
|
### tor-config
|
|
|
|
|
2022-05-04 16:38:08 +01:00
|
|
|
MODIFIED: New facilities for lists in builders (list_builder module, etc.)
|
|
|
|
MODIFIED: New macro macro_first_nonempty
|