Vulpin

Vulpin is a tiny, single character command scripting language that runs on top of Python :)🦊!
It was designed to let you write the smallest possible programs while still having full programming power! ;)

Installition

• Download Vulpin from github or using the gitclone and some of the stuff...

• Download Python 3.

• Then Sync Vulpin in system variables. Sync it with folder of Bin

Quick Start

1. Create a .vul file. Like hello.vul:

   G "Hello from Vul!"
   

2. Run it:

   python vul.py hello.vul

If you run python vul.py without a filename, it will try to execute app.vul in the current directory!

Tip

You can remove spaces in your app! dont worry about it! Because if you do that you can build your smallest program like this:

G"Hello World"

---

Command Reference

Char	Name	Syntax	Description
G	Print	G expr	Print expression with newline
P	Print (no nl)	P expr	Print expression without newline
=	Assign	var=expr	Direct variable assignment
A	Arithmetic assign	A"var"op expr	var = var op expr
S	String replace	S"var""old""new"	Replace substring in variable
D	Delay / Delete	D seconds / D"var"	Wait or delete a variable
K	Input	K"var""prompt""type"	Read input from keyboard
X	Execute file	X"file.py"	Run Python file in background
Q	Quit	Q	Exit the program
E	Error exit	E"msg"	Print error message and exit
U	Import	U"module"	Import Python module or .vul file
?	If / Cond jump	? cond / ? cond J label	Conditional execution
:	Else	:	Else clause
;	Endif	;	End if block
@	While	@ cond	Start while loop
&	Wend / End for	&	End loop
O	For‑range	O var start end [step]	Counted loop
L	Label	L name	Define a jump label
J	Jump	J label	Unconditional jump
F	Function	F name(params)	Define a function
R	Return	R expr	Return from function
~	End function	~	End function body
T	Try	T	Start try block
C	Catch	C / C"var"	Catch exception
Y	End try	Y	End try/catch block
W	Switch	W expr	Start switch block
V	Case	V value	Case in switch
N	Default	N	Default case
Z	End switch	Z	End switch block
!	Python exec	! code	Execute raw Python code
#	Comment	# text	Inline comment

Bruh :/ This doesnt look's like command reference of ASM :/ if you think, damn! learn ASM ;-;

---

Basic Syntax

name="Armin"
G"Hello"           # Prints with newline
P"Loading..."      # Prints without newline
G 5 + 3            # Prints 8
G $name            # Prints value of variable name

Output

Hello
Loading...8
Armin

---

Input

K"user""Your name: "
G"Hi, " + $user

# Typed input (invalid → default value)
K"age""Age: ""I"        # Integer (default 0)
K"price""Price: ""F"    # Float (default 0.0)
K"letter""Guess: ""L"   # Single letter (default "")

Type characters for K:

Char	Type	Default if invalid
I	Integer	0
F	Float	0.0
N	Number (int/float)	0
L	Single letter	""
W	Word (letters only)	""
E	Lowercase only	""
U	Uppercase only	""
A	Letters + spaces	""
P	Alphanumeric + spaces	""

---

Variables

x=10               # Direct assignment
name="Vul"

A"x"+5             # x = x + 5
S"name""Vul""VUL"  # Replace in string
D"y"               # Delete variable

String shortcuts:

Shortcut	Method	Example ($msg.S)
.U	upper()	"hello".U → "HELLO"
.L	lower()	"HELLO".L → "hello"
.S	strip()	" hi ".S → "hi"
.T	title()	"hi there".T → "Hi There"
.C	capitalize()	"hello".C → "Hello"

Delay

D1          # wait 1 second
D0.5        # wait 0.5 seconds
D $delay    # wait the value of variable

---

Imports

U"os"
G $os.getcwd()
$os.system("echo Hello")

U"math"
G $math.sqrt(16)

U"mylib.vul"    # execute another Vul file

---

Control Flow

? / : / ; – If / Else

score=85
? $score >= 90
    G"A"
:
? $score >= 80
    G"B"
:
    G"C"
;
;

? ... J – Conditional Jump🦊🦘

x=5
? $x > 3 J skip
G"Not printed"
L skip
G"Printed"

@ / & – While Loop ➰🦊

i=0
@ $i < 5
    G $i
    i=$i+1
&

@ 1 – Infinite Loop ➿🦊

@ 1
    G"Running forever..."
&

O / & – For‑Range Loop 🏌️🦊

O i 0 5            # 0,1,2,3,4
    G $i
&

O x 10 0 -2        # 10,8,6,4,2
    G $x
&

W / V / N / Z – Switch / Case🛟🦊

fruit="apple"
W $fruit
V"banana"   G"yellow"
V"apple"    G"red or green"
N           G"unknown"
Z

L / J – Labels & Jumps🦊

J end
G"Skipped"
L end
G"Done"

---

🔧 Functions

F add(a, b)
    R $a + $b
~

G $add(3, 4)       # 7

F greet(name)
    G"Hello " + $name
~

$greet("World")

---

🥷 Error Handling

T
    x=10
    y=0
    G $x/$y        # division by zero!
C"err"
    G"Error: " + $err
Y
G"Continues..."

📤Output:

Error: division by zero
Continues...

---

🐍🦊 Inline Python (!)

Single line

!print("Hello from Python")
!x = 42
G $x

Multi‑line (every line starts with !)

!class Dog:
!    def __init__(self, name):
!        self.name = name
!    def speak(self):
!        return "Woof!"

!d = Dog("Buddy")
G $d.name
G $d.speak()

---

🧪 Complete Examples

👋 Hello World

G"Hello World"

🧮 Calculator

K"a""First: ""N"
K"op""Op (+,-,*,/): ""W"
K"b""Second: ""N"
? $op="+" G $a+$b
:? $op="-" G $a-$b
:? $op="*" G $a*$b
:? $op="/" G $a/$b
;
;
;
;

🤔 Guessing Game (For practice)

U"random"
secret=$random.randint(1,10)
tries=0
L guess
K"num""Guess (1-10): ""I"
tries=$tries+1
? $num=$secret
    G"Correct! Tries: "+$tries
    Q
:? $num<$secret G"Higher"
: G"Lower"
;
;
J guess

🏭 Factorial

F factorial(n)
    ? $n<=1
        R 1
    ;
    R $n*$factorial($n-1)
~

G $factorial(5)   # 120

---

Command for check version 🦊

To check the version of Vul you are running:

vulpin version

Output:

Vul 0.1

Build your app! (Beta) 🦊🏗️

• If you want to build your app, first you should install pyinstaller:

pip install pyinstaller

then all things are right!

you can build your apps easily like this:

• for build your app as default:

vulbuild

• for build for linux, macos,windows:

vulbuild --os all --cross

• for build a specific OS only:

vulbuild --os linux --cross

vulbuild --os windows --cross

• for package your Project:

vulbuild --os all --cross --package zip tar.gz appimage dmg

---

TroubleShooting💫

Let's fix your problems!

• Python Type Hint Syntax Error: this is known error in new Vulpin version like you can see it at most in version 0.5 but thats easy to fix!
  • on vulpin 0.5 this error might be in line of 682 or line of 77 or etc...! take a look at here to see how to fix: https://github.com/orgs/community/discussions/199748

---

Some of the notes

• Spaces are optional after commands. G"Hi" and G "Hi" both work.
• All commands are case‑sensitive – only uppercase for the command letters (except !, =, #).
• The dot operator (like $os.name) works correctly in the latest release. If you encounter issues, use the --debug flag to see detailed parser output.

---

📄 License

MIT LICENCE. CHECK OUT LICENCE. :D

Happy coding with Vulpin!

Actually, the word "vulpin" comes from Vulpes. Vulpes are so cute! I was taking a look at them and saw that they have rainbow colored eyes and light eyes! but they were escaping from me. :( We all learn from animals and nature :D We should support all animals. The fox is not extinct yet, but it could be. If we don't pay attention, it will become extinct too. :(

---