wraith 1.0.0__tar.gz

wraith-1.0.0/LICENSE

@@ -0,0 +1,23 @@
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+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, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

wraith-1.0.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.1
+Name: wraith
+Version: 1.0.0
+Summary: All the power of Python...in the palm of your hand.
+Author: Omer Drkić
+Author-email: omerdrkic2501@gmail.com
+License: Boost Software License 1.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Boost Software License 1.0 (BSL-1.0)
+Classifier: Natural Language :: English
+Classifier: Operating System :: Microsoft
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Interpreters
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+License-File: LICENSE
+
+Wraith is a module programmed by Omer Drkić that adds loads of new features and makes Python easier to use. The module adds some features that the developer felt like they were missing from Python. It also adds some extension to the 'math' library and to the actual Python environment, as well as some useful data manipulation tools.

wraith-1.0.0/README.md

@@ -0,0 +1,31 @@
+# All the power of Python...in the palm of your hand.
+
+Wraith is a module programmed by Omer Drkić that adds loads of new features and makes Python easier to use. The module adds some features that the developer felt like they were missing from Python. It also adds some extension to the 'math' library and to the actual Python environment, as well as some useful data manipulation tools.
+
+## History
+
+Wraith was first created in 2022 for personal use, but now the developer has decided to recreate it even better and finally upload it to PyPI. Fun fact: the original name was actually Pynamic, but the developer found out that there was already a module named Pynamic on PyPI.
+
+## Examples
+
+The more detailed documentation on how to use Wraith is not yet available, but here are some of the most important and notable functions.
+
+### `cls()`
+
+The `cls()` function is added to make clearing the console output easier and quicker and it has no parameters at all.
+
+### `wait(interval)`
+
+The `wait()` function makes pausing the program quicker and it has only one parameter, the interval to pause the program for in seconds. For example, `wait(3)` makes the program wait for three seconds.
+
+### `random(min, max)`
+
+The `random()` function generates true random floating numbers and requires two parameters, the minimum value and the maximum value. It includes both ends during generation. For example, `random(3.2, 5)` generates a float between 3.2 and 5.
+
+### `choose(*values)`
+
+The `choose()` function returns a randomly chosen item from the specified list which can have as many items. For example, `choose("apple", "banana", "pear")` will return either "apple", "banana", or "pear".
+
+## Support
+
+If you have any suggestions or ideas, please share them with me through e-mail. If you have any critics, be sure to e-mail as well. Also, please report any bugs you find - that way you help the rest of the community. Thank you for using Wraith!

wraith-1.0.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61", "setuptools-scm"]
+build-backend = "setuptools.build_meta"

wraith-1.0.0/setup.cfg

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

wraith-1.0.0/setup.py

@@ -0,0 +1,33 @@
+from setuptools import setup
+
+setup(
+  name = "wraith",
+  version = "1.0.0",
+  description = "All the power of Python...in the palm of your hand.",
+  long_description = "Wraith is a module programmed by Omer Drkić that adds loads of new features and makes Python easier to use. The module adds some features that the developer felt like they were missing from Python. It also adds some extension to the 'math' library and to the actual Python environment, as well as some useful data manipulation tools.",
+  author = "Omer Drkić",
+  author_email = "omerdrkic2501@gmail.com",
+  py_modules = [
+    "wraith"
+  ],
+  classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Framework :: Jupyter",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Boost Software License 1.0 (BSL-1.0)",
+    "Natural Language :: English",
+    "Operating System :: Microsoft",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Interpreters",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed"
+  ],
+  license = "Boost Software License 1.0",
+  install_requires = [
+    "keyboard"
+  ],
+  python_requires = ">=3.10"
+)

wraith-1.0.0/wraith.egg-info/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.1
+Name: wraith
+Version: 1.0.0
+Summary: All the power of Python...in the palm of your hand.
+Author: Omer Drkić
+Author-email: omerdrkic2501@gmail.com
+License: Boost Software License 1.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Boost Software License 1.0 (BSL-1.0)
+Classifier: Natural Language :: English
+Classifier: Operating System :: Microsoft
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Interpreters
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+License-File: LICENSE
+
+Wraith is a module programmed by Omer Drkić that adds loads of new features and makes Python easier to use. The module adds some features that the developer felt like they were missing from Python. It also adds some extension to the 'math' library and to the actual Python environment, as well as some useful data manipulation tools.

wraith-1.0.0/wraith.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+wraith.py
+wraith.egg-info/PKG-INFO
+wraith.egg-info/SOURCES.txt
+wraith.egg-info/dependency_links.txt
+wraith.egg-info/requires.txt
+wraith.egg-info/top_level.txt

wraith-1.0.0/wraith.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

wraith-1.0.0/wraith.egg-info/requires.txt

@@ -0,0 +1 @@
+keyboard

wraith-1.0.0/wraith.egg-info/top_level.txt

@@ -0,0 +1 @@
+wraith

wraith-1.0.0/wraith.py

@@ -0,0 +1,610 @@
+"""
+A module programmed by Omer Drkić that adds loads of new features and makes Python easier to use.
+"""
+
+import cmath as c
+import keyboard as k
+import math as m
+import os as o
+import random as r
+import subprocess as s
+import time as t
+
+timer = t.time()
+
+def ceil(value: float):
+  """
+  Returns an integer higher than the specified floating point number.
+  """
+  value = int(value) + 1
+  return value
+
+def choose(*values):
+  """
+  Returns a random item from the specified list.
+  """
+  return r.choice(values)
+
+def chooseindex(index: int, *values):
+  """
+  Returns an item from the specified list using a zero-based index.
+  """
+  return values[index]
+
+def cls():
+  """
+  Clears the previous console output.
+  """
+  o.system("cls")
+
+def find(string: str, character: str):
+  """
+  Returns the number of times a character is repeated in the specified string.
+  """
+  count = 0
+  for i in string:
+    if i == character:
+      count += 1
+    else:
+      pass
+  return count
+
+def floor(value: float):
+  """
+  Returns an integer lower than the specified floating point number.
+  """
+  return int(value)
+
+def key(key: int):
+  """
+  Pauses the program until the requested key is pressed.
+  """
+  if key == 0:
+    k.wait("escape")
+  elif key == 1:
+    k.wait("f1")
+  elif key == 2:
+    k.wait("f2")
+  elif key == 3:
+    k.wait("f3")
+  elif key == 4:
+    k.wait("f4")
+  elif key == 5:
+    k.wait("f5")
+  elif key == 6:
+    k.wait("f6")
+  elif key == 7:
+    k.wait("f7")
+  elif key == 8:
+    k.wait("f8")
+  elif key == 9:
+    k.wait("f9")
+  elif key == 10:
+    k.wait("f10")
+  elif key == 11:
+    k.wait("f11")
+  elif key == 12:
+    k.wait("f12")
+  elif key == 13:
+    k.wait("asciitilde")
+  elif key == 14:
+    k.wait("num 1")
+  elif key == 15:
+    k.wait("num 2")
+  elif key == 16:
+    k.wait("num 3")
+  elif key == 17:
+    k.wait("num 4")
+  elif key == 18:
+    k.wait("num 5")
+  elif key == 19:
+    k.wait("num 6")
+  elif key == 20:
+    k.wait("num 7")
+  elif key == 21:
+    k.wait("num 8")
+  elif key == 22:
+    k.wait("num 9")
+  elif key == 23:
+    k.wait("num 0")
+  elif key == 24:
+    k.wait("num minus")
+  elif key == 25:
+    k.wait("equal")
+  elif key == 26:
+    k.wait("tab")
+  elif key == 27:
+    k.wait("caps lock")
+  elif key == 28:
+    k.wait("left shift")
+  elif key == 29:
+    k.wait("left control")
+  elif key == 30:
+    k.wait("left win")
+  elif key == 31:
+    k.wait("left alt")
+  elif key == 32:
+    k.wait("space")
+  elif key == 33:
+    k.wait("alt gr")
+  elif key == 34:
+    k.wait("right win")
+  elif key == 35:
+    k.wait("menu")
+  elif key == 36:
+    k.wait("right control")
+  elif key == 37:
+    k.wait("right shift")
+  elif key == 38:
+    k.wait("return")
+  elif key == 39:
+    k.wait("backspace")
+  elif key == 40:
+    k.wait("q")
+  elif key == 41:
+    k.wait("w")
+  elif key == 42:
+    k.wait("e")
+  elif key == 43:
+    k.wait("r")
+  elif key == 44:
+    k.wait("t")
+  elif key == 45:
+    k.wait("y")
+  elif key == 46:
+    k.wait("u")
+  elif key == 47:
+    k.wait("i")
+  elif key == 48:
+    k.wait("o")
+  elif key == 49:
+    k.wait("p")
+  elif key == 50:
+    k.wait("a")
+  elif key == 51:
+    k.wait("s")
+  elif key == 52:
+    k.wait("d")
+  elif key == 53:
+    k.wait("f")
+  elif key == 54:
+    k.wait("g")
+  elif key == 55:
+    k.wait("h")
+  elif key == 56:
+    k.wait("j")
+  elif key == 57:
+    k.wait("k")
+  elif key == 58:
+    k.wait("l")
+  elif key == 59:
+    k.wait("z")
+  elif key == 60:
+    k.wait("x")
+  elif key == 61:
+    k.wait("c")
+  elif key == 62:
+    k.wait("v")
+  elif key == 63:
+    k.wait("b")
+  elif key == 64:
+    k.wait("n")
+  elif key == 65:
+    k.wait("m")
+  elif key == 66:
+    k.wait("bracketleft")
+  elif key == 67:
+    k.wait("bracketright")
+  elif key == 68:
+    k.wait("semicolon")
+  elif key == 69:
+    k.wait("apostrophe")
+  elif key == 70:
+    k.wait("backslash")
+  elif key == 71:
+    k.wait("comma")
+  elif key == 72:
+    k.wait("dot")
+  elif key == 73:
+    k.wait("slash")
+  elif key == 74:
+    k.wait("up arrow")
+  elif key == 75:
+    k.wait("left arrow")
+  elif key == 76:
+    k.wait("down arrow")
+  elif key == 77:
+    k.wait("right arrow")
+  elif key == 78:
+    k.wait("num lock")
+  elif key == 79:
+    k.wait("num add")
+  elif key == 80:
+    k.wait("num sub")
+  elif key == 81:
+    k.wait("num multiply")
+  elif key == 82:
+    k.wait("num divide")
+  elif key == 83:
+    k.wait("num enter")
+  elif key == 84:
+    k.wait("insert")
+  elif key == 85:
+    k.wait("delete")
+  elif key == 86:
+    k.wait("home")
+  elif key == 87:
+    k.wait("end")
+  elif key == 88:
+    k.wait("page up")
+  elif key == 89:
+    k.wait("page down")
+  elif key == 90:
+    k.wait("print screen")
+  elif key == 91:
+    k.wait("scroll lock")
+  elif key == 92:
+    k.wait("pause break")
+
+def random(min: float, max: float):
+  """
+  Returns a random float inside the specified range, including the lowest end but not the highest.
+  """
+  return r.uniform(min, max)
+
+def replace(string: str, character: str, replace: str):
+  """
+  Replaces all the instances of a character in the specified string.
+  """
+  replaced = ""
+  for i in string:
+    if i == character:
+      replaced += replace
+    else:
+      replaced += i
+  return replaced
+
+def round(value: float):
+  """
+  Rounds the specified float to the closest integer.
+  """
+  if value * 10 >= (int(value) * 10) + 5:
+    return ceil(value)
+  else:
+    return floor(value)
+
+def roundtodp(value: float, dp: int):
+  """
+  Rounds the floating point number to the specified number of decimal places.
+  """
+  return int(value * (10 ** dp)) / 10 ** dp
+
+def run(path: str):
+  """
+  Runs an external Python script.
+  """
+  s.call(["python", f"{path}.py"])
+
+def time():
+  """
+  Returns the number of seconds that passed since the beginning of the program.
+  """
+  return int(t.time() - timer)
+
+def tstamp():
+  """
+  Returns the number of seconds that passed since epoch.
+  """
+  return int(t.time())
+
+def wait(interval: float):
+  """
+  Pauses the program for the given number of seconds.
+  """
+  t.sleep(interval)
+
+def zeropad(value: int, digits: int):
+  """
+  Pads the specified number out to the given number of digits by adding zeroes to the left, then returns the number as a string.
+  """
+  value = str(value)
+  string = ""
+  zeroes = digits - len(value)
+  for i in range(zeroes):
+    string += "0"
+  string += value
+  return string
+
+class mathclass:
+  pi = 3.1415926535897932384626433832795028841971693993751058209749445923078164062862089986280348253421170679
+  """
+  Represents the value of Archimedes' Constant (π).
+  """
+
+  e = 2.7182818284590452353602874713526624977572470936999595749669676277240766303535475945713821785251664274
+  """
+  Represents the value of Euler's Number (e).
+  """
+
+  def acos(x: float):
+    """
+    Calculates the arc cosine of X.
+    """
+    return m.acos(x)
+
+  def acosh(x: float):
+    """
+    Calculates the inverse hyperbolic cosine of X.
+    """
+    return m.acosh(x)
+
+  def asin(x: float):
+    """
+    Calculates the arc sine of X.
+    """
+    return m.asin(x)
+
+  def asinh(x: float):
+    """
+    Calculates the inverse hyperbolic sine of X.
+    """
+    return m.asinh(x)
+
+  def atan(x: float):
+    """
+    Calculates the arc tangent of X.
+    """
+    return m.atan(x)
+
+  def atanh(x: float):
+    """
+    Calculates the inverse hyperbolic tangent of X.
+    """
+    return m.atanh(x)
+
+  def cbrt(x: float):
+    """
+    Calculates the cube root of X.
+    """
+    return m.cbrt(x)
+
+  def clamp(x: float, a: float, b: float):
+    """
+    Clamps the specified value.
+    """
+    if x < a:
+      return a
+    elif x > b:
+      return b
+    else:
+      return x
+
+  def cos(x: float):
+    """
+    Calculates the cosine of X.
+    """
+    return m.cos(x)
+
+  def cosh(x: float):
+    """
+    Calculates the hyperbolic cosine of X.
+    """
+    return m.cosh(x)
+
+  def cosp(x: float, a: float, b: float):
+    """
+    Interpolates the cosine of A to B by X.
+    """
+    return (a + b + (a - b) * m.cos(x * 180)) / 2
+
+  def cubic(x: float, a: float, b: float, c: float, d: float):
+    """
+    Cubically nterpolates through A, B, C and D by X.
+    """
+    return math.lerp(math.qarp(a, b, c, x), math.qarp(b, c, d, x), x)
+
+  def distance(x1: float, x2: float, y1: float, y2: float):
+    """
+    Calculates the distance between two points in a 2D environment.
+    """
+    return m.sqrt((x2 - x1) ** 2 + (y2 - y1) ** 2)
+
+  def exp(x: float):
+    """
+    Returns e (Euler's Number) to the power of X.
+    """
+    return math.e ** x
+
+  def lerp(x: float, a: float, b: float):
+    """
+    Linearly interpolates A to B by X.
+    """
+    return a + x * (b - a)
+
+  def ln(x: float):
+    """
+    Returns the base e logarithm of X.
+    """
+    return m.log(x, math.e)
+
+  def log(x: float, l: float):
+    """
+    Returns the specified base logarithm of X.
+    """
+    return m.log(x, l)
+
+  def log10(x: float):
+    """
+    Returns the base 10 logarithm of X.
+    """
+    return m.log10(x)
+
+  def pol(a: int, b: int):
+    """
+    Converts the specified complex number (A, B) from rectangular coordinates to polar coordinates.
+    """
+    return c.polar(a, b)
+
+  def qarp(x: float, a: float, b: float, c: float):
+    """
+    Quadriatically interpolates through A, B and C by X.
+    """
+    return math.lerp(math.lerp(a, b, x), math.lerp(b, c, x), x)
+
+  def rec(r: float, p: float):
+    """
+    Converts the specified complex number (R, Φ) from polar coordinates to rectangular coordinates.
+    """
+    return c.rect(r, p)
+
+  def sign(x):
+    """
+    Returns 1 for positive values, -1 for negative values or 0 for zero.
+    """
+    if x > 0:
+      return 1
+    elif x < 0:
+      return - 1
+    else:
+      return 0
+
+  def sin(x: float):
+    """
+    Calculates the sine of X.
+    """
+    return m.sin(x)
+
+  def sinh(x: float):
+    """
+    Calculates the hyperbolic sine of X.
+    """
+    return m.sinh(x)
+
+  def sqrt(x: float):
+    """
+    Calculates the square root of X.
+    """
+    return m.sqrt(x)
+
+  def tan(x: float):
+    """
+    Calculates the tangent of X.
+    """
+    return m.tan(x)
+
+  def tanh(x: float):
+    """
+    Calculates the hyperbolic tangent of X.
+    """
+    return m.tanh(x)
+
+  def unlerp(a: float, b: float, y: float):
+    """
+    Linearly interpolates A to B by Y, e.g. the reverses lerping.
+    """
+    return (y - a) / (b - a)
+
+class drawclass:
+  def line(length: int, formation: int = 0, fixed_width: bool = True):
+    """
+    Draws a line in the console using full block characters.
+    """
+    if fixed_width:
+      if formation == 0:
+        for i in range(length):
+          print("██", end = "")
+      elif formation == 1:
+        indent = 0
+        for i in range(length):
+          for i in range(indent):
+            print("  ", end = "")
+          print("██", end = "\n")
+          indent += 1
+      elif formation == 2:
+        for i in range(length):
+          print("██", end = "\n")
+      elif formation == 3:
+        indent = length - 1
+        for i in range(length):
+          for i in range(indent):
+            print("  ", end = "")
+          print("██", end = "\n")
+          indent -= 1
+    else:
+      if formation == 0:
+        for i in range(length):
+          print("█", end = "")
+      elif formation == 1:
+        indent = 0
+        for i in range(length):
+          for i in range(indent):
+            print(" ", end = "")
+          print("█", end = "\n")
+          indent += 1
+      elif formation == 2:
+        for i in range(length):
+          print("█", end = "\n")
+      elif formation == 3:
+        indent = length - 1
+        for i in range(length):
+          for i in range(indent):
+            print(" ", end = "")
+          print("█", end = "\n")
+          indent -= 1
+    print()
+
+  def rect(width: int, height: int, fixed_width: bool = True):
+    """
+    Draws a rectangle in the console using full block characters.
+    """
+    if fixed_width:
+      for i in range(height):
+        for i in range(width):
+          print("██", end = "")
+        print()
+    else:
+      for i in range(height):
+        for i in range(width):
+          print("█", end = "")
+        print()
+    print()
+
+  def rectb(width: int, height: int, fixed_width: bool = True):
+    """
+    Draws a rectangle border in the console using full block characters.
+    """
+    if fixed_width:
+      for i in range(width):
+        print("██", end = "")
+      print()
+      for i in range(height):
+        print("██", end = "")
+        for i in range(2, width):
+          print("  ", end = "")
+        print("██", end = "")
+        print()
+      for i in range(width):
+        print("██", end = "")
+    else:
+      for i in range(width):
+        print("█", end = "")
+      print()
+      for i in range(height):
+        print("█", end = "")
+        for i in range(2, width):
+          print(" ", end = "")
+        print("█", end = "")
+        print()
+      for i in range(width):
+        print("█", end = "")
+    print()
+
+math = mathclass
+"""
+A sub-class of Wraith that extends the math library.
+"""
+
+draw = drawclass
+"""
+A sub-class of Wraith that adds in-console drawing functions.
+"""