Privex Python Currency Converter CLI

一个用于在命令行上快速进行货币转换的小型CLI工具

官方仓库: https://github.com/Privex/python-curconv

+===================================================+
|                 © 2021 Privex Inc.                |
|               https://www.privex.io               |
+===================================================+
|                                                   |
|        Python Currency Converter CLI              |
|        License: X11/MIT                           |
|                                                   |
|        Core Developer(s):                         |
|                                                   |
|          (+)  Chris (@someguy123) [Privex]        |
|                                                   |
+===================================================+

Python Currency Converter CLI - A small CLI tool for quick currency conversions on the command line
Copyright (c) 2021    Privex Inc. ( https://www.privex.io )

快速入门

安装

# We recommend using the highest version of Python available on your system,
# check by typing 'python3.' and pushing tab (on some shells you may need to 
# press tab two or three times for tab suggestions).
python3.8 -m pip install -U privex-curconv

# If you can't use 'python3.x -m pip', then you can install using the classic 'pip3'
# command, which will generally use your system default python3 version.
pip3 install -U privex-curconv

# If you want to be able to support caching rates in both Redis and Memcached,
# install privex-curconv with the 'cache' extra:
python3.8 -m pip install -U 'privex-curconv[cache]'

# If you only want either Redis OR Memcached support, you can install with
# the appropriate extra, depending on which cache you want.
python3.8 -m pip install -U 'privex-curconv[redis]'
python3.8 -m pip install -U 'privex-curconv[memcached]'

使用工具

首先确定是否可以使用conv - 或者是否需要使用python3 -m privex.curconv

# By default, this package should install the 'conv' utility into /usr/local/bin, or ~/.local/bin
# so that you can just type the 'conv' command like so:
conv --help

# If for some reason the 'conv' command doesn't work, you can also run the CLI tool using the
# python3 module executor argument:
python3 -m privex.curconv --help

现在让我们试试看 - 应该能直接使用

获取20美元兑换英镑的汇率

conv 20 usd to gbp

如果您希望它显示x.xx USD = x.xx GBP而不是仅仅是x.xx，可以使用-f来启用“完整模式”

conv -f 20 usd to gbp

如果您希望汇率显示不同的小数位数，可以使用标志-d / -dp / --dp / --decimals

例如，-dp 5表示5位小数，因此这将输出14.48240（撰写时）

conv -dp 5 20 usd to gbp

获取所有英镑的汇率，但只显示默认的收藏货币：USD, EUR, GBP, CAD, SEK, TRY

conv 1 gbp

您也可以指定带有符号的货币金额，但可能需要引用您的查询，因为它们可能会干扰shell

conv '£20.00'
conv '$50 to CAD'
conv -f 'CA$30 to £'

如果您想为单个查询动态调整收藏货币，可以使用-c标志

conv -c AUD,NZD,CAD,HKD,CHF 5000 SEK

如果您想查看给定货币+金额的所有可用汇率，可以使用-a标志

conv -a 20 gbp

配置工具

通过系统环境动态传递ENV变量

对于单个命令，您可以传递“内联ENV变量”以仅更改该单个命令的环境

CURRENCY_LIST="CHF,CAD,AUD,BZD" DEFAULT_DP=4 CACHE_ADAPTER=redis conv -f '5 usd'

如果您想暂时更改某些设置，并让它们在几条命令中持续有效，但又不想永久更改您的配置，您可以简单地导出shell中的ENV变量，它们将一直保持，直到您关闭终端/shell或手动取消设置。

export CURRENCY_LIST="CHF,CAD,AUD,BZD"
export DEFAULT_DP=4
export CACHE_ADAPTER=redis

conv -f '5 usd'
conv -f '10.2361 eur'

unset CURRENCY_LIST
conf -f '2.4829 HKD'
unset DEFAULT_DP CACHE_ADAPTER

使用一条命令生成并创建默认的ENV文件

您可以通过运行带-Gd（G表示生成，d表示默认配置）标志的工具，在~/.curconv.env快速生成一个模板默认ENV配置文件。

user@example ~ $ conv -Gd
 >>> Generating ENV file to default location: /Users/example/.curconv.env
 +++ Successfully wrote ENV file to default location: /Users/example/.curconv.env

ENV生成命令会生成一个ENV配置，其中所有主要的支持ENV变量都设置为默认设置，除非它从环境或配置文件继承了一些配置变量。

它输出的设置是在运行命令时实际配置在内存中的设置。

所有生成的ENV变量都是可选的，因此您应该删除或注释掉您未更改默认值的任何ENV变量，以便清楚地知道哪些ENV变量已更改，哪些仍然设置为默认值。

配置搜索路径

默认情况下，该工具将按以下顺序搜索配置文件，并且它只会使用它找到的第一个文件。

• ~/.curconv
• ~/.curconv.env（-Gd输出的文件）
• /etc/curconv
• /etc/curconv.env

生成ENV文件到stdout

如果您想以ENV格式生成/转储当前配置，但又不想将其写入文件，可以使用-G单独使用，它将生成与-Gd相同的ENV配置，但输出到STDOUT而不是文件（您可以将它轻松地管道传输）。

user@example ~ $ conv -G
DEBUG=false
LOG_LEVEL=WARNING
API_BASE=https://api.ratesapi.io/api
API_CACHE_TIME=3600
CACHE_ADAPTER=sqlite
DEFAULT_DP=3
BASE_COIN=EUR
CURRENCY_LIST=USD,EUR,GBP,CAD,SEK,TRY
CUR_SYMBOLS=CA$:CAD,CAD$:CAD,AU$:AUD,AUD$:AUD,NZ$:NZD,NZD$:NZD,$:USD,€:EUR,£:GBP,kr:SEK

例如，您可以将其管道传输到sudo tee以将配置写入当前用户无法写入的文件，例如/etc/curconv.env。

conv -G | sudo tee /etc/curconv.env

生成ENV文件并将其直接输出到文件

您还可以使用-G与-Gf [file]一起使用来生成ENV文件并将其输出到您选择的文件。

注意：与-Gd不同，-Gf参数本身不工作，您必须指定-G以生成ENV配置，并使用-Gf来覆盖默认的stdout输出。

user@example ~ $ conv -G -Gf /tmp/convtest.env
 >>> Generating ENV file to custom location: /tmp/convtest.env
 +++ Successfully wrote ENV file to custom location: /tmp/convtest.env