drawzero 0.4.3__tar.gz → 0.4.5__tar.gz

drawzero-0.4.5/PKG-INFO

@@ -0,0 +1,310 @@
+Metadata-Version: 2.1
+Name: drawzero
+Version: 0.4.5
+Summary: A zero-boilerplate canvas drawing framework for Python 3, based on Pygame.
+Home-page: https://github.com/ShashkovS/drawzero
+Author: Sergey Shashkov
+Author-email: sh57@yandex.ru
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications
+Classifier: Environment :: MacOS X
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Russian
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pygame>=2.0.1
+
+
+<p align="center">
+<a href="https://pypi.org/project/drawzero/" target="_blank">
+<img alt="PyPI" src="https://img.shields.io/pypi/v/drawzero">
+</a>
+<img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/drawzero">
+<img alt="GitHub" src="https://img.shields.io/github/license/ShashkovS/drawzero">
+<img alt="coverage" src="https://img.shields.io/badge/coverage-90%25-brightgreen">
+</p>
+
+# Draw Zero
+A zero-boilerplate canvas drawing framework for Python 3, based on Pygame.
+
+
+## Some examples
+
+Here's some neat stuff you can do:
+
+``` python
+# import all
+from drawzero import *
+
+# simple shapes
+fill('#12bbae')
+line('red', (400, 400), (800, 800))
+circle('yellow', (500, 560), 200)
+filled_circle('brown', (500, 500), 20)
+text('red', 'Hello, world!', (300, 200), 72)
+rect('blue', (200, 600), 100, 100)
+filled_rect('orange', (400, 600), 100, 100)
+polygon('white', [(20, 200), (100, 240), (40, 160)])
+filled_polygon('burlywood', 200, 400, 130, 304, 20, 342, 20, 458, 130, 496, )
+```
+
+<img alt="hello world" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/hello_world.png" width="75%">
+
+# Animation
+
+Animations are also straightforward:
+
+<img alt="planet_animation" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/planet_animation.gif" width="50%">
+
+``` python
+from drawzero import *
+from math import sin, cos, pi
+
+earth_orbit = 400
+earth_radius = 30
+earth_rot_step = 2 * pi / 360
+moon_orbit = 100
+moon_radius = 10
+moon_rot_step = 2 * pi / 60
+
+i = 0
+while True:
+    i += 1
+    e_x = 500 + earth_orbit * cos(earth_rot_step * i)
+    e_y = 500 + earth_orbit * sin(earth_rot_step * i)
+    m_x = e_x + moon_orbit * cos(moon_rot_step * i)
+    m_y = e_y + moon_orbit * sin(moon_rot_step * i)
+
+    clear()
+    filled_circle(C.red, (500, 500), 100)
+    filled_circle(C.blue, (e_x, e_y), earth_radius)
+    filled_circle(C.yellow, (m_x, m_y), moon_radius)
+    tick()
+```
+
+
+# Point class which acts like 2-d vector and Turtle both
+
+<img alt="transparent.png" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/ex_05.png" width="50%">
+
+```python
+from drawzero import *
+
+# just coordinates
+A = Pt(100, 100)
+B = Pt(300, 150)
+line(C.red, A, B)
+
+# A point which acts as 2-d vector and as a Turtle
+# Pt(x=0.0, y=0.0, *, heading=0.0)
+#
+# Provides (for a, b — points, k number):
+#   * arithmetic
+#     a+b — vector addition
+#     a-b — vector subtraction
+#     k*a and a*k — multiplication with scalar
+#     abs  — absolute value of a
+#     +a, -a
+
+# arithmetic
+A = Pt(100, 200)
+dx = Pt(50, 5)
+for i in range(10):
+    filled_circle(C.blue, A + dx * i, radius=10)
+
+#   * turtle-style movement
+#     forward — Move the point forward by the specified distance.
+#     backward — Move the point backward by distance.
+#     right — Turn point right by angle degrees.
+#     left — Turn point left by angle degrees.
+#     goto — Move point to an absolute position.
+#     rotate_around — Rotate around given point by angle degrees.
+#     move_towards — Move towards the given point by the specified distance.
+#     reset, home — Move point to the origin - coordinates (0,0), set heading=0
+#     setx — Set the point's first coordinate to x
+#     sety — Set the point's second coordinate to y
+#     setheading — Set the point's heading
+
+A = Pt(100, 300)
+B = Pt(1000, 400)
+for i in range(10):
+    filled_circle(C.green2, A, radius=10)
+    A.move_towards(50, B)
+
+A = Pt(100, 400)
+for i in range(10):
+    filled_circle(C.magenta, A, radius=10)
+    A.left(10).forward(30)
+
+#   * information
+#     position — Return the point's current location (x,y), as a tuple.
+#     x, xcor — Return the point's x coordinate.
+#     y, ycor — Return the point's y coordinate
+#     heading — Return the point's heading
+#     distance — Return the distance between points
+#     towards — Return the angle towards point
+#   * deep copy
+#     copy — a clone of point
+```
+
+
+
+# Transparency
+
+Transparency is also straightforward via alpha parameter or RGBA color:
+
+<img alt="transparent.png" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/transparent.png" width="50%">
+
+```python
+from drawzero import *
+
+clear()
+fill(C.black)
+
+filled_circle('red', (100, 100), 20)
+filled_circle('blue', (100, 110), 22, alpha=100)  # <-- alpha
+circle('red', (100, 100), 50, line_width=10)
+circle((0, 255, 0, 50), (100, 110), 50, line_width=10)  # <-- RGBA
+...
+```
+
+<details>
+  <summary>Full code for transparency and line width example</summary>
+
+  ``` python
+  from drawzero import *
+
+  clear()
+  fill(C.black)
+
+  filled_circle('red', (100, 100), 20)
+  filled_circle('blue', (100, 110), 22, alpha=100)
+  circle('red', (100, 100), 50, line_width=10)
+  circle((0, 255, 0, 50), (100, 110), 50, line_width=10)
+  filled_rect(C.aquamarine, (200, 100), 100, 40)
+  filled_rect(C.darkmagenta, (210, 110), 100, 40, alpha=80)
+  rect(C.darkgoldenrod, (180, 90), 200, 80, line_width=10)
+  rect(C.hotpink, (190, 90), 200, 90, alpha=180, line_width=10)
+    
+  line('red', 600, 400, 600, 990)
+  image('cat.png', (500, 500))
+  image('cat.png', (500, 800), width=200, alpha=128)
+  image('cat.png', (550, 850), width=200, alpha=128)
+    
+  polygon('yellow', [(20, 300), (100, 340), (40, 260)], line_width=20)
+  polygon((0, 0, 255, 200), [(20, 300), (100, 340), (40, 260)], line_width=15)
+  polygon('red', [(20, 300), (100, 340), (40, 260)])
+    
+  filled_polygon('burlywood', 200, 600, 130, 504, 20, 542, 20, 658, 130, 696)
+  filled_polygon(C.hotpink, 200, 700, 130, 604, 20, 642, 20, 758, 130, 796, alpha=100)
+    
+  line(C.green, (700, 100), (800, 200))
+  line(C.green, (710, 100), (810, 200), line_width=5)
+  line(C.red, (820, 100), (720, 200), line_width=10, alpha=50)
+  line(C.blue, (830, 100), (730, 200), line_width=10, alpha=128)
+  ```
+</details>
+
+
+# Color gradients
+
+<img alt="transparent.png" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/ex_13.png" width="50%">
+
+```python
+from drawzero import *
+
+
+scale1 = Gradient([C.black, C.white], 0, 1000)
+for x in range(0, 1000, 10):
+    filled_rect(scale1(x), (x, 0), 10, 100)
+text(C.white, 'scale1 = Gradient([C.black, C.white], 0, 1000)', (50, 100), 48, '<^')
+
+scale2 = Gradient([C.green, C.yellow, C.magenta, C.red], 0, 1000)
+for x in range(0, 1000, 10):
+    filled_rect(scale2(x), (x, 200), 10, 100)
+text(C.white, 'scale2 = Gradient([C.green, C.yellow, C.magenta, C.red], 0, 1000)', (50, 300), 32, '<^')
+
+scale3 = Gradient([C.white, C.black, C.red, C.black, C.white], 200, 800)
+for x in range(0, 1000, 10):
+    filled_rect(scale3(x), (x, 400), 10, 100)
+text(C.white, 'scale3 = Gradient([C.white, C.black, C.red, C.black, C.white], 200, 800)', (50, 500), 32, '<^')
+```
+
+
+
+# Keyboard and mouse events
+
+Process keyboard events in two ways: check if key is pressed via `get_keys_pressed()` or run throw `keysdown` or `keysup` events:
+
+``` python
+from drawzero import *
+
+upper_text = 'Typed: '
+SIZE = 20
+x = y = 500 - SIZE // 2
+
+while True:
+    # Mouse buttons events
+    if mousebuttonsdown:
+        x, y = mousebuttonsdown[0].pos
+    # Keys which are still pressed
+    keys = get_keys_pressed()
+    if keys[K.UP] or keys[K.w]:
+        y -= 5
+    if keys[K.DOWN] or keys[K.s]:
+        y += 5
+    if keys[K.LEFT] or keys[K.a]:
+        x -= 5
+    if keys[K.RIGHT] or keys[K.d]:
+        x += 5
+    # Keyboard events
+    for ev in keysdown:
+        if ev.unicode:
+            upper_text += ev.unicode
+
+    # Redraw everything
+    clear()
+    filled_rect(C.red, x, y, SIZE, SIZE)
+    text(C.white, upper_text, (100, 5))
+    filled_circle(C.yellow, mouse_pos(), 3)
+    tick()
+```
+
+<img alt="keyboard_and_mouse_events.gif" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/keyboard_and_mouse_events.gif" width="50%">
+
+
+
+# Installation
+
+In a Terminal window, type:
+```shell
+pip install drawzero --upgrade --user
+```
+
+
+Or run the following program:
+
+```python
+import os, sys
+python = sys.executable
+user = '--user' if 'venv' not in python and 'virtualenvs' not in python else ''
+cmd = f'"{python}" -m pip install drawzero --upgrade {user}'
+os.system(cmd)
+from drawzero import *
+```
+
+# [Contributing](CONTRIBUTING.md) 

{drawzero-0.4.3 → drawzero-0.4.5}/README.md

@@ -66,6 +66,71 @@ while True:
 ```
 
 
+# Point class which acts like 2-d vector and Turtle both
+
+<img alt="transparent.png" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/ex_05.png" width="50%">
+
+```python
+from drawzero import *
+
+# just coordinates
+A = Pt(100, 100)
+B = Pt(300, 150)
+line(C.red, A, B)
+
+# A point which acts as 2-d vector and as a Turtle
+# Pt(x=0.0, y=0.0, *, heading=0.0)
+#
+# Provides (for a, b — points, k number):
+#   * arithmetic
+#     a+b — vector addition
+#     a-b — vector subtraction
+#     k*a and a*k — multiplication with scalar
+#     abs  — absolute value of a
+#     +a, -a
+
+# arithmetic
+A = Pt(100, 200)
+dx = Pt(50, 5)
+for i in range(10):
+    filled_circle(C.blue, A + dx * i, radius=10)
+
+#   * turtle-style movement
+#     forward — Move the point forward by the specified distance.
+#     backward — Move the point backward by distance.
+#     right — Turn point right by angle degrees.
+#     left — Turn point left by angle degrees.
+#     goto — Move point to an absolute position.
+#     rotate_around — Rotate around given point by angle degrees.
+#     move_towards — Move towards the given point by the specified distance.
+#     reset, home — Move point to the origin - coordinates (0,0), set heading=0
+#     setx — Set the point's first coordinate to x
+#     sety — Set the point's second coordinate to y
+#     setheading — Set the point's heading
+
+A = Pt(100, 300)
+B = Pt(1000, 400)
+for i in range(10):
+    filled_circle(C.green2, A, radius=10)
+    A.move_towards(50, B)
+
+A = Pt(100, 400)
+for i in range(10):
+    filled_circle(C.magenta, A, radius=10)
+    A.left(10).forward(30)
+
+#   * information
+#     position — Return the point's current location (x,y), as a tuple.
+#     x, xcor — Return the point's x coordinate.
+#     y, ycor — Return the point's y coordinate
+#     heading — Return the point's heading
+#     distance — Return the distance between points
+#     towards — Return the angle towards point
+#   * deep copy
+#     copy — a clone of point
+```
+
+
 
 # Transparency
 
@@ -124,6 +189,31 @@ circle((0, 255, 0, 50), (100, 110), 50, line_width=10)  # <-- RGBA
 </details>
 
 
+# Color gradients
+
+<img alt="transparent.png" src="https://raw.githubusercontent.com/ShashkovS/drawzero/master/docs/ex_13.png" width="50%">
+
+```python
+from drawzero import *
+
+
+scale1 = Gradient([C.black, C.white], 0, 1000)
+for x in range(0, 1000, 10):
+    filled_rect(scale1(x), (x, 0), 10, 100)
+text(C.white, 'scale1 = Gradient([C.black, C.white], 0, 1000)', (50, 100), 48, '<^')
+
+scale2 = Gradient([C.green, C.yellow, C.magenta, C.red], 0, 1000)
+for x in range(0, 1000, 10):
+    filled_rect(scale2(x), (x, 200), 10, 100)
+text(C.white, 'scale2 = Gradient([C.green, C.yellow, C.magenta, C.red], 0, 1000)', (50, 300), 32, '<^')
+
+scale3 = Gradient([C.white, C.black, C.red, C.black, C.white], 200, 800)
+for x in range(0, 1000, 10):
+    filled_rect(scale3(x), (x, 400), 10, 100)
+text(C.white, 'scale3 = Gradient([C.white, C.black, C.red, C.black, C.white], 200, 800)', (50, 500), 32, '<^')
+```
+
+
 
 # Keyboard and mouse events
 
@@ -180,10 +270,10 @@ Or run the following program:
 ```python
 import os, sys
 python = sys.executable
-user = '--user' if 'venv' not in python else ''
+user = '--user' if 'venv' not in python and 'virtualenvs' not in python else ''
 cmd = f'"{python}" -m pip install drawzero --upgrade {user}'
-print(cmd)
 os.system(cmd)
+from drawzero import *
 ```
 
 # [Contributing](CONTRIBUTING.md) 

{drawzero-0.4.3 → drawzero-0.4.5}/setup.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-# pip install wheel twine
+# pip install wheel twine setuptools
 
 # build and upload
 # python setup.py sdist bdist_wheel
@@ -108,13 +108,13 @@ setup(
         'Operating System :: OS Independent',
         'Programming Language :: Python',
         'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: 3.8',
         'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13',
         'Programming Language :: Python :: Implementation :: CPython',
-        'Topic :: Multimedia :: Graphics',
     ],
     # $ setup.py publish support.
     cmdclass={

{drawzero-0.4.3 → drawzero-0.4.5}/src/drawzero/__about__.py

@@ -5,7 +5,7 @@ __all__ = [
     "__copyright__",
 ]
 
-__version__ = '0.4.3'
+__version__ = '0.4.5'
 __author__ = "Sergey Shashkov"
 __license__ = "MIT"
 __copyright__ = "Copyright 2020- Sergey Shashkov"

{drawzero-0.4.3 → drawzero-0.4.5}/src/drawzero/__init__.py

@@ -1,44 +1,46 @@
-"""
-drawzero
-========
-A zero-boilerplate canvas drawing framework for Python 3, based on Pygame.
-"""
-
-from .utils.draw import *
-from .utils.pt import Pt
-from .utils.gradient import Gradient
-from .utils.copy_examples import copy_examples
-from .utils.screen_size import set_virtual_size
-from .utils.i18n import set_lang
-from .utils.key_flags import K, KEY
-from .utils.colors import C, COLORS, THECOLORS, ALL_COLORS
-from .__about__ import __author__, __copyright__, __version__
-
-__all__ = [
-    # spec
-    '__author__', '__copyright__', '__version__',
-    # simple shapes
-    'line', 'arc', 'circle', 'rect', 'ellipse', 'rect_rotated', 'polygon',
-    # filled shapes
-    'filled_circle', 'filled_rect', 'filled_ellipse', 'filled_rect_rotated', 'filled_polygon',
-    # other
-    'grid', 'text', 'clear', 'fill', 'image', 'fps', 'set_lang',
-    # animation control
-    'tick', 'sleep', 'quit',
-    # keyboard and mouse
-    'mouse_pos',
-    # examples
-    'copy_examples',
-    # Point class
-    'Pt',
-    # Color consts (all are the same)
-    'C', 'COLORS', 'THECOLORS', 'ALL_COLORS',
-    # Keyboard key names
-    'K', 'KEY',
-    # Gradient tools
-    'Gradient',
-    # pygamezero compatibility
-    'screen', 'set_virtual_size',
-    # Mouse and keyboard events
-    'get_keys_pressed', 'keys_mods_pressed', 'get_mouse_pressed', 'keysdown', 'keysup', 'mousemotions', 'mousebuttonsdown', 'mousebuttonsup',
-]
+"""
+drawzero
+========
+A zero-boilerplate canvas drawing framework for Python 3, based on Pygame.
+"""
+
+from .utils.draw import *
+from .utils.pt import Pt
+from .utils.gradient import Gradient
+from .utils.copy_examples import copy_examples
+from .utils.screen_size import set_virtual_size
+from .utils.i18n import set_lang
+from .utils.key_flags import K, KEY
+from .utils.colors import C, COLORS, THECOLORS, ALL_COLORS
+from .__about__ import __author__, __copyright__, __version__
+
+__all__ = [
+    # spec
+    '__author__', '__copyright__', '__version__',
+    #
+    'run',
+    # simple shapes
+    'line', 'arc', 'circle', 'rect', 'ellipse', 'rect_rotated', 'polygon',
+    # filled shapes
+    'filled_circle', 'filled_rect', 'filled_ellipse', 'filled_rect_rotated', 'filled_polygon',
+    # other
+    'grid', 'text', 'clear', 'fill', 'image', 'fps', 'set_lang',
+    # animation control
+    'tick', 'sleep', 'quit',
+    # keyboard and mouse
+    'mouse_pos',
+    # examples
+    'copy_examples',
+    # Point class
+    'Pt',
+    # Color consts (all are the same)
+    'C', 'COLORS', 'THECOLORS', 'ALL_COLORS',
+    # Keyboard key names
+    'K', 'KEY',
+    # Gradient tools
+    'Gradient',
+    # pygamezero compatibility
+    'screen', 'set_virtual_size',
+    # Mouse and keyboard events
+    'get_keys_pressed', 'keys_mods_pressed', 'get_mouse_pressed', 'keysdown', 'keysup', 'mousemotions', 'mousebuttonsdown', 'mousebuttonsup',
+]

drawzero-0.4.5/src/drawzero/examples/00_hello_world.py

@@ -0,0 +1,20 @@
+# Just import everything
+# Импортируем всё
+from drawzero import *
+
+# Red rectangle with upper left corner at (50, 150) and width = 900, height = 700
+# Красный прямоугольник с левым верхнем углом в точке(50, 150), шириной 900 и высотой 700
+rect('red', (50, 150), 900, 700)
+
+# Straight orange line from (100, 500) to (900, 500)
+# Оранжевая прямая линия из точки (100, 500) в точку (900, 500)
+line('orange', (100, 500), (900, 500))
+
+# Centered text
+# Центрированный текст
+text('green', 'Hello world!', (500, 250), fontsize=72)
+text('blue', 'Привет, мир!', (500, 750), fontsize=72)
+
+# Run loop
+# Запуск
+run()

drawzero-0.4.5/src/drawzero/examples/05_points.py

@@ -0,0 +1,57 @@
+from drawzero import *
+
+# just coordinates
+A = Pt(100, 100)
+B = Pt(300, 150)
+line(C.red, A, B)
+
+# A point which acts as 2-d vector and as a Turtle
+# Pt(x=0.0, y=0.0, *, heading=0.0)
+#
+# Provides (for a, b — points, k number):
+#   * arithmetic
+#     a+b — vector addition
+#     a-b — vector subtraction
+#     k*a and a*k — multiplication with scalar
+#     abs  — absolute value of a
+#     +a, -a
+
+# arithmetic
+A = Pt(100, 200)
+dx = Pt(50, 5)
+for i in range(10):
+    filled_circle(C.blue, A + dx * i, radius=10)
+
+#   * turtle-style movement
+#     forward — Move the point forward by the specified distance.
+#     backward — Move the point backward by distance.
+#     right — Turn point right by angle degrees.
+#     left — Turn point left by angle degrees.
+#     goto — Move point to an absolute position.
+#     rotate_around — Rotate around given point by angle degrees.
+#     move_towards — Move towards the given point by the specified distance.
+#     reset, home — Move point to the origin - coordinates (0,0), set heading=0
+#     setx — Set the point's first coordinate to x
+#     sety — Set the point's second coordinate to y
+#     setheading — Set the point's heading
+
+A = Pt(100, 300)
+B = Pt(1000, 400)
+for i in range(10):
+    filled_circle(C.green2, A, radius=10)
+    A.move_towards(50, B)
+
+A = Pt(100, 400)
+for i in range(10):
+    filled_circle(C.magenta, A, radius=10)
+    A.left(10).forward(30)
+
+#   * information
+#     position — Return the point's current location (x,y), as a tuple.
+#     x, xcor — Return the point's x coordinate.
+#     y, ycor — Return the point's y coordinate
+#     heading — Return the point's heading
+#     distance — Return the distance between points
+#     towards — Return the angle towards point
+#   * deep copy
+#     copy — a clone of point