Open-AutoTools 0.0.1__tar.gz

open_autotools-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 MAX REMY DEV
+
+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.

open_autotools-0.0.1/Open_AutoTools.egg-info/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.1
+Name: Open-AutoTools
+Version: 0.0.1
+License-File: LICENSE
+Requires-Dist: Brotli==1.1.0
+Requires-Dist: certifi==2024.2.2
+Requires-Dist: charset-normalizer==3.3.2
+Requires-Dist: click==8.1.7
+Requires-Dist: idna==3.6
+Requires-Dist: importlib-metadata==7.0.1
+Requires-Dist: joblib==1.3.2
+Requires-Dist: Levenshtein==0.25.0
+Requires-Dist: mutagen==1.47.0
+Requires-Dist: nltk==3.8.1
+Requires-Dist: platformdirs==4.2.0
+Requires-Dist: pycryptodomex==3.20.0
+Requires-Dist: pyperclip==1.9.0
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: python-Levenshtein==0.25.0
+Requires-Dist: rapidfuzz==3.6.1
+Requires-Dist: regex==2023.12.25
+Requires-Dist: requests==2.32.3
+Requires-Dist: textblob==0.18.0.post0
+Requires-Dist: tomli==2.0.1
+Requires-Dist: tqdm==4.66.2
+Requires-Dist: urllib3==2.2.1
+Requires-Dist: websockets==13.0.1
+Requires-Dist: yapf==0.40.2
+Requires-Dist: yt-dlp==2024.8.6
+Requires-Dist: zipp==3.17.0

open_autotools-0.0.1/Open_AutoTools.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+README.md
+setup.py
+Open_AutoTools.egg-info/PKG-INFO
+Open_AutoTools.egg-info/SOURCES.txt
+Open_AutoTools.egg-info/dependency_links.txt
+Open_AutoTools.egg-info/entry_points.txt
+Open_AutoTools.egg-info/requires.txt
+Open_AutoTools.egg-info/top_level.txt
+autotools/__init__.py
+autotools/cli.py
+autotools/autocaps/__init__.py
+autotools/autocaps/core.py
+autotools/autocorrect/__init__.py
+autotools/autocorrect/core.py
+autotools/autotranslate/__init__.py
+autotools/autotranslate/core.py
+autotools/downloader/__init__.py
+autotools/downloader/core.py

open_autotools-0.0.1/Open_AutoTools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

open_autotools-0.0.1/Open_AutoTools.egg-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+autocaps = autotools.cli:autocaps
+autocorrect = autotools.cli:autocorrect
+autodownload = autotools.cli:autodownload
+autotools = autotools.cli:autotools
+autotranslate = autotools.cli:autotranslate

open_autotools-0.0.1/Open_AutoTools.egg-info/requires.txt

@@ -0,0 +1,26 @@
+Brotli==1.1.0
+certifi==2024.2.2
+charset-normalizer==3.3.2
+click==8.1.7
+idna==3.6
+importlib-metadata==7.0.1
+joblib==1.3.2
+Levenshtein==0.25.0
+mutagen==1.47.0
+nltk==3.8.1
+platformdirs==4.2.0
+pycryptodomex==3.20.0
+pyperclip==1.9.0
+python-dotenv==1.0.1
+python-Levenshtein==0.25.0
+rapidfuzz==3.6.1
+regex==2023.12.25
+requests==2.32.3
+textblob==0.18.0.post0
+tomli==2.0.1
+tqdm==4.66.2
+urllib3==2.2.1
+websockets==13.0.1
+yapf==0.40.2
+yt-dlp==2024.8.6
+zipp==3.17.0

open_autotools-0.0.1/Open_AutoTools.egg-info/top_level.txt

@@ -0,0 +1 @@
+autotools

open_autotools-0.0.1/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.1
+Name: Open-AutoTools
+Version: 0.0.1
+License-File: LICENSE
+Requires-Dist: Brotli==1.1.0
+Requires-Dist: certifi==2024.2.2
+Requires-Dist: charset-normalizer==3.3.2
+Requires-Dist: click==8.1.7
+Requires-Dist: idna==3.6
+Requires-Dist: importlib-metadata==7.0.1
+Requires-Dist: joblib==1.3.2
+Requires-Dist: Levenshtein==0.25.0
+Requires-Dist: mutagen==1.47.0
+Requires-Dist: nltk==3.8.1
+Requires-Dist: platformdirs==4.2.0
+Requires-Dist: pycryptodomex==3.20.0
+Requires-Dist: pyperclip==1.9.0
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: python-Levenshtein==0.25.0
+Requires-Dist: rapidfuzz==3.6.1
+Requires-Dist: regex==2023.12.25
+Requires-Dist: requests==2.32.3
+Requires-Dist: textblob==0.18.0.post0
+Requires-Dist: tomli==2.0.1
+Requires-Dist: tqdm==4.66.2
+Requires-Dist: urllib3==2.2.1
+Requires-Dist: websockets==13.0.1
+Requires-Dist: yapf==0.40.2
+Requires-Dist: yt-dlp==2024.8.6
+Requires-Dist: zipp==3.17.0

open_autotools-0.0.1/README.md

@@ -0,0 +1,65 @@
+# Open-AutoTools - ***WORK IN PROGRESS (WIP)***
+Open-AutoTools is an innovative project developed in Python, specifically designed to offer a suite of automated tools directly accessible via the terminal. This project aims to simplify and automate daily tasks for developers and terminal users, such as converting text to uppercase, automatically correcting text errors, and real-time text translation.
+
+https://github.com/BabylooPro/Open-AutoTools/assets/35376790/d57f2b9d-55f8-4368-bb40-c0010eb9d49a
+
+## Installation
+To install Open-AutoTools, use the following command in your terminal: ``pip install open-autotools``
+
+This command installs all the necessary tools to integrate Open-AutoTools into your workflow.
+
+## Key Features
+
+### AutoCaps
+- **Description:** Converts any text entered by the user to uppercase.
+- **Usage:** 
+    ```
+    ~ ❯ autocaps "Your text here."
+    ```
+- **Output:**
+    ```
+    YOUR TEXT HERE.
+    ```
+
+### AutoCorrect
+- **Description:** Automatically corrects mistakes in any text.
+- **Usage:** 
+    ```
+    ~ ❯ autocorrect "Your text with mistakes here."
+    ```
+- **Output:**
+    ```
+    Your text without mistakes here.
+    ```
+(Note: The exact output for AutoCorrect will vary depending on the mistakes in the input text and the correction applied.)
+
+### AutoTranslate
+- **Description:** Translates text from one language to another in real-time, offering users a convenient solution to overcome the language barrier.
+- **Usage:** 
+    ```
+    ~ ❯ autotranslate "Bonjour le monde" --from fr --to en
+    ```
+- **Output:**
+    ```
+    Hello world
+    ```
+
+These examples demonstrate how the terminal will display the results after executing each command, providing a straightforward way for users to understand the immediate effects of these commands.
+
+## General Usage
+Open-AutoTools is designed to be used as a set of CLI commands, making its features directly accessible from the user's terminal.
+
+## Technologies, Frameworks, Libraries, and APIs
+- **Programming Language:** Python (3.8 or higher)
+- **Frameworks and Libraries:** Click
+- **APIs:** Text correction API (multi-language), Text translation API (multi-language)
+
+## Contributing
+This project is a work in progress, and we welcome any contributions that can help improve Open-AutoTools. If you're interested in contributing, please check the project's issues or submit a pull request.
+
+## License
+This project is licensed under the MIT License. For more details, see the [LICENSE](LICENSE) file.
+
+---
+
+For more information and updates, please follow the project's GitHub repository.

open_autotools-0.0.1/autotools/autocaps/core.py

@@ -0,0 +1,7 @@
+import pyperclip
+
+# AUTOCAPS CORE FUNCTION DEFINITION
+def autocaps_transform(text):
+    transformed_text = text.upper()  # TRANSFORM TEXT TO UPPERCASE
+    pyperclip.copy(transformed_text)  # COPY TRANSFORMED TEXT TO CLIPBOARD
+    return transformed_text

open_autotools-0.0.1/autotools/autocorrect/core.py

@@ -0,0 +1,34 @@
+import requests
+import os
+import pyperclip
+
+# AUTOCORRECT FUNCTION DEFINITION
+def autocorrect_text(text, language="en"):
+    # API CALL TO REWRITER API
+    url = "https://rewriter-paraphraser-text-changer-multi-language.p.rapidapi.com/rewrite"
+
+    # PAYLOAD AND HEADERS FOR API CALL
+    payload = {
+        "language": language,
+        "strength": 3, # STRENGTH OF REWRITING (STRENGTH 3 IS RECOMMENDED FOR BETTER RESULTS)
+        "text": text
+    }
+    headers = {
+        "content-type": "application/json",
+        "X-RapidAPI-Key": os.getenv('RAPIDAPI_API_KEY'), # API KEY FROM ENVIRONMENT VARIABLE
+        "X-RapidAPI-Host": "rewriter-paraphraser-text-changer-multi-language.p.rapidapi.com"
+    }
+
+    # RESPONSE FROM API CALL
+    response = requests.post(url, json=payload, headers=headers)
+
+    # RETURN REWRITTEN TEXT IF SUCCESSFUL ELSE RETURN ERROR MESSAGE
+    if response.status_code == 200:
+        corrected_text = response.json()['rewrite']
+
+        # COPY CORRECTED TEXT TO CLIPBOARD
+        pyperclip.copy(corrected_text)
+
+        return corrected_text
+    else:
+        return "ERROR: CORRECTION FAILED - " + response.text + str(response.status_code)

open_autotools-0.0.1/autotools/autotranslate/core.py

@@ -0,0 +1,39 @@
+import requests
+import os
+import pyperclip
+
+# PARAMETERS API
+BASE_URL = "https://google-translate113.p.rapidapi.com/api/v1/translator/{}"
+HEADERS = {
+    "X-RapidAPI-Key": os.getenv('RAPIDAPI_API_KEY'),
+    "X-RapidAPI-Host": "google-translate113.p.rapidapi.com"
+}
+
+
+# FUNCTION TO GET SUPPORTED LANGUAGES
+def autotranslate_supported_languages():
+    endpoint = "support-languages"
+    full_url = BASE_URL.format(endpoint)
+    response = requests.get(full_url, headers=HEADERS)
+    languages = response.json()
+
+    language_codes = [lang['code'] for lang in languages]
+    return language_codes
+
+
+# FUNCTION TO TRANSLATE TEXT AND COPY TO CLIPBOARD
+def autotranslate_text(text, language_target):
+    endpoint = "text"
+    full_url = BASE_URL.format(endpoint)
+    payload = {"from": "auto", "to": language_target, "text": text}
+    specific_headers = {
+        **HEADERS, "content-type": "application/x-www-form-urlencoded"
+    }
+
+    response = requests.post(full_url, data=payload, headers=specific_headers)
+    translated_text = response.json()['trans']
+
+    # COPY TRANSLATED TEXT TO CLIPBOARD
+    pyperclip.copy(translated_text)
+
+    return translated_text

open_autotools-0.0.1/autotools/cli.py

@@ -0,0 +1,66 @@
+from dotenv import load_dotenv
+load_dotenv() # LOAD ENVIRONMENT VARIABLES BEFORE IMPORTING OTHER MODULES BECAUSE CERTAIN MODULES DEPEND ON ENVIRONMENT VARIABLES
+
+import os
+import click
+from autotools.autotranslate.core import autotranslate_text, autotranslate_supported_languages
+from autotools.autocorrect.core import autocorrect_text
+from autotools.autocaps.core import autocaps_transform
+from autotools.downloader.core import download_youtube_video, download_file
+
+# CLI FUNCTION DEFINITION
+@click.group()
+def cli():
+    """Autotools is a set of tools for text capitalization, correction and translation."""
+    pass
+
+# AUTOTOOLS COMMAND LINE INTERFACE FUNCTION DEFINITION FOR SHOW HELP MESSAGE
+@cli.command()
+def autotools():
+    return
+
+# AUTOCAPS COMMAND LINE INTERFACE FUNCTION DEFINITION
+@cli.command()
+@click.argument('text')
+def autocaps(text):
+    result = autocaps_transform(text)
+    click.echo(result)
+
+# AUTOCORRECT COMMAND LINE INTERFACE FUNCTION DEFINITION
+@cli.command()
+@click.argument('text')
+def autocorrect(text):
+    result = autocorrect_text(text)
+    click.echo(result)
+
+# AUTOTRANSLATE COMMAND LINE INTERFACE FUNCTION DEFINITION
+VALID_LANGUAGES = autotranslate_supported_languages() # VALID LANGUAGES FOR TRANSLATION
+@cli.command()
+@click.argument('text')
+#@click.option('--from', 'language_origin', required=True, help="Language of the source text")
+@click.option('--to', 'language_target', required=True, help="Target language for translation")
+def autotranslate(text, language_target):
+    if language_target not in VALID_LANGUAGES:
+        click.secho(f"Language code '{
+                    language_target}' is not supported.", fg='red')
+        return
+
+    # CALL TO AUTOTRANSLATE FUNCTION
+    result = autotranslate_text(
+        text, language_target=language_target)
+    click.secho(result)
+
+# AUTODOWNLOAD COMMAND LINE INTERFACE FUNCTION DEFINITION
+@cli.command()
+@click.argument('url')
+@click.option('--format', type=click.Choice(['mp4', 'mp3'], case_sensitive=False), default='mp4', help='Output file format (mp4 or mp3)')
+@click.option('--quality', type=click.Choice(['best', '1440p', '1080p', '720p', '480p', '360p', '240p'], case_sensitive=False), default='best', help='"Video quality (mp4 only)"')
+def autodownload(url, format, quality):
+    if "youtube.com" in url or "youtu.be" in url:
+        download_youtube_video(url, format, quality)
+    else:
+        download_file(url)
+
+# MAIN FUNCTION TO RUN CLI
+if __name__ == '__main__':
+    cli()

open_autotools-0.0.1/autotools/downloader/core.py

@@ -0,0 +1,189 @@
+import requests
+import os
+from pathlib import Path
+from urllib.parse import urlsplit
+from tqdm import tqdm
+import yt_dlp
+import platform
+import subprocess
+
+
+# FUNCTION TO GET DEFAULT DOWNLOAD DIRECTORY
+def get_default_download_dir():
+    return Path(os.getenv('USERPROFILE') if os.name == 'nt' else Path.home()) / 'Downloads'
+
+
+# FUNCTION TO GET FILENAME FROM URL WITH DEFAULT AND EXTENSION HANDLING
+def get_filename_from_url(url):
+    filename = os.path.basename(urlsplit(url).path)
+    if not filename:  # IF NO FILENAME IN URL
+        return "downloaded_file"
+    if not Path(filename).suffix:  # IF NO EXTENSION IN FILENAME
+        return f"{filename}.bin"
+    return filename
+
+
+# FUNCTION TO OPEN DOWNLOAD DIRECTORY AFTER DOWNLOAD IS COMPLETE
+def open_download_folder(path):
+    try:
+        if platform.system() == 'Darwin':  # macOS
+            subprocess.run(['open', '--', path], check=True)
+        elif platform.system() == 'Windows':  # Windows
+            subprocess.run(['explorer', str(path)], check=True)
+        elif platform.system() == 'Linux':  # Linux
+            subprocess.run(['xdg-open', str(path)], check=True)
+    except Exception as e:
+        print(f"Could not open the folder: {e}")
+
+
+# FUNCTION TO VALIDATE YOUTUBE URL FORMAT
+def validate_youtube_url(url):
+    try:
+        # USE YT-DLP TO CHECK IF THE URL IS VALID
+        with yt_dlp.YoutubeDL({'quiet': True, 'no_warnings': True}) as ydl:
+            ydl.extract_info(url, download=False)
+        return True
+    except yt_dlp.utils.DownloadError as e:
+        print(f"Invalid YouTube URL: {e}")
+        return False
+    except Exception as e:
+        print(f"Unexpected error during URL validation: {e}")
+        return False
+
+
+# FUNCTION TO DOWNLOAD FILES WITH REQUESTS, INCLUDING ERROR HANDLING AND PROGRESS BAR
+def download_file(url):
+    download_dir = get_default_download_dir()
+    filename = get_filename_from_url(url)
+    dest_file = download_dir / filename
+
+    try:
+        with requests.get(url, stream=True) as response:
+            response.raise_for_status()
+
+            total_size = int(response.headers.get('content-length', 0))
+            block_size = 1024  # 1KB
+
+            with tqdm(total=total_size if total_size else None, unit='iB', unit_scale=True, desc=f"Downloading {filename}", leave=True) as tqdm_bar:
+                with open(dest_file, 'wb') as file:
+                    for chunk in response.iter_content(chunk_size=block_size):
+                        if chunk:
+                            file.write(chunk)
+                            tqdm_bar.update(len(chunk))
+
+        # AUTOMATICALLY OPEN DOWNLOAD FOLDER AFTER FILE DOWNLOAD IS COMPLETE
+        open_download_folder(download_dir)
+    except requests.exceptions.RequestException as e:
+        print(f"Error during file download: {e}")
+
+
+# FUNCTION TO DOWNLOAD YOUTUBE VIDEOS WITH YT-DLP AND SPECIFIED FORMAT AND QUALITY
+def download_youtube_video(url, file_format='mp4', quality='best'):
+    # First, validate the YouTube URL
+    if not validate_youtube_url(url):
+        print(f"Aborting download: Invalid URL {url}")
+        return
+
+    download_dir = get_default_download_dir()
+
+    video_formats = {
+        '1440p': 'bestvideo[height<=1440]+bestaudio/best[height<=1440]',
+        '1080p': 'bestvideo[height<=1080]+bestaudio/best[height<=1080]',
+        '720p': 'bestvideo[height<=720]+bestaudio/best[height<=720]',
+        '480p': 'bestvideo[height<=480]+bestaudio/best[height<=480]',
+        '360p': 'bestvideo[height<=360]+bestaudio/best[height<=360]',
+        '240p': 'bestvideo[height<=240]+bestaudio/best[height<=240]',
+        'best': 'bestvideo+bestaudio/best'
+    }
+
+    selected_format = video_formats.get(quality, video_formats['best'])
+
+    ydl_opts = {
+        'format': selected_format if file_format == 'mp4' else 'bestaudio',
+        'outtmpl': str(download_dir / '%(title)s.%(ext)s'),
+        'progress_hooks': [tqdm_progress_hook],
+        'quiet': True,  # SUPPRESS MOST OF YT-DLP OUTPUT EXCEPT PROGRESS
+        'no_warnings': True,  # HIDE WARNINGS
+        'merge_output_format': 'mp4'  # AUTOMATICALLY REMUX TO MP4 IF NEEDED
+    }
+
+    if file_format == 'mp3':
+        ydl_opts['postprocessors'] = [{
+            'key': 'FFmpegExtractAudio',
+            'preferredcodec': 'mp3',
+            'preferredquality': '192'
+        }]
+
+    try:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            ydl.download([url])
+        # AUTOMATICALLY OPEN DOWNLOAD FOLDER AFTER YOUTUBE DOWNLOAD IS COMPLETE
+        open_download_folder(download_dir)
+    except yt_dlp.utils.DownloadError as e:
+        print(f"Error during YouTube download: {e}")
+    except Exception as e:
+        print(f"Unexpected error: {e}")
+
+
+# FUNCTION TO LIST AVAILABLE FORMATS FOR A YOUTUBE VIDEO
+def list_available_formats(url):
+    try:
+        with yt_dlp.YoutubeDL({'quiet': True}) as ydl:
+            info_dict = ydl.extract_info(url, download=False)
+            formats = info_dict.get('formats', None)
+            if formats:
+                for f in formats:
+                    print(f"Format: {f['format_id']}, Resolution: {f.get('resolution')}, Extension: {f['ext']}")
+    except yt_dlp.utils.DownloadError as e:
+        print(f"Error fetching formats: {e}")
+    except Exception as e:
+        print(f"Unexpected error: {e}")
+
+pbar = None  # GLOBAL VARIABLE TO STORE PROGRESS BAR
+
+
+# FUNCTION TO UPDATE PROGRESS BAR
+def tqdm_progress_hook(d):
+    global pbar
+
+    if d['status'] == 'downloading':
+        total = d.get('total_bytes', 0)
+        downloaded = d.get('downloaded_bytes', 0)
+
+        if pbar is None:
+            pbar = tqdm(total=total, unit='B', unit_scale=True, desc="YouTube Download", leave=True)
+
+        pbar.n = downloaded
+        pbar.refresh()
+
+    elif d['status'] == 'finished' and pbar:
+        pbar.n = pbar.total
+        pbar.close()
+        print("Download completed")
+        pbar = None
+
+
+# FUNCTION TO DOWNLOAD FILE WITH SPECIFIC HANDLING AND FOLDER OPENING
+def download_file_with_tqdm(url):
+    download_dir = get_default_download_dir()
+    filename = get_filename_from_url(url)
+    dest_file = download_dir / filename
+
+    try:
+        with requests.get(url, stream=True) as response:
+            response.raise_for_status()
+
+            total_size = int(response.headers.get('content-length', 0))
+            block_size = 1024  # 1KB
+
+            with tqdm(total=total_size if total_size else None, unit='iB', unit_scale=True, desc=f"Downloading {filename}", leave=True) as tqdm_bar:
+                with open(dest_file, 'wb') as file:
+                    for chunk in response.iter_content(chunk_size=block_size):
+                        if chunk:
+                            file.write(chunk)
+                            tqdm_bar.update(len(chunk))
+
+        # AUTOMATICALLY OPEN DOWNLOAD FOLDER AFTER FILE DOWNLOAD IS COMPLETE
+        open_download_folder(download_dir)
+    except requests.exceptions.RequestException as e:
+        print(f"Error during file download: {e}")

open_autotools-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

open_autotools-0.0.1/setup.py

@@ -0,0 +1,22 @@
+from setuptools import setup, find_packages
+
+# READING REQUIREMENTS FROM FILE
+with open('requirements.txt') as f:
+    required = [line for line in f.read().splitlines() if "git+" not in line] # ignore git+ links in requirements if "pip freeze > requirements.txt" generates them
+
+# SETUP CONFIGURATION FOR PACKAGE DISTRIBUTION
+setup(
+    name='Open-AutoTools',
+    version='0.0.1',
+    packages=find_packages(),
+    include_package_data=True,
+    install_requires=required,
+    entry_points='''
+        [console_scripts]
+        autotools=autotools.cli:autotools
+        autocaps=autotools.cli:autocaps
+        autocorrect=autotools.cli:autocorrect
+        autotranslate=autotools.cli:autotranslate
+        autodownload=autotools.cli:autodownload
+    ''',
+)