maliklang 1.0.0__tar.gz

maliklang-1.0.0/LICENSE

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

maliklang-1.0.0/PKG-INFO

@@ -0,0 +1,297 @@
+Metadata-Version: 2.4
+Name: maliklang
+Version: 1.0.0
+Summary: A beginner-friendly programming language designed for natural readability and defensive cybersecurity automation.
+Author: MalikLang Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/maliklang/maliklang
+Project-URL: Documentation, https://github.com/maliklang/maliklang#readme
+Project-URL: Repository, https://github.com/maliklang/maliklang.git
+Project-URL: Issues, https://github.com/maliklang/maliklang/issues
+Project-URL: Changelog, https://github.com/maliklang/maliklang/blob/main/CHANGELOG.md
+Keywords: programming-language,interpreter,beginner-friendly,cybersecurity,education,automation,scripting,maliklang
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Information Technology
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Interpreters
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+Dynamic: requires-python
+
+# MalikLang 🚀
+
+[![CI](https://github.com/maliklang/maliklang/actions/workflows/ci.yml/badge.svg)](https://github.com/maliklang/maliklang/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/maliklang.svg)](https://pypi.org/project/maliklang/)
+[![Python versions](https://img.shields.io/pypi/pyversions/maliklang.svg)](https://pypi.org/project/maliklang/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![VS Code Marketplace](https://img.shields.io/badge/VS%20Code-Extension-blueviolet.svg)](vscode-extension/)
+
+> **A complete, beginner-friendly programming language designed from scratch.**  
+> Simpler than Python, natural English-like syntax, zero external runtime dependencies, 13 built-in standard library modules, defensive cybersecurity automation tools, interactive REPL, formatted diagnostics, and VS Code support.
+
+---
+
+## 🌟 Language Philosophy & Key Highlights
+
+- **Natural English Commands**: Write `say "Hello"`, `name = ask "What is your name?"`, `repeat 5 ... end`.
+- **Zero Syntax Clutter**: No mandatory semicolons, brackets, or weird symbols.
+- **Defensive Cybersecurity Ready**: Built-in modules for safe port checking, DNS lookups, cryptographic hashes, HTTP requests, and log forensics.
+- **Friendly Diagnostics**: Clear error messages pointing directly to the line and column with actionable hints.
+- **Zero External Dependencies**: Runs out of the box on Windows, macOS, and Linux with standard Python 3.
+
+---
+
+## ⚡ Installation & Quickstart
+
+### 1. Installation via PyPI
+```bash
+pip install --upgrade maliklang
+```
+
+Verify your installation:
+```bash
+malik --version
+```
+
+### 2. Run a MalikLang File
+```bash
+malik run examples/hello.malik
+# Or simply:
+malik examples/hello.malik
+```
+
+### 3. Launch Interactive REPL Shell
+```bash
+malik repl
+```
+
+```
+malik> x = 10 + 20
+malik> say "Result: " + x
+Result: 30
+malik> repeat 3
+... say "MalikLang is awesome!"
+... end
+MalikLang is awesome!
+MalikLang is awesome!
+MalikLang is awesome!
+```
+
+### 4. Run Built-in Automated Tests
+```bash
+malik test
+```
+
+---
+
+## 📖 Syntax at a Glance
+
+### Variables & Data Types
+```malik
+name = "Malik"
+age = 20
+active = true
+score = 98.5
+items = ["apple", "banana", "cherry"]
+person = { name: "Malik", role: "admin" }
+```
+
+### Input & Output
+```malik
+say "Hello World!"
+user_name = ask "Enter your name: "
+say "Welcome, " + user_name
+```
+
+### Conditions
+```malik
+if age >= 18
+    say "You are an adult"
+else if age >= 13
+    say "You are a teenager"
+else
+    say "You are a child"
+end
+```
+
+### Loops
+```malik
+# Fixed count loop
+repeat 5 as i
+    say "Iteration: " + i
+end
+
+# Condition-based loop
+count = 3
+while count > 0
+    say count
+    count -= 1
+end
+
+# List / Collection loop
+for item in items
+    say "Item: " + item
+end
+```
+
+### Functions & Closures
+```malik
+function add(a, b)
+    return a + b
+end
+
+result = add(10, 25)
+say "Sum: " + result
+```
+
+### Defensive Cybersecurity & Log Forensics
+```malik
+import crypto
+import network
+import log
+
+# SHA-256 Hash Verification
+hash = crypto.sha256("AdminSecret")
+say "SHA-256: " + hash
+
+# Port Connectivity Check
+if network.port_check("127.0.0.1", 80, 0.5)
+    say "Web server port 80 is listening."
+end
+
+# Brute Force Log Detection
+suspicious_ips = log.detect_brute_force(log_lines, 5)
+```
+
+---
+
+## 🛠️ CLI Commands
+
+| Command | Description | Example |
+|---|---|---|
+| `malik run <file.malik>` | Executes a MalikLang program | `malik run examples/hello.malik` |
+| `malik <file.malik>` | Shortcut to execute a script | `malik examples/calculator.malik` |
+| `malik check <file.malik>` | Validates syntax without running | `malik check script.malik` |
+| `malik repl` | Starts the interactive REPL shell | `malik repl` |
+| `malik format <file.malik>` | Auto-formats code indentation | `malik format script.malik` |
+| `malik test` | Runs the automated test suite (108+ tests) | `malik test` |
+| `malik examples` | Lists all built-in example programs | `malik examples` |
+| `malik version` | Displays version and platform info | `malik version` |
+| `malik help` | Displays full help manual | `malik help` |
+
+---
+
+## 💻 Visual Studio Code Extension
+
+Install the MalikLang extension for VS Code:
+```bash
+code --install-extension vscode-extension/maliklang-1.0.0.vsix
+```
+
+**Features Included:**
+- Full syntax highlighting for `.malik` and `.mlk` files.
+- Auto-closing brackets and comment toggling (`#`).
+- Built-in snippets (`if`, `repeat`, `while`, `for`, `function`, `try`).
+- Editor Run button & `Ctrl+F5` execution shortcut.
+- Inline syntax error diagnostics in the VS Code Problems panel.
+
+---
+
+## 📁 Project Structure
+
+```
+MalikLang/
+│
+├── malik_lang/                   # Core Language Engine
+│   ├── lexer/                    # Tokenizer & Token structures
+│   ├── parser/                   # Recursive-Descent Parser & AST Nodes
+│   ├── runtime/                  # Environment, Scopes, Values & Diagnostics
+│   ├── interpreter/              # Tree-Walking AST Evaluator
+│   ├── stdlib/                   # 13 Built-in Standard Modules
+│   ├── cli/                      # Command-Line Interface & Formatter
+│   └── repl/                     # Interactive REPL Shell
+│
+├── tests/                        # 108 Automated Unit & Integration Tests
+│   ├── test_lexer.py
+│   ├── test_parser.py
+│   ├── test_interpreter.py
+│   ├── test_stdlib.py
+│   ├── test_networking_crypto.py
+│   ├── test_security_scripting.py
+│   ├── test_cli_and_repl.py
+│   ├── test_programs.py
+│   └── test_stability_and_edge_cases.py
+│
+├── examples/                     # 11 Working Example Scripts
+│   ├── hello.malik
+│   ├── calculator.malik
+│   ├── guessing_game.malik
+│   ├── todo.malik
+│   ├── file_reader.malik
+│   ├── json_example.malik
+│   ├── network_example.malik
+│   ├── http_example.malik
+│   ├── cybersecurity_defensive_example.malik
+│   ├── security_log_analyzer.malik
+│   └── file_integrity_checker.malik
+│
+├── docs/                         # Comprehensive Documentation Suite
+│   ├── installation.md           # Installation Guide
+│   ├── vscode.md                 # VS Code Setup & Extension Guide
+│   ├── language.md               # Beginner Language Manual
+│   ├── standard-library.md       # Standard Library Reference
+│   ├── security.md               # Defensive Cybersecurity Guide
+│   ├── contributing.md           # Developer & Contributing Guide
+│   ├── spec.md                   # Formal Language Specification
+│   ├── tutorial.md               # 10-Minute Beginner Tutorial
+│   └── architecture_and_compiler_roadmap.md
+│
+├── vscode-extension/             # Visual Studio Code Syntax Extension & VSIX Package
+├── .github/                      # GitHub Actions CI/CD Workflows
+│   └── workflows/
+│       ├── ci.yml                # Multi-OS CI Matrix
+│       ├── release.yml           # PyPI Trusted Publishing & Release Assets
+│       ├── testpypi.yml          # TestPyPI Publishing
+│       └── vscode-marketplace.yml# VS Code Extension Release
+│
+├── malik.py                      # Root Python Entrypoint
+├── malik.bat                     # Windows CLI Batch Wrapper
+├── pyproject.toml                # Standard Package Configuration
+├── setup.py                      # Setuptools Configuration
+├── RELEASE-CHECKLIST.md          # Release Step-by-Step Checklist
+├── SECURITY.md                   # Security & Anti-Malware Policy
+├── CHANGELOG.md                  # Release Notes
+└── README.md
+```
+
+---
+
+## 📚 Documentation Index
+
+- [Installation Guide](docs/installation.md)
+- [Visual Studio Code Setup](docs/vscode.md)
+- [Language Guide](docs/language.md)
+- [Standard Library Reference](docs/standard-library.md)
+- [Defensive Cybersecurity Scripting](docs/security.md)
+- [Contributing Guide](docs/contributing.md)
+- [Language Specification](docs/spec.md)
+- [Security Policy](SECURITY.md)
+
+---
+
+## 📜 License
+
+MIT License. See [LICENSE](LICENSE) for details.

maliklang-1.0.0/README.md

@@ -0,0 +1,264 @@
+# MalikLang 🚀
+
+[![CI](https://github.com/maliklang/maliklang/actions/workflows/ci.yml/badge.svg)](https://github.com/maliklang/maliklang/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/maliklang.svg)](https://pypi.org/project/maliklang/)
+[![Python versions](https://img.shields.io/pypi/pyversions/maliklang.svg)](https://pypi.org/project/maliklang/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![VS Code Marketplace](https://img.shields.io/badge/VS%20Code-Extension-blueviolet.svg)](vscode-extension/)
+
+> **A complete, beginner-friendly programming language designed from scratch.**  
+> Simpler than Python, natural English-like syntax, zero external runtime dependencies, 13 built-in standard library modules, defensive cybersecurity automation tools, interactive REPL, formatted diagnostics, and VS Code support.
+
+---
+
+## 🌟 Language Philosophy & Key Highlights
+
+- **Natural English Commands**: Write `say "Hello"`, `name = ask "What is your name?"`, `repeat 5 ... end`.
+- **Zero Syntax Clutter**: No mandatory semicolons, brackets, or weird symbols.
+- **Defensive Cybersecurity Ready**: Built-in modules for safe port checking, DNS lookups, cryptographic hashes, HTTP requests, and log forensics.
+- **Friendly Diagnostics**: Clear error messages pointing directly to the line and column with actionable hints.
+- **Zero External Dependencies**: Runs out of the box on Windows, macOS, and Linux with standard Python 3.
+
+---
+
+## ⚡ Installation & Quickstart
+
+### 1. Installation via PyPI
+```bash
+pip install --upgrade maliklang
+```
+
+Verify your installation:
+```bash
+malik --version
+```
+
+### 2. Run a MalikLang File
+```bash
+malik run examples/hello.malik
+# Or simply:
+malik examples/hello.malik
+```
+
+### 3. Launch Interactive REPL Shell
+```bash
+malik repl
+```
+
+```
+malik> x = 10 + 20
+malik> say "Result: " + x
+Result: 30
+malik> repeat 3
+... say "MalikLang is awesome!"
+... end
+MalikLang is awesome!
+MalikLang is awesome!
+MalikLang is awesome!
+```
+
+### 4. Run Built-in Automated Tests
+```bash
+malik test
+```
+
+---
+
+## 📖 Syntax at a Glance
+
+### Variables & Data Types
+```malik
+name = "Malik"
+age = 20
+active = true
+score = 98.5
+items = ["apple", "banana", "cherry"]
+person = { name: "Malik", role: "admin" }
+```
+
+### Input & Output
+```malik
+say "Hello World!"
+user_name = ask "Enter your name: "
+say "Welcome, " + user_name
+```
+
+### Conditions
+```malik
+if age >= 18
+    say "You are an adult"
+else if age >= 13
+    say "You are a teenager"
+else
+    say "You are a child"
+end
+```
+
+### Loops
+```malik
+# Fixed count loop
+repeat 5 as i
+    say "Iteration: " + i
+end
+
+# Condition-based loop
+count = 3
+while count > 0
+    say count
+    count -= 1
+end
+
+# List / Collection loop
+for item in items
+    say "Item: " + item
+end
+```
+
+### Functions & Closures
+```malik
+function add(a, b)
+    return a + b
+end
+
+result = add(10, 25)
+say "Sum: " + result
+```
+
+### Defensive Cybersecurity & Log Forensics
+```malik
+import crypto
+import network
+import log
+
+# SHA-256 Hash Verification
+hash = crypto.sha256("AdminSecret")
+say "SHA-256: " + hash
+
+# Port Connectivity Check
+if network.port_check("127.0.0.1", 80, 0.5)
+    say "Web server port 80 is listening."
+end
+
+# Brute Force Log Detection
+suspicious_ips = log.detect_brute_force(log_lines, 5)
+```
+
+---
+
+## 🛠️ CLI Commands
+
+| Command | Description | Example |
+|---|---|---|
+| `malik run <file.malik>` | Executes a MalikLang program | `malik run examples/hello.malik` |
+| `malik <file.malik>` | Shortcut to execute a script | `malik examples/calculator.malik` |
+| `malik check <file.malik>` | Validates syntax without running | `malik check script.malik` |
+| `malik repl` | Starts the interactive REPL shell | `malik repl` |
+| `malik format <file.malik>` | Auto-formats code indentation | `malik format script.malik` |
+| `malik test` | Runs the automated test suite (108+ tests) | `malik test` |
+| `malik examples` | Lists all built-in example programs | `malik examples` |
+| `malik version` | Displays version and platform info | `malik version` |
+| `malik help` | Displays full help manual | `malik help` |
+
+---
+
+## 💻 Visual Studio Code Extension
+
+Install the MalikLang extension for VS Code:
+```bash
+code --install-extension vscode-extension/maliklang-1.0.0.vsix
+```
+
+**Features Included:**
+- Full syntax highlighting for `.malik` and `.mlk` files.
+- Auto-closing brackets and comment toggling (`#`).
+- Built-in snippets (`if`, `repeat`, `while`, `for`, `function`, `try`).
+- Editor Run button & `Ctrl+F5` execution shortcut.
+- Inline syntax error diagnostics in the VS Code Problems panel.
+
+---
+
+## 📁 Project Structure
+
+```
+MalikLang/
+│
+├── malik_lang/                   # Core Language Engine
+│   ├── lexer/                    # Tokenizer & Token structures
+│   ├── parser/                   # Recursive-Descent Parser & AST Nodes
+│   ├── runtime/                  # Environment, Scopes, Values & Diagnostics
+│   ├── interpreter/              # Tree-Walking AST Evaluator
+│   ├── stdlib/                   # 13 Built-in Standard Modules
+│   ├── cli/                      # Command-Line Interface & Formatter
+│   └── repl/                     # Interactive REPL Shell
+│
+├── tests/                        # 108 Automated Unit & Integration Tests
+│   ├── test_lexer.py
+│   ├── test_parser.py
+│   ├── test_interpreter.py
+│   ├── test_stdlib.py
+│   ├── test_networking_crypto.py
+│   ├── test_security_scripting.py
+│   ├── test_cli_and_repl.py
+│   ├── test_programs.py
+│   └── test_stability_and_edge_cases.py
+│
+├── examples/                     # 11 Working Example Scripts
+│   ├── hello.malik
+│   ├── calculator.malik
+│   ├── guessing_game.malik
+│   ├── todo.malik
+│   ├── file_reader.malik
+│   ├── json_example.malik
+│   ├── network_example.malik
+│   ├── http_example.malik
+│   ├── cybersecurity_defensive_example.malik
+│   ├── security_log_analyzer.malik
+│   └── file_integrity_checker.malik
+│
+├── docs/                         # Comprehensive Documentation Suite
+│   ├── installation.md           # Installation Guide
+│   ├── vscode.md                 # VS Code Setup & Extension Guide
+│   ├── language.md               # Beginner Language Manual
+│   ├── standard-library.md       # Standard Library Reference
+│   ├── security.md               # Defensive Cybersecurity Guide
+│   ├── contributing.md           # Developer & Contributing Guide
+│   ├── spec.md                   # Formal Language Specification
+│   ├── tutorial.md               # 10-Minute Beginner Tutorial
+│   └── architecture_and_compiler_roadmap.md
+│
+├── vscode-extension/             # Visual Studio Code Syntax Extension & VSIX Package
+├── .github/                      # GitHub Actions CI/CD Workflows
+│   └── workflows/
+│       ├── ci.yml                # Multi-OS CI Matrix
+│       ├── release.yml           # PyPI Trusted Publishing & Release Assets
+│       ├── testpypi.yml          # TestPyPI Publishing
+│       └── vscode-marketplace.yml# VS Code Extension Release
+│
+├── malik.py                      # Root Python Entrypoint
+├── malik.bat                     # Windows CLI Batch Wrapper
+├── pyproject.toml                # Standard Package Configuration
+├── setup.py                      # Setuptools Configuration
+├── RELEASE-CHECKLIST.md          # Release Step-by-Step Checklist
+├── SECURITY.md                   # Security & Anti-Malware Policy
+├── CHANGELOG.md                  # Release Notes
+└── README.md
+```
+
+---
+
+## 📚 Documentation Index
+
+- [Installation Guide](docs/installation.md)
+- [Visual Studio Code Setup](docs/vscode.md)
+- [Language Guide](docs/language.md)
+- [Standard Library Reference](docs/standard-library.md)
+- [Defensive Cybersecurity Scripting](docs/security.md)
+- [Contributing Guide](docs/contributing.md)
+- [Language Specification](docs/spec.md)
+- [Security Policy](SECURITY.md)
+
+---
+
+## 📜 License
+
+MIT License. See [LICENSE](LICENSE) for details.

maliklang-1.0.0/malik_lang/__init__.py

@@ -0,0 +1,24 @@
+"""
+MalikLang Programming Language
+A beginner-friendly, English-like programming language built from scratch.
+"""
+
+__version__ = "1.0.0"
+__author__ = "MalikLang Contributors"
+
+from malik_lang.lexer.lexer import Lexer
+from malik_lang.parser.parser import Parser
+from malik_lang.interpreter.interpreter import Interpreter
+from malik_lang.runtime.environment import Environment
+from malik_lang.runtime.errors import MalikError, MalikSyntaxError, MalikRuntimeError
+
+__all__ = [
+    "Lexer",
+    "Parser",
+    "Interpreter",
+    "Environment",
+    "MalikError",
+    "MalikSyntaxError",
+    "MalikRuntimeError",
+    "__version__",
+]

maliklang-1.0.0/malik_lang/cli/__init__.py

@@ -0,0 +1,7 @@
+"""
+CLI package for MalikLang.
+"""
+
+from malik_lang.cli.cli import main
+
+__all__ = ["main"]