comfund 0.1.1

A WCF-like framework for defining service contracts.
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
69
70
71
72
73
74
75
76
77

//! # `comfund`: WCF-like Service Contracts in Rust
//!
//! Ever stumbled upon the routine of setting up/modyfying endpoints for your REST Api
//! for both Rust client and Rust server code? Then `comfund` is what you need.
//!
//! Define your service contracts in one place and use auto generated clients
//! and server services accordingly.
//!
//! ## How does it work
//!
//! The cornerstone of `comfund` is a [`#[contract]`](contract) attribute proc macro,
//! that generates feature-gated client and server code, that will be depent on by consuming front- and back-end.
//!
//! As both client and server code are generated from the same place,
//! synchronization of endporint URLs, methods, parameters, etc. is guaranteed.
//! And only one place in code should be modified manually, if needed.

pub use comfund_macros::contract;
pub use serde;

#[cfg(any(feature = "reqwest"))]
pub use paths;

#[cfg(feature = "reqwest")]
pub use reqwest_exports::*;

#[cfg(feature = "actix-web")]
pub use actix_web;

#[cfg(feature = "axum")]
pub use axum;

#[cfg(feature = "reqwest")]
mod reqwest_exports {
    pub use reqwest;

    #[derive(Debug)]
    pub enum ClientError {
        PathSerializerError(paths::path_serializer::Error),
        Reqwest(reqwest::Error),
    }

    impl From<reqwest::Error> for ClientError {
        fn from(value: reqwest::Error) -> Self {
            Self::Reqwest(value)
        }
    }

    impl From<::paths::path_serializer::Error> for ClientError {
        fn from(value: ::paths::path_serializer::Error) -> Self {
            Self::PathSerializerError(value)
        }
    }
}

#[cfg(feature = "reqwest")]
pub type Result<T> = std::result::Result<T, ClientError>;

#[macro_export]
macro_rules! reexport {
    ($($comfund_crate:ident)::*) => {
        #[cfg(feature = "serde")]
        pub use $($comfund_crate)::*::serde;

        #[cfg(feature = "reqwest")]
        pub use $($comfund_crate)::*::reqwest;

        #[cfg(feature = "actix-web")]
        pub use $($comfund_crate)::*::actix_web;

        #[cfg(feature = "axum")]
        pub use $($comfund_crate)::*::axum;
    };
    () => {
        reexport!(comfund)
    }
}