borschscript 0.1.1__tar.gz

borschscript-0.1.1/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Oleksandr Volkohon
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

borschscript-0.1.1/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: borschscript
+Version: 0.1.1
+Summary: An esoteric XMLlike joke programming language in Ukrainian.
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center">
+  <img src="img/icon.png" alt="BorschScript Logo" width="150" /><br />
+  <sub
+    ><a
+      href="https://www.flaticon.com/free-icons/russian-food"
+      title="russian food icons"
+      >Russian food icons created by Muhammad_Usman - Flaticon</a
+    ></sub
+  >
+</p>
+<h1 align="center">BorschScript</h1>
+
+<p align="center">
+  <b>BorschScript</b>, an esoteric, XML-like programming language written in Ukrainian.
+</p>
+
+---
+
+## Installation
+
+### From Source
+Clone the repository and install it locally using `pip`:
+
+```bash
+git clone [https://github.com/your-username/borshscript.git](https://github.com/your-username/borshscript.git)
+cd borshscript
+pip install -e .
+```
+
+## Quick Start
+
+Create a script file named `recipe.brsh`:
+
+```xml
+<змінна назва="порції">3</змінна>
+
+<функція назва="зварити_борщ" аргументи="кількість">
+    <друк>f"Варимо борщ на {кількість} порції!"</друк>
+</функція>
+
+<якщо умова="порції >= 3">
+    <викликати назва="зварити_борщ" аргументи="порції" />
+</якщо>
+<інакше>
+    <друк>"Занадто мало інгредієнтів..."</друк>
+</інакше>
+```
+
+Run your script from the terminal:
+
+```bash
+borsch recipe.brsh
+```
+
+### Debug Mode
+
+To inspect the transpiled Python code before execution, pass the --debug flag:
+
+```bash
+borsch recipe.brsh --debug
+```
+
+## Language Syntax Overview
+
+|BorschScript|Description|Python Equivalent|
+|-|-|-|
+|`<змінна назва="X">значення</змінна>`|Declare variable|`X = значення`|
+|`<друк>значення</друк>`|Print output|`print(значення)`|
+|`<якщо умова="X">`|Conditional statement|if X:|
+|`<інакше>`|Else block|`else:`|
+|`<поки умова="X">`|While loop|`while X:`|
+|`<функція назва="X" аргументи="A, B">`|Define function|`def X(A,B)`|
+|`<повернути>значення</повернути>`|Return statement|`return значення`|
+|`<викликати назва="X" аргументи="A" />`|Call function|`X(A)`|
+
+## License
+
+Distributed under **BSD-3** License. See [LICENSE](LICENSE) for more info.

borschscript-0.1.1/README.md

@@ -0,0 +1,78 @@
+<p align="center">
+  <img src="img/icon.png" alt="BorschScript Logo" width="150" /><br />
+  <sub
+    ><a
+      href="https://www.flaticon.com/free-icons/russian-food"
+      title="russian food icons"
+      >Russian food icons created by Muhammad_Usman - Flaticon</a
+    ></sub
+  >
+</p>
+<h1 align="center">BorschScript</h1>
+
+<p align="center">
+  <b>BorschScript</b>, an esoteric, XML-like programming language written in Ukrainian.
+</p>
+
+---
+
+## Installation
+
+### From Source
+Clone the repository and install it locally using `pip`:
+
+```bash
+git clone [https://github.com/your-username/borshscript.git](https://github.com/your-username/borshscript.git)
+cd borshscript
+pip install -e .
+```
+
+## Quick Start
+
+Create a script file named `recipe.brsh`:
+
+```xml
+<змінна назва="порції">3</змінна>
+
+<функція назва="зварити_борщ" аргументи="кількість">
+    <друк>f"Варимо борщ на {кількість} порції!"</друк>
+</функція>
+
+<якщо умова="порції >= 3">
+    <викликати назва="зварити_борщ" аргументи="порції" />
+</якщо>
+<інакше>
+    <друк>"Занадто мало інгредієнтів..."</друк>
+</інакше>
+```
+
+Run your script from the terminal:
+
+```bash
+borsch recipe.brsh
+```
+
+### Debug Mode
+
+To inspect the transpiled Python code before execution, pass the --debug flag:
+
+```bash
+borsch recipe.brsh --debug
+```
+
+## Language Syntax Overview
+
+|BorschScript|Description|Python Equivalent|
+|-|-|-|
+|`<змінна назва="X">значення</змінна>`|Declare variable|`X = значення`|
+|`<друк>значення</друк>`|Print output|`print(значення)`|
+|`<якщо умова="X">`|Conditional statement|if X:|
+|`<інакше>`|Else block|`else:`|
+|`<поки умова="X">`|While loop|`while X:`|
+|`<функція назва="X" аргументи="A, B">`|Define function|`def X(A,B)`|
+|`<повернути>значення</повернути>`|Return statement|`return значення`|
+|`<викликати назва="X" аргументи="A" />`|Call function|`X(A)`|
+
+## License
+
+Distributed under **BSD-3** License. See [LICENSE](LICENSE) for more info.

borschscript-0.1.1/borsch/cli.py

@@ -0,0 +1,15 @@
+import sys
+from borsch.runner import run_file
+
+def main():
+    if len(sys.argv) < 2:
+        print("Використання: borsch <файл.brsh> [--debug]")
+        sys.exit(1)
+
+    filename = sys.argv[1]
+    debug_mode = "--debug" in sys.argv
+
+    run_file(filename, show_generated_python=debug_mode)
+
+if __name__ == "__main__":
+    main()

borschscript-0.1.1/borsch/errors.py

@@ -0,0 +1,11 @@
+class BorschSyntaxError(Exception):
+    """Raised when the .brsh markup is malformed."""
+    pass
+
+class BorschRuntimeError(Exception):
+    """Raised when the code fails during execution."""
+    pass
+
+def print_borsch_error(error_type, message):
+    print(f"\nBORSCH ERROR: {error_type}")
+    print(f"> {message}\n")

borschscript-0.1.1/borsch/parser.py

@@ -0,0 +1,138 @@
+import re
+from .errors import BorschSyntaxError
+
+class Token:
+    def __init__(self, kind, value, line):
+        self.kind = kind      # 'OPEN_TAG', 'CLOSE_TAG', 'SELF_CLOSE_TAG'
+        self.value = value    # Tag name (e.g. 'змінна', 'якщо')
+        self.line = line
+        self.attrs = {}       # Dictionary of attributes
+        self.content = ""     # Inner text content
+
+class BorschTranspiler:
+    def __init__(self):
+        # Map BorschScript tags to Python code generation rules
+        self.tag_handlers = {
+            "змінна": self._handle_variable,
+            "друк": self._handle_print,
+            "якщо": self._handle_if,
+            "інакше": self._handle_else,
+            "поки": self._handle_while,
+            "функція": self._handle_function,
+            "повернути": self._handle_return,
+            "викликати": self._handle_call
+        }
+
+    def transpile(self, brsh_code: str) -> str:
+        tokens = self._tokenize(brsh_code)
+        python_code = self._generate_python(tokens)
+        return python_code
+
+    def _tokenize(self, code: str):
+        tokens = []
+        # Matches tags like: <tag attr="val">Content</tag> OR <tag attr="val" />
+        tag_pattern = re.compile(
+            r'<\s*(?P<close>/)?\s*(?P<tag>[\w\'-]+)(?P<attrs>[^/>]*)(?P<self_close>/)?\s*>'
+        )
+        
+        pos = 0
+        line_num = 1
+        
+        for match in tag_pattern.finditer(code):
+            start, end = match.span()
+            line_num += code[pos:start].count('\n')
+            
+            is_close = bool(match.group('close'))
+            is_self_close = bool(match.group('self_close'))
+            tag_name = match.group('tag').lower()
+            raw_attrs = match.group('attrs')
+            
+            # Parse attributes (handles both "val" and 'val', plus ім'я/назва)
+            attrs = {}
+            attr_pattern = re.compile(r'([\w\'-]+)\s*=\s*(?:"([^"]*)"|\'([^\']*)\')')
+            for attr_match in attr_pattern.finditer(raw_attrs):
+                key = attr_match.group(1).replace("ім'я", "назва").replace("імʼя", "назва")
+                val = attr_match.group(2) if attr_match.group(2) is not None else attr_match.group(3)
+                attrs[key] = val
+
+            token = Token(
+                kind='CLOSE' if is_close else ('SELF_CLOSE' if is_self_close else 'OPEN'),
+                value=tag_name,
+                line=line_num
+            )
+            token.attrs = attrs
+
+            # Capture text content between the previous position and this tag
+            if not is_close:
+                pos_next = match.end()
+                # Find matching closing tag or next tag to extract text content
+                next_tag = tag_pattern.search(code, pos_next)
+                if next_tag:
+                    raw_content = code[pos_next:next_tag.start()]
+                    token.content = raw_content.strip()
+
+            tokens.append(token)
+            pos = end
+
+        return tokens
+
+    def _generate_python(self, tokens) -> str:
+        python_lines = []
+        indent_level = 0
+
+        for token in tokens:
+            prefix = "    " * indent_level
+
+            if token.kind == 'CLOSE':
+                # Dedent when closing a block tag
+                if token.value in ["якщо", "інакше", "поки", "функція"]:
+                    indent_level = max(0, indent_level - 1)
+                continue
+
+            if token.value not in self.tag_handlers:
+                raise BorschSyntaxError(f"Рядок {token.line}: Невідомий тег <{token.value}>")
+
+            handler = self.tag_handlers[token.value]
+            line_code, increases_indent = handler(token, prefix)
+            
+            python_lines.append(line_code)
+            if increases_indent:
+                indent_level += 1
+
+        return "\n".join(python_lines) + "\n"
+
+    # --- TAG HANDLERS ---
+
+    def _handle_variable(self, token, prefix):
+        name = token.attrs.get("назва") or token.attrs.get("назва")
+        val = token.content if token.content else "None"
+        return f"{prefix}{name} = {val}", False
+
+    def _handle_print(self, token, prefix):
+        return f"{prefix}print({token.content})", False
+
+    def _handle_if(self, token, prefix):
+        cond = token.attrs.get("умова", "True")
+        return f"{prefix}if {cond}:", True
+
+    def _handle_else(self, token, prefix):
+        # Dedicated handler for <інакше>
+        return f"{prefix}else:", True
+
+    def _handle_while(self, token, prefix):
+        cond = token.attrs.get("умова", "True")
+        return f"{prefix}while {cond}:", True
+
+    def _handle_function(self, token, prefix):
+        name = token.attrs.get("назва")
+        args = token.attrs.get("аргументи", "")
+        return f"{prefix}def {name}({args}):", True
+
+    def _handle_return(self, token, prefix):
+        val = token.content if token.content else "None"
+        return f"{prefix}return {val}", False
+
+    def _handle_call(self, token, prefix):
+        name = token.attrs.get("назва")
+        args = token.attrs.get("аргументи", "")
+        return f"{prefix}{name}({args})", False

borschscript-0.1.1/borsch/runner.py

@@ -0,0 +1,27 @@
+from .parser import BorschTranspiler
+from .errors import BorschSyntaxError, print_borsch_error
+
+def run_file(file_path: str, show_generated_python: bool = False):
+    if not file_path.endswith(".brsh"):
+        print_borsch_error("Файл", "BorschScript файли повинні мати розширення .brsh!")
+        return
+
+    try:
+        with open(file_path, "r", encoding="utf-8") as f:
+            code = f.read()
+
+        transpiler = BorschTranspiler()
+        py_code = transpiler.transpile(code)
+    
+        if show_generated_python:
+            print("--- Transpiled Python Code ---")
+            print(py_code)
+            print("------------------------------")
+
+        exec_globals = {"__name__": "__main__"}
+        exec(py_code, exec_globals)
+
+    except BorschSyntaxError as e:
+        print_borsch_error("Помилка Синтаксису", str(e))
+    except Exception as e:
+        print_borsch_error("Помилка Виконання", str(e))

borschscript-0.1.1/borschscript.egg-info/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: borschscript
+Version: 0.1.1
+Summary: An esoteric XMLlike joke programming language in Ukrainian.
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center">
+  <img src="img/icon.png" alt="BorschScript Logo" width="150" /><br />
+  <sub
+    ><a
+      href="https://www.flaticon.com/free-icons/russian-food"
+      title="russian food icons"
+      >Russian food icons created by Muhammad_Usman - Flaticon</a
+    ></sub
+  >
+</p>
+<h1 align="center">BorschScript</h1>
+
+<p align="center">
+  <b>BorschScript</b>, an esoteric, XML-like programming language written in Ukrainian.
+</p>
+
+---
+
+## Installation
+
+### From Source
+Clone the repository and install it locally using `pip`:
+
+```bash
+git clone [https://github.com/your-username/borshscript.git](https://github.com/your-username/borshscript.git)
+cd borshscript
+pip install -e .
+```
+
+## Quick Start
+
+Create a script file named `recipe.brsh`:
+
+```xml
+<змінна назва="порції">3</змінна>
+
+<функція назва="зварити_борщ" аргументи="кількість">
+    <друк>f"Варимо борщ на {кількість} порції!"</друк>
+</функція>
+
+<якщо умова="порції >= 3">
+    <викликати назва="зварити_борщ" аргументи="порції" />
+</якщо>
+<інакше>
+    <друк>"Занадто мало інгредієнтів..."</друк>
+</інакше>
+```
+
+Run your script from the terminal:
+
+```bash
+borsch recipe.brsh
+```
+
+### Debug Mode
+
+To inspect the transpiled Python code before execution, pass the --debug flag:
+
+```bash
+borsch recipe.brsh --debug
+```
+
+## Language Syntax Overview
+
+|BorschScript|Description|Python Equivalent|
+|-|-|-|
+|`<змінна назва="X">значення</змінна>`|Declare variable|`X = значення`|
+|`<друк>значення</друк>`|Print output|`print(значення)`|
+|`<якщо умова="X">`|Conditional statement|if X:|
+|`<інакше>`|Else block|`else:`|
+|`<поки умова="X">`|While loop|`while X:`|
+|`<функція назва="X" аргументи="A, B">`|Define function|`def X(A,B)`|
+|`<повернути>значення</повернути>`|Return statement|`return значення`|
+|`<викликати назва="X" аргументи="A" />`|Call function|`X(A)`|
+
+## License
+
+Distributed under **BSD-3** License. See [LICENSE](LICENSE) for more info.

borschscript-0.1.1/borschscript.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+borsch/__init__.py
+borsch/cli.py
+borsch/errors.py
+borsch/parser.py
+borsch/runner.py
+borschscript.egg-info/PKG-INFO
+borschscript.egg-info/SOURCES.txt
+borschscript.egg-info/dependency_links.txt
+borschscript.egg-info/entry_points.txt
+borschscript.egg-info/top_level.txt

borschscript-0.1.1/borschscript.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

borschscript-0.1.1/borschscript.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+borsch = borsch.cli:main

borschscript-0.1.1/borschscript.egg-info/top_level.txt

@@ -0,0 +1 @@
+borsch

borschscript-0.1.1/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "borschscript"
+version = "0.1.1"
+description = "An esoteric XMLlike joke programming language in Ukrainian."
+readme = "README.md"
+requires-python = ">=3.8"
+
+[project.scripts]
+borsch = "borsch.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["borsch*"]

borschscript-0.1.1/setup.cfg

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

borschscript-0.1.1/setup.py

@@ -0,0 +1,12 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="borschscript",
+    version="0.1.0",
+    packages=find_packages(),
+    entry_points={
+        "console_scripts": [
+            "borsch=borsch.cli:main",   # Creates the 'borsch' CLI command
+        ],
+    },
+)