ascii-art-python 3.0.0b3__tar.gz → 3.0.0b4__tar.gz

{ascii_art_python-3.0.0b3/src/ascii_art_python.egg-info → ascii_art_python-3.0.0b4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ascii_art_python
-Version: 3.0.0b3
+Version: 3.0.0b4
 Summary: A Python library and CLI tool for converting images and videos into ASCII art.
 Author-email: Guillem Prieur <prieurguillem38@gmail.com>
 Project-URL: Homepage, https://gitlab.pprriieeuurr.fr/guill_prieur/ascii-art-python-3
@@ -134,6 +134,9 @@ aap-echo my_image.jpg
 
 # Play a video with the 'old_skool' edges-only style
 aap-echo my_video.mp4 -m old_skool
+
+# Play a video with the 'old_skool' edges-only style from Youtube
+aap-echo "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -m old_skool
 ```
 
 
@@ -176,22 +179,32 @@ video.export(filename="my_ascii_video", sound=True, old_skool=True, new_skool=Tr
 ```
 
 
-## Requirements
-
-- Python 3.9+
-
-- `opencv-python`
-
-- `numpy`
+## Prerequisites
 
-- `Pillow`
+This program requires `ffmpeg` to process videos. Before using this script, make sure to install it on your system:
 
-- `moviepy`
+- macOS:
+  ```bash
+  brew install ffmpeg
+  ```
 
-- `click`
+- Windows:
+  ```powershell
+  winget install ffmpeg
+  # or
+  choco install ffmpeg
+  ```
 
-- `tqdm`
+- Linux (Debian/Ubuntu):
+  ```bash
+  sudo apt update && sudo apt install ffmpeg
+  ```
 
+- Linux (Fedora/Arch):
+  ```bash
+  sudo dnf install ffmpeg   # Fedora
+  sudo pacman -S ffmpeg     # Arch Linux
+  ```
 
 ## Full Documentation
 

{ascii_art_python-3.0.0b3 → ascii_art_python-3.0.0b4}/README.md

@@ -92,6 +92,9 @@ aap-echo my_image.jpg
 
 # Play a video with the 'old_skool' edges-only style
 aap-echo my_video.mp4 -m old_skool
+
+# Play a video with the 'old_skool' edges-only style from Youtube
+aap-echo "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -m old_skool
 ```
 
 
@@ -134,22 +137,32 @@ video.export(filename="my_ascii_video", sound=True, old_skool=True, new_skool=Tr
 ```
 
 
-## Requirements
-
-- Python 3.9+
-
-- `opencv-python`
-
-- `numpy`
+## Prerequisites
 
-- `Pillow`
+This program requires `ffmpeg` to process videos. Before using this script, make sure to install it on your system:
 
-- `moviepy`
+- macOS:
+  ```bash
+  brew install ffmpeg
+  ```
 
-- `click`
+- Windows:
+  ```powershell
+  winget install ffmpeg
+  # or
+  choco install ffmpeg
+  ```
 
-- `tqdm`
+- Linux (Debian/Ubuntu):
+  ```bash
+  sudo apt update && sudo apt install ffmpeg
+  ```
 
+- Linux (Fedora/Arch):
+  ```bash
+  sudo dnf install ffmpeg   # Fedora
+  sudo pacman -S ffmpeg     # Arch Linux
+  ```
 
 ## Full Documentation
 

{ascii_art_python-3.0.0b3 → ascii_art_python-3.0.0b4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ascii_art_python"
-version = "3.0.0b3"
+version = "3.0.0b4"
 authors = [
     { name="Guillem Prieur", email="prieurguillem38@gmail.com" },
 ]

{ascii_art_python-3.0.0b3 → ascii_art_python-3.0.0b4}/src/ascii_art_python/cli.py

@@ -34,7 +34,7 @@ def _get_media_type(source_path: str) -> str:
     Returns
     -------
     str
-        TODO
+        The type of media ("image", "video", or "YouTube")
 
     Raises
     ------
@@ -63,7 +63,7 @@ def _get_media_type(source_path: str) -> str:
         raise click.ClickException(f"Error: Unsupported media type '{media_type}'.")
 
 @click.command()
-@click.argument("source_path", type=click.STRING)
+@click.argument("source_uri", type=click.STRING)
 @click.argument("target_filename", type=click.STRING)
 @click.option(
     "--width",
@@ -100,7 +100,7 @@ def _get_media_type(source_path: str) -> str:
     help="If the file is a video, export it with or without audio."
 )
 def create_and_export(
-    source_path: str,
+    source_uri: str,
     target_filename: str,
     width: Optional[int],
     height: Optional[int],
@@ -114,19 +114,19 @@ def create_and_export(
     Processes the input file located at SOURCE_PATH and exports the result
     to TARGET_FILENAME with the specified settings.
     """
-    click.echo(f"▶ Converting '{source_path}'...")
+    click.echo(f"▶ Converting '{source_uri}'...")
     click.echo(f"▶ Settings: length=({width}, {height}), mode={mode}")
 
-    media_type = _get_media_type(source_path)
+    media_type = _get_media_type(source_uri)
     click.echo(f"▶ Export type: {media_type}")
 
     if media_type == "image":
-        image = Image.from_path(source_path, height=height, width=width)
+        image = Image.from_path(source_uri, height=height, width=width)
         image.export(target_filename, font_size = fontsize, **MODES[mode])
         click.echo("✓ Conversion complete!")
 
     elif media_type == "video":
-        video = Video(source_path, width=width, height=height)
+        video = Video(source_uri, width=width, height=height)
         click.echo(
             f"Please note: You are about to export a video with the following settings: "
             f"length=({video.width}, {video.height}) font_size={fontsize}"
@@ -147,9 +147,9 @@ def create_and_export(
         )
         click.confirm("Do you want to continue?", abort=True)
         if height is None:
-            tools.youtube.export(source_path, target_filename, sound = sound)
+            tools.youtube.export(source_uri, target_filename, sound = sound)
         else:
-            tools.youtube.export(source_path, target_filename, height, sound)
+            tools.youtube.export(source_uri, target_filename, height, sound)
         click.echo("✓ Conversion complete!")
         if sound:
             click.echo(f"✓ Your file is available here: {target_filename}_audio.mp4")
@@ -158,7 +158,7 @@ def create_and_export(
 
 
 @click.command()
-@click.argument("source_path", type=click.STRING)
+@click.argument("source_uri", type=click.STRING)
 @click.option(
     "--mode",
     "-m",
@@ -166,7 +166,7 @@ def create_and_export(
     default="full_mode",
     help="The ASCII generation mode to use."
 )
-def create_and_echo(source_path: str, mode: str) -> None:
+def create_and_echo(source_uri: str, mode: str) -> None:
     """
     Creates and prints an ASCII art image or video in the terminal.
 
@@ -174,20 +174,20 @@ def create_and_echo(source_path: str, mode: str) -> None:
     directly to the standard output.
     """
 
-    click.echo(f"▶ Converting '{source_path}'...")
+    click.echo(f"▶ Converting '{source_uri}'...")
     click.echo(f"▶ Settings: mode={mode}")
 
-    media_type = _get_media_type(source_path)
+    media_type = _get_media_type(source_uri)
     click.echo(f"▶ Echo type: {media_type}")
 
     if media_type == "image":
-        image = Image.from_path(source_path)
+        image = Image.from_path(source_uri)
 
         click.echo(image.to_string(**MODES[mode], one_on_two = True))
         click.echo("✓ Conversion complete!")
 
     elif media_type == "video":
-        video = Video(source_path, wanted_fps = 10)
+        video = Video(source_uri, wanted_fps = 10)
 
         click.clear()
         video.print_in_terminal(**MODES[mode], func_print = tools.terminal.clean_print)
@@ -195,5 +195,5 @@ def create_and_echo(source_path: str, mode: str) -> None:
 
     elif media_type == "youtube":
         click.clear()
-        tools.youtube.echo(source_path, **MODES[mode], func_print = tools.terminal.clean_print)
+        tools.youtube.echo(source_uri, **MODES[mode], func_print = tools.terminal.clean_print)
         click.echo("✓ Conversion complete!")

{ascii_art_python-3.0.0b3 → ascii_art_python-3.0.0b4/src/ascii_art_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ascii_art_python
-Version: 3.0.0b3
+Version: 3.0.0b4
 Summary: A Python library and CLI tool for converting images and videos into ASCII art.
 Author-email: Guillem Prieur <prieurguillem38@gmail.com>
 Project-URL: Homepage, https://gitlab.pprriieeuurr.fr/guill_prieur/ascii-art-python-3
@@ -134,6 +134,9 @@ aap-echo my_image.jpg
 
 # Play a video with the 'old_skool' edges-only style
 aap-echo my_video.mp4 -m old_skool
+
+# Play a video with the 'old_skool' edges-only style from Youtube
+aap-echo "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -m old_skool
 ```
 
 
@@ -176,22 +179,32 @@ video.export(filename="my_ascii_video", sound=True, old_skool=True, new_skool=Tr
 ```
 
 
-## Requirements
-
-- Python 3.9+
-
-- `opencv-python`
-
-- `numpy`
+## Prerequisites
 
-- `Pillow`
+This program requires `ffmpeg` to process videos. Before using this script, make sure to install it on your system:
 
-- `moviepy`
+- macOS:
+  ```bash
+  brew install ffmpeg
+  ```
 
-- `click`
+- Windows:
+  ```powershell
+  winget install ffmpeg
+  # or
+  choco install ffmpeg
+  ```
 
-- `tqdm`
+- Linux (Debian/Ubuntu):
+  ```bash
+  sudo apt update && sudo apt install ffmpeg
+  ```
 
+- Linux (Fedora/Arch):
+  ```bash
+  sudo dnf install ffmpeg   # Fedora
+  sudo pacman -S ffmpeg     # Arch Linux
+  ```
 
 ## Full Documentation