Github项目分享之Amazing-QR|Python 二维码生成器

本文累计 3757 字, 最后更新时间：2022年01月10日

### 0x00 说在前面
从本篇文章开始，我将会为观众老爷们持续分享一些我在Github上搜集到的有趣好玩的项目， 
在博文中我会介绍该项目如何安装以及使用，提供一个较为完整的使用流程，  
当然，在每篇文章最后我都会贴出该项目的地址以供你直接访问~  
本文作为系列文章的第一篇，我们来分享这个项目—— Amazing-QR|Python 二维码生成器  
## 生成只属于你独一无二的二维码！  
> 可生成普通二维码、带图片的艺术二维码（黑白与彩色）、动态二维码（黑白与彩色）。

效果如图所示。![qrcode_c.png][1]
![QQ截图20220110153209.png][2]

### 0x01 开始！
本文部分讲解内容为追求准确性，引用了原文相关介绍，特此鸣谢。

#### 安装

安装环境: Python3
所需工具: pip3

执行命令：

pip install amzqr

是的，安装该项目仅需要一行命令即可，相当的简洁方便。
Python3 在一般的Linux系统完整安装包中会预置，同样的，pip3也往往会随着Python3的安装而被同时安装。

你可以在自己的Linux操作系统中输入 `python` 或是 `python3` 来查阅自己所安装的Python版本。  
![QQ截图20220110153921.png][3]
如果显示Python 3.x.x等信息，那么python3算是安装成功了。

输出完amzqr的安装命令后，以下信息即为安装成功。 
Collecting amzqr

Downloading amzqr-0.0.1-py3-none-any.whl (30 kB)
    Requirement already satisfied: Pillow>=3.3.1 in /root/anaconda3/lib/python3.7/site-packages (from amzqr) (5.2.0)
    Requirement already satisfied: numpy>=1.11.1 in /root/anaconda3/lib/python3.7/site-packages (from amzqr) (1.15.1)
    Requirement already satisfied: imageio>=1.5 in /root/anaconda3/lib/python3.7/site-packages (from amzqr) (2.4.1)
    Installing collected packages: amzqr
    Successfully installed amzqr-0.0.1

#### 使用
amzqr有两个使用方式，分别为“命令行使用”以及“作为导入文件”

**命令行使用**
如果你在上一步安装成功，那么在命令行终端输入 amzqr 会出现以下信息

[root@localhost amzqr]# amzqr
    usage: amzqr [-h]
                 [-v {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,39,40}]
                 [-l {L,M,Q,H}] [-p PICTURE] [-c] [-con CONTRAST]
                 [-bri BRIGHTNESS] [-n NAME] [-d DIRECTORY]
                 Words
    amzqr: error: the following arguments are required: Words

好的，我们来具体看看使用方法吧。  
#### 普通二维码

#1 Words
    amzqr https://github.com

在命令后输入链接或者句子作为参数，然后在程序的当前目录中产生相应的二维码图片文件，默认命名为” qrcode.png“。  
输入这样一行命令，就可以自定义扫码内容啦，扫完二维码就会解析出相应的文字内容 or 网址。

#2 -v, -l
    amzqr https://github.com -v 10 -l Q

默认边长是取决于你输入的信息的长度和使用的纠错等级；  
而默认纠错等级是最高级的H。  
自定义：如果想要控制边长和纠错水平就使用 -v 和 -l 参数。  
-v 控制边长，范围是1至40，数字越大边长越大；  
-l 控制纠错水平，范围是L、M、Q、H，从左到右依次升高。

#3 -n, -d
    amzqr https://github.com -n github_qr.jpg  -d .../paths/

默认输出文件名是“ qrcode.png "，而默认存储位置是当前目录。    
自定义：可以自己定义输出名称和位置。注意同名文件会覆盖旧的。   
-n 控制文件名，格式可以是 .jpg， .png ，.bmp ，.gif ；   
-d 控制位置。

那我们来生成一个二维码看看。  
输出命令  `amzqr https://hack.best/#Asteriska`
![QQ截图20220110160110.png][4]
成功！  
![qrcode.png][5]
扫码即可访问我的博客

#### 艺术二维码
艺术二维码即有特殊图案及颜色的二维码，不同于常规二维码。

#1 -p
    amzqr https://hack.best/#Asteriska  -p myAva.jpg

参数-p 用来将QR二维码图像与一张同目录下的图片相结合，产生一张黑白图片。

#2 -c
    amzqr https://hack.best/#Asteriska  -p myAva.jpg -c

加上参数 -c 可以使产生的图片由黑白变为彩色的。

输入  `amzqr https://hack.best/#Asteriska -p myAva.jpg -n qrcode_c.png -c`  
成功！  
这里成功的把我的头像和博客地址结合在一起了~ 
![qrcode_c.png][6]

#### 动态二维码
动态二维码与上述的带图片的二维码的生成方法没什么区别，你只要采用 .gif 格式的图片即可生成黑白或者彩色的动态二维码。 
但注意如果使用了 -n 参数自定义输出的文件名，切记其格式也必须是 .gif 格式。

### 作为导入文件
# 安装模块后

from amzqr import amzqr
    version, level, qr_name = amzqr.run(
        words,
        version=1,
        level='H',
        picture=None,
        colorized=False,
        contrast=1.0,
        brightness=1.0,
        save_name=None,
        save_dir=os.getcwd()
    )
作为python包导入的话，我们就可以在自己的程序中嵌入这个强大的二维码工具啦，具体玩法请自行摸索。  
### 项目地址

https://github.com/x-hw/amazing-qr

[1]: https://hack.best/usr/uploads/2022/01/433800202.png
  [2]: https://hack.best/usr/uploads/2022/01/3239191180.png
  [3]: https://hack.best/usr/uploads/2022/01/2229596245.png
  [4]: https://hack.best/usr/uploads/2022/01/3992100443.png
  [5]: https://hack.best/usr/uploads/2022/01/1681984786.png
  [6]: https://hack.best/usr/uploads/2022/01/433800202.png