salvo-captcha 0.1.0

A captcha middleware for Salvo framework.
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

use crate::{CaptchaDifficulty, CaptchaName, CaptchaStorage};

/// Captcha generator, used to generate a new captcha image. This trait are implemented for all [`CaptchaStorage`].
pub trait CaptchaGenerator: CaptchaStorage {
    /// Create a new captcha image and return the token and the image encoded as png. Will return None if the captcha crate failed to create the captcha.
    ///
    /// The returned captcha image is 220x110 pixels.
    ///
    /// For more information about the captcha name and difficulty, see the [`README.md`](https://github.com/TheAwiteb/salvo-captcha/#captcha-name-and-difficulty).
    fn new_captcha(
        &self,
        name: CaptchaName,
        difficulty: CaptchaDifficulty,
    ) -> impl std::future::Future<Output = Result<Option<(Self::Token, Vec<u8>)>, Self::Error>> + Send
    {
        async {
            let Some((captcha_answer, captcha_image)) =
                captcha::by_name(difficulty, name).as_tuple()
            else {
                return Ok(None);
            };

            let token = self.store_answer(captcha_answer.into()).await?;
            Ok(Some((token, captcha_image)))
        }
    }
}

impl<T> CaptchaGenerator for T where T: CaptchaStorage {}