xython 4.3.9__tar.gz → 4.3.10__tar.gz

{xython-4.3.9/src/xython.egg-info → xython-4.3.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xython
-Version: 4.3.9
+Version: 4.3.10
 Summary: xython package
 Author-email: "SJ.Park" <sjpkorea@naver.com>
 License: MIT

{xython-4.3.9 → xython-4.3.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xython"
-version = "4.3.9"
+version = "4.3.10"
 description = "xython package"
 readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.8"

{xython-4.3.9 → xython-4.3.10}/src/xython/xy_color.py

@@ -1210,7 +1210,7 @@ class xy_color:
         return result
 
     def rgb_to_hex(self, input_rgb, option="#"):
-        return change_rgb_to_hex(input_rgb, option)
+        return self.change_rgb_to_hex(input_rgb, option)
 
     def change_rgb_to_hex(self, input_rgb, option="#"):
         """
@@ -1406,15 +1406,8 @@ class xy_color:
         return result
 
     def change_xcolor_to_hex(self, input_xcolor):
-        """
-        xcolor값을 16진수인 hex로 변경하는 것
-        xcolor형식 : 12, "red", "red45", "red++"
-
-        :param input_xcolor: solor형태의 색깔입력, (12, "red", "red45", "red++")
-        :return:
-        """
-        my_rgb_color = self.change_xcolor_to_rgb(input_xcolor)
-        result = self.xcolor_alpha_to_rgba(my_rgb_color)
+        rgb = self.change_xcolor_to_rgb(input_xcolor)
+        result = self.change_rgb_to_hex(rgb)
         return result
 
     def change_xcolor_to_hsl(self, input_xcolor):
@@ -2504,3 +2497,174 @@ class xy_color:
         """
         return self.xcolor_to_rgbint(input_xcolor)
 
+    def get_text_color_for_background(self, bg_rgb):
+        """
+        배경색이 주어지면 텍스트를 흰색/검정 중 어느 쪽으로 할지 자동 결정
+        WCAG 명도 기준 사용
+        """
+        r, g, b = [x / 255 for x in bg_rgb]
+        luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b
+        return [255, 255, 255] if luminance < 0.5 else [0, 0, 0]
+
+    def get_contrast_ratio(self, rgb1, rgb2):
+        """
+        두 색의 WCAG 명암비 계산 (1~21)
+        4.5 이상이면 텍스트로 사용 가능 (AA 기준)
+        """
+        def lum(rgb):
+            c = [x / 255 for x in rgb]
+            c = [x / 12.92 if x <= 0.04045 else ((x + 0.055) / 1.055) ** 2.4 for x in c]
+            return 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2]
+        l1, l2 = lum(rgb1), lum(rgb2)
+        lighter, darker = max(l1, l2), min(l1, l2)
+        return round((lighter + 0.05) / (darker + 0.05), 2)
+
+    def hex_to_rgb(self, hex_color):
+        """
+        "#ff5733" 또는 "ff5733" → [255, 87, 51]
+        """
+        hex_color = hex_color.lstrip("#")
+        return [int(hex_color[i:i+2], 16) for i in (0, 2, 4)]
+
+    def hex_to_hsl(self, hex_color):
+        """
+        hex → hsl 직접 변환
+        """
+        return self.rgb_to_hsl(self.hex_to_rgb(hex_color))
+
+    def rgb_to_cmyk(self, input_rgb):
+        """
+        RGB → CMYK 변환 (인쇄용)
+        반환: [c, m, y, k] (0~100 정수)
+        """
+        r, g, b = [x / 255 for x in input_rgb]
+        k = 1 - max(r, g, b)
+        if k == 1:
+            return [0, 0, 0, 100]
+        c = (1 - r - k) / (1 - k)
+        m = (1 - g - k) / (1 - k)
+        y = (1 - b - k) / (1 - k)
+        return [round(c*100), round(m*100), round(y*100), round(k*100)]
+
+    def cmyk_to_rgb(self, c, m, y, k):
+        """
+        CMYK → RGB 변환
+        입력: 0~100 정수
+        """
+        c, m, y, k = c/100, m/100, y/100, k/100
+        r = int(255 * (1 - c) * (1 - k))
+        g = int(255 * (1 - m) * (1 - k))
+        b = int(255 * (1 - y) * (1 - k))
+        return [r, g, b]
+
+    def rgb_to_hsv(self, input_rgb):
+        """
+        RGB → HSV 변환 (포토샵 등에서 사용하는 방식)
+        반환: [h(0~360), s(0~100), v(0~100)]
+        """
+        r, g, b = [x / 255 for x in input_rgb]
+        mx, mn = max(r, g, b), min(r, g, b)
+        v = mx
+        s = 0 if mx == 0 else (mx - mn) / mx
+        if mx == mn:
+            h = 0
+        elif mx == r:
+            h = (60 * ((g - b) / (mx - mn))) % 360
+        elif mx == g:
+            h = 60 * ((b - r) / (mx - mn)) + 120
+        else:
+            h = 60 * ((r - g) / (mx - mn)) + 240
+        return [round(h), round(s * 100), round(v * 100)]
+
+    def get_analogous_colors(self, input_xcolor, angle=30, count=2):
+        """
+        유사색 생성 (색상환에서 ±angle도 이내의 색)
+        count=2이면 양쪽 1개씩, count=4이면 양쪽 2개씩
+        반환: [[rgb...], ...]
+        """
+        hsl = self._change_xcolor_to_hsl(input_xcolor)
+        result = []
+        for i in range(1, count // 2 + 1):
+            for sign in [-1, 1]:
+                new_h = (hsl[0] + sign * angle * i) % 360
+                result.append(self.hsl_to_rgb([new_h, hsl[1], hsl[2]]))
+        return result
+
+    def get_triadic_colors(self, input_xcolor):
+        """
+        3색 배색 (120도 간격)
+        """
+        hsl = self._change_xcolor_to_hsl(input_xcolor)
+        return [self.hsl_to_rgb([(hsl[0] + i * 120) % 360, hsl[1], hsl[2]]) for i in range(3)]
+
+    def get_split_complementary_colors(self, input_xcolor, angle=150):
+        """
+        분리 보색 (보색에서 ±30도)
+        """
+        hsl = self._change_xcolor_to_hsl(input_xcolor)
+        h = hsl[0]
+        return [
+            self.hsl_to_rgb([h, hsl[1], hsl[2]]),
+            self.hsl_to_rgb([(h + angle) % 360, hsl[1], hsl[2]]),
+            self.hsl_to_rgb([(h - angle) % 360, hsl[1], hsl[2]]),
+        ]
+
+    def get_monochromatic_colors(self, input_xcolor, count=5):
+        """
+        단색 배색: 같은 색상(H)에서 명도만 달리한 count개 색
+        """
+        hsl = self._change_xcolor_to_hsl(input_xcolor)
+        step = 100 // (count + 1)
+        return [self.hsl_to_rgb([hsl[0], hsl[1], step * (i + 1)]) for i in range(count)]
+
+    def is_dark_color(self, input_rgb):
+        """
+        어두운 색인지 여부 (True/False)
+        luminance 0.5 기준
+        """
+        r, g, b = [x / 255 for x in input_rgb]
+        luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b
+        return luminance < 0.5
+
+    def is_warm_color(self, input_rgb):
+        """
+        따뜻한 색(빨강~노랑 계열)인지 여부
+        HSL 기준 H가 0~60 또는 300~360이면 따뜻한 색
+        """
+        hsl = self.rgb_to_hsl(input_rgb)
+        h = hsl[0]
+        return h <= 60 or h >= 300
+
+    def get_color_temperature(self, input_rgb):
+        """
+        색 온도 분류 반환: "warm" / "cool" / "neutral"
+        """
+        hsl = self.rgb_to_hsl(input_rgb)
+        h = hsl[0]
+        if h <= 60 or h >= 300:
+            return "warm"
+        elif 150 <= h <= 270:
+            return "cool"
+        else:
+            return "neutral"
+
+    def get_color_info(self, input_rgb):
+        """
+        RGB 색상의 종합 정보를 딕셔너리로 반환
+        {"rgb", "hsl", "hsv", "hex", "cmyk", "is_dark", "temperature"}
+        """
+        return {
+            "rgb":         input_rgb,
+            "hsl":         self.rgb_to_hsl(input_rgb),
+            "hsv":         self.rgb_to_hsv(input_rgb),
+            "hex":         self.change_rgb_to_hex(input_rgb),
+            "cmyk":        self.rgb_to_cmyk(input_rgb),
+            "is_dark":     self.is_dark_color(input_rgb),
+            "temperature": self.get_color_temperature(input_rgb),
+        }
+
+
+
+
+
+

{xython-4.3.9 → xython-4.3.10}/src/xython/xy_edge.py

@@ -2955,3 +2955,38 @@ class xy_edge:
         else:
             print("❌ PDF 데이터를 생성하지 못했습니다.")
 
+
+    def write_by_xpath(self, xpath: str, value: str) -> bool:
+        try:
+            element = self.page.ele(f'xpath:{xpath}')
+
+            if element is None:
+                print(f"[ERROR] 요소를 찾을 수 없습니다: {xpath}")
+                return False
+
+            element.clear()  # 기존 내용 초기화
+            element.input(value)  # 값 입력
+
+            print(f"[OK] 입력 완료")
+            return True
+
+        except Exception as e:
+            print(f"[ERROR] 입력 실패 - {e}")
+            return False
+
+    def write_by_id(self, element_id: str, value: str) -> bool:
+        try:
+            element = self.page.ele(f'#{element_id}')
+            if element is None:
+                print(f"[ERROR] 요소를 찾을 수 없습니다: #{element_id}")
+                return False
+
+            element.clear()
+            element.input(value)
+
+            print(f"[OK] 입력 완료")
+            return True
+
+        except Exception as e:
+            print(f"[ERROR] 입력 실패 - {e}")
+            return False