summaryrefslogtreecommitdiff
path: root/doc/semver_status.md
blob: 1123b7462685e8b1ce42850247a0930874cb5e30 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# 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.

## Since Arti 0.3.0

### arti

ADDED: ARTI_EXAMPLE_CONFIG introduced
BREAKING: ArtiConfig no longer contains a TorClientConfig

### arti-client

MODIFIED: Code to configure fs-mistrust.
BREAKING: TorConfig no longer implements TryInto<DirMgrConfig>

### arti-config

BREAKING: default_config_file moved to arti_client, and changed to return Result
GREAKING: ConfigurationSource::new_empty renamed from ::new
BREAKING: ConfigurationSource methods take Into<String> and Into<PathBuf> now
BREAKING: ARTI_DEFAULTS removed, in favour of ARTI_EXAMPLE_CONFIG in the arti crate
BREAKING: ConfigurationSource is now in the tor-config crate.
DEPRECATION: arti-config is to be abolished.  Currently it is merely an empty tombstone.

### fs-mistrust

MODIFIED: New APIs for CachedDir, Error.
BREAKING: New builder API.

### tor-dirclient

MODIFIED: new max_skew api

### tor-dirmgr

BREAKING: Added new cache_trust element to DirMgrConfig.
BREAKING: Delete Error::BadNetworkConfig

### tor-netdoc

BREAKING: Routerstatus::nickname() now returns &str, not &String.
MODIFIED: Lifetime has a valid_at() method.

### tor-persist

+BREAKING: Replaced from_path with from_path_and_mistrust

### tor-proto

MODIFIED: channel() method on ClientCirc.

### tor-rtcompat

BREAKING: Runtime now requires the Debug trait to be implemented.

### tor-config

BREAKING: impl_standard_builder macro now tries to impl new Builder trait by default
ADDED: New load module containing Resolvable, and tor_config::resolve, etc.