maliklang 1.0.0__py3-none-any.whl

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__",
+]

malik_lang/cli/__init__.py

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

malik_lang/cli/cli.py

@@ -0,0 +1,196 @@
+"""
+Command-Line Interface (CLI) for MalikLang.
+"""
+
+import sys
+import os
+import unittest
+from malik_lang import __version__
+from malik_lang.lexer import Lexer
+from malik_lang.parser import Parser
+from malik_lang.interpreter import Interpreter
+from malik_lang.runtime.errors import MalikError
+from malik_lang.cli.formatter import format_source_code
+from malik_lang.repl import start_repl
+
+HELP_TEXT = f"""MalikLang CLI v{__version__}
+A beginner-friendly programming language designed for natural readability and defensive security scripting.
+
+Usage:
+  malik run <filename.malik> [args...]   Execute a MalikLang source file
+  malik <filename.malik>                 Execute a MalikLang source file (shortcut)
+  malik check <filename.malik>           Check source file syntax without executing
+  malik repl                             Launch interactive REPL shell
+  malik format <filename.malik>          Format and beautify source code indentation
+  malik test                             Run all built-in automated test suites
+  malik version                          Show language version and platform info
+  malik examples                         List available built-in example programs
+  malik help                             Display this help manual
+
+Examples:
+  malik run examples/hello.malik
+  malik run examples/calculator.malik
+  malik check my_script.malik
+  malik format my_script.malik
+"""
+
+
+def run_file(filepath: str) -> int:
+    """Executes a MalikLang source file."""
+    if not os.path.exists(filepath):
+        print(f"Error: File '{filepath}' not found.", file=sys.stderr)
+        return 1
+
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            source = f.read()
+
+        lexer = Lexer(source, filename=filepath)
+        tokens = lexer.tokenize()
+        parser = Parser(tokens, source_code=source, filename=filepath)
+        program = parser.parse()
+
+        interpreter = Interpreter(source_code=source, filename=filepath)
+        interpreter.interpret(program)
+        return 0
+
+    except MalikError as me:
+        print(me.format_friendly(), file=sys.stderr)
+        return 1
+    except Exception as e:
+        print(f"Internal Runtime Error: {e}", file=sys.stderr)
+        return 1
+
+
+def check_file(filepath: str) -> int:
+    """Validates the syntax and AST structure of a MalikLang file."""
+    if not os.path.exists(filepath):
+        print(f"Error: File '{filepath}' not found.", file=sys.stderr)
+        return 1
+
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            source = f.read()
+
+        lexer = Lexer(source, filename=filepath)
+        tokens = lexer.tokenize()
+        parser = Parser(tokens, source_code=source, filename=filepath)
+        parser.parse()
+        print(f"Syntax check passed successfully for '{filepath}'.")
+        return 0
+
+    except MalikError as me:
+        print(me.format_friendly(), file=sys.stderr)
+        return 1
+
+
+def format_file(filepath: str) -> int:
+    """Auto-formats a MalikLang file with standard indentation."""
+    if not os.path.exists(filepath):
+        print(f"Error: File '{filepath}' not found.", file=sys.stderr)
+        return 1
+
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            source = f.read()
+
+        formatted = format_source_code(source)
+        with open(filepath, "w", encoding="utf-8") as f:
+            f.write(formatted)
+
+        print(f"Successfully formatted '{filepath}'.")
+        return 0
+    except Exception as e:
+        print(f"Error formatting file: {e}", file=sys.stderr)
+        return 1
+
+
+def run_tests() -> int:
+    """Runs the test suite."""
+    print("Running MalikLang automated test suite...\n")
+    loader = unittest.TestLoader()
+    suite = loader.discover("tests", pattern="test_*.py")
+    runner = unittest.TextTestRunner(verbosity=2)
+    result = runner.run(suite)
+    return 0 if result.wasSuccessful() else 1
+
+
+def show_examples() -> None:
+    """Lists built-in example programs."""
+    print("\n--- Available MalikLang Example Programs ---")
+    examples = [
+        ("examples/hello.malik", "Variables, input/output, and basic English commands"),
+        ("examples/calculator.malik", "Interactive arithmetic calculator with loops and functions"),
+        ("examples/guessing_game.malik", "Number guessing game with conditions and user interaction"),
+        ("examples/todo.malik", "To-do manager demonstrating lists and dictionaries"),
+        ("examples/file_reader.malik", "File I/O, writing, reading, and line processing"),
+        ("examples/json_example.malik", "JSON parsing and structured serialization"),
+        ("examples/network_example.malik", "Safe DNS lookup, IP verification, and port checks"),
+        ("examples/http_example.malik", "Safe HTTP requests and REST API consumption"),
+        ("examples/cybersecurity_defensive_example.malik", "Defensive multi-point security audit"),
+        ("examples/security_log_analyzer.malik", "Web server log forensics & brute force detector"),
+        ("examples/file_integrity_checker.malik", "SHA-256 baseline security monitor"),
+    ]
+    for path, desc in examples:
+        print(f"  {path:45} - {desc}")
+    print("\nRun any example using: malik run <example_path>\n")
+
+
+def main(args: list = None) -> int:
+    if args is None:
+        args = sys.argv[1:]
+
+    if not args:
+        start_repl()
+        return 0
+
+    command = args[0].lower()
+
+    if command in ("-v", "--version", "version"):
+        print(f"MalikLang version {__version__} (Python runtime: {sys.version.split()[0]})")
+        return 0
+
+    elif command in ("-h", "--help", "help"):
+        print(HELP_TEXT)
+        return 0
+
+    elif command in ("repl", "shell"):
+        start_repl()
+        return 0
+
+    elif command == "test":
+        return run_tests()
+
+    elif command == "examples":
+        show_examples()
+        return 0
+
+    elif command == "run":
+        if len(args) < 2:
+            print("Error: 'run' requires a target .malik file.\nUsage: malik run <file.malik>", file=sys.stderr)
+            return 1
+        return run_file(args[1])
+
+    elif command == "check":
+        if len(args) < 2:
+            print("Error: 'check' requires a target .malik file.\nUsage: malik check <file.malik>", file=sys.stderr)
+            return 1
+        return check_file(args[1])
+
+    elif command in ("format", "fmt"):
+        if len(args) < 2:
+            print("Error: 'format' requires a target .malik file.\nUsage: malik format <file.malik>", file=sys.stderr)
+            return 1
+        return format_file(args[1])
+
+    # Direct filename shortcut: `malik script.malik`
+    elif command.endswith(".malik") or command.endswith(".mlk") or os.path.exists(command):
+        return run_file(command)
+
+    else:
+        print(f"Unknown command or file '{command}'. Run 'malik help' for usage.", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

malik_lang/cli/formatter.py

@@ -0,0 +1,40 @@
+"""
+Source code formatter for MalikLang.
+Automatically formats indentation, removes trailing whitespace, and normalizes block structures.
+"""
+
+from typing import List
+
+
+def format_source_code(source: str, indent_size: int = 4) -> str:
+    """Formats MalikLang source code with consistent indentation."""
+    lines = source.strip().splitlines()
+    formatted_lines: List[str] = []
+    indent_level = 0
+    indent_str = " " * indent_size
+
+    for raw_line in lines:
+        line = raw_line.strip()
+
+        # Preserve internal empty lines
+        if not line:
+            formatted_lines.append("")
+            continue
+
+        # Check for dedenting keywords
+        # Dedent if the line starts with 'end', 'else', or 'catch'
+        if line.startswith("end") or line.startswith("else") or line.startswith("catch"):
+            indent_level = max(0, indent_level - 1)
+
+        # Apply current indentation
+        formatted_lines.append((indent_str * indent_level) + line)
+
+        # Check for indenting keywords
+        # Indent after lines starting with 'if', 'else', 'repeat', 'while', 'for', 'function', 'try', 'catch'
+        # unless it is a single-line statement with 'end'
+        if not line.endswith("end"):
+            first_word = line.split()[0] if line.split() else ""
+            if first_word in ("if", "repeat", "while", "for", "function", "try", "catch", "else"):
+                indent_level += 1
+
+    return "\n".join(formatted_lines) + "\n"

malik_lang/interpreter/__init__.py

@@ -0,0 +1,7 @@
+"""
+Interpreter package for MalikLang.
+"""
+
+from malik_lang.interpreter.interpreter import Interpreter
+
+__all__ = ["Interpreter"]