English Document | 中文文档


qs 运行

安装

点此获取安装文档
1
pip3 install quickstart-rhy [--upgrade]

qs的配置表:.qsrc

  • 自qs 0.3.0版本起,当您初次安装QuickStart_Rhy并通过命令运行qs时,qs将在如下位置生成qs的配置表.qsrc
系统位置
WindowsC:\Users\你的用户名\.qsrc
*nix/Users/你的用户名/.qsrc 或 /root/.qsrc
  • .qsrc是以json格式存储的配置表,当它初次被生成时,内容为:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
/* 文档中的注释内容在文件中不存在 */
{
"basic_settings": {
"default_language": "zh", /* !默认语言,zh表示中文,en为英文 */
"default_currency": "CNY", /* !默认币种,用于汇率换算 */
"default_translate_engine": { /* !默认语言引擎,请勿修改support */
"index": 0,
"support": ["default", "TencentCloud"]
},
"default_proxy": "用户名:密码@ip:端口 或 ip:端口" /* 设置下载代理,启用`-px`时通过代理下载 */
},
"API_settings": { /* 填入你需要用的API KEY */
"rmbg": "GET: https://www.remove.bg",
"smms": "GET: https://sm.ms",
"darksky": "GET: https://darksky.net/",
"aliyun_oss_acid": "GET: https://www.aliyun.com/product/oss",
"aliyun_oss_ackey": "GET: https://www.aliyun.com/product/oss",
"aliyun_oss_bucket_url": "GET: https://www.aliyun.com/product/oss",
"aliyun_oss_df_bucket": "GET: https://www.aliyun.com/product/oss",
"txyun_scid": "GET: https://console.cloud.tencent.com/",
"txyun_sckey": "GET: https://console.cloud.tencent.com/",
"txyun_cos_df_bucket": "GET: https://console.cloud.tencent.com/",
"txyun_df_region": "GET: ap-[location]",
"qiniu_ac_key": "GET: http://qiniu.com/",
"qiniu_sc_key": "GET: http://qiniu.com/",
"qiniu_bk_name": "GET: [Qiniu Bucket Name]",
"gitee": "GET: http://gitee.com/",
"ipinfo": "GET: https://ipinfo.io/",
"AipImageAPP_ID": "GET: https://cloud.baidu.com/product/imageprocess",
"AipImageAPP_KEY": "GET: https://cloud.baidu.com/product/imageprocess",
"AipImageSECRET_KEY": "GET: https://cloud.baidu.com/product/imageprocess",
"AipNlpAPP_ID" : "GET: https://cloud.baidu.com/product/nlp_apply",
"AipNlpAPP_KEY": "GET: https://cloud.baidu.com/product/nlp_apply",
"AipNlpSECRET_KEY": "GET: https://cloud.baidu.com/product/nlp_apply",
"commonClipboardFilePath": "GET: /Path/to/file",
"alapi_token": "GET: https://www.alapi.net/"
}
}
  • 关于默认语言:
标志语言标志语言标志语言
zh🇨🇳en🇬🇧jp🇯🇵
kor🇰🇷fra🇫🇷spa🇪🇸
th🇹🇭ara阿拉伯ru🇷🇺
pt🇵🇹de🇩🇪it🇮🇹
el🇬🇷nl🇵🇱bul🇧🇬
est🇪🇪dan🇩🇰fin🇫🇮
cs🇨🇿rom🇷🇴slo🇸🇮
swe🇸🇪hu🇭🇺vie🇻🇳
  • 关于API,某些API需要依赖官方提供的Python第三方库,但并不是每位用户都会用到它们,为了保持qs安装时的轻松畅快,qs在安装时不会将这些Python第三方库作为依赖项预先安装。因此,如果你需要使用相关的API,请在下方的API对照表中选择安装。
  • *特殊说明 1:qs的某些方便功能高度依赖alapi.net,因此你可以考虑注册成为alapi的免费用户以获得更好的使用体验。
  • *特殊说明 2:如果您在使用Mac系统,qs推荐您使用iTerm作为默认终端以获得最棒的体验。

交流与讨论


使用

命令 含义
qs u url 使用默认浏览器打开多个链接
qs a app [files] 打开应用或使用应用打开文件(仅支持Mac OS)
qs f file 使用合适的应用打开文件
qs cal exp 计算算术表达式
qs time 查看当前时间
命令 含义
qs top CPU和内存监控器
qs clear 释放本机内存
qs mktar path ... 使用多个文件或文件夹创建tar压缩包
qs untar path ... 解压各种格式的tar包
qs mkzip path ... 使用多个文件或文件夹创建zip压缩包
qs unzip path ... 解压zip压缩包
qs unrar path ... 解压rar压缩包
qs mk7z path ... 使用多个文件或文件夹创建7z压缩包
qs un7z path ... 解压7z压缩包
qs md5 path ... 获取文件的md5值
qs sha1 path ... 获取文件的sha1值
qs sha256 path ... 获取文件的sha256值
qs sha512 path ... 获取文件的sha512值
命令 含义
qs http [ip:port] [-bind url] 在当前路径下开启简单的多线程http服务
qs netinfo [url ...] 获取命令参数或剪切板中链接或ip的信息
qs wifi 扫描附近WiFi并选择连接
qs dl [urls] [--help] 从命令参数或剪切板中链接下载文件 (qs下载策略)
qs upload 上传你的pypi仓库
qs upgrade 更新qs
命令 含义
qs trans [words] 翻译命令参数或剪切板中的内容
qs pinyin [words] 查询命令参数或剪切板中的内容的拼音(words必须是中文)
qs rmbg picture 移除图片背景
qs smms picture/*.md 将图片或Markdown中图片上传至sm.ms
qs upimg -help 将图片或Markdown中图片上传至多平台(暂无需token)
qs alioss -help 获取阿里云对象存储的使用帮助
qs txcos -help 获取腾讯云对象存储的使用帮助
qs qiniu -help 获取七牛云对象存储的使用帮助
qs weather [address] 获取当地天气(或指定地址天气)
qs LG image 通过百度图像效果增强放大图片
qs nlp [words] 通过百度NLP对words或剪切板内容纠错
qs cb get/post [msg] 通过网络硬盘的本地文件系统get或post信息
qs pasteme get/post [password/content] 通过pasteme.cn获取或传递内容
qs bcv [url/video code] 获取B站视频、直播封面图片
qs gbc garbage... 中国垃圾分类查询 (仅支持中文)
qs svi url 获取命令参数或剪切板内短视频分享链接的信息
qs svd url 通过命令参数或剪切板内短视频分享链接下载视频
qs acg [-save] 获取一张acg图片链接(或保存)
qs bing [-save] 获取一张bing图片链接(或保存)
qs phi url 获取url中的图片链接 (在Mac::iTerm上自动预览)
qs kd courier-number 查询国内快递
qs loli [-save] [-p] 获取一张萝莉图片链接 [或保存(通过默认代理)]
qs setu [-save] [-p] 获取一张涩图链接 [或保存(通过默认代理)]
qs exc number currency 汇率换算,将查询的指定货币数量换算为默认币种
命令 含义
qs stbg picture to [from] 替换图片颜色(from默认为透明)
qs icat img 在终端预览图片(仅在MacOS下ITerm支持)
qs v2gif video [sz] [fps] 将视频导出为gif
qs v2mp4 video 将视频导出为mp4
qs v2mp3 video 提取视频音频为mp3
qs rmaudio video 删除视频的音频(仅返回mp4文件)

更新日志

最近(2020-02-26)

setu — 随机调用setu, acg获取图片链接

pinyin — 查询指定内容的拼音(带音标)

exc — 货币换算,将查询货币换算为设置的默认货币

2020-01-31

loli — 查看或保存萝莉图片(你需要开启梯子以访问P站)

2020-01-16
  1. kd — 查询国内快递!

  2. 下载交互优化

  3. 压缩与解压缩支持7z格式

  4. 修复bug


API

  • QuickStart-Rhy提供一些流行的在线平台的api,所以你可以用qs做令人惊奇的事情!
  • 您需要亲自到适当的网站注册,并填写所需的API密钥,以确保正确调用qs
  • 编辑的~ /.qsrc来设置你的API!

支持的 API

对照表
API官网Pypi库键值
remove bg链接“rmbg”
smms链接“smms”

Aliyun OSS

链接

oss2
“aliyun_oss_acid”
“aliyun_oss_ackey”
“aliyun_oss_df_bucket”
“aliyun_oss_bucket_url”

Qiniu OSS

链接

qiniu
“qiniu_ac_key”
“qiniu_sc_key”
“qiniu_bk_name”

Tencent COS

链接

cos-python-sdk-v5
“txyun_scid”
“txyun_sckey”
“txyun_df_region”
“txyun_cos_df_bucket”
IPinfo链接ipinfo“ipinfo”
Baidu Image
Process

链接

aip
“AipImageAPP_ID”
“AipImageAPP_KEY”
“AipImageSECRET_KEY”

Baidu NLP

链接

aip
“AipNlpAPP_ID”
“AipNlpAPP_KEY”
“AipNlpSECRET_KEY”
Tencent translate链接tencentcloud-sdk-python“txyun_scid”
“txyun_sckey”
“txyun_df_region”
alapi链接“alapi_token”

API 画廊


开发者工具

不满足于只在命令行上使用qs? qs现在提供了实用的工具来帮助您更快地开发Python应用程序!

ImageTools

  • ColorTools.py:

    • QuickStart_Rhy.ImageTools.ColorTools.get_color_from_str(str_color): get (R, G, B, A=255) from str_color

      样例:

call return
get_color_from_str('0,0,0,0') (0, 0, 0, 0)
get_color_from_str('0,0,0') (0, 0, 0, 255)
get_color_from_str('FFFFFF') (255, 255, 255, 255)
  • QuickStart_Rhy.ImageTools.ColorTools.transport_back(src: str, to_color, from_color=(0, 0, 0, 0)): 将图片 Image.open(src)中颜色 from_color 替换为 to_color

    样例:

call return
transport_back('test.jpg', (0, 0, 0, 255)) Replace the transparent color with white

NetTools

  • QuickStart_Rhy.NetTools.check_one_page(url): 确定url是否可访问。

  • QuickStart_Rhy.NetTools.formatUrl(try_url): 尝试添加https://或http://以使`try_url`可以访问(不能保证返回值可以访问)

  • QuickStart_Rhy.NetTools.get_ip(): 获取局域网下当前机器的IP

  • QuickStart_Rhy.NetTools.size_format(sz, align=False): 格式化文件大小1000000 -> 1.000 MB(如果不对齐,则为1.000 MB)

  • QuickStart_Rhy.NetTools.get_ip_info(): 返回字典

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    {
    'status': 'success',
    'country': 'China',
    'countryCode': 'CN',
    'region': 'Province name abbreviations',
    'regionName': 'Province name',
    'city': 'City',
    'zip': '',
    'lat': latitude,
    'lon': longitude,
    'timezone': 'Asia/Shanghai',
    'isp': 'Network operator',
    'org': 'Network operator + location',
    'as': 'AS4134 Chinanet',
    'query': 'Your public IP'
    }
  • QuickStart_Rhy.NetTools.get_fileinfo(url): 返回可下载的链接, 文件名和头部信息.

ThreadTools

  • QuickStart_Rhy.ThreadTools.ThreadFunctionWrapper(threading.Thread): 打开一个新线程来运行函数。

    • __init__(self, function, *args, **kwargs)
    • run(self): 开始运行
    • get_res(self): 获取运行结果
  • QuickStart_Rhy.ThreadTools.FileWriters: 写文件线程池

    • __init__(self, filename, workers, mode): 模式样例: r+, w, rb+, wb
    • wait(self): 等待线程池所有线程工作完毕
    • new_job(self, content, index): 加入新的任务

    文件必须已经创建并预先分配了足够的空间

TuiTools

  • QuickStart_Rhy.TuiTools.get_console_width(): 顾名思义,获取控制台宽度
  • QuickStart_Rhy.TuiTools.Bar.RollBar:支持在命令行上滚动条形图,您可以运行qs -top来查看效果。
  • QuickStart_Rhy.TuiTools.Line.Line: 在命令行上支持折线图,您可以运行qs -weather来查看效果。

Wrappers

  • QuickStart_Rhy.Wrapper.set_timeout(num): 函数包装器使函数在指定的时间num内结束。

    • 样例:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    from QuickStart_Rhy.Wrapper import set_timeout
    import time

    @set_timeout(2)
    def fuck(who):
    time.sleep(3)
    return 'fuck {}'.format(who)
    # 返回 False

    @set_timeout(2)
    def fuck(who):
    return 'fuck {}'.format(who)
    # 返回 'fuck {}'.format(who)