captcha-a

a captcha library for rust

| | --- | --- | --- | |

Usage

Add this to your Cargo.toml:

toml [dependencies] captcha-a = "0.1.5"

or with base64 feature, if you need base64_url

toml [dependencies] captcha-a = { version ="0.1.5", features = ["base64"] }

code example

```rust use captcha_a::{CaptchaBuilder, Font};

fn main() { //load fonts let fonts = vec![ Font::tryfrombytes(includebytes!("./fonts/captcha0.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha1.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha2.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha3.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha4.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha5.ttf")).unwrap(), ]; let builder = CaptchaBuilder { //custom attribute width: 120, height: 40, length: 4, fonts: &fonts, //default attribute ..Default::default() }; for i in 0..6 { let savepath = format!("image{}.png", i); //each save build and save a new image let phrase = builder.save(&savepath).unwrap(); println!("[{}]phrase={}", i, phrase); } let captcha = builder.build().unwrap(); //require base64 feature let base64url = captcha.base64url(); println!("base64: phrase={}\n{}", captcha.phrase, base64url); } ```

use with actix-web example

```rust use actixweb::{ http::header, web::{self, Json}, App, CustomizeResponder, HttpServer, Responder, }; use captchaa::{Captcha, CaptchaBuilder, Font, ImageResult}; use serde::Serialize;

///define a struct to hold fonts pub struct CaptchaService { pub fonts: Vec>, } ///default impl impl Default for CaptchaService { fn default() -> Self { //load fonts Self { fonts: vec![ Font::tryfrombytes(includebytes!("./fonts/captcha0.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha1.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha2.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha3.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha4.ttf")).unwrap(), Font::tryfrombytes(includebytes!("./fonts/captcha5.ttf")).unwrap(), ], } } } //add build function impl CaptchaService { pub fn build_captcha(&self) -> ImageResult { let builder = CaptchaBuilder { //custom attribute width: 150, height: 40, fonts: &self.fonts, //default attribute ..Default::default() }; builder.build() } }

///show captcha handler

[actix_web::get("/img")]

async fn captchashow(captchaservice: web::Data) -> CustomizeResponder> { let captcha = captchaservice .buildcaptcha() .expect("build captcha failed"); //todo save captcha code in database or session println!("captcha code={}", captcha.phrase); let captchadata = captcha.rawdata; captchadata .customize() .insertheader((header::CONTENT_TYPE, "image/png")) }

///api response

[derive(Serialize)]

pub struct ApiResponse { pub image_url: String, }

///use json with base64 data url handler

[actix_web::get("/img-api")]

async fn captchajson(captchaservice: web::Data) -> Json { let captcha = captchaservice .buildcaptcha() .expect("build captcha failed"); //todo save captcha code in database or session println!("captcha code={}", captcha.phrase); let resp = ApiResponse { imageurl: captcha.base64url(), }; Json(resp) }

[actix_web::main]

async fn main() -> std::io::Result<()> { //share service in handlers let captchaservice = web::Data::new(CaptchaService::default()); println!("server run at: 127.0.0.1:8080"); HttpServer::new(move || { App::new() .service(captchashow) .service(captchajson) //use appdata here .appdata(captchaservice.clone()) }) .bind(("127.0.0.1", 8080))? .run() .await } ```