# 🌙 Whisper Programming Language
A truly unique programming language with conversational, natural English syntax that makes coding feel like storytelling.
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://badge.fury.io/py/whisper-lang)
[](https://pepy.tech/project/whisper-lang)
## 🌐 Website
**Official Website:** [https://whisper.ibrahimmustafaopu.com](https://whisper.ibrahimmustafaopu.com)
- 📚 [Documentation](https://whisper.ibrahimmustafaopu.com/documentation.html)
- 📖 [Tutorial](https://whisper.ibrahimmustafaopu.com/tutorial.html)
- 💻 [Examples](https://whisper.ibrahimmustafaopu.com/examples.html)
- 🤝 [Contribute](https://whisper.ibrahimmustafaopu.com/contribute.html)
## ✨ What Makes Whisper Unique?
- **File Extensions**: `.wsp` or `.whisper` - your choice!
- **Conversational Syntax**: Write code like you're having a conversation
- **Question-Based Logic**: Ask questions with yes/no answers
- **Story Objects**: Create characters and objects with properties
- **Natural Commands**: Multiple ways to express the same thing
- **Beginner-Friendly**: Read and write code in plain English
- **Fully Featured**: Functions, loops, lists, file I/O, and more
## 🚀 Quick Start
### Installation
```bash
pip install whisper-lang
```
### Hello World
Create `hello.wsp` (or `hello.whisper`):
```whisper
hey whisper, remember that name is "World"
tell me "Hello, " + name + "!"
```
Run it:
```bash
whisper hello.wsp
# Both .wsp and .whisper extensions are supported
```
## 🎯 Examples
### 1. Conversational Variables
```whisper
# Talk to Whisper naturally
hey whisper, remember that score is 0
whisper, so lives is 3
# Or use traditional syntax
let player be "Alice"
set level to 1
```
### 2. Question-Based Conditions
```whisper
is age greater than 18?
yes:
tell me "You can vote!"
no:
tell me "Too young to vote"
```
### 3. Story-Like Programming
```whisper
# Create objects with properties
there is a hero with health 100, power 50
there is a dragon with health 200, damage 30
# Perform actions
the hero loses 20 health
the dragon loses 30 health
the hero gains 10 power
```
### 4. Natural Loop Control
```whisper
do 10 times:
let num be randint(1, 10)
when num is 5:
skip # Skip 5
when num is 9:
end loop # Exit loop
show num
```
### 5. Functions & Logic
```whisper
define greet with name, age:
whisper "Hello, " + name + "!"
is age greater than 18?
yes:
tell me "Welcome, adult!"
no:
tell me "Welcome, young one!"
give back "Greeting complete"
call greet with "Alice", 25
```
## 📚 Core Features
### Variables (Multiple Ways!)
```whisper
remember that x is 10 # Conversational
let y be 20 # Traditional
set z to 30 # Alternative
so w is 40 # Shorthand
forget about old_var # Delete
```
### Output (Choose Your Style!)
```whisper
whisper "Hello" # Classic
show value # Simple
tell me "Message" # Conversational
just say "Quick" # Casual
announce "No newline" # Inline
```
### Conditionals
```whisper
# When/Otherwise (if/elif/else)
when x greater than 10:
show "Big"
or when x greater than 5:
show "Medium"
otherwise:
show "Small"
# Question format
is x equals 10?
yes:
show "Perfect!"
no:
show "Try again"
```
### Loops
```whisper
do 5 times: # Repeat N times
show "Hello"
repeat 10: # Alternative syntax
show "Counting"
while count less than 10: # While loop
increase count by 1
for each item in items: # For-each loop
show item
```
### Lists
```whisper
make fruits with ["apple", "banana", "orange"]
add "grape" to fruits
remove "banana" from fruits
for each fruit in fruits:
show fruit
```
### Functions
```whisper
define calculate with a, b:
let sum be a + b
let product be a * b
give back sum
call calculate with 10, 5
show __last_result__
```
### File Operations
```whisper
write "Hello, File!" to "output.txt"
read "input.txt" into content
show content
```
### Error Handling
```whisper
attempt:
let result be 10 / 0
handle:
whisper "Error: " + error
```
### Math & Random
```whisper
let x be sqrt(16) # 4
let y be pow(2, 3) # 8
let z be randint(1, 100) # Random 1-100
increase score by 10
decrease lives by 1
```
### String Operations
```whisper
uppercase "hello" into upper # HELLO
lowercase "WORLD" into lower # world
```
## 🎮 Complete Example: Number Guessing Game
```whisper
# Number Guessing Game
whisper "=== Guess the Number ==="
let secret be randint(1, 100)
let attempts be 0
while attempts less than 10:
increase attempts by 1
ask "Guess (1-100):" into guess
is guess equals secret?
yes:
whisper "🎉 Correct! You win!"
show "Attempts: " + attempts
end loop
no:
when guess greater than secret:
tell me "Too high!"
otherwise:
tell me "Too low!"
let remaining be 10 - attempts
show "Tries left: " + remaining
whisper "Thanks for playing!"
```
## 📖 Syntax Comparison
| Feature | Python | Whisper |
|---------|--------|---------|
| Variable | `x = 10` | `remember that x is 10` or `let x be 10` |
| Print | `print("Hi")` | `whisper "Hi"` or `tell me "Hi"` |
| Input | `name = input("Name?")` | `ask "Name?" into name` |
| If/Else | `if x > 5:` | `when x greater than 5:` or `is x greater than 5?` |
| For Loop | `for i in items:` | `for each i in items:` |
| While | `while x < 10:` | `while x less than 10:` |
| Function | `def greet(name):` | `define greet with name:` |
| Return | `return value` | `give back value` |
| Break | `break` | `break` or `end loop` or `stop` |
| Continue | `continue` | `continue` or `next` or `skip` |
## 🎨 Why Choose Whisper?
### For Beginners
- **No cryptic symbols**: Read code like English
- **Multiple ways**: Choose syntax that feels natural to you
- **Clear errors**: Understand what went wrong
- **Gentle learning curve**: Start coding immediately
### For Educators
- **Teach concepts**: Focus on logic, not syntax
- **Engaging**: Story-based programming captures imagination
- **Versatile**: Suitable for all age groups
- **Creative**: Build games, stories, and apps
### For Fun Projects
- **Text adventures**: Built-in story object system
- **Quick scripts**: Natural syntax for rapid prototyping
- **Creative coding**: Express ideas conversationally
- **Experimentation**: Try ideas without syntax barriers
## 📦 Installation & Usage
### Requirements
- Python 3.7 or higher
### Install
```bash
pip install whisper-lang
```
### Run a Program
```bash
whisper myprogram.wsp
# Both .wsp and .whisper extensions are supported
```
### VS Code Extension
**Syntax highlighting available!**
Install from VS Code:
1. Open Extensions panel (`Ctrl+Shift+X`)
2. Search "Whisper Language Support"
3. Click Install
Or via command line:
```bash
code --install-extension ibrahimmustafaopu.whisper-lang-support
```
See [DOCUMENTATION.md](DOCUMENTATION.md) for manual installation instructions.
## 📚 Documentation
**Complete documentation available in [DOCUMENTATION.md](DOCUMENTATION.md)**
Includes:
- Full syntax reference
- All features explained
- Dozens of examples
- Best practices
- Common mistakes
- Quick reference card
## 🎓 Learning Path
### Lesson 1: Variables & Output
```whisper
remember that name is "Alice"
let age be 25
whisper "Name: " + name
show "Age: " + age
```
### Lesson 2: Input & Logic
```whisper
ask "Your age?" into age
is age greater than 18?
yes:
tell me "Adult"
no:
tell me "Minor"
```
### Lesson 3: Loops
```whisper
do 5 times:
whisper "Hello!"
let count be 0
while count less than 5:
show count
increase count by 1
```
### Lesson 4: Functions
```whisper
define add with a, b:
let sum be a + b
give back sum
call add with 10, 20
show __last_result__
```
### Lesson 5: Story Objects
```whisper
there is a player with health 100, score 0
the player gains 10 score
the player loses 20 health
show player
```
## 🌟 Example Programs
### Todo List Manager
```whisper
make tasks with []
let running be 1
while running is 1:
whisper "\n1. Add 2. Show 3. Remove 4. Exit"
ask "Choice:" into choice
when choice is 1:
ask "Task:" into task
add task to tasks
or when choice is 2:
for each task in tasks:
show "- " + task
or when choice is 3:
ask "Remove:" into task
remove task from tasks
or when choice is 4:
set running to 0
```
### RPG Battle
```whisper
there is a hero with health 100, attack 25
there is a monster with health 80, attack 15
while hero health > 0 and monster health > 0:
the monster loses hero attack
show "You attack! Monster: " + monster health
when monster health less than 1:
whisper "Victory!"
break
the hero loses monster attack
show "Monster attacks! You: " + hero health
```
### Calculator
```whisper
ask "First number:" into a
ask "Second number:" into b
let sum be a + b
let diff be a - b
let product be a * b
let quotient be a / b
show "Sum: " + sum
show "Difference: " + diff
show "Product: " + product
show "Quotient: " + quotient
```
## 🔧 Advanced Features
### Math Functions
```whisper
let x be sqrt(16) # Square root
let y be pow(2, 8) # Power
let z be abs(-10) # Absolute value
let a be round(3.7) # Rounding
let b be randint(1, 100) # Random integer
```
### File Operations
```whisper
# Write
write "Log entry: Started" to "log.txt"
# Read
read "config.txt" into config
show config
```
### Error Handling
```whisper
attempt:
read "missing.txt" into data
handle:
whisper "File not found: " + error
let data be "default"
```
### List Operations
```whisper
make numbers with [5, 2, 8, 1, 9]
add 3 to numbers
remove 8 from numbers
for each num in numbers:
when num greater than 5:
show num + " is big"
```
## 🤝 Contributing
Contributions are welcome! Feel free to:
- Report bugs
- Suggest features
- Submit pull requests
- Share your Whisper programs
## 📄 License
MIT License - see [LICENSE](LICENSE) file for details
## 🔗 Links
## 🔗 Links
- **Website**: https://whisper.ibrahimmustafaopu.com
- **Documentation**: https://whisper.ibrahimmustafaopu.com/documentation.html
- **GitHub**: https://github.com/ibrahim787898m/whisper-lang
- **PyPI**: https://pypi.org/project/whisper-lang/
- **Issues**: https://github.com/ibrahim787898m/whisper-lang/issues
## 💬 Community
Share your Whisper programs! Tag them with `#WhisperLang`
## 🚦 Status
- ✅ Core language features complete
- ✅ Full documentation available
- ✅ VS Code syntax highlighting
- ✅ Error handling
- ✅ File I/O
- 🔄 Coming soon: More built-in functions
- 🔄 Coming soon: Package manager
- 🔄 Coming soon: Standard library
## 🎯 Roadmap
## 🎯 Roadmap
### Version 1.1 (Q2 2026) - Enhanced Features
- [ ] Dictionary/object support
- [ ] Date/time functions
- [ ] Advanced string methods
- [ ] JSON support
- [ ] HTTP requests
- [ ] Improved error messages
- [ ] More built-in functions
- [ ] Performance optimizations
### Version 1.5 (Q3 2026) - Developer Tools
- [ ] Interactive REPL mode
- [ ] Package manager
- [ ] Testing framework
- [ ] More IDE extensions (Sublime, Atom, etc.)
- [ ] Online code playground
- [ ] Enhanced debugging tools
### Version 2.0 (Q4 2026) - Advanced Capabilities
- [ ] Module system
- [ ] Classes/OOP
- [ ] Async operations
- [ ] GUI toolkit
- [ ] Web framework integration
- [ ] Database connectivity
- [ ] API support
- [ ] Multi-language support
- [ ] Community plugins system
## ❓ FAQ
**Q: Is Whisper suitable for production?**
A: Whisper is great for learning, scripting, and fun projects. For production systems, consider Python, JavaScript, etc.
**Q: Can I use Whisper in my project?**
A: Yes! Whisper is MIT licensed and free to use.
**Q: How do I get syntax highlighting?**
A: See the VS Code extension setup in DOCUMENTATION.md
**Q: Can I contribute?**
A: Absolutely! Pull requests are welcome.
**Q: Is there a standard library?**
A: Currently building one. Basic functions included.
**Q: Can Whisper do [X]?**
A: Check DOCUMENTATION.md for full feature list.
## 🙏 Acknowledgments
Thanks to all programming language pioneers who made coding more accessible!
## 📞 Contact
- **Author**: Ibrahim Mustafa Opu
- **Email**: ibrahimmustafa787898@gmail.com
- **GitHub**: github.com/ibrahim787898m
- **Website**: v2.ibrahimmustafaopu.com
---
**Made with 🌙 by Ibrahim Mustafa Opu**
*"Programming should feel like telling a story"*
Raw data
{
"_id": null,
"home_page": "https://whisper.ibrahimmustafaopu.com",
"name": "whisper-lang",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "programming-language interpreter whisper natural-language conversational education beginner-friendly",
"author": "Ibrahim Mustafa Opu",
"author_email": "ibrahimmustafa787898@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ec/68/033e7fa38aee5d217e585e1cf9ef9b722a7d1b52d48b6022542a07837e04/whisper_lang-1.0.0.tar.gz",
"platform": null,
"description": "# \ud83c\udf19 Whisper Programming Language\r\n\r\nA truly unique programming language with conversational, natural English syntax that makes coding feel like storytelling.\r\n\r\n[](https://opensource.org/licenses/MIT)\r\n[](https://www.python.org/downloads/)\r\n[](https://badge.fury.io/py/whisper-lang)\r\n[](https://pepy.tech/project/whisper-lang)\r\n\r\n## \ud83c\udf10 Website\r\n\r\n**Official Website:** [https://whisper.ibrahimmustafaopu.com](https://whisper.ibrahimmustafaopu.com)\r\n\r\n- \ud83d\udcda [Documentation](https://whisper.ibrahimmustafaopu.com/documentation.html)\r\n- \ud83d\udcd6 [Tutorial](https://whisper.ibrahimmustafaopu.com/tutorial.html)\r\n- \ud83d\udcbb [Examples](https://whisper.ibrahimmustafaopu.com/examples.html)\r\n- \ud83e\udd1d [Contribute](https://whisper.ibrahimmustafaopu.com/contribute.html)\r\n\r\n## \u2728 What Makes Whisper Unique?\r\n\r\n- **File Extensions**: `.wsp` or `.whisper` - your choice!\r\n- **Conversational Syntax**: Write code like you're having a conversation\r\n- **Question-Based Logic**: Ask questions with yes/no answers\r\n- **Story Objects**: Create characters and objects with properties\r\n- **Natural Commands**: Multiple ways to express the same thing\r\n- **Beginner-Friendly**: Read and write code in plain English\r\n- **Fully Featured**: Functions, loops, lists, file I/O, and more\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\npip install whisper-lang\r\n```\r\n\r\n### Hello World\r\n\r\nCreate `hello.wsp` (or `hello.whisper`):\r\n\r\n```whisper\r\nhey whisper, remember that name is \"World\"\r\ntell me \"Hello, \" + name + \"!\"\r\n```\r\n\r\nRun it:\r\n\r\n```bash\r\nwhisper hello.wsp\r\n# Both .wsp and .whisper extensions are supported\r\n```\r\n\r\n## \ud83c\udfaf Examples\r\n\r\n### 1. Conversational Variables\r\n\r\n```whisper\r\n# Talk to Whisper naturally\r\nhey whisper, remember that score is 0\r\nwhisper, so lives is 3\r\n\r\n# Or use traditional syntax\r\nlet player be \"Alice\"\r\nset level to 1\r\n```\r\n\r\n### 2. Question-Based Conditions\r\n\r\n```whisper\r\nis age greater than 18?\r\n yes:\r\n tell me \"You can vote!\"\r\n no:\r\n tell me \"Too young to vote\"\r\n```\r\n\r\n### 3. Story-Like Programming\r\n\r\n```whisper\r\n# Create objects with properties\r\nthere is a hero with health 100, power 50\r\nthere is a dragon with health 200, damage 30\r\n\r\n# Perform actions\r\nthe hero loses 20 health\r\nthe dragon loses 30 health\r\nthe hero gains 10 power\r\n```\r\n\r\n### 4. Natural Loop Control\r\n\r\n```whisper\r\ndo 10 times:\r\n let num be randint(1, 10)\r\n \r\n when num is 5:\r\n skip # Skip 5\r\n \r\n when num is 9:\r\n end loop # Exit loop\r\n \r\n show num\r\n```\r\n\r\n### 5. Functions & Logic\r\n\r\n```whisper\r\ndefine greet with name, age:\r\n whisper \"Hello, \" + name + \"!\"\r\n \r\n is age greater than 18?\r\n yes:\r\n tell me \"Welcome, adult!\"\r\n no:\r\n tell me \"Welcome, young one!\"\r\n \r\n give back \"Greeting complete\"\r\n\r\ncall greet with \"Alice\", 25\r\n```\r\n\r\n## \ud83d\udcda Core Features\r\n\r\n### Variables (Multiple Ways!)\r\n```whisper\r\nremember that x is 10 # Conversational\r\nlet y be 20 # Traditional\r\nset z to 30 # Alternative\r\nso w is 40 # Shorthand\r\nforget about old_var # Delete\r\n```\r\n\r\n### Output (Choose Your Style!)\r\n```whisper\r\nwhisper \"Hello\" # Classic\r\nshow value # Simple\r\ntell me \"Message\" # Conversational\r\njust say \"Quick\" # Casual\r\nannounce \"No newline\" # Inline\r\n```\r\n\r\n### Conditionals\r\n```whisper\r\n# When/Otherwise (if/elif/else)\r\nwhen x greater than 10:\r\n show \"Big\"\r\nor when x greater than 5:\r\n show \"Medium\"\r\notherwise:\r\n show \"Small\"\r\n\r\n# Question format\r\nis x equals 10?\r\n yes:\r\n show \"Perfect!\"\r\n no:\r\n show \"Try again\"\r\n```\r\n\r\n### Loops\r\n```whisper\r\ndo 5 times: # Repeat N times\r\n show \"Hello\"\r\n\r\nrepeat 10: # Alternative syntax\r\n show \"Counting\"\r\n\r\nwhile count less than 10: # While loop\r\n increase count by 1\r\n\r\nfor each item in items: # For-each loop\r\n show item\r\n```\r\n\r\n### Lists\r\n```whisper\r\nmake fruits with [\"apple\", \"banana\", \"orange\"]\r\nadd \"grape\" to fruits\r\nremove \"banana\" from fruits\r\n\r\nfor each fruit in fruits:\r\n show fruit\r\n```\r\n\r\n### Functions\r\n```whisper\r\ndefine calculate with a, b:\r\n let sum be a + b\r\n let product be a * b\r\n give back sum\r\n\r\ncall calculate with 10, 5\r\nshow __last_result__\r\n```\r\n\r\n### File Operations\r\n```whisper\r\nwrite \"Hello, File!\" to \"output.txt\"\r\nread \"input.txt\" into content\r\nshow content\r\n```\r\n\r\n### Error Handling\r\n```whisper\r\nattempt:\r\n let result be 10 / 0\r\nhandle:\r\n whisper \"Error: \" + error\r\n```\r\n\r\n### Math & Random\r\n```whisper\r\nlet x be sqrt(16) # 4\r\nlet y be pow(2, 3) # 8\r\nlet z be randint(1, 100) # Random 1-100\r\n\r\nincrease score by 10\r\ndecrease lives by 1\r\n```\r\n\r\n### String Operations\r\n```whisper\r\nuppercase \"hello\" into upper # HELLO\r\nlowercase \"WORLD\" into lower # world\r\n```\r\n\r\n## \ud83c\udfae Complete Example: Number Guessing Game\r\n\r\n```whisper\r\n# Number Guessing Game\r\nwhisper \"=== Guess the Number ===\"\r\n\r\nlet secret be randint(1, 100)\r\nlet attempts be 0\r\n\r\nwhile attempts less than 10:\r\n increase attempts by 1\r\n ask \"Guess (1-100):\" into guess\r\n \r\n is guess equals secret?\r\n yes:\r\n whisper \"\ud83c\udf89 Correct! You win!\"\r\n show \"Attempts: \" + attempts\r\n end loop\r\n no:\r\n when guess greater than secret:\r\n tell me \"Too high!\"\r\n otherwise:\r\n tell me \"Too low!\"\r\n \r\n let remaining be 10 - attempts\r\n show \"Tries left: \" + remaining\r\n\r\nwhisper \"Thanks for playing!\"\r\n```\r\n\r\n## \ud83d\udcd6 Syntax Comparison\r\n\r\n| Feature | Python | Whisper |\r\n|---------|--------|---------|\r\n| Variable | `x = 10` | `remember that x is 10` or `let x be 10` |\r\n| Print | `print(\"Hi\")` | `whisper \"Hi\"` or `tell me \"Hi\"` |\r\n| Input | `name = input(\"Name?\")` | `ask \"Name?\" into name` |\r\n| If/Else | `if x > 5:` | `when x greater than 5:` or `is x greater than 5?` |\r\n| For Loop | `for i in items:` | `for each i in items:` |\r\n| While | `while x < 10:` | `while x less than 10:` |\r\n| Function | `def greet(name):` | `define greet with name:` |\r\n| Return | `return value` | `give back value` |\r\n| Break | `break` | `break` or `end loop` or `stop` |\r\n| Continue | `continue` | `continue` or `next` or `skip` |\r\n\r\n## \ud83c\udfa8 Why Choose Whisper?\r\n\r\n### For Beginners\r\n- **No cryptic symbols**: Read code like English\r\n- **Multiple ways**: Choose syntax that feels natural to you\r\n- **Clear errors**: Understand what went wrong\r\n- **Gentle learning curve**: Start coding immediately\r\n\r\n### For Educators\r\n- **Teach concepts**: Focus on logic, not syntax\r\n- **Engaging**: Story-based programming captures imagination\r\n- **Versatile**: Suitable for all age groups\r\n- **Creative**: Build games, stories, and apps\r\n\r\n### For Fun Projects\r\n- **Text adventures**: Built-in story object system\r\n- **Quick scripts**: Natural syntax for rapid prototyping\r\n- **Creative coding**: Express ideas conversationally\r\n- **Experimentation**: Try ideas without syntax barriers\r\n\r\n## \ud83d\udce6 Installation & Usage\r\n\r\n### Requirements\r\n- Python 3.7 or higher\r\n\r\n### Install\r\n```bash\r\npip install whisper-lang\r\n```\r\n\r\n### Run a Program\r\n```bash\r\nwhisper myprogram.wsp\r\n# Both .wsp and .whisper extensions are supported\r\n```\r\n\r\n### VS Code Extension\r\n\r\n**Syntax highlighting available!**\r\n\r\nInstall from VS Code:\r\n1. Open Extensions panel (`Ctrl+Shift+X`)\r\n2. Search \"Whisper Language Support\"\r\n3. Click Install\r\n\r\nOr via command line:\r\n```bash\r\ncode --install-extension ibrahimmustafaopu.whisper-lang-support\r\n```\r\n\r\nSee [DOCUMENTATION.md](DOCUMENTATION.md) for manual installation instructions.\r\n\r\n## \ud83d\udcda Documentation\r\n\r\n**Complete documentation available in [DOCUMENTATION.md](DOCUMENTATION.md)**\r\n\r\nIncludes:\r\n- Full syntax reference\r\n- All features explained\r\n- Dozens of examples\r\n- Best practices\r\n- Common mistakes\r\n- Quick reference card\r\n\r\n## \ud83c\udf93 Learning Path\r\n\r\n### Lesson 1: Variables & Output\r\n```whisper\r\nremember that name is \"Alice\"\r\nlet age be 25\r\nwhisper \"Name: \" + name\r\nshow \"Age: \" + age\r\n```\r\n\r\n### Lesson 2: Input & Logic\r\n```whisper\r\nask \"Your age?\" into age\r\n\r\nis age greater than 18?\r\n yes:\r\n tell me \"Adult\"\r\n no:\r\n tell me \"Minor\"\r\n```\r\n\r\n### Lesson 3: Loops\r\n```whisper\r\ndo 5 times:\r\n whisper \"Hello!\"\r\n\r\nlet count be 0\r\nwhile count less than 5:\r\n show count\r\n increase count by 1\r\n```\r\n\r\n### Lesson 4: Functions\r\n```whisper\r\ndefine add with a, b:\r\n let sum be a + b\r\n give back sum\r\n\r\ncall add with 10, 20\r\nshow __last_result__\r\n```\r\n\r\n### Lesson 5: Story Objects\r\n```whisper\r\nthere is a player with health 100, score 0\r\nthe player gains 10 score\r\nthe player loses 20 health\r\nshow player\r\n```\r\n\r\n## \ud83c\udf1f Example Programs\r\n\r\n### Todo List Manager\r\n```whisper\r\nmake tasks with []\r\nlet running be 1\r\n\r\nwhile running is 1:\r\n whisper \"\\n1. Add 2. Show 3. Remove 4. Exit\"\r\n ask \"Choice:\" into choice\r\n \r\n when choice is 1:\r\n ask \"Task:\" into task\r\n add task to tasks\r\n or when choice is 2:\r\n for each task in tasks:\r\n show \"- \" + task\r\n or when choice is 3:\r\n ask \"Remove:\" into task\r\n remove task from tasks\r\n or when choice is 4:\r\n set running to 0\r\n```\r\n\r\n### RPG Battle\r\n```whisper\r\nthere is a hero with health 100, attack 25\r\nthere is a monster with health 80, attack 15\r\n\r\nwhile hero health > 0 and monster health > 0:\r\n the monster loses hero attack\r\n show \"You attack! Monster: \" + monster health\r\n \r\n when monster health less than 1:\r\n whisper \"Victory!\"\r\n break\r\n \r\n the hero loses monster attack\r\n show \"Monster attacks! You: \" + hero health\r\n```\r\n\r\n### Calculator\r\n```whisper\r\nask \"First number:\" into a\r\nask \"Second number:\" into b\r\n\r\nlet sum be a + b\r\nlet diff be a - b\r\nlet product be a * b\r\nlet quotient be a / b\r\n\r\nshow \"Sum: \" + sum\r\nshow \"Difference: \" + diff\r\nshow \"Product: \" + product\r\nshow \"Quotient: \" + quotient\r\n```\r\n\r\n## \ud83d\udd27 Advanced Features\r\n\r\n### Math Functions\r\n```whisper\r\nlet x be sqrt(16) # Square root\r\nlet y be pow(2, 8) # Power\r\nlet z be abs(-10) # Absolute value\r\nlet a be round(3.7) # Rounding\r\nlet b be randint(1, 100) # Random integer\r\n```\r\n\r\n### File Operations\r\n```whisper\r\n# Write\r\nwrite \"Log entry: Started\" to \"log.txt\"\r\n\r\n# Read\r\nread \"config.txt\" into config\r\nshow config\r\n```\r\n\r\n### Error Handling\r\n```whisper\r\nattempt:\r\n read \"missing.txt\" into data\r\nhandle:\r\n whisper \"File not found: \" + error\r\n let data be \"default\"\r\n```\r\n\r\n### List Operations\r\n```whisper\r\nmake numbers with [5, 2, 8, 1, 9]\r\nadd 3 to numbers\r\nremove 8 from numbers\r\n\r\nfor each num in numbers:\r\n when num greater than 5:\r\n show num + \" is big\"\r\n```\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nContributions are welcome! Feel free to:\r\n- Report bugs\r\n- Suggest features\r\n- Submit pull requests\r\n- Share your Whisper programs\r\n\r\n## \ud83d\udcc4 License\r\n\r\nMIT License - see [LICENSE](LICENSE) file for details\r\n\r\n## \ud83d\udd17 Links\r\n\r\n## \ud83d\udd17 Links\r\n\r\n- **Website**: https://whisper.ibrahimmustafaopu.com\r\n- **Documentation**: https://whisper.ibrahimmustafaopu.com/documentation.html\r\n- **GitHub**: https://github.com/ibrahim787898m/whisper-lang\r\n- **PyPI**: https://pypi.org/project/whisper-lang/\r\n- **Issues**: https://github.com/ibrahim787898m/whisper-lang/issues\r\n\r\n## \ud83d\udcac Community\r\n\r\nShare your Whisper programs! Tag them with `#WhisperLang`\r\n\r\n## \ud83d\udea6 Status\r\n\r\n- \u2705 Core language features complete\r\n- \u2705 Full documentation available\r\n- \u2705 VS Code syntax highlighting\r\n- \u2705 Error handling\r\n- \u2705 File I/O\r\n- \ud83d\udd04 Coming soon: More built-in functions\r\n- \ud83d\udd04 Coming soon: Package manager\r\n- \ud83d\udd04 Coming soon: Standard library\r\n\r\n## \ud83c\udfaf Roadmap\r\n\r\n## \ud83c\udfaf Roadmap\r\n\r\n### Version 1.1 (Q2 2026) - Enhanced Features\r\n- [ ] Dictionary/object support\r\n- [ ] Date/time functions\r\n- [ ] Advanced string methods\r\n- [ ] JSON support\r\n- [ ] HTTP requests\r\n- [ ] Improved error messages\r\n- [ ] More built-in functions\r\n- [ ] Performance optimizations\r\n\r\n### Version 1.5 (Q3 2026) - Developer Tools\r\n- [ ] Interactive REPL mode\r\n- [ ] Package manager\r\n- [ ] Testing framework\r\n- [ ] More IDE extensions (Sublime, Atom, etc.)\r\n- [ ] Online code playground\r\n- [ ] Enhanced debugging tools\r\n\r\n### Version 2.0 (Q4 2026) - Advanced Capabilities\r\n- [ ] Module system\r\n- [ ] Classes/OOP\r\n- [ ] Async operations\r\n- [ ] GUI toolkit\r\n- [ ] Web framework integration\r\n- [ ] Database connectivity\r\n- [ ] API support\r\n- [ ] Multi-language support\r\n- [ ] Community plugins system\r\n\r\n## \u2753 FAQ\r\n\r\n**Q: Is Whisper suitable for production?** \r\nA: Whisper is great for learning, scripting, and fun projects. For production systems, consider Python, JavaScript, etc.\r\n\r\n**Q: Can I use Whisper in my project?** \r\nA: Yes! Whisper is MIT licensed and free to use.\r\n\r\n**Q: How do I get syntax highlighting?** \r\nA: See the VS Code extension setup in DOCUMENTATION.md\r\n\r\n**Q: Can I contribute?** \r\nA: Absolutely! Pull requests are welcome.\r\n\r\n**Q: Is there a standard library?** \r\nA: Currently building one. Basic functions included.\r\n\r\n**Q: Can Whisper do [X]?** \r\nA: Check DOCUMENTATION.md for full feature list.\r\n\r\n## \ud83d\ude4f Acknowledgments\r\n\r\nThanks to all programming language pioneers who made coding more accessible!\r\n\r\n## \ud83d\udcde Contact\r\n\r\n- **Author**: Ibrahim Mustafa Opu\r\n- **Email**: ibrahimmustafa787898@gmail.com\r\n- **GitHub**: github.com/ibrahim787898m\r\n- **Website**: v2.ibrahimmustafaopu.com\r\n\r\n---\r\n\r\n**Made with \ud83c\udf19 by Ibrahim Mustafa Opu**\r\n\r\n*\"Programming should feel like telling a story\"*\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A truly unique programming language with conversational, natural English syntax",
"version": "1.0.0",
"project_urls": {
"Bug Reports": "https://github.com/ibrahim787898m/whisper-lang/issues",
"Changelog": "https://github.com/ibrahim787898m/whisper-lang/blob/master/CHANGELOG.md",
"Documentation": "https://whisper.ibrahimmustafaopu.com/documentation.html",
"Examples": "https://whisper.ibrahimmustafaopu.com/examples.html",
"Homepage": "https://whisper.ibrahimmustafaopu.com",
"Source": "https://github.com/ibrahim787898m/whisper-lang",
"Tutorial": "https://whisper.ibrahimmustafaopu.com/tutorial.html"
},
"split_keywords": [
"programming-language",
"interpreter",
"whisper",
"natural-language",
"conversational",
"education",
"beginner-friendly"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cfe85213cae53e493e9c5d578e398989ade5a052b9a531c94f83e2ea50b6bd3f",
"md5": "9fdc2e36e78f6ce756a74614cec8c440",
"sha256": "fc35da6033c73d2c300df4d62e693708b40b4bdd27a8430378b42a05ba774d08"
},
"downloads": -1,
"filename": "whisper_lang-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9fdc2e36e78f6ce756a74614cec8c440",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 16083,
"upload_time": "2025-10-29T18:25:32",
"upload_time_iso_8601": "2025-10-29T18:25:32.555732Z",
"url": "https://files.pythonhosted.org/packages/cf/e8/5213cae53e493e9c5d578e398989ade5a052b9a531c94f83e2ea50b6bd3f/whisper_lang-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ec68033e7fa38aee5d217e585e1cf9ef9b722a7d1b52d48b6022542a07837e04",
"md5": "0430bcba341bc65c4cb9cc69778be479",
"sha256": "ec4bce2ae67faf7a8bb74084c2f7e70c87d619309c5a8480a968cf5ba63e2f6b"
},
"downloads": -1,
"filename": "whisper_lang-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "0430bcba341bc65c4cb9cc69778be479",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 39571,
"upload_time": "2025-10-29T18:25:33",
"upload_time_iso_8601": "2025-10-29T18:25:33.979089Z",
"url": "https://files.pythonhosted.org/packages/ec/68/033e7fa38aee5d217e585e1cf9ef9b722a7d1b52d48b6022542a07837e04/whisper_lang-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-29 18:25:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ibrahim787898m",
"github_project": "whisper-lang",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "whisper-lang"
}
JSON
