{"id":27808,"library":"gheymat","title":"Gheymat","description":"Gheymat is a Python library for fetching currency, gold, and coin prices from Iranian markets. Version 0.3.8 requires Python >=3.7 and is actively maintained on GitHub.","status":"active","version":"0.3.8","language":"python","source_language":"en","source_url":"https://github.com/imrrobat/gheymat","tags":["currency","gold","coin","Iran","price","finance"],"install":[{"cmd":"pip install gheymat","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"HTTP requests to price APIs","package":"requests","optional":false},{"reason":"HTML parsing for some sources","package":"beautifulsoup4","optional":false}],"imports":[{"note":"get_price is a top-level function, not a method on the module.","wrong":"import gheymat","symbol":"get_price","correct":"from gheymat import get_price"}],"quickstart":{"code":"from gheymat import get_price\n\nprice = get_price('USD')\nprint(price)  # e.g., 420000","lang":"python","description":"Fetch the price of USD (Iranian toman) using default settings."},"warnings":[{"fix":"Upgrade to >=0.3.0 and use from gheymat import get_price.","message":"In version 0.3.0, the API changed from class-based to function-based. get_price replaced Gheymat().get_price().","severity":"breaking","affected_versions":"<0.3.0"},{"fix":"Wrap calls in try/except and consider caching results.","message":"The library may fail or return stale data if the source website changes its structure. Always handle exceptions.","severity":"gotcha","affected_versions":"*"},{"fix":"Use symbol='USD' instead of currency='USD'.","message":"The 'currency' parameter in older versions is replaced by 'symbol' in 0.3.0+. Check your calls.","severity":"deprecated","affected_versions":"<0.3.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run: pip install gheymat","cause":"Library not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'gheymat'"},{"fix":"Update gheymat: pip install --upgrade gheymat, then import correctly: from gheymat import get_price","cause":"Using an older version (<0.3.0) or wrong import.","error":"AttributeError: module 'gheymat' has no attribute 'get_price'"},{"fix":"Check internet connection and retry. If persistent, report at https://github.com/imrrobat/gheymat/issues","cause":"Network issue or source website changed.","error":"ConnectionError: Failed to fetch data"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}