big-mamba 1.0.0__tar.gz

big_mamba-1.0.0/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to Big Mamba will be documented in this file.
+
+## [1.0.0] - 2026-07-07
+
+### Added
+- Complete language engine: lexer, parser, AST, transpiler, executor
+- Interactive REPL with multi-line support
+- CLI with run, repl, transpile, and tokens commands
+- 80+ keyword and function shortenings
+- 20+ method shortenings
+- Special operators: ++, --, <>, ??, $""
+- Control flow: ? / ?? / !: for if / elif / else
+- For loops with @ syntax
+- List and dict comprehensions with @
+- Class support with me (self) and init (__init__)
+- Import system: use, ->, =>
+- Error handling: try / catch / fin / throw / chk
+- Comments with // and docstrings with ///
+- 5 example programs
+- Full README documentation
+- .mamba file extension (unique, not used by any other language)

big_mamba-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,88 @@
+# Contributing to Big Mamba
+
+Thank you for your interest in contributing to Big Mamba.
+
+## How to Contribute
+
+### Reporting Bugs
+- Open an issue on GitHub
+- Include the `.mamba` code that causes the bug
+- Include the error message
+- Include your Python version and OS
+
+### Suggesting Features
+- Open an issue with the title prefixed by `[Feature]`
+- Describe what the feature does
+- Show example Big Mamba syntax for the feature
+- Explain how it maps to Python
+
+### Submitting Code
+1. Fork the repository
+2. Create a branch: `git checkout -b feature/your-feature`
+3. Make your changes
+4. Test all examples: run each file in the `examples/` directory
+5. Commit: `git commit -m "Add your feature"`
+6. Push: `git push origin feature/your-feature`
+7. Open a Pull Request
+
+### Code Standards
+- No comments in source code
+- No emojis in any file
+- No external dependencies (pure Python 3.6+)
+- All files must be clean and professional
+- Test all examples before submitting
+
+### Project Structure
+
+```
+bigmamba/
+    __init__.py      Package metadata
+    lexer.py         Tokenizer
+    parser.py        Recursive descent parser
+    ast_nodes.py     AST node definitions
+    transpiler.py    AST to Python code generator
+    executor.py      Python code executor
+    repl.py          Interactive REPL
+    builtins.py      Keyword and function mappings
+    errors.py        Custom error types
+
+examples/            Example .mamba programs
+mamba.py             CLI entry point
+```
+
+### Adding a New Keyword or Shorthand
+1. Add the mapping to `bigmamba/builtins.py`
+2. If it is a keyword, add it to `KEYWORDS` in `bigmamba/lexer.py`
+3. If it needs special parsing, update `bigmamba/parser.py`
+4. If it needs special transpilation, update `bigmamba/transpiler.py`
+5. Add the runtime alias to `RUNTIME_PREAMBLE` in `bigmamba/builtins.py`
+6. Update `README.md` with the new syntax
+7. Add an example demonstrating the feature
+
+### Adding a New Method Shorthand
+1. Add the mapping to `METHOD_MAP` in `bigmamba/builtins.py`
+2. Add the mapping to `method_remap` in `bigmamba/parser.py` (in `parse_postfix`)
+3. Update the Method Reference table in `README.md`
+
+### Testing
+Run all examples to verify nothing is broken:
+
+```bash
+python mamba.py run examples/hello.mamba
+python mamba.py run examples/fibonacci.mamba
+python mamba.py run examples/calculator.mamba
+python mamba.py run examples/classes.mamba
+python mamba.py run examples/guessing_game.mamba
+```
+
+Verify transpiled output is correct:
+
+```bash
+python mamba.py transpile examples/hello.mamba
+```
+
+Test the REPL:
+
+```bash
+python mamba.py repl
+```

big_mamba-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Big Mamba Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

big_mamba-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include CONTRIBUTING.md
+recursive-include examples *.mamba
+recursive-include bigmamba *.py

big_mamba-1.0.0/PKG-INFO

@@ -0,0 +1,325 @@
+Metadata-Version: 2.4
+Name: big-mamba
+Version: 1.0.0
+Summary: Big Mamba - The shorthand programming language. Python, but faster to type.
+Home-page: https://github.com/redhatsam09/big-mamba
+Author: Big Mamba Team
+License: MIT
+Project-URL: Homepage, https://github.com/redhatsam09/big-mamba
+Project-URL: Issues, https://github.com/redhatsam09/big-mamba/issues
+Project-URL: Documentation, https://github.com/redhatsam09/big-mamba#readme
+Keywords: programming-language,transpiler,shorthand,mamba,big-mamba
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Software Development :: Interpreters
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Big Mamba Programming Language
+
+[![Test Big Mamba](https://github.com/redhatsam09/big-mamba/actions/workflows/test.yml/badge.svg)](https://github.com/redhatsam09/big-mamba/actions/workflows/test.yml)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/redhatsam09/big-mamba/blob/main/LICENSE)
+
+**Python, but faster to type.**
+
+Big Mamba shortens Python the same way Python shortened C++. It transpiles to Python under the hood.
+
+The `.mamba` file extension is exclusive to Big Mamba. No other language uses it.
+
+```
+Python                              Big Mamba
+------                              ---------
+def fibonacci(n):                   fn fibonacci(n):
+    if n <= 1:                          ? n <= 1:
+        return n                            ret n
+    return fib(n-1) + fib(n-2)         ret fib(n-1) + fib(n-2)
+
+for i in range(10):                 @ i in rng(10):
+    print(f"fib({i}) = {fib(i)}")       say $"fib({i}) = {fib(i)}"
+```
+
+---
+
+## Installation
+
+### pip install (Recommended)
+
+```bash
+pip install big-mamba
+```
+
+After installation, use the `mamba` command from anywhere:
+
+```bash
+mamba run hello.mamba
+mamba repl
+mamba version
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/redhatsam09/big-mamba.git
+cd big-mamba
+pip install .
+```
+
+### Run without installing
+
+```bash
+git clone https://github.com/redhatsam09/big-mamba.git
+cd big-mamba
+python mamba.py run examples/hello.mamba
+python mamba.py repl
+```
+
+No external dependencies. Pure Python 3.9+.
+
+---
+
+## Quick Start
+
+```bash
+mamba run examples/hello.mamba        # Run a program
+mamba repl                            # Interactive mode
+mamba transpile examples/hello.mamba  # See generated Python
+mamba tokens examples/hello.mamba     # See lexer tokens
+mamba help                            # All commands
+mamba version                         # Version info
+```
+
+---
+
+## Language Reference
+
+### Variables and Types
+
+```
+name = "Big Mamba"
+age = 1
+pi = 3.14
+active = T
+nothing = N
+```
+
+### Print and Input
+
+```
+say "Hello, World!"
+say $"Hello {name}"
+name = ask "What's your name? "
+```
+
+### Control Flow
+
+```
+? x > 0:
+    say "positive"
+?? x == 0:
+    say "zero"
+!:
+    say "negative"
+
+@ item in items:
+    say item
+
+@ i in rng(10):
+    say i
+
+wl running:
+    process()
+```
+
+### Functions
+
+```
+fn greet(name):
+    say $"Hello {name}!"
+    ret $"Hi {name}"
+
+double = lm x: x * 2
+```
+
+### Classes
+
+```
+cls Dog(Animal):
+    fn init(me, name):
+        me.name = name
+
+    fn bark(me):
+        say "Woof!"
+```
+
+### Special Operators
+
+```
+x++                         x += 1
+x--                         x -= 1
+a <> b                      a, b = b, a
+result = value ?? "default" value if value is not None else "default"
+$"Hello {name}"             f"Hello {name}"
+```
+
+### Imports
+
+```
+use os                      import os
+use os -> path              from os import path
+use numpy => np             import numpy as np
+use os -> path, getcwd      from os import path, getcwd
+```
+
+### Error Handling
+
+```
+try:
+    risky()
+catch ValueError as e:
+    say $"Error: {e}"
+fin:
+    cleanup()
+
+throw ValueError("oops")
+chk x > 0
+```
+
+### Comprehensions
+
+```
+squares = [x**2 @ x in rng(10)]
+evens = [x @ x in rng(20) ? x % 2 == 0]
+```
+
+### Built-in Function Reference
+
+| Big Mamba | Python        | Big Mamba | Python        |
+|-----------|---------------|-----------|---------------|
+| say x     | print(x)      | l(x)      | len(x)        |
+| ask "?"   | input("?")    | rng(n)    | range(n)      |
+| i(x)      | int(x)        | s(x)      | str(x)        |
+| fl(x)     | float(x)      | ls(x)     | list(x)       |
+| dt()      | dict()        | tp(x)     | tuple(x)      |
+| st(x)     | set(x)        | bl(x)     | bool(x)       |
+| srt(x)    | sorted(x)     | rev(x)    | reversed(x)   |
+| mx(x)     | max(x)        | mn(x)     | min(x)        |
+| sm(x)     | sum(x)        | ab(x)     | abs(x)        |
+| enum(x)   | enumerate(x)  | zp(a,b)   | zip(a,b)      |
+| mp(f,x)   | map(f,x)      | flt(f,x)  | filter(f,x)   |
+
+### Method Reference
+
+| Big Mamba   | Python          | Big Mamba    | Python          |
+|-------------|-----------------|--------------|-----------------|
+| .add(x)     | .append(x)      | .rm(x)       | .remove(x)      |
+| .up()       | .upper()        | .lo()        | .lower()        |
+| .trim()     | .strip()        | .spl(x)      | .split(x)       |
+| .jn(x)      | .join(x)        | .rep(a,b)    | .replace(a,b)   |
+| .starts(x)  | .startswith(x)  | .ends(x)     | .endswith(x)    |
+| .ks()       | .keys()         | .vs()        | .values()       |
+| .its()      | .items()        | .addall(x)   | .extend(x)      |
+
+### Keyword Reference
+
+| Big Mamba | Python   | Big Mamba | Python   |
+|-----------|----------|-----------|----------|
+| fn        | def      | ret       | return   |
+| cls       | class    | me        | self     |
+| init      | __init__ | lm        | lambda   |
+| ?         | if       | ??        | elif     |
+| !:        | else:    | @         | for      |
+| wl        | while    | brk       | break    |
+| cnt       | continue | ..        | pass     |
+| use       | import   | throw     | raise    |
+| catch     | except   | fin       | finally  |
+| chk       | assert   | gl        | global   |
+| yld       | yield    | rm        | del      |
+| w/        | with     | T/F/N     | True/False/None |
+| &&        | and      | \|\|      | or       |
+| ~         | not      | //        | # (comment) |
+
+---
+
+## Architecture
+
+Big Mamba is a transpiler. It converts Big Mamba source code to Python and executes it.
+
+```
+.mamba source -> Lexer -> Tokens -> Parser -> AST -> Transpiler -> Python -> Execution
+```
+
+### Project Structure
+
+```
+bigmamba/
+    __init__.py      Package metadata
+    lexer.py         Tokenizer
+    parser.py        Recursive descent parser
+    ast_nodes.py     AST node definitions
+    transpiler.py    AST to Python code generator
+    executor.py      Python code executor
+    repl.py          Interactive REPL
+    builtins.py      Keyword and function mappings
+    errors.py        Custom error types
+
+examples/            Example .mamba programs
+mamba.py             CLI entry point
+```
+
+---
+
+## Comparison
+
+| Feature       | C++                        | Python              | Big Mamba          |
+|---------------|----------------------------|---------------------|--------------------|
+| Hello World   | 5 lines                    | 1 line              | 1 line (shorter)   |
+| Function def  | int f(int x) {             | def f(x):           | fn f(x):           |
+| Print         | cout << x << endl;         | print(x)            | say x              |
+| For loop      | for(int i=0;i<n;i++)       | for i in range(n):  | @ i in rng(n):     |
+| Swap          | 3 lines + temp var         | a, b = b, a         | a <> b             |
+| Self ref      | this->x                    | self.x              | me.x               |
+| Import        | #include <x>               | import x            | use x              |
+| Boolean       | bool b = true;             | b = True            | b = T              |
+
+---
+
+## Platform Support
+
+| Platform | Install Command |
+|----------|----------------|
+| Windows  | `pip install big-mamba` |
+| macOS    | `pip3 install big-mamba` |
+| Linux    | `pip3 install big-mamba` |
+
+Works on any system with Python 3.9+. No external dependencies.
+
+See [INSTALL.md](INSTALL.md) for detailed installation instructions for every OS.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+Big Mamba -- Write Python at the speed of thought.