Package: bonbast
Bonbastbonbast.comoffers accurate and reliable gold prices and IRR exchange rates for businesses.
Bonbast is the most accurate and reputable foreign exchange trading data collector of the Iranian market.I don't alter any of the data in this tool; it all comes from bonbast. The sole purpose of this tool is to offer a
different method of obtaining bonbast prices.ContentsInstallationBrewPythonArch Linux (AUR)RaycastUsageCommand LineMain modeLiveSimpleCurrencyHistoryGraphConvertJson OutputPretty Print JsonList of supported currenciesUsage in other programsMac ShortcutsRaycastDevelopmentInstallationBrewbrew install samadipour/bonbast/bonbastorbrew tap samadipour/bonbast
brew update
brew install bonbastPythonTo install this program, you can to use pip:$pipinstallbonbast# Or$python-mpipinstallbonbastThen you can use it:$bonbast# Or$python-mbonbastAlso, to update the program, you can use pip:pipinstall-Ubonbast#orpython-mpipinstall-UbonbastArch Linux (AUR)To install the package on Arch Linux or any Arch-based distro, you can use any AUR (Arch User Repository) package manager, such asyayorparu:yay-Spython-bonbastor manually build the package from the AUR source:gitclonehttps://aur.archlinux.org/python-bonbast.gitcdpython-bonbast
makepkg-siThe package is available in theArch User Repository.UsageI tried my best to display the price data in a variety of ways that would be useful in a variety of circumstances.Command LineMain modeThis will be the default mode if you run the program without any arguments. It will show the current prices for gold,
coins, and the IRR exchange rate in separate tables.LiveIn live mode, the program tries to update the prices in a specified interval. This is useful if you want to keep an eye
on the prices.The website updates the prices every 30 seconds and the default value is 30 seconds as well. You can change this value
by using the-ior--intervalargument.SimpleIn this mode, the program will show the prices as text in the terminal.$bonbastlivesimple--show-onlyusd,eur,gbp,cad-i300# Or$python-mbonbastlivesimple--show-onlyusd,eur,gbp,cad-i300CurrencyIn this mode, the program will show the prices in a table. It can only show one currency at a time.$bonbastlivecurrency--show-onlyusd,eur,gbp,cad-i300# Or$python-mbonbastlivecurrency--show-onlyusd,eur,gbp,cad-i300HistoryThis is useful if you want to see the prices for a specific date. You can use the-dor--dateargument to specify
the date. The date must be in the formatYYYY-MM-DDorYYYY/MM/DD. Also, the date needs to be Gregorian.The date is valid from 2012-10-09 to one day before the current date.$bonbasthistory--date2020/10/10# Or$python-mbonbasthistory--date2020/10/10GraphThis is useful if you want to see the price of a currency in a specific date range. You can use the--start-dateargument to specify the start date and--end-datefor the end date. The date must be in the formatYYYY-MM-DDorYYYY/MM/DD. Also, the date needs to be Gregorian.If start or end date is not specified, the end date will default to today and the start date will be set to 30 days prior
to the end date.The date is valid from 2012-10-09 to one day before the current date.$bonbastgrapheur
$bonbastgrapheur--start-date2023-01-02
$bonbastgrapheur--start-date2023-02-12--end-date2023-05-09# Or$python-mbonbastgrapheurConvertThis is useful if you want to convert a value from one currency to Rial or from Rial to another currency.
If you want to convert from a currency to Rial, you need to use-sor--sourceargument to specify the currency you
want to convert from.$bonbastconvert-sEUR12.5# Or$python-mbonbastconvert-sEUR12.5If you want to convert from Rial to another currency, you need to use the-dor--destinationargument to specify
the currency you want to convert to.$bonbastconvert-dUSD1837850# Or$python-mbonbastconvert-dUSD1837850You can also use--only-buyor--only-sellto specify which price you want to use.$bonbastconvert-dUSD1837850--only-buy
$bonbastconvert-dUSD1837850--only-sell# Or$python-mbonbastconvert-dUSD1837850--only-buy
$python-mbonbastconvert-dUSD1837850--only-sellJson OutputIt can be useful if you want to use the result of the program in another program. You can also pipe the output in
terminal to another program likeJQ.$bonbastexport# Or$python-mbonbastexportPretty Print JsonThere is also a way to pretty print the json output. You can use the--prettyargument to do that. It helps to see the
output in a more readable way.$bonbastexport--pretty# Or$python-mbonbastexport--prettyList of supported currenciesFlagCurrencyCode🇺🇸US DollarUSD🇪🇺EuroEUR🇬🇧British PoundGBP🇨🇭Swiss FrancCHF🇨🇦Canadian DollarCAD🇦🇺Australian DollarAUD🇸🇪Swedish KronaSEK🇳🇴Norwegian KroneNOK🇷🇺Russian RubleRUB🇹🇭Thai BahtTHB🇸🇬Singapore DollarSGD🇭🇰Hong Kong DollarHKD🇦🇿Azerbaijani ManatAZN🇦🇲10 Armenian DramAMD🇩🇰Danish KroneDKK🇦🇪UAE DirhamAED🇯🇵10 Japanese YenJPY🇹🇷Turkish LiraTRY🇨🇳Chinese YuanCNY🇸🇦Saudi RiyalSAR🇮🇳Indian RupeeINR🇲🇾Malaysian RinggitMYR🇦🇫Afghan AfghaniAFN🇰🇼Kuwaiti DinarKWD🇮🇶100 Iraqi DinarIQD🇧🇭Bahraini DinarBHD🇴🇲Omani RialOMR🇶🇦Qatari RialQARUsage in other programsThere are few ways to use the program in other programs. The best way is to use the json output.Mac ShortcutsYou can use the json output or the convert function to create a shortcut in Mac. You can use the shortcut to show the
currency price as a notification.RaycastRaycast is a tool for searching your Mac, launching applications, and controlling your computer, and it is far superior
to Spotlight. You can use the json output to create a script command in Raycast. In this way, you can easily access the
prices in Raycast.I included an example script command in theraycastfolder. You can use it to create your own script.Setup for RaycastYou can use thissetup-raycast.shscript to setup the script command in Raycast. Then Follow the instructions in below image or read Raycast docs.$chmod+xsetup-raycast.sh

$./setup-raycast.shstandalone
or
$./setup-raycast.shpythonor manually:Enable the script command in Raycast.Copybonbast.shfile to the Raycastscript-commandsfolder.Follow the instructions below or read Raycast docs.DevelopmentSetupClone the repoInstall the dependenciesRun it with pythongitclonehttps://github.com/SamadiPour/bonbast.gitcdbonbast
pipinstall.
python-msrc.bonbast.mainBuilding the packageInstall build dependenciesBuild the packageinstall it locally if you want (or you can uselocal_installscript)python-mpipinstall".[build]"python-mbuild
python-mpipinstalldist/*.whl