easycv-lib 0.2.0

A convenient wrapper library for OpenCV - Simple and easy-to-use computer vision tools

EasyCV

یک کتابخانه راحت و ساده برای کار با OpenCV

نصب

نصب از PyPI

کتابخانه در PyPI منتشر شده است. برای نصب:

pip install easycv-lib

نکته: نام پکیج در PyPI easycv-lib است (چون نام easycv قبلاً گرفته شده بود)، اما بعد از نصب می‌توانید با import easycv استفاده کنید.

روش 1: نصب از پوشه پروژه (برای توسعه)

از پوشه اصلی پروژه این دستور را اجرا کنید:

pip install .

بعد از نصب، می‌توانید از هر جای سیستم از کتابخانه استفاده کنید:

import easycv.vision
easycv.vision.open_live_window()

روش 2: نصب با اسکریپت خودکار

ویندوز:

build_and_install.bat

لینوکس/Mac:

chmod +x build_and_install.sh
./build_and_install.sh

یا با Python:

python install.py

روش 3: نصب از فایل wheel (بعد از build)

اگر قبلاً کتابخانه را build کرده‌اید:

# ابتدا build کنید
python -m build

# سپس از فایل wheel نصب کنید
pip install dist/easycv-0.1.0-py3-none-any.whl

روش 4: نصب در حالت توسعه (برای توسعه‌دهندگان)

اگر می‌خواهید تغییرات را بلافاصله ببینید:

pip install -e .

نکته: برای نصب از PyPI از pip install easycv-lib استفاده کنید.

استفاده

روش 1: استفاده از ماژول (پیشنهادی)

import easycv.vision

# استفاده از توابع بدون نیاز به import جداگانه
easycv.vision.open_live_window(window_name="Live Feed", show_fps=True)

روش 2: Import مستقیم توابع

from easycv import open_live_window

open_live_window(window_name="Live Feed", show_fps=True)

روش 3: Import ماژول با نام کوتاه‌تر

from easycv import vision

vision.open_live_window(window_name="Live Feed", show_fps=True)

ساختار پروژه

easycv/
├── __init__.py          # نقطه ورود اصلی
├── vision.py            # ماژول پردازش ویدیو و دوربین
└── ...

توسعه

این پروژه در حال توسعه است و توابع به تدریج اضافه خواهند شد.