Once upon a time, in a magical land of ice and snow, there lived a colony of adorable penguins who loved to code! 🐧✨
CodePenguin is a special programming language made just for you! It's like telling a story about penguins, but the story is actually a computer program! How cool is that? 🎉
- 🐧 Super Fun! Every program reads like a cute penguin adventure!
- 🎓 Secretly Educational! You're learning real programming while having fun!
- 🌈 Colorful & Beautiful! Everything is bright and cheerful!
- 💝 Kid-Friendly! Made especially for ages 9 and up!
First, make sure you have Python 3 installed on your computer! Then:
# Clone this repository (or download it)
cd "Project Code Penguin"
# That's it! You're ready to go! 🎉Let's write your very first CodePenguin program! Create a file called hello.cp:
An adorable colony gathers called HelloWorld
squawk "🐧 Hello, World! Welcome to CodePenguin! 🐧"
The colony joyfully disperses
Now run it:
python codepenguin.py hello.cpWow! Did you see that? You just wrote your first program! 🎉
Want to try things out quickly? Start the interactive playground:
python codepenguin.pyYou'll see this friendly message:
🐧 Welcome to CodePenguin! 🐧
Brr-ello, little chick! Ready to waddle some code?
Type your penguin story and press Enter twice to run it!
🐧 >>>
Just type your code and press Enter twice to run it! It's that easy! 🐧
An adorable colony gathers called MyProgram
preen Your code goes here!
The colony joyfully disperses
Give a penguin a pebble (variable) with a value:
gift pebble name with "Penguin"
gift pebble age with 5
gift pebble favoriteNumber with 42
Make your penguin squawk (print) something:
squawk "Hello, world!"
squawk name
squawk "I am "
squawk age
squawk " years old!"
Create a list of things:
crèche of chicks friends = ["Alice", "Bob", "Charlie"]
crèche of chicks numbers = [1, 2, 3, 4, 5]
For loops - March over a list:
march over friends giving each friend
squawk "Hello, "
squawk friend
squawk "!"
While loops - Porpoise while something is true:
gift pebble count with 10
porpoise while count > 0
squawk count
gift pebble count with count - 1
squawk "Blast off! 🚀"
Create a huddle (function) that penguins can dive into:
huddle greet name
squawk "Hello, "
squawk name
squawk "! 🐧"
end huddle
dive into greet("Penguin")
Help your penguin make choices:
gift pebble age with 10
if age >= 10
squawk "You're a big penguin!"
else
squawk "You're still a little chick!"
Get a random number:
gift pebble luckyNumber with random pebble between 1 and 100
squawk "Your lucky number is "
squawk luckyNumber
Mix up a list:
crèche of chicks colors = ["red", "blue", "green"]
huddle-shuffle colors
Save something to a file:
gift pebble score with 1000
nest "highscore.txt" with score
Do math just like in school:
gift pebble a with 10
gift pebble b with 5
squawk a + b preen Addition
squawk a - b preen Subtraction
squawk a * b preen Multiplication
squawk a / b preen Division
Add notes to your code:
preen This is a comment! Penguins use it to leave notes!
gift pebble x with 5 preen This sets x to 5
Check out the examples/ folder for lots of fun programs:
- Hello World - Your first program! 🐧
- Variables - Learning about pebbles! 💎
- Number Guessing Game - A fun game! 🎮
- Fibonacci - Math magic! ✨
- Lists - Working with crèches! 🐣
- Arduino LED - Generate MicroPython code! 💡
- Turtle Penguin - Draw a penguin! 🎨
- Feed the Penguin - A complete game! 🐟
- Shuffle Game - Mix things up! 🔀
- Math Fun - Practice math! ➕
- Functions - Learn about huddles! 🤗
- Countdown - Count backwards! ⏰
- File Operations - Save your data! 💾
- Random Adventure - Daily adventures! 🎲
Try running them all:
python codepenguin.py examples/01_hello_world.cp
python codepenguin.py examples/02_variables.cp
# ... and so on!If something goes wrong, don't worry! CodePenguin will help you with friendly messages:
- "Oops! A penguin slipped on the ice – you forgot to end your huddle!"
- "That pebble wasn't gifted yet! Try 'gift pebble name with value' first."
- "The crèche is empty! You tried to march over nothing."
Every error message is designed to help you learn! 🎓
For more experienced penguins, you can enable strict mode:
emperor mode on
An adorable colony gathers called StrictProgram
preen This mode catches more errors!
The colony joyfully disperses
Chain operations together:
gift pebble result with 10 → toboggan → multiply(2)
- Start Simple! Begin with hello world and work your way up!
- Read the Examples! The examples folder has lots of great code to learn from!
- Experiment! Try changing things and see what happens!
- Have Fun! Programming should be fun! If you're stuck, take a break! 🐧
- Ask for Help! It's okay to ask questions! That's how we learn!
While you're having fun with penguins, you're secretly learning:
- ✅ Variables and data types
- ✅ Functions and code organization
- ✅ Loops and iteration
- ✅ Conditionals and decision-making
- ✅ Lists and data structures
- ✅ File I/O
- ✅ Programming concepts that work in any language!
Want to make CodePenguin even better? We'd love your help! 🐧
CodePenguin is free and open source! Use it, learn from it, and share it with your friends! 🎉
Thank you for choosing CodePenguin! We hope you have as much fun learning to code as we had making this language! 🐧✨
Remember: Every great programmer started with their first "Hello, World!" You're on an amazing journey! 🌟
Happy Coding, Little Penguin! 🐧💙
Made with ❤️ for young programmers everywhere