pyhori 0.1.5

PyHorizon custom language interpreter

PyHorizon

PyHorizon is a tiny custom programming language written in Python. Program files use the .pyh extension and are executed by pyhori.

Project Structure

• main.py - command-line entry point. Reads a .pyh file and runs it.
• lexer.py - converts source code into tokens.
• parser.py - turns tokens into an abstract syntax tree.
• ast_nodes.py - AST node definitions.
• interpreter.py - executes the AST.
• environment.py - variable scope handling.
• errors.py - readable lexer, parser, and runtime errors.
• tokens.py - token data model.
• example.pyh - sample program in the language.
• calculator.pyh - interactive calculator app written in PyHorizon.
• app.pyh - GUI app that opens a window.
• telegram_send.pyh - Telegram Bot API example.
• ai_request.pyh - AI HTTP request example with object and list literals.
• ai_starter.pyh - AI starter template.
• pyhori_ai.py - machine-readable AI manifest.

Syntax

Supported commands:

• say "Hello"
• say Hello world name
• imp x = 10
• x = x + 1
• if x > 5 ... else ... end
• loop x < 10 ... end
• func add(a, b) ... end
• return value
• # comment

In say, plain words without quotes are treated as text, and variables are inserted automatically. Example:

imp name = Gh
say Hello name

ask reads user input and automatically converts numbers and booleans when possible:

imp value = ask Введи число

Built-ins for bots and AI:

• http_get(url)
• http_post(url, body)
• http_post_headers(url, body, headers_json)
• json_parse(text)
• json_stringify(value)
• sleep(seconds)
• run_cmd(command)
• to_text(value)

JSON data can be accessed with brackets:

imp data = json_parse("{\"ok\": true, \"n\": 3}")
imp value = data["n"]
say value

You can build structured payloads directly with object literals instead of concatenating JSON strings:

imp body = {
    chat_id: chat_id
    text: text
}

imp headers = {
    Authorization: "Bearer " + token
}

imp response = http_post_headers(url, body, headers)

Lists work too, so nested JSON like messages: [ { role: "user" content: prompt } ] can be written directly.

If you want the easiest version for typing on a PC keyboard, use obj and list blocks:

imp body = obj
    chat_id chat_id
    text text
end

imp headers = obj
    Authorization "Bearer " + token
end

How It Works

1. The lexer reads text from a .pyh file and turns it into tokens.
2. The parser builds a structured tree of statements and expressions.
3. The interpreter walks that tree and executes the program.

Run

Install

From PyPI:

pip install pyhori

From local source:

pip install .

Windows

pyhori example.pyh

Linux

pyhori example.pyh

Termux

pkg install python
pip install .
pyhori example.pyh

You can also run your own file:

pyhori program.pyh

Run the included app:

pyhori calculator.pyh

Open the GUI app:

pyhori app.pyh

Run the Telegram example:

pyhori telegram_send.pyh

Run the AI example:

pyhori ai_request.pyh

Run the AI starter template:

pyhori ai_starter.pyh

Print the machine-readable AI manifest:

python pyhori_ai.py

Show the version:

pyhori --version