A professional, pluggable CAPTCHA library with image, math, and custom challenge types, token-based security, and multiple storage backends.
Project description
InnoCaptcha
🚀 Project Identity & Versioning
| Badge Type | Markdown Code |
|---|---|
| PyPI Version | |
| GitHub Release | |
| GitHub Tag | |
| License | |
| PyPI Status |
📊 Stats & Downloads
| Badge Type | Markdown Code |
|---|---|
| Total Downloads (Pepy) | |
| Monthly Downloads (Pepy) | |
| Weekly Downloads (Pepy) | |
| PyPI Downloads (Daily) | |
| PyPI Downloads (Weekly) | |
| PyPI Downloads (Monthly) |
🛠️ Activity & Development
| Badge Type | Markdown Code |
|---|---|
| Last Commit | |
| Commit Activity (Yearly) | |
| Contributors | |
| Repo Size | |
| Code Size | |
| Top Language | |
| Language Count |
✨ Quality & Testing
| Badge Type | Markdown Code |
|---|---|
| Build Status | |
| Coverage | |
| Code Quality | |
| Typing | |
| PyPI Types |
🐍 Environment & Compatibility
| Badge Type | Markdown Code |
|---|---|
| Python Versions | |
| PyPI Implementation | |
| PyPI Wheel | |
| PyPI Format |
🤝 Community & Social
| Badge Type | Markdown Code |
|---|---|
| GitHub Stars | |
| GitHub Forks | |
| GitHub Watchers | |
| GitHub Followers | |
| GitHub Discussions |
🛠️ Support & Maintenance
| Badge Type | Markdown Code |
|---|---|
| Open Issues | |
| Closed Issues | |
| Open PRs | |
| Closed PRs | |
| Milestones |
Structured Egyptian geographical and timezone data for Python.
Provides a complete, offline dataset of Egyptian governorates, cities, landline and mobile area codes, and timezone utilities — with zero dependencies (uses Python standard library only).
Installation
pip install InnoCaptcha
Quick Start
Image CAPTCHA Generation
Generate custom image-based CAPTCHA with configurable text, colors, and image dimensions.
from InnoCaptcha.image import ImageCaptcha
# Generate a simple CAPTCHA and save it to the current directory
img = ImageCaptcha()
img.create("abs")
print(img.verify("abs")) # True
img.save(r"C:\path\to\image\captcha.png")
# Use custom attributes
img = ImageCaptcha(
width=350,
height=100,
color=(255, 137, 6),
background=(15, 14, 23)
)
img.create("abc123")
print(img.verify("asd")) # False
img.save(r"C:\path\to\image\captcha.jpg")
ImageCaptcha()
Parameter Type Default Description:
- chars str required The text to render in the CAPTCHA image.
- path str Directory where the image will be saved. If None, returns an error.
- format str 'png' Image format (default).
- background tuple of 3 int (RGB) or None white color Background color.
- color tuple of 3 int (RGB) or None black color Foreground (text) color.
- width int or None 300 Image width in pixels. If None, uses default (300).
- height int or None 80 Image height in pixels. If None, uses default (80).
Notes
· All CAPTCHA images include random distortions (curve, dots) and anti‑aliasing for better security.
· The module uses secrets for cryptographically strong randomness.
· For advanced customization, you can fine‑tune the rendering behavior using module-level constants such as CHARACTER_OFFSET_DX, WORD_SPACE_PROBABILITY, and others.
Requirements
· Python 3.9 or later. · Pillow >= 10.0.0
License
MIT - InnoSoft Company
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file innocaptcha-1.0.0.tar.gz.
File metadata
- Download URL: innocaptcha-1.0.0.tar.gz
- Upload date:
- Size: 6.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
37468ea016afb805b4943cfd301e608827002a23be947fbd1f588646ee47289c
|
|
| MD5 |
19d9bdeab71b6393add1639c48efa64a
|
|
| BLAKE2b-256 |
696357447a3fb717ac78042bd7c38b38cccf2b8993f92ca20a5a8e543e6ecd73
|
File details
Details for the file innocaptcha-1.0.0-py3-none-any.whl.
File metadata
- Download URL: innocaptcha-1.0.0-py3-none-any.whl
- Upload date:
- Size: 7.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
af479022b5f327f64e85ef397eb78f83d829ad5d56bbd069e9377bbf64343767
|
|
| MD5 |
ed475a8072d5f95627fe57e01ad2343e
|
|
| BLAKE2b-256 |
a7f25a020af47dd7737b2881b3d7c920788755100698e0fa55477e0a46c18010
|