pylhb4qrcode 1.0.0__tar.gz

pylhb4qrcode-1.0.0/LICENSE

@@ -0,0 +1,25 @@
+Non-Commercial Use License
+
+Copyright (c) 2025 Mr.Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software for non-commercial purposes only, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+2. Commercial use of the Software is expressly prohibited without prior written
+permission from the copyright holder. For purposes of this license, commercial
+use means any use of the Software that is intended for or directed toward
+commercial advantage or monetary compensation.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pylhb4qrcode-1.0.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.3
+Name: pylhb4qrcode
+Version: 1.0.0
+Summary: Mr.Lee's QRCode Helpers
+Author: SoftGod4MrLi
+Author-email: SoftGod4MrLi <596928288@qq.com>
+License: Non-Commercial Use License
+         
+         Copyright (c) 2025 Mr.Lee
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software for non-commercial purposes only, including without limitation
+         the rights to use, copy, modify, merge, publish, distribute, sublicense,
+         and/or sell copies of the Software, subject to the following conditions:
+         
+         1. The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         2. Commercial use of the Software is expressly prohibited without prior written
+         permission from the copyright holder. For purposes of this license, commercial
+         use means any use of the Software that is intended for or directed toward
+         commercial advantage or monetary compensation.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Requires-Dist: pillow>=12.2.0
+Requires-Dist: qrcode>=8.2
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/SoftGod4MrLi/pylhb4qrcode
+Project-URL: Documentation, https://github.com/SoftGod4MrLi/pylhb4qrcode
+Project-URL: Repository, https://github.com/SoftGod4MrLi/pylhb4qrcode
+Project-URL: Issues, https://github.com/SoftGod4MrLi/pylhb4qrcode/issues
+Description-Content-Type: text/markdown
+
+# pylhb4qrcode
+
+[![PyPI version](https://img.shields.io/pypi/v/pylhb-qrcode.svg)](https://pypi.org/project/pylhb-qrcode/)
+[![GitHub stars](https://img.shields.io/github/stars/SoftGod4MrLi/pylhb-qrcode?style=flat&logo=github)](https://github.com/SoftGod4MrLi/pylhb-qrcode)
+[![GitHub license](https://img.shields.io/github/license/SoftGod4MrLi/pylhb-qrcode?style=flat)](https://github.com/SoftGod4MrLi/pylhb-qrcode/blob/main/LICENSE)
+![GitHub repo size](https://img.shields.io/github/repo-size/SoftGod4MrLi/pylhb-qrcode?style=flat)
+[![GitHub forks](https://img.shields.io/github/forks/SoftGod4MrLi/pylhb-qrcode?style=flat&logo=github)](https://github.com/SoftGod4MrLi/pylhb-qrcode)
+
+pylhb-qrcode 是我在工作过程中陆续整理的一个 Python qrcode 工具包，里面就放在一个关于qrcode操作的类及相关函数。与其说是一个正式的开源项目，不如说是我自己的“代码杂物间”——只不过把它打包了一下，方便在不同项目之间复用。
+
+> 由于是个人使用为主，很多设计可能带着比较强的个人习惯，也未必是最优解。如果您发现了问题或有更好的建议，非常欢迎指正。
+
+## 安装
+
+```
+pip install pylhb4qrcode
+```
+
+## 命令
+
+- 创建二维码
+
+```
+pylhb4qrcode --str 596928288
+pylhb4qrcode --str 596928288 --desc 扫我加QQ --logo my.png --circular --file MyQQ.png
+```
+
+## 🌺myqrcode模块
+
+二维码生成，并可以在二维码下方添加描述文字。
+
+使用示例：
+
+```
+from pylhb4qrcode.myqrcode import MyQRCode
+
+if __name__ == "__main__":
+    qr=MyQRCode()
+    qr.get(qrStr:"596928288",qrDesc="扫我加QQ")
+```

pylhb4qrcode-1.0.0/README.md

@@ -0,0 +1,40 @@
+# pylhb4qrcode
+
+[![PyPI version](https://img.shields.io/pypi/v/pylhb-qrcode.svg)](https://pypi.org/project/pylhb-qrcode/)
+[![GitHub stars](https://img.shields.io/github/stars/SoftGod4MrLi/pylhb-qrcode?style=flat&logo=github)](https://github.com/SoftGod4MrLi/pylhb-qrcode)
+[![GitHub license](https://img.shields.io/github/license/SoftGod4MrLi/pylhb-qrcode?style=flat)](https://github.com/SoftGod4MrLi/pylhb-qrcode/blob/main/LICENSE)
+![GitHub repo size](https://img.shields.io/github/repo-size/SoftGod4MrLi/pylhb-qrcode?style=flat)
+[![GitHub forks](https://img.shields.io/github/forks/SoftGod4MrLi/pylhb-qrcode?style=flat&logo=github)](https://github.com/SoftGod4MrLi/pylhb-qrcode)
+
+pylhb-qrcode 是我在工作过程中陆续整理的一个 Python qrcode 工具包，里面就放在一个关于qrcode操作的类及相关函数。与其说是一个正式的开源项目，不如说是我自己的“代码杂物间”——只不过把它打包了一下，方便在不同项目之间复用。
+
+> 由于是个人使用为主，很多设计可能带着比较强的个人习惯，也未必是最优解。如果您发现了问题或有更好的建议，非常欢迎指正。
+
+## 安装
+
+```
+pip install pylhb4qrcode
+```
+
+## 命令
+
+- 创建二维码
+
+```
+pylhb4qrcode --str 596928288
+pylhb4qrcode --str 596928288 --desc 扫我加QQ --logo my.png --circular --file MyQQ.png
+```
+
+## 🌺myqrcode模块
+
+二维码生成，并可以在二维码下方添加描述文字。
+
+使用示例：
+
+```
+from pylhb4qrcode.myqrcode import MyQRCode
+
+if __name__ == "__main__":
+    qr=MyQRCode()
+    qr.get(qrStr:"596928288",qrDesc="扫我加QQ")
+```

pylhb4qrcode-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "pylhb4qrcode"
+version = "1.0.0"
+description = "Mr.Lee's QRCode Helpers"
+readme = "README.md"
+license = {file = "LICENSE"}
+authors = [
+    { name = "SoftGod4MrLi", email = "596928288@qq.com" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "pillow>=12.2.0",
+    "qrcode>=8.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/SoftGod4MrLi/pylhb4qrcode"
+Documentation = "https://github.com/SoftGod4MrLi/pylhb4qrcode"
+Repository = "https://github.com/SoftGod4MrLi/pylhb4qrcode"
+Issues = "https://github.com/SoftGod4MrLi/pylhb4qrcode/issues"
+
+[project.scripts]
+pylhb-qrcode = "pylhb4qrcode:main"
+
+[build-system]
+requires = ["uv_build>=0.11.18,<1000.12.0"]
+build-backend = "uv_build"

pylhb4qrcode-1.0.0/src/pylhb4qrcode/__init__.py

@@ -0,0 +1,46 @@
+import argparse
+# Mr.Lee's Module
+from .myqrcode import MyQRCode
+
+__all__ = [
+    "MyQRCode"
+]
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Mr.Lee's QRCode Helpers")
+    parser.add_argument('-v', '--version', action='store_true', help='show version')
+    parser.add_argument("-s", "--str", default=None, type=str, help="二维码字符")
+    parser.add_argument("-d", "--desc", default=None, type=str, help="二维码描述")
+    parser.add_argument("-l", "--logo", default=None, type=str, help="二维码Logo")
+    parser.add_argument("-f", "--file", default="QR.png", type=str, help="二维码文件名")
+    parser.add_argument('-c', '--circular', action='store_true', help='圆形Logo')
+    args = parser.parse_args()
+
+    # show version
+    if args.version:
+        try:
+            from importlib.metadata import version, PackageNotFoundError
+            # 直接从包元数据获取版本号
+            ver = version("pylhb-yaml")
+            print(f"pylhb-yaml {ver}")
+        except PackageNotFoundError:
+            print("Package not found.")
+        except ImportError:
+            print("Import errored.")
+        except:
+            print("Other errored.")
+        return
+
+    # 生成二维码
+    if args.qrstr:
+        qr=MyQRCode()
+        if args.logo:
+            if args.circular:
+                qrImg=qr.getWithLogo4Circular(args.str,args.desc,args.logo)
+                qrImg.save(args.file)
+            else:
+                qrImg=qr.getWithLogo(args.str,args.desc,args.logo)
+                qrImg.save(args.file)
+        else:
+            qrImg=qr.get(args.str,args.desc)
+            qrImg.save(args.file)

pylhb4qrcode-1.0.0/src/pylhb4qrcode/myqrcode.py

@@ -0,0 +1,217 @@
+"""
+模块：myqrcode
+作者：李生
+描述：二维码生成
+"""
+import qrcode
+from PIL import Image,ImageFont,ImageDraw
+import os
+
+class MyQRCode:
+    def __init__(self,qrVersion=1,qrBoxSize = 10,qrBorder = 5,fontColor="black",backColor="white",marginTop=20,marginButtom=20,fontSize=16) -> None:
+        """
+        构造函数
+        Args:
+            qrVersion：二维码的规格，即控制二维码包含多少行和列，有效值为1-40。
+            qrBoxSize：每个格子的像素大小
+            qrBorder：边框的厚度
+            fontColor：前景色
+            backColor：背景色
+            marginTop：描述文字上边距
+            marginButtom：描述文字下边距
+            fontSize：描述文字体号
+        """
+        self.qrVersion=qrVersion
+        self.qrBoxSize=qrBoxSize
+        self.qrBorder=qrBorder
+        self.fontColor=fontColor
+        self.backColor=backColor
+        self.marginTop=marginTop
+        self.marginButtom=marginButtom
+        self.fontSize=fontSize
+
+    def addText(self,qrImg,qrDesc):
+        """
+        在二维码图片下方添加文本，生成新图片
+        Args：
+            qrImg：二维码图片
+            text：文字
+        Returns:
+            Image
+        """
+        # 获取二维码尺寸
+        qrWidth, qrHeight = qrImg.size
+        
+        # 设置字体（使用默认字体，可根据需要修改路径）
+        try:
+            # 尝试使用系统字体，Windows可用arial.ttf，macOS/Linux可用DejaVuSans.ttf
+            font = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", self.fontSize)
+        except:
+            try:
+                font = ImageFont.truetype("C:/Windows/Fonts/simhei.ttf", self.fontSize)
+            except:
+                font = ImageFont.load_default()
+        
+        # 计算文本尺寸
+        drawTemp = ImageDraw.Draw(Image.new('RGB', (1, 1)))
+        bbox = drawTemp.textbbox((0, 0), text, font=font)
+        textWidth = bbox[2] - bbox[0]
+        textHeight = bbox[3] - bbox[1]
+        
+        # 新图片高度 = 二维码高度 + 间距 + 文本高度
+        newHeight = qrHeight + self.marginTop + textHeight+self.marginButtom
+        newWidth = max(qrWidth, textWidth)  # 新图片宽度取二维码和文本中较宽者
+        
+        # 创建新画布
+        newImg = Image.new('RGB', (newWidth, newHeight), self.backColor)
+        
+        # 将二维码粘贴到新图片顶部（居中）
+        qrX = (newWidth - qrWidth) // 2
+        newImg.paste(qrImg, (qrX, 0))
+        
+        # 绘制文本
+        draw = ImageDraw.Draw(newImg)
+        textX = (newWidth - textWidth) // 2
+        textY = qrHeight + self.marginTop
+        draw.text((textX, textY), qrDesc, fill=self.fontColor, font=font)
+        
+        return newImg
+    
+    def get(self,qrStr,qrDesc=None):
+        """
+        生成简单二维码
+        Args：
+            qrStr：二维码字符
+            qrDesc：二维码描述
+        Returns:
+            Image
+        """
+        qr=qrcode.QRCode(
+            version=self.qrVersion,
+            box_size=self.qrBoxSize,
+            border=self.qrBorder
+        )
+        qr.add_data(qrStr)
+        qr.make(fit=True)
+        qrImg=qr.make_image(fill_color=self.fontColor,back_color=self.backColor).convert('RGB')
+        if qrDesc:
+            return self.addText(qrImg,qrDesc,self.marginTop,self.marginButtom,self.fontSize,self.fontColor,self.backColor)
+        else:
+            return qrImg
+    
+    def get4Easy(self,qrStr,qrDesc=None):
+        """
+        生成简单二维码
+        Args：
+            qrStr：二维码字符
+            qrDesc：二维码描述
+        Returns:
+            Image
+        """
+        qrImg=qrcode.make(qrStr).convert('RGB')
+        if qrDesc:
+            self.addText(qrImg,qrDesc,self.marginTop,self.marginButtom,self.fontSize,"black","white")
+        else:
+            return qrImg
+    
+    def getWithLogo(self,qrStr,qrDesc=None,logoPath=None, logoRatio=0.2) -> None:
+        """
+        生成带图标的二维码
+        Args：
+            qrStr：二维码字符
+            logoPath：Logo
+            qrDesc：二维码描述
+            logoRatio：Logo比率
+        Returns:
+            Image
+        """
+        qr = qrcode.QRCode(
+            version=self.qrVersion,
+            error_correction=qrcode.constants.ERROR_CORRECT_H,  # 使用高纠错级别
+            box_size=self.qrBoxSize,
+            border=self.qrBorder,
+        )
+        
+        qr.add_data(qrStr)
+        qr.make(fit=True)
+        
+        qrImg = qr.make_image(fill_color=self.fontColor, back_color=self.backColor).convert('RGB')
+        
+        # 4. 如果有图标，添加到二维码中央
+        if logoPath and os.path.exists(logoPath):
+            # 加载图标
+            logo = Image.open(logoPath)
+            
+            # 计算图标大小（二维码宽度的比例）
+            qrWidth, qrHeight = qrImg.size
+            logoSize = int(min(qrWidth, qrHeight) * logoRatio)
+            
+            # 调整图标大小
+            logo = logo.resize((logoSize, logoSize), Image.Resampling.LANCZOS)
+            
+            # 计算图标位置（居中）
+            logoPosition = ((qrWidth - logoSize) // 2, (qrHeight - logoSize) // 2)
+            
+            # 创建白色背景圆角效果
+            mask = Image.new('RGBA', (logoSize, logoSize), (255, 255, 255, 0))
+            
+            # 将图标粘贴到二维码上
+            if logo.mode == 'RGBA':
+                qrImg.paste(logo, logoPosition, logo)
+            else:
+                qrImg.paste(logo, logoPosition)
+        
+        # 5. 返回
+        if qrDesc:
+            return self.addText(qrImg,qrDesc,self.marginTop,self.marginButtom,self.fontSize,self.fontColor,self.backColor)
+        else:
+            return qrImg
+    
+    def getWithLogo4Circular(self,qrStr, qrDesc=None, logoPath=None, logoRatio=0.2):
+        """
+        生成带圆形图标的二维码
+        Args：
+            qrStr：二维码字符
+            logoPath：Logo
+            qrDesc：二维码描述
+            logoRatio：Logo比率
+        Returns:
+            Image
+        """
+        # 创建二维码
+        qr = qrcode.QRCode(
+            version=self.qrVersion,
+            error_correction=qrcode.constants.ERROR_CORRECT_H,
+            box_size=self.qrBoxSize,
+            border=self.qrBorder,
+        )
+        
+        qr.add_data(qrStr)
+        qr.make(fit=True)
+        qrImg = qr.make_image(fill_color="black", back_color="white").convert('RGB')
+        
+        if logoPath and os.path.exists(logoPath):
+            # 加载图标
+            logo = Image.open(logoPath)
+            qrWidth, qrHeight = qrImg.size
+            logoSize = int(min(qrWidth, qrHeight) * logoRatio)
+            logo = logo.resize((logoSize, logoSize), Image.Resampling.LANCZOS)
+            
+            # 创建圆形遮罩
+            mask = Image.new('L', (logoSize, logoSize), 0)
+            mask_draw = ImageDraw.Draw(mask)
+            mask_draw.ellipse((0, 0, logoSize, logoSize), fill=255)
+            
+            # 创建带透明背景的图标
+            logoWithAlpha = Image.new('RGBA', (logoSize, logoSize), (255, 255, 255, 0))
+            logoWithAlpha.paste(logo, (0, 0), mask)
+            
+            # 计算位置并粘贴
+            logoPosition = ((qrWidth - logoSize) // 2, (qrHeight - logoSize) // 2)
+            qrImg.paste(logoWithAlpha, logoPosition, logoWithAlpha)
+    
+        if qrDesc:
+            return self.addText(qrImg,qrDesc,self.marginTop,self.marginButtom,self.fontSize,self.fontColor,self.backColor)
+        else:
+            return qrImg
+