actix-web-location 0.5.0

A extensible crate to provide location determination for actix-web, using GeoIP or other techniques
Documentation 
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

//! Location determination for Actix Web applications.

#![warn(missing_docs)]
#![forbid(unsafe_code)]

/* This is a mess, but it makes the rest of the crate tidier. Only include this
 * modules and uses if exactly one of v3 or v4 is specified. */

#[cfg(any(
    all(feature = "actix-web-v3", not(feature = "actix-web-v4")),
    all(not(feature = "actix-web-v3"), feature = "actix-web-v4")
))]
mod domain;
#[cfg(any(
    all(feature = "actix-web-v3", not(feature = "actix-web-v4")),
    all(not(feature = "actix-web-v3"), feature = "actix-web-v4")
))]
mod error;
#[cfg(any(
    all(feature = "actix-web-v3", not(feature = "actix-web-v4")),
    all(not(feature = "actix-web-v3"), feature = "actix-web-v4")
))]
mod extractors;
#[cfg(any(
    all(feature = "actix-web-v3", not(feature = "actix-web-v4")),
    all(not(feature = "actix-web-v3"), feature = "actix-web-v4")
))]
pub mod providers;

#[cfg(any(
    all(feature = "actix-web-v3", not(feature = "actix-web-v4")),
    all(not(feature = "actix-web-v3"), feature = "actix-web-v4")
))]
pub use crate::{domain::Location, error::Error, extractors::LocationConfig, providers::Provider};

/* The two stanzas below provide nicer error messages if not exactly one of v3
 * and v4 are enabled. They aren't hard errors so that this crate's CI still
 * works, but because nothing will be defined above it will be a hard error for
 * any downstream crates. This provides a nicer message to debug what's happening.
 * It uses deprecation notices because this is the only way to generate compiler
 * warnings.
 * */

/* If both v3 and v4 are enabled at the same time, generate a compiler warning. */
#[cfg(all(feature = "actix-web-v3", feature = "actix-web-v4"))]
mod warning {
    #![allow(dead_code)]

    #[deprecated(
        note = "Only one of actix-web-v3 and actix-web-v4 can be used at once. This entire crate will be disabled."
    )]
    fn actix_web_location_must_specify_one_version_of_actix_web() {}
    fn trigger_warning() {
        actix_web_location_must_specify_one_version_of_actix_web()
    }
}

/* If neither v3 or v4 are enabled at the same time, generate a compiler warning. */
#[cfg(not(any(feature = "actix-web-v3", feature = "actix-web-v4")))]
mod warning {
    #![allow(dead_code)]

    #[deprecated(note = "Exactly of actix-web-v3 or actix-web-v4 must be specified")]
    fn actix_web_location_must_specify_one_version_of_actix_web() {}
    fn trigger_warning() {
        actix_web_location_must_specify_one_version_of_actix_web()
    }
}