captcha-a

a captcha library for rust

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

Usage

Add this to your Cargo.toml:

toml [dependencies] captcha-a = "0.1.3"

or with base64 feature, if you need base64_url

toml [dependencies] captcha-a = { version ="0.1.3", 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}; 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!("../../captchaexamples/fonts/captcha0.ttf")) .unwrap(), Font::tryfrombytes(includebytes!("../../captchaexamples/fonts/captcha1.ttf")) .unwrap(), Font::tryfrombytes(includebytes!("../../captchaexamples/fonts/captcha2.ttf")) .unwrap(), Font::tryfrombytes(includebytes!("../../captchaexamples/fonts/captcha3.ttf")) .unwrap(), Font::tryfrombytes(includebytes!("../../captchaexamples/fonts/captcha4.ttf")) .unwrap(), Font::tryfrombytes(includebytes!("../../captchaexamples/fonts/captcha5.ttf")) .unwrap(), ], } } }

fn buildcaptcha(captchaservice: &web::Data) -> Captcha { let builder = CaptchaBuilder { //custom attribute width: 150, height: 40, fonts: &captcha_service.fonts, //default attribute ..Default::default() }; builder.build().expect("build captcha failed") }

///show captcha handler

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

async fn captchashow(captchaservice: web::Data) -> CustomizeResponder> { let captcha = buildcaptcha(&captchaservice); //todo save captcha code in database or session println!("captcha code={}", captcha.phrase); let captchadata = Vec::from(captcha.data()); captchadata .customize() .insertheader((header::CONTENTTYPE, "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 = buildcaptcha(&captchaservice); //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()); HttpServer::new(move || { App::new() .service(captchashow) .service(captchajson) //use appdata here .appdata(captchaservice.clone()) }) .bind(("127.0.0.1", 8080))? .run() .await } ```