ADD:givemecolor

Author: ParthVirgoz

README.md

@@ -0,0 +1,87 @@
+# Giveme Color
+
+Giveme Color is a simple Python package that generates a random color and copies it to the clipboard. It’s a handy tool for quickly obtaining a random color code for your projects.
+
+## Features
+
+- Generates a random color.
+- Automatically copies the color code to your clipboard.
+
+## Installation
+
+You can install Giveme Color via pip:
+
+```bash
+pip install givemecolor
+```
+
+## Usage
+
+### Method 1: Directly from Python
+
+First, import the package in your Python script:
+
+```python
+import givemecolor
+```
+
+Then, call the function to generate a random color:
+
+```python
+givemecolor.givemecolor()
+```
+
+### Method 2: Using an Alias
+
+Alternatively, you can import the function directly:
+
+```python
+from givemecolor import givemecolor
+```
+
+And call it the same way:
+
+```python
+givemecolor()
+```
+
+The color code will be copied to your clipboard automatically, so you can easily paste it wherever needed.
+
+### Command Line Usage
+
+After installation, you can also use `givemecolor` directly from the command line:
+
+```bash
+givemecolor
+```
+
+This command will generate a random color and copy the color code to your clipboard.
+
+## Example
+
+Here’s a quick example of using Giveme Color in a Python script:
+
+```python
+from givemecolor import givemecolor
+
+# Generate a random color and copy it to the clipboard
+givemecolor()
+```
+
+## About the Author
+
+Giveme Color is created by Parth Dudhatra (imParth), a passionate software engineer, developer advocate, and content creator known for his contributions to the tech community. Parth is dedicated to frontend development, Python programming, open-source software, and sharing knowledge with others.
+
+Parth is active on various social media platforms, where he shares insights, tutorials, and tips related to programming, web development, and software engineering. Parth's dedication to sharing his expertise and fostering a supportive environment for developers has earned him recognition and respect within the tech community.
+
+You can connect with Parth on social media:
+
+- [Portfolio](https://imparth.me)
+- [X/Twitter](https://x.com/imparth73)
+- [Instagram](https://instagram.com/imparth.dev)
+- [GitHub](https://github.com/imparth7)
+- [LinkedIn](https://linkedin.com/in/imparth7)
+- [Medium](https://imparth7.medium.com)
+- [Dev.to](https://dev.to/imparth)
+
+If you have any questions, feedback, or suggestions, feel free to reach out on any platform!

givemecolor/__init__.py

@@ -0,0 +1 @@
+from .main import givemecolor

givemecolor/main.py

@@ -0,0 +1,44 @@
+import random
+import sys
+import subprocess
+
+
+def givemecolor():
+    # Generate random values for red, green, and blue components
+    red = random.randint(0, 255)
+    green = random.randint(0, 255)
+    blue = random.randint(0, 255)
+
+    # Convert decimal to hexadecimal format
+    red_hex = f"{red:02x}"
+    green_hex = f"{green:02x}"
+    blue_hex = f"{blue:02x}"
+
+    # Calculate luminance
+    luminance = (0.299 * red + 0.587 * green + 0.114 * blue) / 255
+
+    # Determine luminance color
+    lum_color = "0;0;0" if luminance > 0.5 else "255;255;255"
+
+    # Concatenate the components to form the color code
+    color = f"#{red_hex}{green_hex}{blue_hex}"
+
+    # Copy to clipboard
+    copy_to_clipboard(color)
+
+    # Print the color
+    print(f"\033[48;2;{red};{green};{blue}m\033[38;2;{lum_color}m{color}\033[0m")
+
+
+def copy_to_clipboard(color):
+    # Determine the platform
+    if sys.platform == "win32":
+        # Windows
+        subprocess.run(f"echo {color.strip()} | clip", shell=True)
+    else:
+        # macOS and Linux
+        subprocess.run(f"echo -n {color.strip()} | pbcopy", shell=True)
+
+
+if __name__ == "__main__":
+    givemecolor()

setup.py

@@ -0,0 +1,28 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="givemecolor",
+    version="1.0.1",
+    description="Giveme Color is a random color generator package. Every time it returns a new random color and copies it to your clipboard.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="imparth",
+    url="https://github.com/imparth7/giveme-color-py",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    keywords=["random", "color"],
+    python_requires=">=3.6",
+    entry_points={
+        "console_scripts": [
+            "givemecolor=givemecolor:givemecolor",
+        ],
+    },
+    project_urls={
+        "Bug Reports": "https://github.com/imparth7/giveme-color-py/issues",
+        "Homepage": "https://github.com/imparth7/giveme-color-py#readme",
+    },
+)