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.1.0.tar.gz (6.8 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.1.0-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file innocaptcha-1.1.0.tar.gz.

File metadata

  • Download URL: innocaptcha-1.1.0.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for innocaptcha-1.1.0.tar.gz
Algorithm Hash digest
SHA256 ee48a0efc991a0881755161480f337eefce4961094d823659dd961833518fb12
MD5 58ad70dd36b6c92c93ae398e83e019b2
BLAKE2b-256 d06bd2f14005a2f530d3f7a4b1141162ae4d32213f00a33d3d5024e2400b964f

See more details on using hashes here.

File details

Details for the file innocaptcha-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: innocaptcha-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.6 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5979a739048f01796567c0c9232cc7a3e69f8b08c243fdc0c6dbc96ee184169c
MD5 880625d02a8e3abeee28ca6d6cf7b62c
BLAKE2b-256 3948c481f55e6637b9d4e42995a587a29ecfb67691e9f68941acbd66682fd124

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