Skip to content

Commit 9adb66f

Browse files
authored
meta: Streamline Cargo.toml and README files (#219)
* All the `Cargo.toml` files should have the same structure. * README files should have the same structure. * Streamline versions and dev-dependencies. * Remove the DSN from the examples.
1 parent 0a361de commit 9adb66f

File tree

47 files changed

+305
-241
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

47 files changed

+305
-241
lines changed

README.md

Lines changed: 88 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -5,41 +5,103 @@
55
<br />
66
</p>
77

8-
# Sentry Rust
8+
# Sentry SDK for Rust
99

1010
[![Build Status](https://travis-ci.com/getsentry/sentry-rust.svg?branch=master)](https://travis-ci.com/getsentry/sentry-rust)
11-
[![Crates.io](https://img.shields.io/crates/v/sentry.svg?style=flat)](https://crates.io/crates/sentry)
12-
13-
This workspace contains various crates that provide support for logging events
14-
and errors / panics to the [Sentry](https://sentry.io/) error logging service.
15-
16-
- [sentry](./sentry) The main `sentry` crate aimed at application users that
17-
want to log events to sentry.
18-
- [sentry-actix](./sentry-actix) An integration for the `actix-web (0.7)`
19-
framework.
20-
- [sentry-core](./sentry-core) The core of `sentry`, which can be used to
21-
instrument code, and to write integrations that generate events or hook into
22-
event processing.
23-
- [sentry-types](./sentry-types) Contains types for the Sentry v7 protocol as
24-
well as other common types.
25-
26-
**Note**: Until the _1.0_ release, the crates in this repository are considered work in
27-
progress and do not follow semver semantics. Between minor releases, we might
28-
occasionally introduce breaking changes while we are exploring the best API and
29-
adding new features.
11+
12+
This workspace contains various crates that provide support for logging events and errors / panics to the
13+
[Sentry](https://sentry.io/) error logging service.
14+
15+
- [sentry](./sentry) [![crates.io](https://img.shields.io/crates/v/sentry.svg)](https://crates.io/crates/sentry)
16+
[![docs.rs](https://docs.rs/sentry/badge.svg)](https://docs.rs/sentry)
17+
18+
The main `sentry` crate aimed at application users that want to log events to sentry.
19+
20+
- [sentry-actix](./sentry-actix)
21+
[![crates.io](https://img.shields.io/crates/v/sentry-actix.svg)](https://crates.io/crates/sentry-actix)
22+
[![docs.rs](https://docs.rs/sentry-actix/badge.svg)](https://docs.rs/sentry-actix)
23+
24+
An integration for the `actix-web (0.7)` framework.
25+
26+
- [sentry-anyhow](./sentry-anyhow)
27+
[![crates.io](https://img.shields.io/crates/v/sentry-anyhow.svg)](https://crates.io/crates/sentry-anyhow)
28+
[![docs.rs](https://docs.rs/sentry-anyhow/badge.svg)](https://docs.rs/sentry-anyhow)
29+
30+
An integration for `anyhow` errors.
31+
32+
- [sentry-backtrace](./sentry-backtrace)
33+
[![crates.io](https://img.shields.io/crates/v/sentry-backtrace.svg)](https://crates.io/crates/sentry-backtrace)
34+
[![docs.rs](https://docs.rs/sentry-backtrace/badge.svg)](https://docs.rs/sentry-backtrace)
35+
36+
A utility crate that creates and processes backtraces.
37+
38+
- [sentry-contexts](./sentry-contexts)
39+
[![crates.io](https://img.shields.io/crates/v/sentry-contexts.svg)](https://crates.io/crates/sentry-contexts)
40+
[![docs.rs](https://docs.rs/sentry-contexts/badge.svg)](https://docs.rs/sentry-contexts)
41+
42+
An integration that provides `os`, `device` and `rust` contexts.
43+
44+
- [sentry-core](./sentry-core)
45+
[![crates.io](https://img.shields.io/crates/v/sentry-core.svg)](https://crates.io/crates/sentry-core)
46+
[![docs.rs](https://docs.rs/sentry-core/badge.svg)](https://docs.rs/sentry-core)
47+
48+
The core of `sentry`, which can be used to instrument code, and to write integrations that generate events or hook
49+
into event processing.
50+
51+
- [sentry-debug-images](./sentry-debug-images)
52+
[![crates.io](https://img.shields.io/crates/v/sentry-debug-images.svg)](https://crates.io/crates/sentry-debug-images)
53+
[![docs.rs](https://docs.rs/sentry-debug-images/badge.svg)](https://docs.rs/sentry-debug-images)
54+
55+
An integration that adds a list of loaded libraries to events.
56+
57+
- [sentry-error-chain](./sentry-error-chain)
58+
[![crates.io](https://img.shields.io/crates/v/sentry-error-chain.svg)](https://crates.io/crates/sentry-error-chain)
59+
[![docs.rs](https://docs.rs/sentry-error-chain/badge.svg)](https://docs.rs/sentry-error-chain)
60+
61+
An integration for the `error-chain` crate. This is _deprecated_ and may be completely removed in the future.
62+
63+
- [sentry-failure](./sentry-failure)
64+
[![crates.io](https://img.shields.io/crates/v/sentry-failure.svg)](https://crates.io/crates/sentry-failure)
65+
[![docs.rs](https://docs.rs/sentry-failure/badge.svg)](https://docs.rs/sentry-failure)
66+
67+
An integration for the `failure` crate.
68+
69+
- [sentry-log](./sentry-log)
70+
[![crates.io](https://img.shields.io/crates/v/sentry-log.svg)](https://crates.io/crates/sentry-log)
71+
[![docs.rs](https://docs.rs/sentry-log/badge.svg)](https://docs.rs/sentry-log)
72+
73+
An integration for the `log` and `env_logger` crate.
74+
75+
- [sentry-panic](./sentry-panic)
76+
[![crates.io](https://img.shields.io/crates/v/sentry-panic.svg)](https://crates.io/crates/sentry-panic)
77+
[![docs.rs](https://docs.rs/sentry-panic/badge.svg)](https://docs.rs/sentry-panic)
78+
79+
An integration for capturing and logging panics.
80+
81+
- [sentry-slog](./sentry-slog)
82+
[![crates.io](https://img.shields.io/crates/v/sentry-slog.svg)](https://crates.io/crates/sentry-slog)
83+
[![docs.rs](https://docs.rs/sentry-slog/badge.svg)](https://docs.rs/sentry-slog)
84+
85+
An integration for the `slog` crate.
86+
87+
- [sentry-types](./sentry-types)
88+
[![crates.io](https://img.shields.io/crates/v/sentry-types.svg)](https://crates.io/crates/sentry-types)
89+
[![docs.rs](https://docs.rs/sentry-types/badge.svg)](https://docs.rs/sentry-types)
90+
91+
Contains types for the Sentry v7 protocol as well as other common types.
92+
93+
**Note**: Until the _1.0_ release, the crates in this repository are considered work in progress and do not follow
94+
semver semantics. Between minor releases, we might occasionally introduce breaking changes while we are exploring the
95+
best API and adding new features.
3096

3197
## Requirements
3298

33-
We currently only verify this crate against a recent version of Sentry hosted on
34-
[sentry.io](https://sentry.io/) but it should work with on-prem Sentry versions
35-
8.20 and later.
99+
We currently only verify this crate against a recent version of Sentry hosted on [sentry.io](https://sentry.io/) but it
100+
should work with on-prem Sentry versions 8.20 and later.
36101

37102
Additionally, the lowest Rust version we target is _1.40.0_.
38103

39104
## Resources
40105

41-
- [crates.io](https://crates.io/crates/sentry)
42-
- [Documentation](https://getsentry.github.io/sentry-rust)
43-
- [Bug Tracker](https://github.com/getsentry/sentry-rust/issues)
44106
- [Discord](https://discord.gg/ez5KZN7) server for project discussions.
45107
- Follow [@getsentry](https://twitter.com/getsentry) on Twitter for updates

sentry-actix/Cargo.toml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,15 @@ authors = ["Sentry <hello@sentry.io>"]
55
license = "Apache-2.0"
66
readme = "README.md"
77
repository = "https://github.com/getsentry/sentry-rust"
8-
homepage = "https://github.com/getsentry/sentry-rust"
9-
documentation = "https://docs.rs/sentry-actix"
8+
homepage = "https://sentry.io/welcome/"
109
description = """
11-
Sentry client extension for actix-web
10+
Sentry client extension for actix-web 0.7.
1211
"""
1312
edition = "2018"
1413

14+
[package.metadata.docs.rs]
15+
all-features = true
16+
1517
[features]
1618
default = ["with_sentry_default"]
1719
with_sentry_default = [

sentry-actix/README.md

Lines changed: 2 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -5,25 +5,6 @@
55
<br />
66
</p>
77

8-
# Sentry-Actix
8+
# Sentry SDK Integration for actix-web 0.7
99

10-
[![Build Status](https://travis-ci.org/getsentry/sentry-rust.svg?branch=master)](https://travis-ci.org/getsentry/sentry-rust)
11-
[![Crates.io](https://img.shields.io/crates/v/sentry-actix.svg?style=flat)](https://crates.io/crates/sentry-actix)
12-
13-
This is an actix-web integration for the Sentry crate.
14-
15-
## Requirements
16-
17-
We currently only verify this crate against a recent version of Sentry hosted on
18-
[sentry.io](https://sentry.io/) but it should work with on-prem Sentry versions
19-
8.20 and later.
20-
21-
Additionally, the lowest Rust version we target is _1.40.0_.
22-
23-
## Resources
24-
25-
- [crates.io](https://crates.io/crates/sentry-actix)
26-
- [Documentation](https://docs.rs/sentry)
27-
- [Bug Tracker](https://github.com/getsentry/sentry-rust/issues)
28-
- [IRC](irc://chat.freenode.net/sentry) (chat.freenode.net, #sentry)
29-
- Follow [@getsentry](https://twitter.com/getsentry) on Twitter for updates
10+
This is a Sentry extension for the `actix-web 0.7` framework.

sentry-actix/examples/basic.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ fn failing(_req: &HttpRequest) -> Result<String, Error> {
99
}
1010

1111
fn main() {
12-
let _guard = sentry::init("https://a94ae32be2584e0bbd7a4cbb95971fee@sentry.io/1041156");
12+
let _guard = sentry::init(());
1313
env::set_var("RUST_BACKTRACE", "1");
1414

1515
server::new(|| {

sentry-actix/src/lib.rs

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,10 @@
2828
//! App::new()
2929
//! .middleware(SentryMiddleware::new())
3030
//! .resource("/", |r| r.f(failing))
31-
//! }).bind("127.0.0.1:3001")
32-
//! .unwrap()
33-
//! .run();
31+
//! })
32+
//! .bind("127.0.0.1:3001")
33+
//! .unwrap()
34+
//! .run();
3435
//! }
3536
//! ```
3637
//!

sentry-anyhow/Cargo.toml

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,14 @@ authors = ["Sentry <hello@sentry.io>"]
55
license = "Apache-2.0"
66
readme = "README.md"
77
repository = "https://github.com/getsentry/sentry-rust"
8-
homepage = "https://github.com/getsentry/sentry-rust"
9-
documentation = "https://getsentry.github.io/sentry-rust"
8+
homepage = "https://sentry.io/welcome/"
109
description = """
11-
Sentry Integration for any errors.
10+
Sentry integration for anyhow.
1211
"""
1312
edition = "2018"
1413

14+
[package.metadata.docs.rs]
15+
all-features = true
1516

1617
[dependencies]
1718
sentry-core = { version = "0.18.0", path = "../sentry-core" }

sentry-anyhow/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
<p align="center">
2+
<a href="https://sentry.io" target="_blank" align="center">
3+
<img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" width="280">
4+
</a>
5+
<br />
6+
</p>
7+
8+
# Sentry SDK Integration for anyhow
9+
10+
This is a Sentry integration for the `anyhow` crate.

sentry-backtrace/Cargo.toml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,15 @@ authors = ["Sentry <hello@sentry.io>"]
55
license = "Apache-2.0"
66
readme = "README.md"
77
repository = "https://github.com/getsentry/sentry-rust"
8-
homepage = "https://github.com/getsentry/sentry-rust"
9-
documentation = "https://getsentry.github.io/sentry-rust"
8+
homepage = "https://sentry.io/welcome/"
109
description = """
11-
Sentry integration and utilities for dealing with stacktraces
10+
Sentry integration and utilities for dealing with stacktraces.
1211
"""
1312
edition = "2018"
1413

14+
[package.metadata.docs.rs]
15+
all-features = true
16+
1517
[dependencies]
1618
sentry-core = { version = "0.18.0", path = "../sentry-core" }
1719
lazy_static = "1.4.0"

sentry-backtrace/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
<p align="center">
2+
<a href="https://sentry.io" target="_blank" align="center">
3+
<img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" width="280">
4+
</a>
5+
<br />
6+
</p>
7+
8+
# Sentry SDK backtrace integration and utilities
9+
10+
Sentry integration and utilities for dealing with stacktraces.

sentry-contexts/Cargo.toml

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,16 @@ authors = ["Sentry <hello@sentry.io>"]
55
license = "Apache-2.0"
66
readme = "README.md"
77
repository = "https://github.com/getsentry/sentry-rust"
8-
homepage = "https://github.com/getsentry/sentry-rust"
9-
documentation = "https://getsentry.github.io/sentry-rust"
8+
homepage = "https://sentry.io/welcome/"
109
description = """
11-
Sentry integration for rust and device contexts
10+
Sentry integration for os, device, and rust contexts.
1211
"""
1312
build = "build.rs"
1413
edition = "2018"
1514

15+
[package.metadata.docs.rs]
16+
all-features = true
17+
1618
[dependencies]
1719
sentry-core = { version = "0.18.0", path = "../sentry-core" }
1820
libc = "0.2.66"
@@ -27,4 +29,4 @@ uname = "0.1.1"
2729
rustc_version = "0.2.3"
2830

2931
[dev-dependencies]
30-
sentry = { version = "0.18.0", path = "../sentry" }
32+
sentry = { version = "0.18.0", path = "../sentry", default-features = false, features = ["test"] }

0 commit comments

Comments
 (0)