ascii-art-python 0.1.0__tar.gz

ascii_art_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guillem Prieur
+
+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.

ascii_art_python-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include ascii_art_python/assets/fonts *

ascii_art_python-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: ascii_art_python
+Version: 0.1.0
+Summary: A Python library for converting images and videos into ASCII art.
+Author-email: Guillem Prieur <prieurguillem38@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pillow
+Requires-Dist: tqdm
+Requires-Dist: opencv-python
+Dynamic: license-file
+
+# Ascii Art Python
+
+Une bibliothèque Python permettant de convertir facilement des images et des vidéos en ASCII Art.
+
+## Installation
+
+Vous pouvez installer la bibliothèque localement ou (si vous la publiez plus tard) via pip :
+
+```bash
+pip install .
+```
+
+## Dependencies
+
+This project uses the following libraries:
+
+- Pillow (image manipulation)
+- opencv-python (video reading and writing)
+- tqdm (progress bar)
+- requests
+
+## Usage
+
+Here is a basic example of how to use the library:
+
+```python
+from ascii_art_python.new_school import ImageAscii
+from PIL import Image
+
+# Load an image with Pillow
+img = Image.open("mon_image.jpg")
+
+# Convert to ASCII
+ascii_converter = ImageAscii(img)
+ascii_converter.export("mon_export", export_type="txt")
+```

ascii_art_python-0.1.0/README.md

@@ -0,0 +1,36 @@
+# Ascii Art Python
+
+Une bibliothèque Python permettant de convertir facilement des images et des vidéos en ASCII Art.
+
+## Installation
+
+Vous pouvez installer la bibliothèque localement ou (si vous la publiez plus tard) via pip :
+
+```bash
+pip install .
+```
+
+## Dependencies
+
+This project uses the following libraries:
+
+- Pillow (image manipulation)
+- opencv-python (video reading and writing)
+- tqdm (progress bar)
+- requests
+
+## Usage
+
+Here is a basic example of how to use the library:
+
+```python
+from ascii_art_python.new_school import ImageAscii
+from PIL import Image
+
+# Load an image with Pillow
+img = Image.open("mon_image.jpg")
+
+# Convert to ASCII
+ascii_converter = ImageAscii(img)
+ascii_converter.export("mon_export", export_type="txt")
+```

ascii_art_python-0.1.0/ascii_art_python/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "0.1.0"
+from . import new_school

ascii_art_python-0.1.0/ascii_art_python/assets/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2017-2020 Kreative Software.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

ascii_art_python-0.1.0/ascii_art_python/new_school.py

@@ -0,0 +1,219 @@
+"""
+Contains all the tools needed to manage images.
+"""
+from importlib import resources
+import math
+from enum import StrEnum
+from tqdm import tqdm
+from PIL import Image, ImageDraw, ImageFont
+# pylint: disable=no-member
+import cv2
+import numpy
+
+FONT = resources.files("ascii_art_python.assets.fonts").joinpath("KreativeSquare.ttf")
+ASCII_CHARS: list[str] = ["#", "@", "&", "$", "{", "(", "=", "*", ";", ":", ".", " "]
+
+class ImageAscii:
+    """
+    Class to convert and manipulate a classic image into ASCII Art.
+    """
+
+    class ExportType(StrEnum):
+        """
+        Used to export the image.
+        """
+        TEXT_FILE = "txt"
+        IMAGE_FILE = "img"
+
+    def __init__(self, image: Image.Image, max_size: int = 100_000, grid: list[str] = None) -> None:
+        if grid is None:
+            grid = ASCII_CHARS
+        self.grid = grid
+        self._source_wb = image.convert("L")
+        self.max_size = max_size
+
+    @property
+    def _ratio(self) -> float:
+        return math.sqrt(self.max_size / (self._source_wb.size[0] * self._source_wb.size[1]))
+
+    @property
+    def _size(self) -> tuple[int, int]:
+        return (
+            int(self._source_wb.size[0] * self._ratio),
+            int(self._source_wb.size[1] * self._ratio)
+        )
+
+    def to_list(self) -> list[str]:
+        """
+        Converts the image into a list of character strings.
+
+        Returns
+        -------
+        list[str]
+            The image in ASCII art, line by line.
+        """
+        size = self._size
+        ascii_list = [""] * size[1]
+        image = self._source_wb.resize(size)
+        converion_factor = len(self.grid) / 256
+        for i in range(size[1]):
+            for j in range(size[0]):
+                ascii_list[i] += self.grid[int(image.getpixel((j, i)) * converion_factor)]
+        return ascii_list
+
+    def __str__(self) -> str:
+        return "\n".join(self.to_list())
+
+    def __len__(self):
+        return self.max_size
+
+    def export(self, filename: str = "mika_export", mode: ExportType = "img") -> None:
+        """
+        TODO
+        """
+        if mode == "txt":
+            with open(f"{filename}.txt", "w", encoding="utf-8") as f:
+                f.write(str(self))
+
+        elif mode == "img":
+            font_size = 20
+            try:
+                font = ImageFont.truetype(FONT, font_size)
+            except IOError:
+                print(f"Warning: {FONT} not found for export. Using default font.")
+                font = ImageFont.load_default()
+
+            size_export = (self._size[0] * font_size, self._size[1] * font_size)
+
+            output_image = Image.new("L", size_export, color=255)
+            draw = ImageDraw.Draw(output_image)
+
+            for i, line in enumerate(self.to_list()):
+                draw.text((0, i * font_size), line, fill=0, font=font)
+
+            output_image.save(f"{filename}.png")
+
+    def to_image(self):
+        """
+        TODO
+        """
+        font_size = 20
+        try:
+            font = ImageFont.truetype(FONT, font_size)
+        except IOError:
+            print(f"Warning: {FONT} not found for export. Using default font.")
+            font = ImageFont.load_default()
+
+        size_export = (self._size[0] * font_size, self._size[1] * font_size)
+
+        output_image = Image.new("L", size_export, color=255)
+        draw = ImageDraw.Draw(output_image)
+
+        for i, line in enumerate(self.to_list()):
+            draw.text((0, i * font_size), line, fill=0, font=font)
+        return output_image
+
+    @classmethod
+    def from_path(cls, path: str, max_size: int = 10_000, grid: list[str] = None):
+        """
+        TODO
+        """
+        return cls(Image.open(path), max_size, grid)
+
+class VideoAscii:
+    """
+    Class to manage the conversion of a full video into an ASCII animation.
+    """
+    def __init__(self, path: str, fps: int = 10, frame_size: int = 2_000) -> None:
+        self.path = path
+        self.max_fps = fps
+        self.max_frame_size = frame_size
+
+    def __iter__(self) -> iter:
+        cap = cv2.VideoCapture(self.path)
+
+        if not cap.isOpened():
+            raise ValueError(f"Error: Unable to open the video at the location '{self.path}'")
+
+        frame_skip = max(1, int(self.fps / self.max_fps))
+        frame_count = 0
+
+        while True:
+            succes, frame = cap.read()
+
+            if not succes:
+                break
+
+            if frame_count % frame_skip == 0:
+                yield ImageAscii(
+                    Image.fromarray(cv2.cvtColor(frame, cv2.COLOR_BGR2RGB)),
+                    self.max_frame_size
+                )
+            frame_count += 1
+        cap.release()
+
+    def __len__(self) -> int:
+        cap = cv2.VideoCapture(self.path)
+
+        frame_skip = max(1, int(self.fps / self.max_fps))
+        if not cap.isOpened():
+            raise ValueError(f"Error: Unable to open the video at the location '{self.path}'")
+
+        lenght = int(cap.get(cv2.CAP_PROP_FRAME_COUNT) / frame_skip)
+        cap.release()
+        return lenght
+
+    @property
+    def fps(self) -> float:
+        """
+        TODO
+        """
+        cap = cv2.VideoCapture(self.path)
+
+        if not cap.isOpened():
+            raise ValueError(f"Error: Unable to open the video at the location '{self.path}'")
+
+        fps = cap.get(cv2.CAP_PROP_FPS)
+        cap.release()
+        return fps
+
+    @property
+    def size(self) -> tuple[int, int]:
+        """
+        TODO
+        """
+        cap = cv2.VideoCapture(self.path)
+
+        succes, frame = cap.read()
+
+        if not succes:
+            raise ValueError("TODO")
+
+        size = ImageAscii(
+            Image.fromarray(cv2.cvtColor(frame, cv2.COLOR_BGR2RGB)),
+            self.max_frame_size
+        )._size
+        return (size[0] * 20, size[1] * 20)
+
+    def export(self, filename: str = "mika_export"):
+        """
+        TODO
+        """
+        fourcc = cv2.VideoWriter_fourcc(*'XVID')
+        print(self.size)
+        out = cv2.VideoWriter(
+            filename + ".avi",
+            fourcc,
+            self.fps / max(1, int(self.fps / self.max_fps)),
+            self.size, False
+        )
+
+        for frame in tqdm(iter(self), "Exporting frames", len(self)):
+            tab = numpy.array(frame.to_image())
+            out.write(tab)
+
+if __name__ == "__main__":
+    """
+    TODO
+    """
+    print("TODO")

ascii_art_python-0.1.0/ascii_art_python.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: ascii_art_python
+Version: 0.1.0
+Summary: A Python library for converting images and videos into ASCII art.
+Author-email: Guillem Prieur <prieurguillem38@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pillow
+Requires-Dist: tqdm
+Requires-Dist: opencv-python
+Dynamic: license-file
+
+# Ascii Art Python
+
+Une bibliothèque Python permettant de convertir facilement des images et des vidéos en ASCII Art.
+
+## Installation
+
+Vous pouvez installer la bibliothèque localement ou (si vous la publiez plus tard) via pip :
+
+```bash
+pip install .
+```
+
+## Dependencies
+
+This project uses the following libraries:
+
+- Pillow (image manipulation)
+- opencv-python (video reading and writing)
+- tqdm (progress bar)
+- requests
+
+## Usage
+
+Here is a basic example of how to use the library:
+
+```python
+from ascii_art_python.new_school import ImageAscii
+from PIL import Image
+
+# Load an image with Pillow
+img = Image.open("mon_image.jpg")
+
+# Convert to ASCII
+ascii_converter = ImageAscii(img)
+ascii_converter.export("mon_export", export_type="txt")
+```

ascii_art_python-0.1.0/ascii_art_python.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+ascii_art_python/__init__.py
+ascii_art_python/new_school.py
+ascii_art_python.egg-info/PKG-INFO
+ascii_art_python.egg-info/SOURCES.txt
+ascii_art_python.egg-info/dependency_links.txt
+ascii_art_python.egg-info/requires.txt
+ascii_art_python.egg-info/top_level.txt
+ascii_art_python/assets/fonts/KreativeSquare.ttf
+ascii_art_python/assets/fonts/OFL.txt

ascii_art_python-0.1.0/ascii_art_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ascii_art_python-0.1.0/ascii_art_python.egg-info/requires.txt

@@ -0,0 +1,4 @@
+requests
+pillow
+tqdm
+opencv-python

ascii_art_python-0.1.0/ascii_art_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+ascii_art_python

ascii_art_python-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ascii_art_python"
+version = "0.1.0"
+authors = [
+  { name="Guillem Prieur", email="prieurguillem38@gmail.com" },
+]
+description = "A Python library for converting images and videos into ASCII art."
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "requests",
+    "pillow",
+    "tqdm",
+    "opencv-python"
+]

ascii_art_python-0.1.0/setup.cfg

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