ip1tricks 0.1.1__py3-none-any.whl

ip1tricks/__init__.py

@@ -0,0 +1 @@
+from .core import *

ip1tricks/core.py

@@ -0,0 +1,133 @@
+"""
+ip1tricks: A simplified wrapper for Python's turtle module.
+
+Author: Scrol
+"""
+
+from turtle import *
+import math
+
+__all__ = [
+    'move', 'turn', 'line', 'polygon', 'circle2', 'arc',
+    'setcolor', 'instant', 'set_speed', 'accelerate', 'hide', 'finish'
+]
+
+# ---------- MOVEMENT ----------
+
+def move(x, y):
+    """
+    Moves the turtle to the specified (x, y) coordinates without drawing.
+    
+    Args:
+        x (int/float): The x-coordinate to move to.
+        y (int/float): The y-coordinate to move to.
+    """
+    penup()
+    goto(x, y)
+    pendown()
+
+def turn(angle):
+    """
+    Turns the turtle to the left by the specified angle.
+    
+    Args:
+        angle (int/float): The angle in degrees to turn left.
+    """
+    lt(angle)
+
+# ---------- SHAPES ----------
+
+def line(length):
+    """
+    Draws a straight line of the specified length.
+    
+    Args:
+        length (int/float): The distance to move forward.
+    """
+    fd(length)
+
+def polygon(length, sides):
+    """
+    Draws a regular polygon with a given side length and number of sides.
+    
+    Args:
+        length (int/float): The length of each side.
+        sides (int): The number of sides in the polygon.
+    """
+    for i in range(sides):
+        fd(length)
+        lt(360 / sides)
+
+def circle2(radius):
+    """
+    Draws a full circle with the specified radius.
+    
+    Args:
+        radius (int/float): The radius of the circle.
+    """
+    arc(radius, 360)
+
+def arc(radius, angle):
+    """
+    Draws an arc with a given radius and extent (angle).
+    
+    Args:
+        radius (int/float): The radius of the arc.
+        angle (int/float): The extent of the arc in degrees.
+    """
+    circumference = 2 * math.pi * radius
+
+    # Calculate steps to make the arc look smooth
+    steps = int(circumference / 4)
+    if steps < 1: steps = 1
+    
+    stepangle = angle / steps
+    steplength = (circumference * angle / 360) / steps
+
+    for i in range(steps):
+        fd(steplength)
+        lt(stepangle)
+
+# ---------- UTIL ----------
+
+def setcolor(c):
+    """
+    Sets the turtle's pen color.
+    
+    Args:
+        c (str): The color name (e.g., 'red', '#FF0000').
+    """
+    color(c)
+
+def instant():
+    """
+    Sets the drawing speed to the fastest possible (no animation).
+    """
+    speed(0)
+
+def set_speed(value):
+    """
+    Sets the turtle drawing speed.
+
+    Args:
+        value (int): Speed value from 0 (fastest) to 10 (slowest).
+    """
+    speed(value)
+
+def accelerate():
+    """
+    Increases the speed to the maximum (instant drawing).
+    """
+    set_speed(0)
+
+def hide():
+    """
+    Hides the turtle icon.
+    """
+    hideturtle()
+
+def finish():
+    """
+    Keeps the turtle window open until it is manually closed.
+    """
+    mainloop()

ip1tricks-0.1.1.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: ip1tricks
+Version: 0.1.1
+Summary: A simplified wrapper for Python's turtle module, perfect for beginners.
+Author-email: Scrol <shanrsjmax@gmail.com>
+Project-URL: Homepage, https://github.com/scr-ol/ip1tricks
+Project-URL: Bug Tracker, https://github.com/scr-ol/ip1tricks/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ip1tricks 🐢
+
+**A simplified, beginner-friendly wrapper for Python's Turtle graphics.**
+
+Created by **Scrol**.
+
+---
+
+## 🌟 Introduction
+
+Welcome to `ip1tricks`! If you've ever wanted to create beautiful digital art with Python but found the standard `turtle` module a bit overwhelming, this library is for you. We've simplified the commands so you can focus on your creativity.
+
+Whether you're a Python newbie or a seasoned coder looking for a quick way to draw shapes, `ip1tricks` makes it easy to create complex patterns like flowers, spirals, and polygons with just a few lines of code.
+
+---
+
+## 🚀 Installation
+
+You can install `ip1tricks` directly from source:
+
+```bash
+pip install .
+```
+
+---
+
+## 🎨 Getting Started (For Newbies)
+
+In Python Turtle, you control a small "turtle" on a screen. Think of it like a robot with a pen attached to its tail. As the robot moves, it leaves a trail.
+
+### The Basic Workflow:
+1. **Import the tools**: `from ip1tricks import *`
+2. **Setup**: `instant()` to make it draw fast.
+3. **Move and Draw**: Use commands like `line()`, `turn()`, and `arc()`.
+4. **Finish**: `hide()` the turtle and `finish()` to keep the window open.
+
+---
+
+## 📚 Core Concepts & Theory
+
+### 1. The Coordinate System
+The screen is a grid. The center is `(0, 0)`.
+- Moving **Forward** means moving in the direction the turtle is facing.
+- **Turning** changes the turtle's direction (Heading).
+
+### 2. Angles and Shapes
+- A full circle is **360 degrees**.
+- To draw a **Square**, you turn 90 degrees four times (360 / 4).
+- To draw a **Triangle**, you turn 120 degrees three times (360 / 3).
+- **The Rule**: To draw a polygon with `n` sides, you turn `360 / n` degrees at each corner.
+
+### 3. How Arcs Work
+An arc is a piece of a circle. We calculate the `circumference` (the total distance around a circle) using `2 * π * radius`. To make the drawing look smooth, we break the arc into many tiny straight lines.
+- **Radius**: How big the circle would be.
+- **Angle**: How much of the circle to draw (e.g., 180 for a semi-circle).
+
+---
+
+## 🛠 Function Reference
+
+| Function | What it does | Example |
+| :--- | :--- | :--- |
+| `move(x, y)` | teleports the turtle to (x, y) without drawing. | `move(100, 50)` |
+| `line(length)` | Draws a straight line forward. | `line(100)` |
+| `turn(angle)` | Turns left by a number of degrees. | `turn(90)` |
+| `polygon(len, sides)` | Draws a shape with equal sides. | `polygon(50, 6)` |
+| `arc(radius, angle)` | Draws a curved line. | `arc(100, 60)` |
+| `circle2(radius)` | Draws a full circle. | `circle2(50)` |
+| `setcolor(c)` | Changes the pen color. | `setcolor('red')` |
+| `instant()` | Makes the drawing happen immediately. | `instant()` |
+| `accelerate()` | Same as `instant()`, for faster drawing! | `accelerate()` |
+| `hide()` | Makes the turtle icon disappear. | `hide()` |
+| `finish()` | Stops the window from closing. | `finish()` |
+
+---
+
+## 🌈 Examples
+
+### 1. The Classic Flower 🌸
+This example uses overlapping `arc()` commands to create a beautiful floral pattern.
+
+**How it works:**
+1. We draw two arcs to create one "petal".
+2. We turn slightly (36 degrees).
+3. We repeat this 10 times (10 * 36 = 360) to complete the flower.
+
+```python
+from ip1tricks import *
+
+instant()
+setcolor('red')
+
+for i in range(10):
+    # Draw a petal
+    arc(100, 60)
+    turn(120)
+    arc(100, 60)
+    turn(120)
+    
+    # Rotate for the next petal
+    turn(36)
+
+hide()
+finish()
+```
+
+![Flower Pattern](docs/images/flower.png)
+
+### 2. The Vibrant Spiral 🌀
+Spirals are created by drawing and turning, but slightly increasing the size or angle each time.
+
+```python
+from ip1tricks import *
+
+instant()
+
+for i in range(100):
+    setcolor(['red', 'purple', 'blue', 'green'][i % 4])
+    line(i * 2)
+    turn(91)
+
+hide()
+finish()
+```
+
+![Spiral Pattern](docs/images/spiral.png)
+
+---

ip1tricks-0.1.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+ip1tricks/__init__.py,sha256=nE8jJjGJaKuJKCyuf6QLfrj8xPj8IqGKeH2VXP3FMzY,21
+ip1tricks/core.py,sha256=9DuMsS73_hT7PUi_jjoUIap0DakWxH0yRqX2PaTcPG0,2873
+ip1tricks-0.1.1.dist-info/licenses/LICENSE,sha256=wOfRcNiyl7QmR-9PzI7MakbhJYYjMElMKsXXrff441k,1084
+ip1tricks-0.1.1.dist-info/METADATA,sha256=1uKuxVOXBQXJRXJnUmwcTEIxfY_ezOOMQs19Bf7NfKw,4540
+ip1tricks-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ip1tricks-0.1.1.dist-info/top_level.txt,sha256=g-2Og-U0MPuGAOEyvcct_OuLipQyR1TVqXlb-FSLoG8,10
+ip1tricks-0.1.1.dist-info/RECORD,,

ip1tricks-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ip1tricks-0.1.1.dist-info/licenses/LICENSE

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

ip1tricks-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+ip1tricks