Vulpin is a tiny, single character command scripting language that runs on top of C!
It was designed to let you write the smallest possible program's.

---

Installation

• Go to Vulpin Website

• Then tab to the Download button on novbar

• and Download and Install the version of Vulpin that you want!

Quick Start

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

   G "Hello World!"
   

2. Run it:

   vulpin hello.vul
   

[!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"

---

Basic Syntax

name="Armin"
G"Hello"           # Prints with newline
P"Loading..."      # Prints without newline
G 5 + 3            # Prints 8
Gname            # 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 "")

Kinput"K can write like this! :)"

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

You can Import C or Vulpin Modules with using U.

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

U"math"
G math.sqrt(16)

Control Flow

If / Else

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

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
&

Infinite Loop

@1
    G"Running forever..."
&

For‑Range Loop

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

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

Switch / Case

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

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...

---

Complete Examples

Hello World

G"Hello World"

Guessing Game

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

---

Checking vul version

To check the version of Vul you are running:

vulpin version

Output:

Vul 0.8

Build your apps!

vulpin build

---

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.
• 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. ICONS ARE UNDER LICENCE TOO.

---

Happy coding with Vulpin!

Sponsers:

FluxCast