Privex Python 货币转换器 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 USD到GBP的汇率

conv 20 usd to gbp

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

conv -f 20 usd to gbp

如果您想要汇率的小数位数不同，您可以使用标志-d///-dp--dp--decimals

eg-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'

如果您想临时更改某些设置，并让它们在多个命令中持续存在，但不必永久更改您的配置 - 您可以简单地 EXPORT 外壳中的 ENV 变量，它们会一直存在，直到您关闭终端/外壳，或手动取消设置它们：

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 文件

~/.curconv.env您可以通过运行带有-Gd(G = generate, d = default config) 标志的工具来快速生成模板默认 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 var 都是可选的，因此您应该删除或注释掉您未更改默认值的任何 ENV var，以便清楚您更改了哪些 ENV var，哪些仍设置为默认值.

配置搜索路径

默认情况下，该工具会搜索以下位置以查找配置文件，并且只会使用它找到的第一个文件：

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

生成一个 ENV 文件到标准输出

如果您想以 ENV 格式生成/转储当前配置，但不将其写入文件，您可以单独使用-G它，这将生成相同的 ENV 配置-Gd，但将其输出到 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文件，直接输出到文件

您还可以使用-Gwith-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