simple-graphics-lib 0.0.6__tar.gz → 0.0.7__tar.gz

{simple_graphics_lib-0.0.6 → simple_graphics_lib-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simple-graphics-lib
-Version: 0.0.6
+Version: 0.0.7
 Summary: A simple graphics library for python learners
 Author-email: Max-Hillyer <maxhillyer7012@gmail.com>
 License-Expression: MIT
@@ -14,12 +14,40 @@ License-File: LICENSE
 Requires-Dist: pygame
 Dynamic: license-file
 
+[![PyPI](https://img.shields.io/pypi/v/simple-graphics-lib)](https://pypi.org/project/simple-graphics-lib/)
 # Simple Graphics
 --- 
 simple graphics is a lightweight python graphics package that offers a more readable alternative to pygame
 
 simple graphics is meant to be extremely readable, allowing you to focus on the logic of your code instead of graphic specifics 
 
+## Installation
+### pip
+```bash
+pip install simple-graphics-lib
+```
+
+## Quick Start
+```python
+from simple_graphics import *
+
+# Create shapes
+rect = Rect(50, 50, 100, 100, color="blue")
+circle = Circle(200, 200, radius=50, color="red")
+
+# Define event handlers
+@on_click(rect)
+def on_rect_click():
+    print("Rectangle clicked!")
+
+@on_press("space")
+def on_space_press():
+    print("Space pressed!")
+
+# Run the window
+run(width=400, height=400, caption="My Graphics App")
+```
+
 ## Shapes
 
 Simple Graphics offers support for various shapes, that will automatically appear on the screen when defined
@@ -57,7 +85,7 @@ Methods:
 | Method | Purpose | Arguments | Returns | 
 | :--- | :---: | :---: | ---: | 
 | is_obj_over | determines if a point is in the circle | x: int, y:int | bool |
-| get_area | returns the area of the circle | None | bool | 
+| get_area | returns the area of the circle | None | int | 
 
 ### Polygon 
 Arguments: 
@@ -100,6 +128,60 @@ Methods:
 | :--- | :---: | :---: | ---: | 
 | is_obj_over | determines if a point is in the text | x: int, y:int | bool |
 
+### Image
+Arguments:
+| Argument | Type | Role | Default | 
+| :--- | :---: | :---: | ---: |
+| x | int | the x value of the image | None | 
+| y | int | the y value of the image | None | 
+| img_path | str | the path to the image | None |
+| width | int | the width of the image | the width from the image path | 
+| height | int | the height of the image | the height from the image path | 
+
+Methods: 
+| Method | Purpose | Arguments | Returns | 
+| :--- | :---: | :---: | ---: | 
+| is_obj_over | determines if a point is in the image | x: int, y:int | bool |
+
+### Group
+Group groups a bunch of objects together, so you can treat them all as one shape, modifying x,y and color and checking for collisions for every shape in the group at once
+
+the below code creates a group of two rectangles
+```python
+r1 = Rect(20, 20)
+r2 = Rect(40, 40)
+group = Group(r1, r2)
+
+group.x += 10
+group.y -= 10
+group.color = "green"
+```
+
+Arguments:
+| Argument | Type | Role | Default | 
+| :--- | :---: | :---: | ---: |
+| *shapes | list[Shape] | the shapes to group | None |
+
+Methods:
+| Method | Purpose | Arguments | Returns | 
+| :--- | :---: | :---: | ---: | 
+| add | appends shapes to the group | *shapes | None | 
+| remove | removes shapes from the group | *shapes | None | 
+| clear | clears the group | None | None | 
+| is_obj_over | checks if a point is over the group | x, y | bool | 
+
+Examples: 
+```python
+r1 = Rect(20, 20)
+r2 = Rect(40, 40)
+group = Group(r1, r2)
+
+c1 = Circle(100,100)
+t1 = Text(300, 300, "hi")
+group.add(c1, t1)
+
+group.remove(r2, t1)
+```
 ---
 
 ## Run 
@@ -255,3 +337,7 @@ changes the background color to black
 ### clear_screen
 `clear_screen()` clears the screen. 
 objects defined before a screen clear can no longer be interacted with
+
+### erase
+`erase()` deletes a single object
+erased objects can no longer be invoked

{simple_graphics_lib-0.0.6 → simple_graphics_lib-0.0.7}/README.md

@@ -1,9 +1,37 @@
+[![PyPI](https://img.shields.io/pypi/v/simple-graphics-lib)](https://pypi.org/project/simple-graphics-lib/)
 # Simple Graphics
 --- 
 simple graphics is a lightweight python graphics package that offers a more readable alternative to pygame
 
 simple graphics is meant to be extremely readable, allowing you to focus on the logic of your code instead of graphic specifics 
 
+## Installation
+### pip
+```bash
+pip install simple-graphics-lib
+```
+
+## Quick Start
+```python
+from simple_graphics import *
+
+# Create shapes
+rect = Rect(50, 50, 100, 100, color="blue")
+circle = Circle(200, 200, radius=50, color="red")
+
+# Define event handlers
+@on_click(rect)
+def on_rect_click():
+    print("Rectangle clicked!")
+
+@on_press("space")
+def on_space_press():
+    print("Space pressed!")
+
+# Run the window
+run(width=400, height=400, caption="My Graphics App")
+```
+
 ## Shapes
 
 Simple Graphics offers support for various shapes, that will automatically appear on the screen when defined
@@ -41,7 +69,7 @@ Methods:
 | Method | Purpose | Arguments | Returns | 
 | :--- | :---: | :---: | ---: | 
 | is_obj_over | determines if a point is in the circle | x: int, y:int | bool |
-| get_area | returns the area of the circle | None | bool | 
+| get_area | returns the area of the circle | None | int | 
 
 ### Polygon 
 Arguments: 
@@ -84,6 +112,60 @@ Methods:
 | :--- | :---: | :---: | ---: | 
 | is_obj_over | determines if a point is in the text | x: int, y:int | bool |
 
+### Image
+Arguments:
+| Argument | Type | Role | Default | 
+| :--- | :---: | :---: | ---: |
+| x | int | the x value of the image | None | 
+| y | int | the y value of the image | None | 
+| img_path | str | the path to the image | None |
+| width | int | the width of the image | the width from the image path | 
+| height | int | the height of the image | the height from the image path | 
+
+Methods: 
+| Method | Purpose | Arguments | Returns | 
+| :--- | :---: | :---: | ---: | 
+| is_obj_over | determines if a point is in the image | x: int, y:int | bool |
+
+### Group
+Group groups a bunch of objects together, so you can treat them all as one shape, modifying x,y and color and checking for collisions for every shape in the group at once
+
+the below code creates a group of two rectangles
+```python
+r1 = Rect(20, 20)
+r2 = Rect(40, 40)
+group = Group(r1, r2)
+
+group.x += 10
+group.y -= 10
+group.color = "green"
+```
+
+Arguments:
+| Argument | Type | Role | Default | 
+| :--- | :---: | :---: | ---: |
+| *shapes | list[Shape] | the shapes to group | None |
+
+Methods:
+| Method | Purpose | Arguments | Returns | 
+| :--- | :---: | :---: | ---: | 
+| add | appends shapes to the group | *shapes | None | 
+| remove | removes shapes from the group | *shapes | None | 
+| clear | clears the group | None | None | 
+| is_obj_over | checks if a point is over the group | x, y | bool | 
+
+Examples: 
+```python
+r1 = Rect(20, 20)
+r2 = Rect(40, 40)
+group = Group(r1, r2)
+
+c1 = Circle(100,100)
+t1 = Text(300, 300, "hi")
+group.add(c1, t1)
+
+group.remove(r2, t1)
+```
 ---
 
 ## Run 
@@ -239,3 +321,7 @@ changes the background color to black
 ### clear_screen
 `clear_screen()` clears the screen. 
 objects defined before a screen clear can no longer be interacted with
+
+### erase
+`erase()` deletes a single object
+erased objects can no longer be invoked

{simple_graphics_lib-0.0.6 → simple_graphics_lib-0.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simple-graphics-lib"
-version = "0.0.6"
+version = "0.0.7"
 authors = [
   { name="Max-Hillyer", email="maxhillyer7012@gmail.com" },
 ]

{simple_graphics_lib-0.0.6 → simple_graphics_lib-0.0.7}/src/simple_graphics/module.py

@@ -1,4 +1,5 @@
 import os
+
 os.environ["PYGAME_HIDE_SUPPORT_PROMPT"] = "1"
 import pygame
 from inspect import signature, currentframe
@@ -64,8 +65,8 @@ class Rect(Shape):
             ox = pygame.mouse.get_pos()[0]
         if oy == None:
             oy = pygame.mouse.get_pos()[1]
-        x_over = ox > self.x and ox < self.x + self.height
-        y_over = oy > self.y and oy < self.y + self.width
+        x_over = ox > self.x and ox < self.x + self.width
+        y_over = oy > self.y and oy < self.y + self.height
         return x_over and y_over
 
     def get_area(self):
@@ -96,7 +97,7 @@ class Circle(Shape):
         return inside
 
     def get_area(self):
-        return pi * self.radius ^ 2
+        return pi * self.radius**2
 
 
 class Polygon(Shape):
@@ -170,6 +171,33 @@ class Line(Shape):
         return ((px - closest_x) ** 2 + (py - closest_y) ** 2) ** 0.5
 
 
+class Image(Shape):
+    def __init__(
+        self, x: int, y: int, img_path: str, width: int = None, height: int = None
+    ):
+        super().__init__(x, y)
+        self.img_path = img_path
+        self.original_img = pygame.image.load(self.img_path)
+
+        img_width, img_height = self.original_img.get_size()
+        self.width = width if width is not None else img_width
+        self.height = height if height is not None else img_height
+
+        self.surface = pygame.transform.scale(
+            self.original_img, (self.width, self.height)
+        )
+
+    def is_obj_over(self, ox=None, oy=None):
+        if ox is None:
+            ox = pygame.mouse.get_pos()[0]
+        if oy is None:
+            oy = pygame.mouse.get_pos()[1]
+
+        x_over = ox > self.x and ox < self.x + self.width
+        y_over = oy > self.y and oy < self.y + self.height
+        return x_over and y_over
+
+
 class Text(Shape):
     def __init__(
         self,
@@ -203,6 +231,70 @@ class Text(Shape):
         return x_over and y_over
 
 
+class Group:
+    def __init__(self, *shapes: list[Shape]):
+        self.grouped = []
+        self.add(*shapes)
+
+    @property
+    def color(self):
+        return self._color if hasattr(self, "_color") else None
+
+    @color.setter
+    def color(self, color):
+        self._color = color
+        for shape in self.grouped:
+            if hasattr(shape, "color"):
+                shape.color = color
+
+    @property
+    def x(self):
+        if not self.grouped:
+            return 0
+        return self.grouped[0].x
+
+    @x.setter
+    def x(self, value):
+        delta = value - self.x
+        for child in self.grouped:
+            child.x += delta
+
+    @property
+    def y(self):
+        if not self.grouped:
+            return 0
+        return self.grouped[0].x
+
+    @y.setter
+    def y(self, value):
+        delta = value - self.y
+        for child in self.grouped:
+            child.y += delta
+
+    def add(self, *shapes):
+        for s in shapes:
+            if not isinstance(s, Shape):
+                raise TypeError(f"{s} must be Shape")
+            self.grouped.append(s)
+
+    def remove(self, *shapes):
+        for s in shapes:
+            self.grouped.remove(s)
+            _shapes.remove(s)
+
+    def clear(self):
+        self.grouped.clear()
+
+    def is_obj_over(self, x, y):
+        for i in self.grouped:
+            if i.is_obj_over(x, y):
+                return True
+        return False
+
+    def __str__(self):
+        return "group"
+
+
 class CollisionManager:
     @staticmethod
     def rect_rect(rect1: Rect, rect2: Rect):
@@ -263,6 +355,26 @@ class CollisionManager:
         dist = ((circle.x - closest_x) ** 2 + (circle.y - closest_y) ** 2) ** 0.5
         return dist < circle.radius
 
+    @staticmethod
+    def rect_image(rect, image):
+        return pygame.Rect(*rect.rect).colliderect(
+            pygame.Rect(image.x, image.y, image.width, image.height)
+        )
+
+    @staticmethod
+    def circle_image(circle, image):
+        closest_x = max(image.x, min(circle.x, image.x + image.width))
+        closest_y = max(image.y, min(circle.y, image.y + image.height))
+        dist = ((circle.x - closest_x) ** 2 + (circle.y - closest_y) ** 2) ** 0.5
+        return dist < circle.radius
+
+    @staticmethod
+    def groupcollision(group, shape):
+        for child in group.grouped:
+            if is_colliding(child, shape):
+                return True
+        return False
+
     def no_collsion_method(shape1, shape2):
         raise Exception(f"{type(shape1)} and {type(shape2)} have no collision method")
 
@@ -275,8 +387,9 @@ def check_args(func, name):
             f'Functions defined with the @{name} decorator may not take arguments\n but "{func.__name__}" was defined with {param_names}'
         )
 
-#decorartors like this get weird: if you want to be able to pass arguments in you need to handle 2 cases
-#if theres no arguments then it just takes the function as the argument
+
+# decorartors like this get weird: if you want to be able to pass arguments in you need to handle 2 cases
+# if theres no arguments then it just takes the function as the argument
 def on_tick(func: Callable):
     name = currentframe().f_code.co_name
     check_args(func, name)
@@ -385,7 +498,15 @@ def clear_screen():
     _shapes.clear()
 
 
+def erase(obj):
+    _shapes.remove(obj)
+
+
 def is_colliding(shape1: Shape, shape2: Shape) -> bool:
+    if "group" == str(shape1) or "group" == str(shape2):
+        method_name = "groupcollision"
+        method = getattr(CollisionManager, method_name, None)
+        return method(shape1, shape2)
     method_name = f"{str(shape1)}_{str(shape2)}"
     method = getattr(CollisionManager, method_name, None)
     if method is None:
@@ -490,8 +611,12 @@ def run(
                     )
             elif str(shape) == "text":
                 screen.blit(shape.txtsurf, (shape.x, shape.y))
+            elif str(shape) == "image":
+                screen.blit(shape.surface, (shape.x, shape.y))
+            elif str(shape) == "group":
+                pass  # this stops weird edgecases while keeping good rendering
 
         pygame.display.flip()
         clock.tick(60)
 
-    pygame.quit()
+    pygame.quit()

{simple_graphics_lib-0.0.6 → simple_graphics_lib-0.0.7}/src/simple_graphics_lib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simple-graphics-lib
-Version: 0.0.6
+Version: 0.0.7
 Summary: A simple graphics library for python learners
 Author-email: Max-Hillyer <maxhillyer7012@gmail.com>
 License-Expression: MIT
@@ -14,12 +14,40 @@ License-File: LICENSE
 Requires-Dist: pygame
 Dynamic: license-file
 
+[![PyPI](https://img.shields.io/pypi/v/simple-graphics-lib)](https://pypi.org/project/simple-graphics-lib/)
 # Simple Graphics
 --- 
 simple graphics is a lightweight python graphics package that offers a more readable alternative to pygame
 
 simple graphics is meant to be extremely readable, allowing you to focus on the logic of your code instead of graphic specifics 
 
+## Installation
+### pip
+```bash
+pip install simple-graphics-lib
+```
+
+## Quick Start
+```python
+from simple_graphics import *
+
+# Create shapes
+rect = Rect(50, 50, 100, 100, color="blue")
+circle = Circle(200, 200, radius=50, color="red")
+
+# Define event handlers
+@on_click(rect)
+def on_rect_click():
+    print("Rectangle clicked!")
+
+@on_press("space")
+def on_space_press():
+    print("Space pressed!")
+
+# Run the window
+run(width=400, height=400, caption="My Graphics App")
+```
+
 ## Shapes
 
 Simple Graphics offers support for various shapes, that will automatically appear on the screen when defined
@@ -57,7 +85,7 @@ Methods:
 | Method | Purpose | Arguments | Returns | 
 | :--- | :---: | :---: | ---: | 
 | is_obj_over | determines if a point is in the circle | x: int, y:int | bool |
-| get_area | returns the area of the circle | None | bool | 
+| get_area | returns the area of the circle | None | int | 
 
 ### Polygon 
 Arguments: 
@@ -100,6 +128,60 @@ Methods:
 | :--- | :---: | :---: | ---: | 
 | is_obj_over | determines if a point is in the text | x: int, y:int | bool |
 
+### Image
+Arguments:
+| Argument | Type | Role | Default | 
+| :--- | :---: | :---: | ---: |
+| x | int | the x value of the image | None | 
+| y | int | the y value of the image | None | 
+| img_path | str | the path to the image | None |
+| width | int | the width of the image | the width from the image path | 
+| height | int | the height of the image | the height from the image path | 
+
+Methods: 
+| Method | Purpose | Arguments | Returns | 
+| :--- | :---: | :---: | ---: | 
+| is_obj_over | determines if a point is in the image | x: int, y:int | bool |
+
+### Group
+Group groups a bunch of objects together, so you can treat them all as one shape, modifying x,y and color and checking for collisions for every shape in the group at once
+
+the below code creates a group of two rectangles
+```python
+r1 = Rect(20, 20)
+r2 = Rect(40, 40)
+group = Group(r1, r2)
+
+group.x += 10
+group.y -= 10
+group.color = "green"
+```
+
+Arguments:
+| Argument | Type | Role | Default | 
+| :--- | :---: | :---: | ---: |
+| *shapes | list[Shape] | the shapes to group | None |
+
+Methods:
+| Method | Purpose | Arguments | Returns | 
+| :--- | :---: | :---: | ---: | 
+| add | appends shapes to the group | *shapes | None | 
+| remove | removes shapes from the group | *shapes | None | 
+| clear | clears the group | None | None | 
+| is_obj_over | checks if a point is over the group | x, y | bool | 
+
+Examples: 
+```python
+r1 = Rect(20, 20)
+r2 = Rect(40, 40)
+group = Group(r1, r2)
+
+c1 = Circle(100,100)
+t1 = Text(300, 300, "hi")
+group.add(c1, t1)
+
+group.remove(r2, t1)
+```
 ---
 
 ## Run 
@@ -255,3 +337,7 @@ changes the background color to black
 ### clear_screen
 `clear_screen()` clears the screen. 
 objects defined before a screen clear can no longer be interacted with
+
+### erase
+`erase()` deletes a single object
+erased objects can no longer be invoked