stac_async/
lib.rs

1//! Asynchronous I/O for [STAC](https://stacspec.org/), built on [stac-rs](https://github.com/stac-utils/stac-rs)
2//!
3//! ⚠️ This crate is deprecated, use [stac](https://crates.io/crates/stac) instead.
4
5#![deprecated = "use `stac` instead of `stac-async`, which is deprecated and will receive no further updates"]
6#![cfg_attr(docsrs, feature(doc_auto_cfg))]
7#![deny(
8    elided_lifetimes_in_paths,
9    explicit_outlives_requirements,
10    keyword_idents,
11    macro_use_extern_crate,
12    meta_variable_misuse,
13    missing_abi,
14    missing_debug_implementations,
15    missing_docs,
16    non_ascii_idents,
17    noop_method_call,
18    rust_2021_incompatible_closure_captures,
19    rust_2021_incompatible_or_patterns,
20    rust_2021_prefixes_incompatible_syntax,
21    rust_2021_prelude_collisions,
22    single_use_lifetimes,
23    trivial_casts,
24    trivial_numeric_casts,
25    unreachable_pub,
26    unsafe_code,
27    unsafe_op_in_unsafe_fn,
28    unused_crate_dependencies,
29    unused_extern_crates,
30    unused_import_braces,
31    unused_lifetimes,
32    unused_qualifications,
33    unused_results,
34    warnings
35)]
36
37mod api_client;
38mod client;
39mod error;
40mod io;
41
42pub use {
43    api_client::ApiClient,
44    client::Client,
45    error::Error,
46    io::{read, read_json, write_json_to_path},
47};
48
49/// Crate-specific result type.
50pub type Result<T> = std::result::Result<T, Error>;
51
52#[cfg(test)]
53use tokio_test as _; // used for doc tests
54
55// From https://github.com/rust-lang/cargo/issues/383#issuecomment-720873790,
56// may they be forever blessed.
57#[cfg(doctest)]
58mod readme {
59    macro_rules! external_doc_test {
60        ($x:expr) => {
61            #[doc = $x]
62            extern "C" {}
63        };
64    }
65
66    external_doc_test!(include_str!("../README.md"));
67}