Skip to main content

a library to retrieve data from fipiran.ir website

Project description

An async python library to fetch data from https://www.fipiran.com/ .

Note: This is package is incomplete and still in initial development phase. The API may change without deprecation.

Installation

Requires Python 3.12+.

$ pip install fipiran

Usage

import asyncio
from fipiran.symbols import Symbol

async def main():
    company_info = await Symbol('فملی').company_info()
    print(company_info)

asyncio.run(main())

There are four modules:

  • data_service

  • funds

  • symbols

  • codal

Use an asyncio-aware REPL, like python -m asyncio, to run the code samples below.

Example 1:

>>> from fipiran.symbols import Symbol
>>> await Symbol('فملی').company_info()
{'نام نماد': 'فملی',
 'نام شرکت': 'ملی صنایع مس ایران',
 'مدیر عامل': 'اردشیر سعدمحمدی',
 'تلفن': '021-88724410',
 'فکس': '021-88729014',
 'آدرس': 'مجتمع مس سرچشمه و مجتمع مس میدوک در استان کرمان و مجتمع مس سونگون در تبریز شهرستان ورزقان واقع شده اند.',
 'وب سایت': 'www.nicico.com',
 'ایمیل': 'office@nicico.com',
 'سال مالی': '12/29',
 'موضوع فعالیت': 'اکتشافات،  استخراج و  بهره برداری از معادن  مس  ایران'}

Example 2:

Getting list of funds as a pandas DataFrame object.

>>> from fipiran.funds import funds
>>> await funds()
     regNo                                  name  ...      isCompleted  fundWatch
0    11726                        جسورانه فیروزه  ...         True       None
1    11603              جسورانه فناوری بازنشستگی  ...         True       None
2    11780                    گروه زعفران سحرخیز  ...         True       None
3    11772                      طلای سرخ نو ویرا  ...         True       None
4    11480                 جسورانه یکم آرمان آتی  ...         True       None
..     ...                                   ...  ...          ...        ...
308  11916                    با درآمد ثابت آریا  ...        False       None
309  11922                      آوای تاراز زاگرس  ...        False       None
310  11927                    صندوق در صندوق صنم  ...        False       None
311  11931  اختصاصی بازارگردانی توسعه سهام عدالت  ...        False       None
312  11933       اختصاصی بازارگردانی تثبیت پاداش  ...        False       None
[313 rows x 37 columns]

There are many other functions and methods. Please explore the code-base for more info.

If you are interested in other information that are available on fipiran.com but this library has no API for, please open an issue for them on github.

See also

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

fipiran-0.23.1.tar.gz (20.9 kB view details)

Uploaded Source

Built Distribution

fipiran-0.23.1-py3-none-any.whl (20.6 kB view details)

Uploaded Python 3

File details

Details for the file fipiran-0.23.1.tar.gz.

File metadata

  • Download URL: fipiran-0.23.1.tar.gz
  • Upload date:
  • Size: 20.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for fipiran-0.23.1.tar.gz
Algorithm Hash digest
SHA256 8d382482f772d86b414607908f962e8ecc164b9ce2fac9fddb0eb060c5ed7fbc
MD5 16f62548c87d1bb2a4ead6a002ed386c
BLAKE2b-256 2d3332c33ef05634700190c3bfd645a8fdad1753b7d59509477158825c70c06a

See more details on using hashes here.

File details

Details for the file fipiran-0.23.1-py3-none-any.whl.

File metadata

  • Download URL: fipiran-0.23.1-py3-none-any.whl
  • Upload date:
  • Size: 20.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for fipiran-0.23.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6843cd280b091a33b98cbb4f8d1fdacfe6491b2873dea45082280be1a62a3b7d
MD5 87b2e9b500b8e3c61cae82a52a3d104c
BLAKE2b-256 f51ad6ecaf5bcf3b396923fa0cefe39e21e3a78d9d3e87ea682918f1e64b1c0c

See more details on using hashes here.

Supported by

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