Skip to main content

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 PyPI Version
GitHub Release GitHub Release
GitHub Tag GitHub Tag
License License: MIT
PyPI Status PyPI Status

📊 Stats & Downloads

Badge Type Markdown Code
Total Downloads (Pepy) Total Downloads
Monthly Downloads (Pepy) Monthly Downloads
Weekly Downloads (Pepy) Weekly Downloads
PyPI Downloads (Daily) PyPI Downloads
PyPI Downloads (Weekly) PyPI Downloads
PyPI Downloads (Monthly) PyPI Downloads

🛠️ Activity & Development

Badge Type Markdown Code
Last Commit GitHub last commit
Commit Activity (Yearly) GitHub commit activity
Contributors GitHub contributors
Repo Size GitHub repo size
Code Size GitHub code size in bytes
Top Language GitHub top language
Language Count GitHub language count

✨ Quality & Testing

Badge Type Markdown Code
Build Status Build Status
Coverage Coverage
Code Quality Code Quality
Typing Typing
PyPI Types PyPI - Types

🐍 Environment & Compatibility

Badge Type Markdown Code
Python Versions Python Versions
PyPI Implementation PyPI Implementation
PyPI Wheel PyPI Wheel
PyPI Format PyPI Format

🤝 Community & Social

Badge Type Markdown Code
GitHub Stars GitHub stars
GitHub Forks GitHub forks
GitHub Watchers GitHub watchers
GitHub Followers GitHub followers
GitHub Discussions GitHub Discussions

🛠️ Support & Maintenance

Badge Type Markdown Code
Open Issues GitHub issues
Closed Issues GitHub issues-closed
Open PRs GitHub pull requests
Closed PRs GitHub pull requests-closed
Milestones GitHub 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).

View on GitHub | View on PyPI


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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

innocaptcha-1.0.0.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

innocaptcha-1.0.0-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

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

Hashes for innocaptcha-1.0.0.tar.gz
Algorithm Hash digest
SHA256 37468ea016afb805b4943cfd301e608827002a23be947fbd1f588646ee47289c
MD5 19d9bdeab71b6393add1639c48efa64a
BLAKE2b-256 696357447a3fb717ac78042bd7c38b38cccf2b8993f92ca20a5a8e543e6ecd73

See more details on using hashes here.

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

Hashes for innocaptcha-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 af479022b5f327f64e85ef397eb78f83d829ad5d56bbd069e9377bbf64343767
MD5 ed475a8072d5f95627fe57e01ad2343e
BLAKE2b-256 a7f25a020af47dd7737b2881b3d7c920788755100698e0fa55477e0a46c18010

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page