craftllc-api 0.1.2__py3-none-any.whl

craftapi/__init__.py

@@ -0,0 +1,5 @@
+from .requests import ReqTools, UnknownMethod
+from .nytgames import Wordle
+from .vartools import VarTools
+
+__all__ = ['ReqTools', 'UnknownMethod', 'VarTools', 'Wordle']

craftapi/nytgames.py

@@ -0,0 +1,13 @@
+import requests
+import bs4
+
+class Wordle:
+    @property
+    def answer(self):
+        """Отримує відповідь на сьогоднішнє слово Wordle."""
+        link = "https://www.tomsguide.com/news/what-is-todays-wordle-answer"
+        req = requests.get(link)
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        word = soup.find_all("strong")[7].text
+        word = word.upper().replace(".", "")
+        return word

craftapi/requests.py

@@ -0,0 +1,177 @@
+import requests
+import bs4
+from urllib.parse import quote as url
+
+class UnknownMethod(Exception):
+    """Виключення для невідомих HTTP методів."""
+    pass
+
+class ReqTools:
+    def __init__(self):
+        pass
+     
+    def whois(self, address):
+        address = url(address)
+        r = requests.get(f"https://who.is/whois-ip/ip-address/{address}")
+        soup = bs4.BeautifulSoup(r.text, "html.parser")
+        text = soup.find("pre").text
+        text_lines = text.splitlines()
+        toReturn = {}
+        for text in text_lines:
+            option = text[:15].replace(" ", "").replace(":", "").strip()
+            value = text[15:]
+            toReturn[option] = value
+        try:
+            del toReturn["Comment"]
+        except:
+            pass
+        return toReturn
+
+    def find_all_images_url(self, site_url, method="GET", **kwargs):
+        """Знаходить всі URL-адреси зображень на вказаному сайті."""
+        if method.upper() == "GET":
+            req = requests.get(site_url, **kwargs)
+        elif method.upper() == "POST":
+            req = requests.post(site_url, **kwargs)
+        elif method.upper() == "PUT":
+            req = requests.put(site_url, **kwargs)
+        elif method.upper() == "DELETE":
+            req = requests.delete(site_url, **kwargs)
+        elif method.upper() == "PATCH":
+            req = requests.patch(site_url, **kwargs)
+        elif method.upper() == "OPTIONS":
+            req = requests.options(site_url, **kwargs)
+        elif method.upper() == "HEAD":
+            req = requests.head(site_url, **kwargs)
+        elif method.upper() == "TRACE":
+            req = requests.trace(site_url, **kwargs)
+        else:
+            raise UnknownMethod("Please input correct HTTP method.")
+
+        req.raise_for_status()
+
+        if method.upper() == "OPTIONS":
+            return req.headers
+
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        images_urls = []
+        images = soup.find_all("img")
+
+        for img in images:
+            src = img.get("src")
+            if src:
+                if src.startswith("/"):
+                    src = f"{site_url}{src}"
+                images_urls.append(src)
+
+        return images_urls
+
+    def get_page_title(self, site_url):
+        """Отримує заголовок сторінки."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        return soup.title.string.strip() if soup.title else "No title found"
+
+    def get_all_links(self, site_url):
+        """Отримує всі посилання на сторінці."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        links = []
+        for a in soup.find_all("a", href=True):
+            href = a["href"]
+            if href.startswith("/"):
+                href = f"{site_url}{href}"
+            links.append(href)
+        return links
+
+    def check_http_status(self, site_url):
+        """Перевіряє HTTP статус-код для вказаного сайту."""
+        try:
+            req = requests.get(site_url)
+            return req.status_code
+        except requests.exceptions.RequestException as e:
+            return f"Error: {e}"
+
+    def extract_paragraphs(self, site_url):
+        """Витягує всі абзаци з вказаного сайту."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        paragraphs = [p.get_text() for p in soup.find_all("p")]
+        return paragraphs
+
+    def get_meta_tags(self, site_url):
+        """Отримує всі мета-теги з веб-сторінки."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        meta_tags = {meta.get("name"): meta.get("content") for meta in soup.find_all("meta") if meta.get("name")}
+        return meta_tags
+
+    def check_ssl_certificate(self, site_url):
+        """Перевіряє SSL сертифікат для HTTPS-з'єднань."""
+        try:
+            req = requests.get(site_url)
+            if req.url.startswith("https"):
+                return "SSL certificate is valid."
+            else:
+                return "SSL certificate is not valid."
+        except requests.exceptions.SSLError as e:
+            return f"SSL error: {e}"
+        except requests.exceptions.RequestException as e:
+            return f"Error: {e}"
+
+    def save_html_to_file(self, site_url, filename="output.html"):
+        """Зберігає HTML-код сторінки у файл."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        with open(filename, "w", encoding="utf-8") as file:
+            file.write(req.text)
+        return f"HTML content saved to {filename}"
+
+    def extract_list_items(self, site_url):
+        """Витягує всі елементи списку з веб-сторінки."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        list_items = [li.get_text() for li in soup.find_all("li")]
+        return list_items
+
+    def get_first_h1(self, site_url):
+        """Отримує перший заголовок <h1> з веб-сторінки."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        h1 = soup.find("h1")
+        return h1.get_text().strip() if h1 else "No <h1> tag found"
+
+    def get_all_scripts(self, site_url):
+        """Отримує всі скрипти з веб-сторінки."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        scripts = [script.get("src") for script in soup.find_all("script") if script.get("src")]
+        return scripts
+
+    def extract_form_data(self, site_url):
+        """Витягує дані з форм на веб-сторінці."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        forms = []
+        for form in soup.find_all("form"):
+            action = form.get("action")
+            method = form.get("method", "GET").upper()
+            inputs = {input.get("name"): input.get("type") for input in form.find_all("input")}
+            forms.append({"action": action, "method": method, "inputs": inputs})
+        return forms
+
+    def get_css_links(self, site_url):
+        """Отримує всі посилання на CSS файли з веб-сторінки."""
+        req = requests.get(site_url)
+        req.raise_for_status()
+        soup = bs4.BeautifulSoup(req.text, "html.parser")
+        css_links = [link.get("href") for link in soup.find_all("link", rel="stylesheet")]
+        return css_links

craftapi/vartools.py

@@ -0,0 +1,47 @@
+class VarTools:
+    def __init__(self, varlist):
+        self.varlist = varlist
+    
+    def get_var_value(self, var):
+        return self.varlist[var]
+    
+    def clean_type(self, var):
+        var_type = str(type(self.varlist[var]))
+        result = var_type.split("'")[1]
+        return result
+
+    def format_time(self, seconds):
+        endings = {
+            "секунда": ["секунда", "секунди", "секунд"],
+            "хвилина": ["хвилина", "хвилини", "хвилин"],
+            "година": ["година", "години", "годин"],
+            "день": ["день", "дня", "днів"],
+            "тиждень": ["тиждень", "тижня", "тижнів"],
+            "місяць": ["місяць", "місяця", "місяців"],
+            "рік": ["рік", "роки", "років"]
+        }
+
+        units = [
+            ("рік", 365 * 24 * 60 * 60),
+            ("місяць", 30 * 24 * 60 * 60),
+            ("тиждень", 7 * 24 * 60 * 60),
+            ("день", 24 * 60 * 60),
+            ("година", 60 * 60),
+            ("хвилина", 60),
+            ("секунда", 1)
+        ]
+
+        for unit, duration in units:
+            if seconds >= duration:
+                number = seconds // duration
+                if 11 <= number % 100 <= 19:
+                    form = endings[unit][2]
+                else:
+                    last_digit = number % 10
+                    if last_digit == 1:
+                        form = endings[unit][0]
+                    elif 2 <= last_digit <= 4:
+                        form = endings[unit][1]
+                    else:
+                        form = endings[unit][2]
+                return f"{number} {form}"

craftllc_api-0.1.2.dist-info/METADATA

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: craftllc-api
+Version: 0.1.2
+Summary: CraftLLC API
+Author-email: CraftLLC <craftllcompany@gmail.com>
+License: MIT
+Keywords: api,craftapi,craftllc,craftllc-api
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: bs4
+
+# CraftAPI
+
+CraftAPI is a simple-to-use Python library providing a set of tools for interacting with websites and retrieving various types of information, as well as utility functions for variable manipulation and time formatting.
+
+## Installation
+
+Install the package using pip:
+
+```bash
+pip install craftapi
+```
+
+## Usage
+
+### `ReqTools` Class
+
+This class provides methods for web scraping and making HTTP requests.
+
+```python
+from craftapi import ReqTools, UnknownMethod
+
+req_tools = ReqTools()
+
+# Get page title
+title = req_tools.get_page_title("https://www.python.org/")
+print(f"Page Title: {title}")
+
+# Get all links on a page
+links = req_tools.get_all_links("https://www.python.org/")
+print("All Links:")
+for link in links[:5]: # Print first 5 links
+    print(link)
+
+# Check HTTP status code
+status_code = req_tools.check_http_status("https://www.python.org/")
+print(f"HTTP Status Code: {status_code}")
+
+# Extract all paragraphs
+paragraphs = req_tools.extract_paragraphs("https://www.python.org/")
+print("First Paragraph:")
+if paragraphs:
+    print(paragraphs[0])
+
+# Get meta tags
+meta_tags = req_tools.get_meta_tags("https://www.python.org/")
+print("Meta Tags:")
+for name, content in meta_tags.items():
+    print(f"  {name}: {content}")
+
+# Check SSL certificate (basic check)
+ssl_status = req_tools.check_ssl_certificate("https://www.google.com/")
+print(f"SSL Status: {ssl_status}")
+
+# Save HTML content to a file
+save_status = req_tools.save_html_to_file("https://www.python.org/", "python_org.html")
+print(save_status)
+
+# Extract list items
+list_items = req_tools.extract_list_items("https://www.python.org/")
+print("First List Item:")
+if list_items:
+    print(list_items[0])
+
+# Get the first H1 tag
+h1_tag = req_tools.get_first_h1("https://www.python.org/")
+print(f"First H1 Tag: {h1_tag}")
+
+# Get all script URLs
+scripts = req_tools.get_all_scripts("https://www.python.org/")
+print("First Script URL:")
+if scripts:
+    print(scripts[0])
+
+# Extract form data
+form_data = req_tools.extract_form_data("https://www.w3schools.com/html/html_forms.asp")
+print("Form Data (first form):")
+if form_data:
+    print(form_data[0])
+
+# Get CSS links
+css_links = req_tools.get_css_links("https://www.python.org/")
+print("First CSS Link:")
+if css_links:
+    print(css_links[0])
+
+# Find all image URLs
+image_urls = req_tools.find_all_images_url("https://www.python.org/")
+print("First Image URL:")
+if image_urls:
+    print(image_urls[0])
+
+# WHOIS lookup
+whois_info = req_tools.whois("8.8.8.8")
+print("WHOIS Info for 8.8.8.8:")
+for key, value in whois_info.items():
+    print(f"  {key}: {value}")
+
+# Example of UnknownMethod exception
+try:
+    req_tools.find_all_images_url("https://example.com", method="INVALID")
+except UnknownMethod as e:
+    print(f"Caught expected exception: {e}")
+```
+
+### `Wordle` Class (from `nytgames` module)
+
+This class provides methods related to New York Times games, specifically Wordle.
+
+```python
+from craftapi import Wordle
+
+wordle_game = Wordle()
+
+# Get today's Wordle answer
+wordle_answer = wordle_game.answer
+print(f"Today's Wordle Answer: {wordle_answer}")
+```
+
+### `VarTools` Class
+
+This class provides utility methods for variable inspection and time formatting.
+
+```python
+from craftapi import VarTools
+
+my_vars = {"name": "CraftAPI", "version": 0.1, "is_active": True}
+var_tools = VarTools(my_vars)
+
+# Get variable value
+name_value = var_tools.get_var_value("name")
+print(f"Value of 'name': {name_value}")
+
+# Clean variable type
+name_type = var_tools.clean_type("name")
+version_type = var_tools.clean_type("version")
+print(f"Type of 'name': {name_type}")
+print(f"Type of 'version': {version_type}")
+
+# Format time in seconds
+formatted_time_seconds = var_tools.format_time(30)
+formatted_time_minutes = var_tools.format_time(150)
+formatted_time_hours = var_tools.format_time(7200)
+formatted_time_days = var_tools.format_time(90000)
+print(f"30 seconds: {formatted_time_seconds}")
+print(f"150 seconds: {formatted_time_minutes}")
+print(f"7200 seconds: {formatted_time_hours}")
+print(f"90000 seconds: {formatted_time_days}")
+```
+
+## License
+
+This project is licensed under the MIT License.

craftllc_api-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+craftapi/__init__.py,sha256=4xOHinhyYJ8_TH-8S9yUd7sMZE0higCzOSylcx1qn04,168
+craftapi/nytgames.py,sha256=MbQxdSRaJzmq2eVHnkMnuRYiw-fS7waCrvgbRZOuJuA,453
+craftapi/requests.py,sha256=XTSefwlUrMpD5tgXdVwaR7knA8rH9zCqRTc3PzFX63I,7066
+craftapi/vartools.py,sha256=GQcdpArp2ljDyByviTwfdPejigCXn9CqEquiIyQGYaI,1783
+craftllc_api-0.1.2.dist-info/METADATA,sha256=SfXWtGH_epvKjzl7AZrbcyo2PxLHrpolXOht4-EOY5k,4535
+craftllc_api-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+craftllc_api-0.1.2.dist-info/top_level.txt,sha256=-FJLUCUwjYRmLTITEExlxuanZxZ98cJawflmrfEP2qY,9
+craftllc_api-0.1.2.dist-info/RECORD,,

craftllc_api-0.1.2.dist-info/WHEEL

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

craftllc_api-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+craftapi