pixelkid 0.1.0__tar.gz

pixelkid-0.1.0/LICENSE

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

pixelkid-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: pixelkid
+Version: 0.1.0
+Summary: Превращает любое фото в пиксель-арт одной функцией. Сделано для мастер-классов по Python.
+License: MIT
+Keywords: pixel art,image,pillow,education,kids
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=9.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# pixelkid
+
+Превращает любое фото в пиксель-арт **одной функцией**. Сделано для мастер-классов по Python (возраст 11–17).
+
+```python
+from pixelkid import pixelate
+
+pixelate("photo.jpg", pixel_size=12, colors=16, save_as="art.png")
+```
+
+## Установка
+
+```
+pip install pixelkid
+```
+
+Нужен Python 3.8+. Вместе с `pixelkid` автоматически установится Pillow.
+
+## Функция `pixelate`
+
+```python
+pixelate(image, pixel_size=12, colors=32, save_as=None, upscale=True)
+```
+
+| Параметр | Что это | По умолчанию |
+|---|---|---|
+| `image` | Путь к файлу (`"photo.jpg"`) или картинка Pillow (`Image`) | — |
+| `pixel_size` | Размер «большого пикселя» в обычных пикселях, от 2. Чем больше — тем крупнее квадраты | `12` |
+| `colors` | Сколько цветов оставить, от 2 до 256 | `32` |
+| `save_as` | Куда сохранить результат. Если не указать — файл не создаётся | `None` |
+| `upscale` | `True` — картинка исходного размера с крупными пикселями. `False` — маленькая картинка, где 1 точка = 1 большой пиксель | `True` |
+
+**Возвращает** картинку Pillow (`PIL.Image.Image`), поэтому её можно показать (`.show()`), сохранить (`.save(...)`) или обработать дальше.
+
+**Ошибки.** Если `pixel_size` меньше 2 или `colors` вне диапазона 2–256, функция выбросит `ValueError`.
+
+## Примеры
+
+```python
+from pixelkid import pixelate
+
+# 1. Просто показать результат
+pixelate("cat.jpg").show()
+
+# 2. Очень крупные пиксели и всего 4 цвета
+pixelate("cat.jpg", pixel_size=30, colors=4, save_as="cat_8bit.png")
+
+# 3. Пять версий одного фото
+for size in (4, 8, 16, 24, 32):
+    pixelate("cat.jpg", pixel_size=size, save_as=f"cat_{size}.png")
+
+# 4. Маленькая «сетка» для своих игр и раскрасок
+grid = pixelate("cat.jpg", pixel_size=16, upscale=False)
+print(grid.size)   # например, (48, 48): можно перебрать каждую клеточку
+```
+
+## Как это работает
+
+1. **Уменьшаем** фото: каждый квадрат `pixel_size × pixel_size` становится одной точкой.
+2. **Оставляем** только `colors` цветов (`quantize`).
+3. **Увеличиваем** обратно методом `NEAREST` — он просто копирует цвет и не размывает границы.
+
+## Разработка
+
+```
+pip install -e .[dev]    # или: pip install -e . pytest
+pytest
+python -m build          # собрать пакет в папку dist/
+```
+
+## Лицензия
+
+MIT

pixelkid-0.1.0/README.md

@@ -0,0 +1,73 @@
+# pixelkid
+
+Превращает любое фото в пиксель-арт **одной функцией**. Сделано для мастер-классов по Python (возраст 11–17).
+
+```python
+from pixelkid import pixelate
+
+pixelate("photo.jpg", pixel_size=12, colors=16, save_as="art.png")
+```
+
+## Установка
+
+```
+pip install pixelkid
+```
+
+Нужен Python 3.8+. Вместе с `pixelkid` автоматически установится Pillow.
+
+## Функция `pixelate`
+
+```python
+pixelate(image, pixel_size=12, colors=32, save_as=None, upscale=True)
+```
+
+| Параметр | Что это | По умолчанию |
+|---|---|---|
+| `image` | Путь к файлу (`"photo.jpg"`) или картинка Pillow (`Image`) | — |
+| `pixel_size` | Размер «большого пикселя» в обычных пикселях, от 2. Чем больше — тем крупнее квадраты | `12` |
+| `colors` | Сколько цветов оставить, от 2 до 256 | `32` |
+| `save_as` | Куда сохранить результат. Если не указать — файл не создаётся | `None` |
+| `upscale` | `True` — картинка исходного размера с крупными пикселями. `False` — маленькая картинка, где 1 точка = 1 большой пиксель | `True` |
+
+**Возвращает** картинку Pillow (`PIL.Image.Image`), поэтому её можно показать (`.show()`), сохранить (`.save(...)`) или обработать дальше.
+
+**Ошибки.** Если `pixel_size` меньше 2 или `colors` вне диапазона 2–256, функция выбросит `ValueError`.
+
+## Примеры
+
+```python
+from pixelkid import pixelate
+
+# 1. Просто показать результат
+pixelate("cat.jpg").show()
+
+# 2. Очень крупные пиксели и всего 4 цвета
+pixelate("cat.jpg", pixel_size=30, colors=4, save_as="cat_8bit.png")
+
+# 3. Пять версий одного фото
+for size in (4, 8, 16, 24, 32):
+    pixelate("cat.jpg", pixel_size=size, save_as=f"cat_{size}.png")
+
+# 4. Маленькая «сетка» для своих игр и раскрасок
+grid = pixelate("cat.jpg", pixel_size=16, upscale=False)
+print(grid.size)   # например, (48, 48): можно перебрать каждую клеточку
+```
+
+## Как это работает
+
+1. **Уменьшаем** фото: каждый квадрат `pixel_size × pixel_size` становится одной точкой.
+2. **Оставляем** только `colors` цветов (`quantize`).
+3. **Увеличиваем** обратно методом `NEAREST` — он просто копирует цвет и не размывает границы.
+
+## Разработка
+
+```
+pip install -e .[dev]    # или: pip install -e . pytest
+pytest
+python -m build          # собрать пакет в папку dist/
+```
+
+## Лицензия
+
+MIT

pixelkid-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pixelkid"
+version = "0.1.0"
+description = "Превращает любое фото в пиксель-арт одной функцией. Сделано для мастер-классов по Python."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+dependencies = ["Pillow>=9.1"]
+keywords = ["pixel art", "image", "pillow", "education", "kids"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Topic :: Multimedia :: Graphics",
+    "Intended Audience :: Education",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "build", "twine"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

pixelkid-0.1.0/setup.cfg

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

pixelkid-0.1.0/src/pixelkid/__init__.py

@@ -0,0 +1,46 @@
+"""pixelkid — превращает фото в пиксель-арт одной функцией.
+
+    from pixelkid import pixelate
+    pixelate("photo.jpg", pixel_size=12, colors=16, save_as="art.png")
+"""
+from PIL import Image
+
+__version__ = "0.1.0"
+__all__ = ["pixelate"]
+
+
+def pixelate(image, pixel_size=12, colors=32, save_as=None, upscale=True):
+    """Делает из фотографии пиксель-арт.
+
+    image      -- путь к файлу ("photo.jpg") или картинка Pillow (Image).
+    pixel_size -- размер одного «большого пикселя» в обычных пикселях (2 и больше).
+    colors     -- сколько цветов оставить (от 2 до 256).
+    save_as    -- куда сохранить результат ("art.png"). Если не нужно -- не указывай.
+    upscale    -- True: вернуть картинку исходного размера с крупными пикселями;
+                  False: вернуть маленькую картинку, где 1 точка = 1 большой пиксель.
+
+    Возвращает картинку Pillow (Image).
+    """
+    if pixel_size < 2:
+        raise ValueError("pixel_size должен быть 2 или больше")
+    if not 2 <= colors <= 256:
+        raise ValueError("colors должен быть от 2 до 256")
+
+    if isinstance(image, Image.Image):
+        photo = image.convert("RGB")
+    else:
+        photo = Image.open(image).convert("RGB")
+
+    # 1. Уменьшаем: каждый квадрат pixel_size x pixel_size станет одной точкой
+    small_size = (max(1, photo.width // pixel_size), max(1, photo.height // pixel_size))
+    small = photo.resize(small_size, Image.Resampling.LANCZOS)
+
+    # 2. Оставляем только нужное количество цветов
+    small = small.quantize(colors=colors).convert("RGB")
+
+    # 3. Увеличиваем обратно без размытия
+    result = small.resize(photo.size, Image.Resampling.NEAREST) if upscale else small
+
+    if save_as:
+        result.save(save_as)
+    return result

pixelkid-0.1.0/src/pixelkid.egg-info/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: pixelkid
+Version: 0.1.0
+Summary: Превращает любое фото в пиксель-арт одной функцией. Сделано для мастер-классов по Python.
+License: MIT
+Keywords: pixel art,image,pillow,education,kids
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=9.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# pixelkid
+
+Превращает любое фото в пиксель-арт **одной функцией**. Сделано для мастер-классов по Python (возраст 11–17).
+
+```python
+from pixelkid import pixelate
+
+pixelate("photo.jpg", pixel_size=12, colors=16, save_as="art.png")
+```
+
+## Установка
+
+```
+pip install pixelkid
+```
+
+Нужен Python 3.8+. Вместе с `pixelkid` автоматически установится Pillow.
+
+## Функция `pixelate`
+
+```python
+pixelate(image, pixel_size=12, colors=32, save_as=None, upscale=True)
+```
+
+| Параметр | Что это | По умолчанию |
+|---|---|---|
+| `image` | Путь к файлу (`"photo.jpg"`) или картинка Pillow (`Image`) | — |
+| `pixel_size` | Размер «большого пикселя» в обычных пикселях, от 2. Чем больше — тем крупнее квадраты | `12` |
+| `colors` | Сколько цветов оставить, от 2 до 256 | `32` |
+| `save_as` | Куда сохранить результат. Если не указать — файл не создаётся | `None` |
+| `upscale` | `True` — картинка исходного размера с крупными пикселями. `False` — маленькая картинка, где 1 точка = 1 большой пиксель | `True` |
+
+**Возвращает** картинку Pillow (`PIL.Image.Image`), поэтому её можно показать (`.show()`), сохранить (`.save(...)`) или обработать дальше.
+
+**Ошибки.** Если `pixel_size` меньше 2 или `colors` вне диапазона 2–256, функция выбросит `ValueError`.
+
+## Примеры
+
+```python
+from pixelkid import pixelate
+
+# 1. Просто показать результат
+pixelate("cat.jpg").show()
+
+# 2. Очень крупные пиксели и всего 4 цвета
+pixelate("cat.jpg", pixel_size=30, colors=4, save_as="cat_8bit.png")
+
+# 3. Пять версий одного фото
+for size in (4, 8, 16, 24, 32):
+    pixelate("cat.jpg", pixel_size=size, save_as=f"cat_{size}.png")
+
+# 4. Маленькая «сетка» для своих игр и раскрасок
+grid = pixelate("cat.jpg", pixel_size=16, upscale=False)
+print(grid.size)   # например, (48, 48): можно перебрать каждую клеточку
+```
+
+## Как это работает
+
+1. **Уменьшаем** фото: каждый квадрат `pixel_size × pixel_size` становится одной точкой.
+2. **Оставляем** только `colors` цветов (`quantize`).
+3. **Увеличиваем** обратно методом `NEAREST` — он просто копирует цвет и не размывает границы.
+
+## Разработка
+
+```
+pip install -e .[dev]    # или: pip install -e . pytest
+pytest
+python -m build          # собрать пакет в папку dist/
+```
+
+## Лицензия
+
+MIT

pixelkid-0.1.0/src/pixelkid.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/pixelkid/__init__.py
+src/pixelkid.egg-info/PKG-INFO
+src/pixelkid.egg-info/SOURCES.txt
+src/pixelkid.egg-info/dependency_links.txt
+src/pixelkid.egg-info/requires.txt
+src/pixelkid.egg-info/top_level.txt
+tests/test_pixelate.py

pixelkid-0.1.0/src/pixelkid.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pixelkid-0.1.0/src/pixelkid.egg-info/requires.txt

@@ -0,0 +1,6 @@
+Pillow>=9.1
+
+[dev]
+pytest
+build
+twine

pixelkid-0.1.0/src/pixelkid.egg-info/top_level.txt

@@ -0,0 +1 @@
+pixelkid

pixelkid-0.1.0/tests/test_pixelate.py

@@ -0,0 +1,33 @@
+from PIL import Image
+import pytest
+from pixelkid import pixelate
+
+
+def make_photo():
+    return Image.effect_mandelbrot((200, 150), (-2, -1.5, 1, 1.5), 30)
+
+
+def test_keeps_size():
+    assert pixelate(make_photo(), pixel_size=10).size == (200, 150)
+
+
+def test_small_image():
+    assert pixelate(make_photo(), pixel_size=10, upscale=False).size == (20, 15)
+
+
+def test_color_limit():
+    result = pixelate(make_photo(), pixel_size=5, colors=4)
+    assert len(result.getcolors(10000)) <= 4
+
+
+def test_save(tmp_path):
+    path = tmp_path / "art.png"
+    pixelate(make_photo(), save_as=str(path))
+    assert path.exists()
+
+
+def test_bad_values():
+    with pytest.raises(ValueError):
+        pixelate(make_photo(), pixel_size=1)
+    with pytest.raises(ValueError):
+        pixelate(make_photo(), colors=1)