Metadata-Version: 2.3
Name: codal-tsetmc
Version: 2.1.1
Summary: Data Downloader for Codal and Tehran stock market
License: MIT
Keywords: codal,tsetmc,stock,iran,finance,crawler
Author: Mohsen Ebrahimi
Author-email: mohsenebrahimy.ir@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: SQLAlchemy (>=2.0,<3.0)
Requires-Dist: aiohttp (>=3.8,<4.0)
Requires-Dist: aiosignal (>=1.2,<2.0)
Requires-Dist: beautifulsoup4 (>=4.11,<5.0)
Requires-Dist: html5lib (>=1.1,<2.0)
Requires-Dist: jalali-pandas (>=0.2,<0.3)
Requires-Dist: lxml (>=5.4,<6.0)
Requires-Dist: nest-asyncio (>=1.5,<2.0)
Requires-Dist: pandas (>=2.2,<3.0)
Requires-Dist: requests (>=2.25,<3.0)
Project-URL: Documentation, https://mohsenebrahimyir.github.io/codal-tsetmc/
Project-URL: Homepage, https://mohsenebrahimyir.github.io/codal-tsetmc/
Project-URL: Repository, https://github.com/mohsenebrahimyir/codal-tsetmc.git
Description-Content-Type: text/markdown

# کدال و بورس در پایتون

این پکیچ برای ذخیره داده‌های سایت کدال و بازار سرمایه برای اهداف تحلیل بنیادی تهیه شده است.

- [آموزش بسته](https://mohsenebrahimyir.github.io/codal-tsetmc/)
- [تلگرام @codal_tsetmc_package](https://t.me/codal_tsetmc_package)
- [ایتا @codal_tsetmc_package](https://eitaa.com/codal_tsetmc_package)

## هشدار

اگر این متن را میبینید یعنی این پکیج درحال توسعه است و قابلیت استفاده در پروژه‌های مهم را ندارد.

```bash
# python3 -m pip install --upgrade build
python3 -m build
```

```bash
# python3 -m pip install --upgrade twine
python3 -m twine upload --repository pypi dist/*
```

## پایگاه داده

### TSETMC

- [X] `tehran_stocks`: الهام از بسته
- [X] `stock`: لیست تمام سهام‌ها و صندوق‌ها و ...
- [X] `stock_capital`: پایگاه داده افزایش سرمایه
  - باید دقت کنیم که بعضی از افزایش سرمایه‌‌های سایت tsetmc بروز نیست و باید برای محاسبه مقدار دقیق از صورت‌های مالی شرکت‌ها استفاده کرد.
- [X] `stock_price`: قیمت و حجم معاملات روزانه
- [X] `stock_group`:

### CODAL

- [X] `company`: لیست تمام شرکت‌ها
- [X] `company_state`: وضعیت شرکت‌ها
- [X] `company_type`: نوع شرکت‌ها
- [X] `report_type`: گروه اطلاعیه‌ها
- [X] `letter_type`: نوع گزارش
- [X] `auditor`: حسابرس‌ها
- [X] `financial_year`: سال مالی‌ها
- [X] `letter`: گزارشات مالی

## نصب پکیج

برای استفاده از این بسته پیشنهاد می‌شود از محیط مجازی استفاده کنید.

```bash
python -m venv .venv
```

فعال سازی محیط مجازی در لینوکس

```bash
source .venv/bin/activate
```

فعال سازی محیط مجازی در ویندوز

```cmd
> .\venv\Scripts\activate
```

نصب از `pypi`:

```bash
pip install -U codal-tsetmc
```

نصب از نسخه در حال توسعه `github`

```bash
pip install git+https://github.com/mohsenebrahimyir/codal-tsetmc.git
```

