color-convert 1.2__py3-none-any.whl

color_convert/__init__.py

@@ -0,0 +1,35 @@
+#coding=UTF-8
+
+from .color import (
+    hex_to_rgb,
+    hex_to_rgba,
+    ten_to_hex,
+    ten_to_rgb,
+    rgb_to_hex,
+    rgba_to_hex,
+    rgb_to_hsl,
+    hsl_to_rgb,
+    rgb_to_hsv,
+    hsv_to_rgb,
+    rgb_to_cmyk,
+    cmyk_to_rgb,
+    hex_to_hsl,
+    hex_to_hsv,
+)
+
+__all__ = [
+    'hex_to_rgb',
+    'hex_to_rgba',
+    'ten_to_hex',
+    'ten_to_rgb',
+    'rgb_to_hex',
+    'rgba_to_hex',
+    'rgb_to_hsl',
+    'hsl_to_rgb',
+    'rgb_to_hsv',
+    'hsv_to_rgb',
+    'rgb_to_cmyk',
+    'cmyk_to_rgb',
+    'hex_to_hsl',
+    'hex_to_hsv',
+]

color_convert/color.py

@@ -0,0 +1,270 @@
+#coding=UTF-8
+
+def hex_to_rgb(hex):
+    """
+    功能：16进制颜色格式颜色转换为RGB格式
+    :param hex: 16进制颜色值，如：#fff000
+    :return: rgb(255,182,193)
+    """
+    r = int(hex[1:3], 16)
+    g = int(hex[3:5], 16)
+    b = int(hex[5:7], 16)
+    rgb = str(r) + ',' + str(g) + ',' + str(b)
+    return 'rgb({})'.format(rgb)
+
+
+def hex_to_rgba(hex_str):
+    """
+    功能：带透明度的16进制颜色值转换为 RGBA 格式
+    :param hex_str: #eefff3a8 转换成 rgba(238,255,243,0.66) 或者 #ffffff 转换成 rgba(255,255,255,1)
+    :return: rgba(255,255,255,1)
+    """
+    hex_str = hex_str.replace('#', '')
+    if len(hex_str) != 6:
+        hex_str = hex_str + '0'
+    r = int(hex_str[0:2], 16)
+    g = int(hex_str[2:4], 16)
+    b = int(hex_str[4:6], 16)
+    a = 1
+    if len(hex_str) > 6:
+        alpha = int(hex_str[6:10], 16) / 255 * 1
+        a = round(alpha, 2)
+    return 'rgba({},{},{},{})'.format(r, g, b, a)
+
+
+def ten_to_hex(num):
+    """
+    功能：十进制颜色格式转换为十六进制格式。
+    :param num: 十进制颜色值，如：16711680
+    :return: #ffffff
+    """
+    color = str(hex(int(num)))
+    return color.replace('0x', '#')
+
+
+def ten_to_rgb(num):
+    """
+    功能：十进制颜色值转换为RGB格式
+    :param num: 十进制颜色值，如：16711680
+    :return: 255,0,0
+    """
+    try:
+        str1 = hex(int(str(num), 10)).replace('0x', '#')
+        return hex_to_rgba(str1)
+    except Exception as e:
+        raise Exception(e)
+
+
+def rgb_to_hex(r, g, b):
+    """
+    功能：RGB格式颜色转换为十六进制格式
+    :param r: 红色通道值 (0-255)
+    :param g: 绿色通道值 (0-255)
+    :param b: 蓝色通道值 (0-255)
+    :return: #ffffff
+    """
+    return '#{:02x}{:02x}{:02x}'.format(int(r), int(g), int(b))
+
+
+def rgba_to_hex(r, g, b, a=1):
+    """
+    功能：RGBA格式颜色转换为十六进制格式（带透明度）
+    :param r: 红色通道值 (0-255)
+    :param g: 绿色通道值 (0-255)
+    :param b: 蓝色通道值 (0-255)
+    :param a: 透明度 (0-1)
+    :return: #ffffffa8
+    """
+    alpha = int(round(a * 255))
+    return '#{:02x}{:02x}{:02x}{:02x}'.format(int(r), int(g), int(b), alpha)
+
+
+def rgb_to_hsl(r, g, b):
+    """
+    功能：RGB格式颜色转换为HSL格式
+    :param r: 红色通道值 (0-255)
+    :param g: 绿色通道值 (0-255)
+    :param b: 蓝色通道值 (0-255)
+    :return: hsl(120, 100%, 50%)
+    """
+    r, g, b = int(r) / 255.0, int(g) / 255.0, int(b) / 255.0
+    max_c = max(r, g, b)
+    min_c = min(r, g, b)
+    l = (max_c + min_c) / 2.0
+
+    if max_c == min_c:
+        h = s = 0.0
+    else:
+        d = max_c - min_c
+        s = d / (2.0 - max_c - min_c) if l > 0.5 else d / (max_c + min_c)
+        if max_c == r:
+            h = (g - b) / d + (6 if g < b else 0)
+        elif max_c == g:
+            h = (b - r) / d + 2
+        else:
+            h = (r - g) / d + 4
+        h /= 6.0
+
+    return 'hsl({}, {}%, {}%)'.format(round(h * 360), round(s * 100), round(l * 100))
+
+
+def hsl_to_rgb(h, s, l):
+    """
+    功能：HSL格式颜色转换为RGB格式
+    :param h: 色相 (0-360)
+    :param s: 饱和度 (0-100)
+    :param l: 亮度 (0-100)
+    :return: rgb(255,255,255)
+    """
+    h, s, l = float(h) / 360.0, float(s) / 100.0, float(l) / 100.0
+
+    if s == 0:
+        r = g = b = l
+    else:
+        def hue_to_rgb(p, q, t):
+            if t < 0: t += 1
+            if t > 1: t -= 1
+            if t < 1/6: return p + (q - p) * 6 * t
+            if t < 1/2: return q
+            if t < 2/3: return p + (q - p) * (2/3 - t) * 6
+            return p
+
+        q = l * (1 + s) if l < 0.5 else l + s - l * s
+        p = 2 * l - q
+        r = hue_to_rgb(p, q, h + 1/3)
+        g = hue_to_rgb(p, q, h)
+        b = hue_to_rgb(p, q, h - 1/3)
+
+    return 'rgb({}, {}, {})'.format(round(r * 255), round(g * 255), round(b * 255))
+
+
+def rgb_to_hsv(r, g, b):
+    """
+    功能：RGB格式颜色转换为HSV格式
+    :param r: 红色通道值 (0-255)
+    :param g: 绿色通道值 (0-255)
+    :param b: 蓝色通道值 (0-255)
+    :return: hsv(120, 100%, 100%)
+    """
+    r, g, b = int(r) / 255.0, int(g) / 255.0, int(b) / 255.0
+    max_c = max(r, g, b)
+    min_c = min(r, g, b)
+    v = max_c
+    d = max_c - min_c
+    s = 0 if max_c == 0 else d / max_c
+
+    if max_c == min_c:
+        h = 0.0
+    else:
+        if max_c == r:
+            h = (g - b) / d + (6 if g < b else 0)
+        elif max_c == g:
+            h = (b - r) / d + 2
+        else:
+            h = (r - g) / d + 4
+        h /= 6.0
+
+    return 'hsv({}, {}%, {}%)'.format(round(h * 360), round(s * 100), round(v * 100))
+
+
+def hsv_to_rgb(h, s, v):
+    """
+    功能：HSV格式颜色转换为RGB格式
+    :param h: 色相 (0-360)
+    :param s: 饱和度 (0-100)
+    :param v: 明度 (0-100)
+    :return: rgb(255,255,255)
+    """
+    h, s, v = float(h) / 360.0, float(s) / 100.0, float(v) / 100.0
+
+    i = int(h * 6)
+    f = h * 6 - i
+    p = v * (1 - s)
+    q = v * (1 - f * s)
+    t = v * (1 - (1 - f) * s)
+
+    mod = i % 6
+    if mod == 0:
+        r, g, b = v, t, p
+    elif mod == 1:
+        r, g, b = q, v, p
+    elif mod == 2:
+        r, g, b = p, v, t
+    elif mod == 3:
+        r, g, b = p, q, v
+    elif mod == 4:
+        r, g, b = t, p, v
+    else:
+        r, g, b = v, p, q
+
+    return 'rgb({}, {}, {})'.format(round(r * 255), round(g * 255), round(b * 255))
+
+
+def rgb_to_cmyk(r, g, b):
+    """
+    功能：RGB格式颜色转换为CMYK格式
+    :param r: 红色通道值 (0-255)
+    :param g: 绿色通道值 (0-255)
+    :param b: 蓝色通道值 (0-255)
+    :return: cmyk(0%, 0%, 0%, 0%)
+    """
+    r, g, b = int(r) / 255.0, int(g) / 255.0, int(b) / 255.0
+    k = 1 - max(r, g, b)
+    if k == 1:
+        return 'cmyk(0%, 0%, 0%, 100%)'
+    c = (1 - r - k) / (1 - k)
+    m = (1 - g - k) / (1 - k)
+    y = (1 - b - k) / (1 - k)
+    return 'cmyk({}%, {}%, {}%, {}%)'.format(round(c * 100), round(m * 100), round(y * 100), round(k * 100))
+
+
+def cmyk_to_rgb(c, m, y, k):
+    """
+    功能：CMYK格式颜色转换为RGB格式
+    :param c: 青色 (0-100)
+    :param m: 品红 (0-100)
+    :param y: 黄色 (0-100)
+    :param k: 黑色 (0-100)
+    :return: rgb(255,255,255)
+    """
+    c, m, y, k = float(c) / 100.0, float(m) / 100.0, float(y) / 100.0, float(k) / 100.0
+    r = round(255 * (1 - c) * (1 - k))
+    g = round(255 * (1 - m) * (1 - k))
+    b = round(255 * (1 - y) * (1 - k))
+    return 'rgb({}, {}, {})'.format(r, g, b)
+
+
+def hex_to_hsl(hex_str):
+    """
+    功能：十六进制颜色格式转换为HSL格式
+    :param hex_str: 16进制颜色值，如：#fff000
+    :return: hsl(56, 100%, 50%)
+    """
+    hex_str = hex_str.replace('#', '')
+    r = int(hex_str[0:2], 16)
+    g = int(hex_str[2:4], 16)
+    b = int(hex_str[4:6], 16)
+    return rgb_to_hsl(r, g, b)
+
+
+def hex_to_hsv(hex_str):
+    """
+    功能：十六进制颜色格式转换为HSV格式
+    :param hex_str: 16进制颜色值，如：#fff000
+    :return: hsv(56, 100%, 100%)
+    """
+    hex_str = hex_str.replace('#', '')
+    r = int(hex_str[0:2], 16)
+    g = int(hex_str[2:4], 16)
+    b = int(hex_str[4:6], 16)
+    return rgb_to_hsv(r, g, b)
+
+
+def my_function(a, b):
+    """函数功能说明
+     >>> my_function(2, 3)
+     6
+     >>> my_function('a', 3)
+     'aaa'
+    """
+    return a * b

color_convert-1.2.dist-info/METADATA

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: color-convert
+Version: 1.2
+Summary: Color Conversion
+Home-page: https://github.com/zhenzi0322/color-convert
+Author: zhenzi0322
+Author-email: 82131529@qq.com
+License: MIT License
+Keywords: color,color-convert,convert
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: summary
+
+
+<p align="center">
+  <h1>color-convert</h1>
+  <b>颜色格式转换工具，支持 HEX、RGB、RGBA、HSL、HSV、CMYK、十进制等多种颜色格式之间的相互转换。</b>
+  <br><br>
+  <a href="https://pypi.org/project/color-convert/"><img src="https://img.shields.io/pypi/v/color-convert.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/color-convert/"><img src="https://img.shields.io/pypi/pyversions/color-convert.svg" alt="Python"></a>
+  <a href="https://github.com/zhenzi0322/color-convert/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/color-convert.svg" alt="License"></a>
+  <a href="https://tool.long920.cn/color-convert"><img src="https://app.readthedocs.org/projects/zhenzi0322-tool/badge/?version=latest" alt="Documentation Status"></a>
+</p>
+
+## 安装
+
+```bash
+pip install color-convert
+```
+
+## 支持的颜色格式
+
+| 格式 | 示例 |
+|------|------|
+| HEX（十六进制） | `#fff000` |
+| RGB | `rgb(255, 240, 0)` |
+| RGBA | `rgba(255, 240, 0, 1)` |
+| HSL | `hsl(56, 100%, 50%)` |
+| HSV | `hsv(56, 100%, 100%)` |
+| CMYK | `cmyk(0%, 6%, 100%, 0%)` |
+| Decimal（十进制） | `16711680` |
+
+## 使用示例
+
+### 十六进制 → RGB
+
+```python
+from color_convert import color
+
+rgb = color.hex_to_rgb('#fff000')
+print(rgb)  # rgb(255,240,0)
+```
+
+### 十六进制 → RGBA
+
+```python
+from color_convert import color
+
+rgba = color.hex_to_rgba('#fff000')
+print(rgba)  # rgba(255,240,0,1)
+
+rgba = color.hex_to_rgba('#fff000a8')
+print(rgba)  # rgba(255,240,0,0.66)
+```
+
+### 十六进制 → HSL
+
+```python
+from color_convert import color
+
+hsl = color.hex_to_hsl('#fff000')
+print(hsl)  # hsl(56, 100%, 50%)
+```
+
+### 十六进制 → HSV
+
+```python
+from color_convert import color
+
+hsv = color.hex_to_hsv('#fff000')
+print(hsv)  # hsv(56, 100%, 100%)
+```
+
+### 十进制 → 十六进制
+
+```python
+from color_convert import color
+
+hex_val = color.ten_to_hex(16711680)
+print(hex_val)  # #ff0000
+```
+
+### 十进制 → RGBA
+
+```python
+from color_convert import color
+
+rgba = color.ten_to_rgb(16711680)
+print(rgba)  # rgba(255,0,0,1)
+```
+
+### RGB → 十六进制
+
+```python
+from color_convert import color
+
+hex_val = color.rgb_to_hex(255, 240, 0)
+print(hex_val)  # #fff000
+```
+
+### RGBA → 十六进制
+
+```python
+from color_convert import color
+
+hex_val = color.rgba_to_hex(255, 240, 0, 0.66)
+print(hex_val)  # #fff000a8
+```
+
+### RGB → HSL
+
+```python
+from color_convert import color
+
+hsl = color.rgb_to_hsl(255, 240, 0)
+print(hsl)  # hsl(56, 100%, 50%)
+```
+
+### HSL → RGB
+
+```python
+from color_convert import color
+
+rgb = color.hsl_to_rgb(56, 100, 50)
+print(rgb)  # rgb(255, 238, 0)
+```
+
+### RGB → HSV
+
+```python
+from color_convert import color
+
+hsv = color.rgb_to_hsv(255, 240, 0)
+print(hsv)  # hsv(56, 100%, 100%)
+```
+
+### HSV → RGB
+
+```python
+from color_convert import color
+
+rgb = color.hsv_to_rgb(56, 100, 100)
+print(rgb)  # rgb(255, 238, 0)
+```
+
+### RGB → CMYK
+
+```python
+from color_convert import color
+
+cmyk = color.rgb_to_cmyk(255, 240, 0)
+print(cmyk)  # cmyk(0%, 6%, 100%, 0%)
+```
+
+### CMYK → RGB
+
+```python
+from color_convert import color
+
+rgb = color.cmyk_to_rgb(0, 6, 100, 0)
+print(rgb)  # rgb(255, 240, 0)
+```
+
+## API 参考
+
+| 函数名 | 说明 | 参数 | 返回值示例 |
+|--------|------|------|------------|
+| `hex_to_rgb(hex)` | 十六进制 → RGB | `hex`: 如 `#fff000` | `rgb(255,240,0)` |
+| `hex_to_rgba(hex_str)` | 十六进制 → RGBA（支持带透明度） | `hex_str`: 如 `#fff000` 或 `#fff000a8` | `rgba(255,240,0,1)` |
+| `hex_to_hsl(hex_str)` | 十六进制 → HSL | `hex_str`: 如 `#fff000` | `hsl(56, 100%, 50%)` |
+| `hex_to_hsv(hex_str)` | 十六进制 → HSV | `hex_str`: 如 `#fff000` | `hsv(56, 100%, 100%)` |
+| `ten_to_hex(num)` | 十进制 → 十六进制 | `num`: 如 `16711680` | `#ff0000` |
+| `ten_to_rgb(num)` | 十进制 → RGBA | `num`: 如 `16711680` | `rgba(255,0,0,1)` |
+| `rgb_to_hex(r, g, b)` | RGB → 十六进制 | `r, g, b`: 0-255 | `#fff000` |
+| `rgba_to_hex(r, g, b, a)` | RGBA → 十六进制（带透明度） | `r, g, b`: 0-255, `a`: 0-1 | `#fff000a8` |
+| `rgb_to_hsl(r, g, b)` | RGB → HSL | `r, g, b`: 0-255 | `hsl(56, 100%, 50%)` |
+| `hsl_to_rgb(h, s, l)` | HSL → RGB | `h`: 0-360, `s`: 0-100, `l`: 0-100 | `rgb(255, 238, 0)` |
+| `rgb_to_hsv(r, g, b)` | RGB → HSV | `r, g, b`: 0-255 | `hsv(56, 100%, 100%)` |
+| `hsv_to_rgb(h, s, v)` | HSV → RGB | `h`: 0-360, `s`: 0-100, `v`: 0-100 | `rgb(255, 238, 0)` |
+| `rgb_to_cmyk(r, g, b)` | RGB → CMYK | `r, g, b`: 0-255 | `cmyk(0%, 6%, 100%, 0%)` |
+| `cmyk_to_rgb(c, m, y, k)` | CMYK → RGB | `c, m, y, k`: 0-100 | `rgb(255, 240, 0)` |
+
+## License
+
+[MIT License](LICENSE)

color_convert-1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+color_convert/__init__.py,sha256=bVeDVYLJ6nxfKwg4P9dF2x1OFc1h40Nr0tas09z2GCE,537
+color_convert/color.py,sha256=7Uws9AHbAVFNAT73g4p3kc8bpcRMtnjn44XjlM6V9b4,7283
+color_convert-1.2.dist-info/licenses/LICENSE,sha256=MK0YzZf6O8ILUNhytU5rNZMl2_2ECw2AnOvb4b7eMuA,1067
+color_convert-1.2.dist-info/METADATA,sha256=iPpgIciN2-H2qxqD-B19atFpNHxizoTt4Oe5kvGizxs,5311
+color_convert-1.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+color_convert-1.2.dist-info/top_level.txt,sha256=TxEO_A-PV4am8TGe4tHTow6QKN4ZX6dkpuyLip1Sl8s,14
+color_convert-1.2.dist-info/RECORD,,

color_convert-1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

color_convert-1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zhenzi0322
+
+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 without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

color_convert-1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+color_convert