homa 0.19__tar.gz → 0.22__tar.gz

homa-0.22/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.1
+Name: homa
+Version: 0.22
+Maintainer: Taha Shieenavaz
+Maintainer-email: tahashieenavaz@gmail.com
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+<p align="center">
+	<img
+		src="https://raw.githubusercontent.com/tahashieenavaz/homa/main/art/homa.svg"
+		width=500
+	/>
+</p>
+
+<hr />
+
+Homa is an easy way to start learning Computer Vision with OpenCV.
+
+## Loading Images
+
+Images could be loaded with the `image` helper, that accepts the file name and a key for the repository.
+
+```python
+from homa import *
+
+image("horse.jpg", "horse")
+```
+
+Alternatively, following code will load the file into the repository with a key of everything before the last in the filename.
+
+```python
+from homa import *
+
+image("horse.jpg") # stored as "horse"
+```
+
+## Smoothing
+
+### Blur
+
+```python
+from homa import *
+
+image("horse.jpg")
+
+blur("horse", 7)                    # rewrites "horse" key
+blur("horse", (7, 19))              # rewrites "horse" key
+blur("horse", 9, "blurred horse")   # as a new key in the repository
+show("blurred horse")
+```
+
+### Gaussian Blur
+
+```python
+from homa import *
+
+image("horse.jpg")
+
+gaussian("horse", 7)                             # rewrites "horse" key
+gaussian("horse", (7, 19))                       # rewrites "horse" key
+gaussian("horse", 9, "gaussian blurred horse")   # as a new key in the repository
+show("gaussian blurred horse")
+```
+
+## Stacking
+
+```python
+from homa import *
+
+image("horse.jpg")
+blur("horse", 9, "blurred horse")
+
+show(
+	vstack("horse", "blurred horse"),
+	window="Vstacked"
+)
+
+showWait(
+	hstack("horse", "blurred horse"),
+	window="Hstacked"
+)
+```
+
+## Camera
+
+Camera frames could be access from the repository with a key of `camera`.
+
+```python
+from homa import *
+
+for _ in camera():
+	show("camera")
+```
+
+You can simply combine camera frames with the supported effects.
+
+```python
+from homa import *
+
+for _ in camera():
+	blur("camera", 13, "blurred camera")
+
+	show(
+		vstack("camera", "blurred camera"),
+		window="Camera Effect"
+	)
+```

homa-0.22/README.md

@@ -0,0 +1,100 @@
+<p align="center">
+	<img
+		src="https://raw.githubusercontent.com/tahashieenavaz/homa/main/art/homa.svg"
+		width=500
+	/>
+</p>
+
+<hr />
+
+Homa is an easy way to start learning Computer Vision with OpenCV.
+
+## Loading Images
+
+Images could be loaded with the `image` helper, that accepts the file name and a key for the repository.
+
+```python
+from homa import *
+
+image("horse.jpg", "horse")
+```
+
+Alternatively, following code will load the file into the repository with a key of everything before the last in the filename.
+
+```python
+from homa import *
+
+image("horse.jpg") # stored as "horse"
+```
+
+## Smoothing
+
+### Blur
+
+```python
+from homa import *
+
+image("horse.jpg")
+
+blur("horse", 7)                    # rewrites "horse" key
+blur("horse", (7, 19))              # rewrites "horse" key
+blur("horse", 9, "blurred horse")   # as a new key in the repository
+show("blurred horse")
+```
+
+### Gaussian Blur
+
+```python
+from homa import *
+
+image("horse.jpg")
+
+gaussian("horse", 7)                             # rewrites "horse" key
+gaussian("horse", (7, 19))                       # rewrites "horse" key
+gaussian("horse", 9, "gaussian blurred horse")   # as a new key in the repository
+show("gaussian blurred horse")
+```
+
+## Stacking
+
+```python
+from homa import *
+
+image("horse.jpg")
+blur("horse", 9, "blurred horse")
+
+show(
+	vstack("horse", "blurred horse"),
+	window="Vstacked"
+)
+
+showWait(
+	hstack("horse", "blurred horse"),
+	window="Hstacked"
+)
+```
+
+## Camera
+
+Camera frames could be access from the repository with a key of `camera`.
+
+```python
+from homa import *
+
+for _ in camera():
+	show("camera")
+```
+
+You can simply combine camera frames with the supported effects.
+
+```python
+from homa import *
+
+for _ in camera():
+	blur("camera", 13, "blurred camera")
+
+	show(
+		vstack("camera", "blurred camera"),
+		window="Camera Effect"
+	)
+```

homa-0.22/homa/__init__.py

@@ -0,0 +1,4 @@
+from .main import *
+from .filters import *
+from .camera import *
+from .orientation import *

homa-0.22/homa/camera.py

@@ -0,0 +1,21 @@
+import cv2
+from .classes.Repository import Repository
+
+
+def camera(delay=10):
+    capture = cv2.VideoCapture(0)
+
+    pressed_key = None
+
+    frame_number = 0
+
+    while pressed_key != ord("q"):
+        frame_number += 1
+        _, frame = capture.read()
+
+        Repository.images["camera"] = frame
+
+        yield frame_number
+        pressed_key = cv2.waitKey(delay)
+
+    capture.release()

homa-0.22/homa/classes/Collection.py

@@ -0,0 +1,11 @@
+from typing import List
+
+
+class Collection:
+    def __init__(self, items: List[any]):
+        self.value = items
+
+    def map(self, callback: callable):
+        return list(
+            map(callback, self.value)
+        )

homa-0.22/homa/classes/Logger.py

@@ -0,0 +1,4 @@
+class Logger:
+    @staticmethod
+    def danger(message: str) -> None:
+        print(message)

homa-0.22/homa/classes/Repository.py

@@ -0,0 +1,32 @@
+from ..helpers import is_colab
+
+
+class RepositoryWrapper:
+    def __init__(self):
+        self.sigmaX = 0
+        self.sigmaY = 0
+
+        self.directory = "./"
+        self.images = {}
+        self.cameras = {}
+        self.window_counter = 0
+
+        if is_colab():
+            from google.colab.patches import cv2_imshow as imshow
+        else:
+            from cv2 import imshow
+
+        def final_imshow(window, image):
+            if is_colab():
+                imshow(image)
+            else:
+                imshow(window, image)
+
+        self.imshow = final_imshow
+
+    def get_counter(self):
+        self.window_counter += 1
+        return self.window_counter
+
+
+Repository = RepositoryWrapper()

homa-0.22/homa/filters.py

@@ -0,0 +1,34 @@
+from typing import List
+from .classes.Repository import Repository
+from .helpers import create_kernel
+import cv2
+
+
+def blur(key: str, kernel: int | List[int] = (7, 7), new_key: str | None = None):
+    if new_key is None:
+        new_key = key
+
+    Repository.images[new_key] = cv2.blur(
+        Repository.images[key],
+        create_kernel(kernel)
+    )
+
+
+def sigma(x: float = 0, y: float = 0):
+    Repository.sigmaX = x
+    Repository.sigmaY = y
+
+
+def gaussian(key: str, kernel: None | List[int] = None, new_key: str | None = None):
+    if new_key is None:
+        new_key = key
+
+    if isinstance(kernel, int):
+        kernel = (kernel, kernel)
+
+    Repository.images[new_key] = cv2.GaussianBlur(
+        Repository.images[key],
+        kernel,
+        sigmaX=Repository.sigmaX,
+        sigmaY=Repository.sigmaY
+    )

homa-0.22/homa/helpers.py

@@ -0,0 +1,30 @@
+import sys
+from typing import List
+from .classes.Collection import Collection
+from .classes.Logger import Logger
+
+
+def is_colab() -> bool:
+    return 'google.colab' in sys.modules
+
+
+def collection(items: List[any]):
+    return Collection(items)
+
+
+def danger(message: str) -> None:
+    Logger.danger(message)
+
+
+def create_kernel(value: int | tuple) -> tuple:
+    if isinstance(value, tuple):
+        x, y = value
+
+        x = x - 1 if x % 2 == 0 else x
+        y = y - 1 if y % 2 == 0 else y
+
+        return (x, y)
+
+    value = value - 1 if value % 2 == 0 else value
+
+    return (value, value)

homa-0.22/homa/main.py

@@ -0,0 +1,56 @@
+import cv2
+from .helpers import danger
+from .classes.Repository import Repository
+
+
+def path(directory: str) -> None:
+    Repository.directory = directory
+
+
+def write(key: str, filename: str) -> None:
+    cv2.imwrite(
+        filename=filename,
+        img=Repository.images[key]
+    )
+
+
+def save(*args, **kwargs) -> None:
+    write(args, kwargs)
+
+
+def image(filename: str, key: str | None = None, color: bool = True) -> None:
+    # TODO: add no extension in the file
+    if key is None:
+        key = filename.split(".")[0]
+
+    Repository.images[key] = cv2.imread(filename, int(color))
+    return Repository.images[key]
+
+
+def wait(delay=0):
+    cv2.waitKey(delay)
+
+
+def showWait(*args, **kwargs):
+    kwargs["wait"] = True
+    show(*args, **kwargs)
+
+
+def show(key: any = None, wait: bool = False, window: str = "Homa Window") -> None:
+    # TODO: add functionality to distinguish between camera and images
+
+    if key is not None and not isinstance(key, str):
+        Repository.imshow(window, key)
+
+    elif key is None:
+        for key, image in Repository.images.items():
+            Repository.imshow(key, image)
+
+    elif key is not None:
+        if key in Repository.images:
+            Repository.imshow(key, Repository.images[key])
+        else:
+            danger(f"No image found with key {key}")
+
+    if wait:
+        cv2.waitKey(0)

homa-0.22/homa/orientation.py

@@ -0,0 +1,36 @@
+from typing import List
+from .classes.Repository import Repository
+from .helpers import collection
+import numpy
+
+
+def stack(*keys, **settings):
+    default_settings = {
+        "axis": 1,
+        "new_key": None
+    }
+
+    settings = {
+        **default_settings,
+        **settings
+    }
+
+    stacked_image = numpy.concatenate(
+        collection(keys).map(lambda key: Repository.images[key]),
+        axis=settings["axis"]
+    )
+
+    if settings["new_key"] is not None:
+        Repository.images[settings["new_key"]] = stacked_image
+
+    return stacked_image
+
+
+def vstack(*keys, **settings):
+    settings["axis"] = 1
+    return stack(*keys, **settings)
+
+
+def hstack(*keys, **settings):
+    settings["axis"] = 0
+    return stack(*keys, **settings)

homa-0.22/homa.egg-info/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.1
+Name: homa
+Version: 0.22
+Maintainer: Taha Shieenavaz
+Maintainer-email: tahashieenavaz@gmail.com
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+<p align="center">
+	<img
+		src="https://raw.githubusercontent.com/tahashieenavaz/homa/main/art/homa.svg"
+		width=500
+	/>
+</p>
+
+<hr />
+
+Homa is an easy way to start learning Computer Vision with OpenCV.
+
+## Loading Images
+
+Images could be loaded with the `image` helper, that accepts the file name and a key for the repository.
+
+```python
+from homa import *
+
+image("horse.jpg", "horse")
+```
+
+Alternatively, following code will load the file into the repository with a key of everything before the last in the filename.
+
+```python
+from homa import *
+
+image("horse.jpg") # stored as "horse"
+```
+
+## Smoothing
+
+### Blur
+
+```python
+from homa import *
+
+image("horse.jpg")
+
+blur("horse", 7)                    # rewrites "horse" key
+blur("horse", (7, 19))              # rewrites "horse" key
+blur("horse", 9, "blurred horse")   # as a new key in the repository
+show("blurred horse")
+```
+
+### Gaussian Blur
+
+```python
+from homa import *
+
+image("horse.jpg")
+
+gaussian("horse", 7)                             # rewrites "horse" key
+gaussian("horse", (7, 19))                       # rewrites "horse" key
+gaussian("horse", 9, "gaussian blurred horse")   # as a new key in the repository
+show("gaussian blurred horse")
+```
+
+## Stacking
+
+```python
+from homa import *
+
+image("horse.jpg")
+blur("horse", 9, "blurred horse")
+
+show(
+	vstack("horse", "blurred horse"),
+	window="Vstacked"
+)
+
+showWait(
+	hstack("horse", "blurred horse"),
+	window="Hstacked"
+)
+```
+
+## Camera
+
+Camera frames could be access from the repository with a key of `camera`.
+
+```python
+from homa import *
+
+for _ in camera():
+	show("camera")
+```
+
+You can simply combine camera frames with the supported effects.
+
+```python
+from homa import *
+
+for _ in camera():
+	blur("camera", 13, "blurred camera")
+
+	show(
+		vstack("camera", "blurred camera"),
+		window="Camera Effect"
+	)
+```

homa-0.22/homa.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+README.md
+setup.py
+homa/__init__.py
+homa/camera.py
+homa/constants.py
+homa/filters.py
+homa/helpers.py
+homa/main.py
+homa/orientation.py
+homa.egg-info/PKG-INFO
+homa.egg-info/SOURCES.txt
+homa.egg-info/dependency_links.txt
+homa.egg-info/requires.txt
+homa.egg-info/top_level.txt
+homa/classes/Collection.py
+homa/classes/Logger.py
+homa/classes/Repository.py
+homa/classes/__init__.py

homa-0.22/homa.egg-info/requires.txt

@@ -0,0 +1,2 @@
+opencv-python
+numpy

{homa-0.19 → homa-0.22}/setup.py

@@ -1,22 +1,27 @@
 from setuptools import setup
 from setuptools import find_packages
+from sys import argv
 
 with open("README.md") as fh:
     description = fh.read()
 
+with open("version.txt", "r") as fh:
+    current_version = float(fh.readline())
+
+with open("version.txt", "w") as fh:
+    next_version = round(current_version + 0.01, 2)
+    fh.write(str(next_version))
+
 setup(
     name="homa",
     maintainer="Taha Shieenavaz",
     maintainer_email="tahashieenavaz@gmail.com",
-    version="0.19",
+    version=next_version,
     packages=find_packages(),
     install_requires=[
-        #
+        "opencv-python",
+        "numpy"
     ],
     long_description=description,
     long_description_content_type="text/markdown",
-    include_package_data=True,
-    package_data={
-        "": ["wordlists/*"]
-    }
 )

homa-0.19/PKG-INFO

@@ -1,43 +0,0 @@
-Metadata-Version: 2.1
-Name: homa
-Version: 0.19
-Maintainer: Taha Shieenavaz
-Maintainer-email: tahashieenavaz@gmail.com
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-<p align="center">
-	<img
-		src="https://raw.githubusercontent.com/tahashieenavaz/homa/main/art/homa.svg"
-		width=400
-	/>
-</p>
-
-<hr />
-
-Homa is a library to generate random data that provides more productivity for developers.
-
-In loving memory of [Saber Rastikerdar](https://rastikerdar.github.io/), who introduced Persian (Farsi) to the digital world. 🖤💚
-
-## Names
-
-```python
-from homa import fake
-
-fake().fullname()       # Julia Briwn
-fake().prefix()         # Ms.
-fake().firstname()      # Joe
-fake().surname()        # Lewos
-
-fake().fullname("girl") # Ms. Heather Willaoms
-fake().fullname("boy")  # Juan Murteniz
-```
-
-## Text
-
-```python
-from homa import fake
-
-fake().title() # Haw jeornels oro fighteng buck agounst e wovu af qiistuinubli umagas
-fake().token() # aivel
-```

homa-0.19/README.md

@@ -1,35 +0,0 @@
-<p align="center">
-	<img
-		src="https://raw.githubusercontent.com/tahashieenavaz/homa/main/art/homa.svg"
-		width=400
-	/>
-</p>
-
-<hr />
-
-Homa is a library to generate random data that provides more productivity for developers.
-
-In loving memory of [Saber Rastikerdar](https://rastikerdar.github.io/), who introduced Persian (Farsi) to the digital world. 🖤💚
-
-## Names
-
-```python
-from homa import fake
-
-fake().fullname()       # Julia Briwn
-fake().prefix()         # Ms.
-fake().firstname()      # Joe
-fake().surname()        # Lewos
-
-fake().fullname("girl") # Ms. Heather Willaoms
-fake().fullname("boy")  # Juan Murteniz
-```
-
-## Text
-
-```python
-from homa import fake
-
-fake().title() # Haw jeornels oro fighteng buck agounst e wovu af qiistuinubli umagas
-fake().token() # aivel
-```

homa-0.19/homa/__init__.py

@@ -1,3 +0,0 @@
-from .main import Homa
-from .main import homa
-from .main import fake