mrt-lang 0.1.4__tar.gz

mrt-lang-0.1.4/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 MRT
+
+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.

mrt-lang-0.1.4/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE.txt
+recursive-include docs *
+recursive-include examples *.mrt

mrt-lang-0.1.4/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.1
+Name: mrt-lang
+Version: 0.1.4
+Summary: MRT Programming Language - A modern, expressive programming language
+Home-page: https://github.com/rithymeth/MRT
+Author: MRT Team
+Author-email: rithy1337@gmail.com
+Keywords: programming language interpreter compiler
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Interpreters
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+
+# MRT Programming Language
+
+MRT is a modern, expressive programming language designed for simplicity and readability. It combines intuitive syntax with powerful features for both beginners and experienced programmers.
+
+## Features
+
+- Simple and expressive syntax
+- Dynamic typing with type inference
+- First-class functions
+- Rich built-in functions
+- Comprehensive array operations
+- Powerful string manipulation
+- Modern module system
+
+## Installation
+
+You can install MRT using pip:
+
+```bash
+pip install mrt-lang
+```
+
+After installation, you can run MRT programs using the `mrt` command:
+```bash
+mrt your_program.mrt
+```
+
+## Quick Start
+
+1. Create a file `hello.mrt`:
+```mrt
+func main() {
+    print("Hello, World!")
+}
+```
+
+2. Run the program:
+```bash
+mrt hello.mrt
+```
+
+## Language Examples
+
+### Variables and Basic Types
+```mrt
+func variables_demo() {
+    var name = "Alice"
+    var age = 25
+    var height = 1.75
+    var isStudent = true
+    
+    print("Name: " + name)
+}
+```
+
+### Arrays
+```mrt
+func array_demo() {
+    var numbers = [1, 2, 3, 4, 5]
+    push(numbers, 6)
+    print("Length:", len(numbers))
+    print("First element:", numbers[0])
+}
+```
+
+### String Operations
+```mrt
+func string_demo() {
+    var text = "  Hello, World!  "
+    print("Trimmed:", trim(text))
+    print("Uppercase:", toUpper(text))
+    print("Contains 'World':", contains(text, "World"))
+}
+```
+
+## Built-in Functions
+
+### Array Operations
+- `len(array)`: Returns array length
+- `push(array, element)`: Adds element to end
+- `pop(array)`: Removes and returns last element
+- `slice(array, start, end)`: Returns array subset
+- `join(array, separator)`: Joins elements into string
+- `indexOf(array, element)`: Finds element index
+
+### String Operations
+- `split(str, separator)`: Splits string into array
+- `substring(str, start, end)`: Extracts string portion
+- `toUpper(str)`: Converts to uppercase
+- `toLower(str)`: Converts to lowercase
+- `trim(str)`: Removes whitespace
+- `replace(str, old, new)`: Replaces text
+- `startsWith(str, prefix)`: Checks string start
+- `endsWith(str, suffix)`: Checks string end
+- `contains(str, substr)`: Checks for substring
+
+## Project Structure
+
+- `src/`: Source code for the MRT interpreter
+  - `lexer.py`: Tokenizes source code
+  - `parser.py`: Parses tokens into AST
+  - `interpreter.py`: Executes MRT programs
+  - `ast.py`: Abstract Syntax Tree definitions
+- `docs/`: Comprehensive documentation
+  - `language_guide.md`: Complete language reference
+  - `examples.md`: Example programs and tutorials
+  - `getting_started.md`: Installation and quick start
+- `examples/`: Example MRT programs
+- `tests/`: Test suite
+
+## Documentation
+
+For more detailed information, check out:
+- [Language Guide](docs/language_guide.md): Complete language reference
+- [Examples](docs/examples.md): Example programs and tutorials
+- [Getting Started](docs/getting_started.md): Installation and quick start
+
+## Development
+
+To set up the development environment:
+
+1. Clone the repository:
+```bash
+git clone <repository-url>
+cd mrt
+```
+
+2. Install in development mode:
+```bash
+pip install -e .
+```
+
+3. Install development dependencies:
+```bash
+pip install -r requirements-dev.txt
+```
+
+## Contributing
+
+We welcome contributions! Whether it's:
+- Bug reports
+- Feature requests
+- Documentation improvements
+- Code contributions
+
+Please feel free to open issues and pull requests.
+
+## License
+
+MIT License - see [LICENSE.txt](LICENSE.txt) for details.

mrt-lang-0.1.4/README.md

@@ -0,0 +1,150 @@
+# MRT Programming Language
+
+MRT is a modern, expressive programming language designed for simplicity and readability. It combines intuitive syntax with powerful features for both beginners and experienced programmers.
+
+## Features
+
+- Simple and expressive syntax
+- Dynamic typing with type inference
+- First-class functions
+- Rich built-in functions
+- Comprehensive array operations
+- Powerful string manipulation
+- Modern module system
+
+## Installation
+
+You can install MRT using pip:
+
+```bash
+pip install mrt-lang
+```
+
+After installation, you can run MRT programs using the `mrt` command:
+```bash
+mrt your_program.mrt
+```
+
+## Quick Start
+
+1. Create a file `hello.mrt`:
+```mrt
+func main() {
+    print("Hello, World!")
+}
+```
+
+2. Run the program:
+```bash
+mrt hello.mrt
+```
+
+## Language Examples
+
+### Variables and Basic Types
+```mrt
+func variables_demo() {
+    var name = "Alice"
+    var age = 25
+    var height = 1.75
+    var isStudent = true
+    
+    print("Name: " + name)
+}
+```
+
+### Arrays
+```mrt
+func array_demo() {
+    var numbers = [1, 2, 3, 4, 5]
+    push(numbers, 6)
+    print("Length:", len(numbers))
+    print("First element:", numbers[0])
+}
+```
+
+### String Operations
+```mrt
+func string_demo() {
+    var text = "  Hello, World!  "
+    print("Trimmed:", trim(text))
+    print("Uppercase:", toUpper(text))
+    print("Contains 'World':", contains(text, "World"))
+}
+```
+
+## Built-in Functions
+
+### Array Operations
+- `len(array)`: Returns array length
+- `push(array, element)`: Adds element to end
+- `pop(array)`: Removes and returns last element
+- `slice(array, start, end)`: Returns array subset
+- `join(array, separator)`: Joins elements into string
+- `indexOf(array, element)`: Finds element index
+
+### String Operations
+- `split(str, separator)`: Splits string into array
+- `substring(str, start, end)`: Extracts string portion
+- `toUpper(str)`: Converts to uppercase
+- `toLower(str)`: Converts to lowercase
+- `trim(str)`: Removes whitespace
+- `replace(str, old, new)`: Replaces text
+- `startsWith(str, prefix)`: Checks string start
+- `endsWith(str, suffix)`: Checks string end
+- `contains(str, substr)`: Checks for substring
+
+## Project Structure
+
+- `src/`: Source code for the MRT interpreter
+  - `lexer.py`: Tokenizes source code
+  - `parser.py`: Parses tokens into AST
+  - `interpreter.py`: Executes MRT programs
+  - `ast.py`: Abstract Syntax Tree definitions
+- `docs/`: Comprehensive documentation
+  - `language_guide.md`: Complete language reference
+  - `examples.md`: Example programs and tutorials
+  - `getting_started.md`: Installation and quick start
+- `examples/`: Example MRT programs
+- `tests/`: Test suite
+
+## Documentation
+
+For more detailed information, check out:
+- [Language Guide](docs/language_guide.md): Complete language reference
+- [Examples](docs/examples.md): Example programs and tutorials
+- [Getting Started](docs/getting_started.md): Installation and quick start
+
+## Development
+
+To set up the development environment:
+
+1. Clone the repository:
+```bash
+git clone <repository-url>
+cd mrt
+```
+
+2. Install in development mode:
+```bash
+pip install -e .
+```
+
+3. Install development dependencies:
+```bash
+pip install -r requirements-dev.txt
+```
+
+## Contributing
+
+We welcome contributions! Whether it's:
+- Bug reports
+- Feature requests
+- Documentation improvements
+- Code contributions
+
+Please feel free to open issues and pull requests.
+
+## License
+
+MIT License - see [LICENSE.txt](LICENSE.txt) for details.

mrt-lang-0.1.4/docs/examples.md

@@ -0,0 +1,159 @@
+# MRT Examples
+
+This document provides practical examples of MRT programming language features.
+
+## Basic Examples
+
+### Hello World
+```mrt
+func main() {
+    print("Hello, World!")
+}
+```
+
+### Variable Usage
+```mrt
+func variables_demo() {
+    var name = "Alice"
+    var age = 25
+    var height = 1.75
+    var isStudent = true
+    
+    print("Name: " + name)
+    print("Age: " + age)
+    print("Height: " + height)
+    print("Is Student: " + isStudent)
+}
+```
+
+### Control Flow
+```mrt
+func check_number(n) {
+    if (n > 0) {
+        print("Positive")
+    } else if (n < 0) {
+        print("Negative")
+    } else {
+        print("Zero")
+    }
+}
+
+func count_to_ten() {
+    for (var i = 1; i <= 10; i = i + 1) {
+        print(i)
+    }
+}
+```
+
+## Array Operations
+
+### Array Manipulation
+```mrt
+func array_demo() {
+    var numbers = [1, 2, 3, 4, 5]
+    
+    // Add elements
+    push(numbers, 6)
+    print("After push:", numbers)
+    
+    // Remove last element
+    var last = pop(numbers)
+    print("Popped value:", last)
+    print("After pop:", numbers)
+    
+    // Get array slice
+    var subset = slice(numbers, 1, 4)
+    print("Slice [1:4]:", subset)
+    
+    // Join array elements
+    var joined = join(numbers, ", ")
+    print("Joined string:", joined)
+    
+    // Find element index
+    var index = indexOf(numbers, 3)
+    print("Index of 3:", index)
+}
+```
+
+## String Operations
+
+### String Manipulation
+```mrt
+func string_demo() {
+    var text = "  Hello, World!  "
+    
+    // Basic operations
+    print("Original:", text)
+    print("Trimmed:", trim(text))
+    print("Uppercase:", toUpper(text))
+    print("Lowercase:", toLower(text))
+    
+    // Substring
+    var hello = substring(trim(text), 0, 5)
+    print("First word:", hello)
+    
+    // Split and join
+    var words = split(trim(text), ", ")
+    print("Split words:", words)
+    print("Rejoined:", join(words, "-"))
+    
+    // Search operations
+    print("Starts with 'Hello':", startsWith(trim(text), "Hello"))
+    print("Contains 'World':", contains(text, "World"))
+    print("Ends with '!':", endsWith(trim(text), "!"))
+    
+    // Replace
+    var new_text = replace(text, "World", "MRT")
+    print("After replace:", new_text)
+}
+```
+
+## Advanced Examples
+
+### Calculator
+```mrt
+func calculator(a, b, operation) {
+    if (operation == "+") {
+        return a + b
+    } else if (operation == "-") {
+        return a - b
+    } else if (operation == "*") {
+        return a * b
+    } else if (operation == "/") {
+        if (b == 0) {
+            print("Error: Division by zero")
+            return 0
+        }
+        return a / b
+    } else {
+        print("Error: Invalid operation")
+        return 0
+    }
+}
+
+func calc_demo() {
+    print("5 + 3 =", calculator(5, 3, "+"))
+    print("10 - 4 =", calculator(10, 4, "-"))
+    print("6 * 2 =", calculator(6, 2, "*"))
+    print("15 / 3 =", calculator(15, 3, "/"))
+}
+```
+
+### Word Counter
+```mrt
+func count_words(text) {
+    var words = split(trim(text), " ")
+    return len(words)
+}
+
+func word_counter_demo() {
+    var text = "The quick brown fox jumps over the lazy dog"
+    var count = count_words(text)
+    print("Word count:", count)
+    
+    var words = split(text, " ")
+    print("Words:", words)
+    print("First word:", words[0])
+    print("Last word:", words[len(words) - 1])
+}
+```

mrt-lang-0.1.4/docs/getting_started.md

@@ -0,0 +1,134 @@
+# Getting Started with MRT
+
+## Installation
+
+There are two ways to install MRT:
+
+### 1. Install from PyPI (Recommended)
+
+```bash
+pip install mrt-lang
+```
+
+After installation, you can run MRT programs using the `mrt` command:
+```bash
+mrt your_program.mrt
+```
+
+### 2. Install from Source
+
+1. Clone the repository:
+```bash
+git clone <repository-url>
+cd mrt
+```
+
+2. Install in development mode:
+```bash
+pip install -e .
+```
+
+3. Install development dependencies (optional):
+```bash
+pip install -r requirements-dev.txt
+```
+
+## Running MRT Programs
+
+After installation, you can run MRT programs in two ways:
+
+1. Using the `mrt` command (if installed via pip):
+```bash
+mrt your_program.mrt
+```
+
+2. Using Python directly:
+```bash
+python -m src your_program.mrt
+```
+
+## Creating Your First Program
+
+1. Create a new file `hello.mrt`:
+```mrt
+func main() {
+    print("Hello, World!")
+}
+```
+
+2. Run the program:
+```bash
+mrt hello.mrt
+```
+
+## Development Environment
+
+MRT files use the `.mrt` extension. Any text editor can be used for MRT development, but we recommend using an editor with syntax highlighting support for better readability.
+
+## Project Structure
+
+- `src/`: Source code for the MRT interpreter
+  - `lexer.py`: Tokenizes source code
+  - `parser.py`: Parses tokens into AST
+  - `interpreter.py`: Executes MRT programs
+  - `ast.py`: Abstract Syntax Tree definitions
+- `examples/`: Example MRT programs
+- `docs/`: Documentation
+- `tests/`: Test suite
+
+## Basic Concepts
+
+### Program Structure
+Every MRT program consists of functions and statements. The `main()` function is the entry point of the program.
+
+### Variables
+Variables are declared using the `var` keyword:
+```mrt
+var name = "John"
+var age = 25
+```
+
+### Functions
+Functions are declared using the `func` keyword:
+```mrt
+func greet(name) {
+    print("Hello, " + name + "!")
+}
+```
+
+### Data Types
+MRT supports these basic data types:
+- Numbers (integers and floats)
+- Strings
+- Booleans
+- Arrays
+
+## Next Steps
+
+1. Review the [Language Guide](language_guide.md) for detailed documentation
+2. Check out the [Examples](examples.md) for practical code samples
+3. Try writing your own MRT programs
+4. Join the community (coming soon)
+
+## Common Issues and Solutions
+
+### Program Not Running
+- Ensure Python 3.6+ is installed
+- Check that all files are in the correct directory
+- Verify syntax in your MRT file
+
+### Syntax Errors
+- Check for missing parentheses or braces
+- Verify all variables are properly declared
+- Ensure strings are properly quoted
+
+## Getting Help
+
+If you encounter any issues:
+1. Check the documentation
+2. Look at similar examples
+3. Report issues on the repository (coming soon)
+
+## Contributing
+
+We welcome contributions! Please see our contributing guidelines (coming soon) for details on how to help improve MRT.