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 smalest program like this:

G"Hello World"

---

📋🦊 Command Reference

Char	Name	Syntax	Description
G	Print	G expr	Print with newline
P	Print (no nl)	P expr	Print without newline
=	Assign	var=expr	Direct assignment (no command letter)
A	Arithmetic assign	A"var"op expr	var = var op expr
S	String replace	S"var""old""new"	Replace substring
D	Delay / Delete	D seconds / D"var"	Wait or delete a variable
K	Input	K"var""prompt""type"	Read from keyboard (with optional type)
X	Execute file	X"file.py"	Run a Python file in the background
Q	Quit	Q	Exit the program
E	Error exit	E"msg"	Print error and exit
U	Import	U"module"	Import a 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
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 (multi‑line possible)
#	Comment	# text	Inline comment

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

---

✨🦊 Basic Syntax

🖨️🦊 Output

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

📥🦊 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 problem's!

• 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 that I gonna say...

• 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 vulpin word comes from Vulpes and Vulpes are so cute and i was take a look at vulpes and I saw that they have rainbow eyes and light eyes but they was escaping from me :(

---

We all learn from animals and nature :D . We should support all animals. The fox is not extinct, but why not? If we don't pay attention, it will become extinct too. :(

---