whizz 0.9.0__tar.gz

whizz-0.9.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 splot.dev
+
+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.

whizz-0.9.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: whizz
+Version: 0.9.0
+Summary: Whizz is a succinct esoteric programming language that is almost, contradictorily, relatively usable.
+License: MIT
+License-File: LICENSE
+Author: splot.dev
+Requires-Python: >=3.11,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: readchar (>=4.2.2,<5.0.0)
+Requires-Dist: typer (>=0.27.0,<1.0.0)
+Description-Content-Type: text/markdown
+
+# Whizz Programming Language
+## Learn more at [the repository](https://codeberg.org/splot-dev/whizz).

whizz-0.9.0/README.md

@@ -0,0 +1,2 @@
+# Whizz Programming Language
+## Learn more at [the repository](https://codeberg.org/splot-dev/whizz).

whizz-0.9.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "whizz"
+version = "0.9.0"
+description = "Whizz is a succinct esoteric programming language that is almost, contradictorily, relatively usable."
+authors = [
+    {name = "splot.dev"}
+]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.11,<4.0"
+dependencies = [
+    "typer (>=0.27.0, <1.0.0)",
+    "readchar (>=4.2.2, <5.0.0)"
+]
+
+[tool.poetry.scripts]
+whizz = "whizz.cli:main"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

whizz-0.9.0/whizz/base.py

@@ -0,0 +1,56 @@
+"""
+Whizz Programming Language / Transpiled Program
+language by splot.dev
+"""
+
+##### BASE CODE #####
+
+import random
+import readchar
+
+_variables = {}
+_selected = None
+
+def _need_selected():
+  if _selected is None:
+    raise RuntimeError('Cannot perform actions without selected variable.')
+
+def _select(name):
+  global _variables
+  if name not in _variables:
+    _variables[name] = 0
+
+  global _selected
+  _selected = name
+    
+def _increment(amount):
+  _need_selected()
+  global variables
+  _variables[_selected] += amount
+
+def _decrement(amount):
+  _need_selected()
+  global variables
+  _variables[_selected] -= amount
+
+def _random():
+  _need_selected()
+  global variables
+  _variables[_selected] = random.randint(1, 1000000)
+
+def _print():
+  _need_selected()
+  try:
+    print(chr(_variables[_selected]), end="")
+  except:
+    raise RuntimeError(f'Could not print integer "{_variables[_selected]}".')
+
+def _input():
+  _need_selected()
+  global variables
+  try:
+    _variables[_selected] = ord(readchar.readchar())
+  except:
+    _variables[_selected] = -1
+    
+##### STARTING USER CODE #####

whizz-0.9.0/whizz/cli.py

@@ -0,0 +1,29 @@
+"""
+Whizz Programming Language / Command-Line Interface
+by splot.dev
+"""
+
+from transpiler import transpile
+import typer
+
+def main(file: str):
+  try:
+    with open(file) as f:
+      code = f.read()
+  except Exception as e:
+    print(f"💬 Couldn't read your file:\n{e}")
+
+  try:
+    transpiled = transpile(code)
+  except Exception as e:
+    print(f"💬 Couldn't transpile your code:\n{e}")
+
+  try:
+    exec(transpiled)
+  except Exception as e:
+    print(f"💬 Couldn't execute your code without errors:\n{e}")
+
+  return True
+
+if __name__ == "__main__":
+  typer.run(main)

whizz-0.9.0/whizz/grammar.lark

@@ -0,0 +1,29 @@
+# Whizz Programming Language / Lark Grammar
+# by splot.dev
+
+start: ( _command | function )*
+
+_command: select | increment | decrement | random
+        | forever | call
+        | print | input
+
+select: NAME
+increment: INTEGER? "+"
+decrement: INTEGER? "-"
+random: "~"
+
+function: NAME "{" _command* "}"
+forever: "(" ( _command | end )* ")"
+end: ";"
+call: NAME "*"
+
+print: "!"
+input: "?"
+
+NAME: /[a-zA-Z]+/
+INTEGER: /[0-9]+/
+
+COMMENT: /\[[\s\S]*?\]/
+%ignore COMMENT
+%ignore WHITESPACE
+%import common.WS -> WHITESPACE

whizz-0.9.0/whizz/transpiler.py

@@ -0,0 +1,85 @@
+"""
+Whizz Programming Language / Transpiler
+by splot.dev
+"""
+
+from lark import Lark
+from lark.visitors import Interpreter
+
+# acquire grammar and load into lark
+with open("grammar.lark") as file:
+  grammar = file.read()
+parser = Lark(grammar)
+
+# set transpilation base from file
+with open("base.py") as file:
+  transpilation_base = file.read()
+
+# lark interpreter class
+class Transpiler(Interpreter):
+  def __init__(self):
+    self.code = transpilation_base + "\n\n"
+    self.level = 0
+
+  def _indent(self):
+    return self.level * "  "
+
+  def forever(self, tree):
+    self.code += self._indent() + "while True:\n"
+    if tree.children:
+      self.level += 1
+      self.visit_children(tree)
+      self.level -= 1
+    else:
+      self.code += self._indent() + "  pass\n"
+
+  def function(self, tree):
+    self.code += f"def {tree.children[0]}():\n"
+    if tree.children[1:]:
+      self.level += 1
+      for child in tree.children[1:]:
+        self.visit(child)
+      self.level -= 1
+    else:
+      self.code += "  pass\n"
+
+  def end(self, tree):
+    self.code += self._indent() + "_need_selected()\n"
+    self.code += self._indent() + "if _variables[_selected] == 0:\n"
+    self.code += self._indent() + "  break\n"
+
+  def call(self, tree):
+    self.code += self._indent() + tree.children[0] + "()\n"
+
+  def select(self, tree):
+    self.code += self._indent() + f"_select('{tree.children[0]}')\n"
+
+  def increment(self, tree):
+    if tree.children:
+      self.code += self._indent() + f"_increment({tree.children[0]})\n"
+    else:
+      self.code += self._indent() + "_increment(1)\n"
+
+  def decrement(self, tree):
+    if tree.children:
+      self.code += self._indent() + f"_decrement({tree.children[0]})\n"
+    else:
+      self.code += self._indent() + "_decrement(1)\n"
+
+  def random(self, tree):
+    self.code += self._indent() + "_random()\n"
+
+  def print(self, tree):
+    self.code += self._indent() + "_print()\n"
+
+  def input(self, tree):
+    self.code += self._indent() + "_input()\n"
+
+# usage of class
+def transpile(code):
+  tree = parser.parse(
+    code.replace("\n", "").replace("\t", "").replace("\r", "").replace(" ", "") # lark is funny with whitespace
+  )
+  transpiler = Transpiler()
+  transpiler.visit(tree)
+  return transpiler.code