Hued version 1.0.6.

Author: Infinitode

Tests/test_palettes.py

@@ -1,3 +1,4 @@
+import os
 from hued.palettes import ColorPalette
 
 def test_generate_complementary():
@@ -119,6 +120,74 @@ def test_generate_random_hex_colors():
     assert isinstance(result, list), "Expected a list for the random HEX colors."
     print("Random HEX Colors:", result)
 
+def test_generate_gradient():
+    print("Testing Gradient Generation...")
+    base_color = (255, 60, 52)  # Example base color (Red)
+    palette = ColorPalette(base_color)
+    start_color = (255, 60, 52)  # Start color (Red)
+    end_color = (51, 247, 255)  # End color (Cyan)
+    expected_gradient = [
+        (255, 60, 52),
+        (214, 97, 92),
+        (173, 134, 133),
+        (132, 172, 173),
+        (91, 209, 214),
+        (51, 247, 255)
+    ]
+    result = palette.generate_gradient(start_color, end_color, steps=5)
+    assert result == expected_gradient, f"Expected {expected_gradient}, but got {result}"
+    print(f"Gradient: {result}")
+
+def test_export_palette():
+    print("Testing Palette Export...")
+    base = (255, 60, 52) # Red
+    cp = ColorPalette(base)
+
+    # 1. Export a simple list palette (e.g., complementary)
+    print("Generating Complementary...")
+    comp_palette = cp.generate_complementary() # self.palette is now the complementary list
+    print(f"Current Palette (Complementary List): {cp.palette}")
+    try:
+        cp.export_palette("complementary_palette.json")
+        cp.export_palette("complementary_palette.txt")
+        cp.export_palette("complementary_palette.csv")
+        print("Exported complementary list palette.")
+    except Exception as e:
+        print(f"Error exporting complementary: {e}")
+
+
+    # 2. Generate and export a complex dictionary palette
+    print("\nGenerating Random Palette Dictionary...")
+    # Generate the dict and set it as the current palette
+    random_palette_dict = cp.generate_random_palette()
+    print(f"Current Palette (Random Dict): Keys = {cp.palette.keys()}")
+    try:
+        cp.export_palette("random_palette_structure.json")
+        cp.export_palette("random_palette_structure.txt")
+        cp.export_palette("random_palette_structure.csv")
+        print("Exported random dictionary palette.")
+    except Exception as e:
+        print(f"Error exporting random dict: {e}")
+
+    # 3. Generate a gradient (doesn't modify self.palette) and export it separately
+    print("\nGenerating Gradient...")
+    gradient = cp.generate_gradient((255, 0, 0), (0, 0, 255), steps=5)
+    # To export the gradient, temporarily set it as the palette
+    original_palette = cp.palette # Save current palette
+    cp.palette = gradient
+    print(f"Current Palette (Gradient List): {cp.palette}")
+    try:
+        cp.export_palette("gradient_palette.json")
+        cp.export_palette("gradient_palette.txt")
+        cp.export_palette("gradient_palette.csv")
+        print("Exported gradient list palette.")
+    except Exception as e:
+        print(f"Error exporting gradient: {e}")
+    finally:
+        cp.palette = original_palette # Restore previous palette
+
+    print("\Exporting complete.")
+
 def run_tests():
     test_generate_complementary()
     test_generate_analogous()
@@ -131,6 +200,8 @@ def run_tests():
     test_generate_random_palette()
     test_generate_random_color()
     test_generate_random_hex_colors()
+    test_generate_gradient()
+    test_export_palette()
     print("All tests passed!")
 
 if __name__ == "__main__":

hued/analysis.py

@@ -1,24 +1,3 @@
-"""
-Module: analysis.py
-
-This module provides functions to analyze the properties of colors.
-It includes methods to determine the temperature, neutrality, brightness,
-and whether a color is pastel, muted, or vibrant.
-
-Functions:
-    - get_temperature: Determines the temperature of a color based on its RGB values.
-    - is_neutral: Checks if a color is neutral.
-    - brightness: Calculates the brightness of a color.
-    - is_pastel: Checks if a color is pastel.
-    - is_muted: Checks if a color is muted.
-    - is_vibrant: Checks if a color is vibrant.
-    - rgb_to_linear: Convert RGB values to linear RGB.
-    - get_luminance: Calculate the relative luminance of an RGB color.
-    - get_vibrancy: Calculate the vibrancy of an RGB color.
-    - color_contrast: Calculates the contrast ratio between two colors using their RGB values.
-    - get_text_color_from_background: Determines whether the text should be "light" or "dark" based on the background color.
-"""
-
 from hued.conversions import rgb_to_hsv
 
 def get_temperature(rgb):

hued/colors.py

@@ -1,22 +1,3 @@
-"""
-Module: colors.py
-
-This module provides functionality for working with a predefined list of named colors.
-It includes methods to search for the closest color name given a hex value and to retrieve 
-color information such as RGB and HEX values.
-
-Classes:
-    - ColorManager: Manages predefined color data and provides search functionality.
-
-Methods:
-    - ColorManager.__init__: Initializes the color manager with a predefined list of colors.
-    - ColorManager.hex_to_rgb: Converts a hex color code to RGB.
-    - ColorManager.rgb_to_hex: Converts RGB values to a hex color code.
-    - ColorManager.closest_color_name: Finds the closest color name given a hex value.
-    - ColorManager.get_color_by_name: Returns the hex and RGB values of a color based on its name.
-"""
-
-
 class ColorManager:
     """
     Manages a collection of predefined named colors and provides methods for color search
@@ -1415,4 +1396,4 @@ def get_color_by_name(self, name):
                     'Hex': hex_value,
                     'RGB': rgb_value
                 }
-        return None
+        return None

hued/conversions.py

@@ -1,43 +1,3 @@
-"""
-Module: conversions.py
-
-This module provides methods for converting between different color formats,
-including RGB, HEX, HSL, HSV, and CMYK.
-
-Methods:
-    - rgb_to_hex(r, g, b): Converts RGB to HEX.
-    - rgb_to_hsl(r, g, b): Converts RGB to HSL.
-    - rgb_to_hsv(r, g, b): Converts RGB to HSV.
-    - rgb_to_cmyk(r, g, b): Converts RGB to CMYK.
-    - rgb_to_xyz(r, g, b): Converts RGB to XYZ.
-    - hex_to_rgb(hex_value): Converts HEX to RGB.
-    - hex_to_hsl(hex_value): Converts HEX to HSL.
-    - hex_to_hsv(hex_value): Converts HEX to HSV.
-    - hex_to_cmyk(hex_value): Converts HEX to CMYK.
-    - hex_to_xyz(hex_value): Converts HEX to XYZ.
-    - hsl_to_rgb(h, s, l): Converts HSL to RGB.
-    - hsl_to_hex(hsl_value): Converts HSL to HEX.
-    - hsl_to_hsv(hsl_value): Converts HSL to HSV.
-    - hsl_to_cmyk(hsl_value): Converts HSL to CMYK.
-    - hsl_to_xyz(hsl_value): Converts HSL to XYZ.
-    - hsv_to_rgb(h, s, v): Converts HSV to RGB.
-    - hsv_to_hex(hsv_value): Converts HSV to HEX.
-    - hsv_to_hsl(hsv_value): Converts HSV to HSL.
-    - hsv_to_cmyk(hsv_value): Converts HSV to CMYK.
-    - hsv_to_xyz(hsv_value): Converts HSV to XYZ.
-    - cmyk_to_rgb(c, m, y, k): Converts CMYK to RGB.
-    - cmyk_to_hex(cmyk_value): Converts CMYK to HEX.
-    - cmyk_to_hsl(cmyk_value): Converts CMYK to HSL.
-    - cmyk_to_hsv(cmyk_value): Converts CMYK to HSV.
-    - cmyk_to_xyz(cmyk_value): Converts CMYK to XYZ.
-    - xyz_to_rgb(x, y, z): Converts XYZ to RGB.
-    - xyz_to_hex(xyz_value): Converts XYZ to HEX.
-    - xyz_to_hsl(xyz_value): Converts XYZ to HSL.
-    - xyz_to_hsv(xyz_value): Converts XYZ to HSV.
-    - xyz_to_cmyk(xyz_value): Converts XYZ to CMYK.
-    - blend_colors(color1, color2, ratio=0.5): Blends two colors in the RGB format (tuple) using the specified ratio.
-"""
-
 def rgb_to_hex(r, g, b):
     """
     Converts RGB values to a hex color code.