ic-captcha 0.1.0

Generating CAPTCHAs with given random bytes for the Internet Computer.
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
78
79
80
81
82
83
84
85
86
87

# ic-captcha

![License](https://img.shields.io/crates/l/ic-captcha.svg)
[![Crates.io](https://img.shields.io/crates/d/ic-captcha.svg)](https://crates.io/crates/ic-captcha)
[![Codecov](https://codecov.io/gh/ldclabs/ic-captcha/branch/main/graph/badge.svg)](https://codecov.io/gh/ldclabs/ic-captcha)
[![CI](https://github.com/ldclabs/ic-captcha/actions/workflows/ci.yml/badge.svg)](https://github.com/ldclabs/ic-captcha/actions/workflows/ci.yml)
[![Docs.rs](https://img.shields.io/docsrs/ic-captcha?label=docs.rs)](https://docs.rs/ic-captcha)
[![Latest Version](https://img.shields.io/crates/v/ic-captcha.svg)](https://crates.io/crates/ic-captcha)

**ic-captcha** is a library that generating CAPTCHAs with given random bytes for the Internet Computer.

It is inspired by [captcha-rs](https://github.com/samirdjelal/captcha-rs).

## Usage

See examples and the [API documentation] for more.

### Using mode method

| ![captcha-mode-0.jpeg](images/captcha-mode-0.jpeg) | ![captcha-mode-0.jpeg](images/captcha-mode-1.jpeg) | ![captcha-mode-0.jpeg](images/captcha-mode-2.jpeg) |
| -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- |
| CaptchaBuilder::new().mode(0)                      | CaptchaBuilder::new().mode(1)                      | CaptchaBuilder::new().mode(2)                      |

### Using complexity method

| ![captcha-complexity-1.jpeg](images/captcha-complexity-1.jpeg) | ![captcha-complexity-5.jpeg](images/captcha-complexity-5.jpeg) | ![captcha-complexity-10.jpeg](images/captcha-complexity-10.jpeg) |
| -------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------- |
| CaptchaBuilder::new().complexity(1)                            | CaptchaBuilder::new().complexity(5)                            | CaptchaBuilder::new().complexity(10)                             |

### Using compression

| ![captcha-compression-10.jpeg](images/captcha-compression-10.jpeg) | ![captcha-compression-40.jpeg](images/captcha-compression-40.jpeg) | ![captcha-compression-80.jpeg](images/captcha-compression-80.jpeg) |
| ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ |
| captcha.to_base64(10)                                              | captcha.to_base64(40)                                              | captcha.to_base64(80)                                              |

## Example

Add the following dependency to the Cargo.toml file:

```toml
[dependencies]
ic-captcha = "0.2"
```

And then get started in your `main.rs`:

```rust
use ic_captcha::CaptchaBuilder;

fn main() {
    {
        let builder = CaptchaBuilder::new();

        let captcha = builder.generate(b"random seed 0", None);
        println!("text: {}", captcha.text());
        println!("base_img: {}", captcha.to_base64(0));

        let captcha = builder.generate(b"random seed 1", None);
        println!("text: {}", captcha.text());
        println!("base_img: {}", captcha.to_base64(0));
    }

    {
        // same as default
        let builder = CaptchaBuilder::new()
            .length(4)
            .width(140)
            .height(60)
            .mode(1)
            .complexity(4);

        let captcha = builder.generate(b"random seed 0", None);
        println!("text: {}", captcha.text());
        println!("base_img: {}", captcha.to_base64(30));
    }
}

```

[API documentation]: https://docs.rs/ic-captcha

## License

Copyright © 2024-present [LDC Labs](https://github.com/ldclabs).

`ldclabs/ic-captcha` is licensed under either of <a href="LICENSE-APACHE">Apache License, Version
2.0</a>.