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).

View on GitHub | View on PyPI

---

Installation

pip install InnoCaptcha

Quick Start

Image CAPTCHA Generation

Generate custom image-based CAPTCHA with configurable text, colors, size, and fonts.

from InnoCaptcha.image import generate_captcha

# Generate a simple CAPTCHA and save it to the current directory
result = generate_captcha("A1b2C3")
print(result)  # {'file_path': '/current/path/captcha.png', 'chars': 'A1b2C3'}

# Save to a specific folder with custom colors and size
result = generate_captcha(
    chars="7Xk9P",
    path="/tmp/captchas",
    format="png",
    bg_color=(255, 255, 255),      # white background
    fg_color=(50, 150, 200),        # blue text
    width=240,
    height=80
)

---

generate_captcha()

Parameter Type Default Description chars str required The text to render in the CAPTCHA image. path str or None None Directory where the image will be saved. If None, saves to the current working directory. format str 'png' Image format (e.g., 'png', 'jpeg', 'gif'). bg_color tuple of 3 int (RGB) or None random light color Background color. If None, a random light color is chosen. fg_color tuple of 3 or 4 int (RGB/RGBA) or None random dark color Foreground (text) color. If None, a random semi‑transparent dark color is generated. width int or None 160 Image width in pixels. If None, uses default (160). height int or None 60 Image height in pixels. If None, uses default (60). fonts list of font paths or None built‑in fonts List of TrueType font file paths to use for text rendering. font_sizes tuple of int or None (42, 50, 56) Font sizes to randomly pick from.

Returns a dictionary:

{
    'file_path': str,   # full path to the saved image file
    'chars': str        # the original text that was rendered
}

---

Additional Functions

· generate_captcha_image(chars, ...) – returns a PIL.Image object instead of saving it. · generate_captcha_bytes(chars, ...) – returns an in‑memory bytes buffer of the image (useful for serving directly over HTTP).

Example using generate_captcha_bytes:

from InnoCaptcha.image import generate_captcha_bytes
from flask import send_file

buffer = generate_captcha_bytes("XyZ12")
return send_file(buffer, mimetype='image/png')

---

Notes

· All CAPTCHA images include random distortions (curve, dots, character warping) and anti‑aliasing for better security. · The module uses secrets for cryptographically strong randomness. · For advanced customization, you can pass your own fonts (list of .ttf file paths) and fine‑tune rendering via the module‑level constants (CHARACTER_OFFSET_DX, WORD_SPACE_PROBABILITY, etc.).

Requirements

· Python 3.9 or later (uses standard library zoneinfo; for Python 3.8 you may need the backports.zoneinfo package).

---

License

MIT - InnoSoft Company