nexus-dsl 1.0.0__tar.gz

nexus_dsl-1.0.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: nexus-dsl
+Version: 1.0.0
+Summary: NEXUS: A Custom Domain-Specific Scripting Language (DSL) for local automation
+Author-email: Yuvneil <yuvneiledu44@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: plyer>=2.1.0
+Requires-Dist: pyttsx3>=2.90
+
+# NEXUS: A Custom Domain-Specific Scripting Language (DSL)
+
+NEXUS is an elegant, cross-platform, domain-specific scripting language engineered entirely in Python. It abstracts complex localized operating system tasks, directory architectures, cryptographic transformations, and core machine telemetry workflows into a highly readable, human-centric syntax layout [Example 4].
+
+Developed as a breakthrough milestone during the First-Year Passed Industrial Training curriculum at Lovely Professional University (LPU), Jalandhar, this framework implements a modular token parsing architecture that lets you automate system scripts natively.
+
+---
+
+## 🚀 Installation & Setup
+
+Install the stable release of the NEXUS engine directly from PyPI using `pip`:
+
+```bash
+pip install nexus-dsl
+```
+
+*(Note: If the name 'nexus' is already reserved on PyPI, it is standard convention to register it as `nexus-dsl` or `nexus-runtime` while keeping the package import name as `nexus`.)*
+
+### External Dependencies
+NEXUS requires a few lightweight libraries to power its native notification toaster and hardware audio modules:
+```bash
+pip install colorama plyer pyttsx3
+```
+
+---
+
+## 💻 Python Integration API
+
+You can easily load and run `.nxs` automation scripts straight from your standard Python files.
+
+```python
+from nexus import nexus
+
+# Simply pass the path of your .nxs script file to the core execution engine
+nexus.nexus("main.nxs")
+```
+
+---
+
+## 📖 Keyword Reference Manual & Syntax Specs
+
+NEXUS statement expressions read line-by-line. Comments must begin with a `#` token. Any multi-word string parameters containing spaces must be cleanly wrapped inside double quotes (`"..."`).
+
+### 1. Console Operations & Core Logging
+* **`Show [string]`**  
+  Strips enclosing quote markers and prints clean string characters directly onto the active console view.  
+  *Syntax:* `Show "Hello, World!"`
+* **`Wait [seconds]`**  
+  Pauses the script execution stream for an integer or floating-point timeline duration. Generates a high-contrast red error message if the parameter value is non-numeric.  
+  *Syntax:* `Wait 1.5`
+* **`Speak [string]`**  
+  Hooks directly into your machine's hardware sound drivers to speak a line of text out loud natively using offline speech synthesis.  
+  *Syntax:* `Speak "Automation sequence initiated"`
+* **`Notify "[Title]" "[Message]"`**  
+  Uses a token slice delimiter to push a real, native desktop notification toast banner into the system screen space. Requires both parameters to be wrapped in double quotes.  
+  *Syntax:* `Notify "NEXUS Core" "Task Completed Successfully"`
+
+### 2. File & Storage Operations
+* **`Create [filename]`**  
+  Safely generates an empty file inside your active working workspace folder if it doesn't already exist.  
+  *Syntax:* `Create log.txt`
+* **`Write [filename] [string]`**  
+  Completely overwrites a file with a fresh text payload, wiping any trailing historical characters out of the file buffer.  
+  *Syntax:* `Write log.txt "Initial Payload"`
+* **`MuteWrite [filename] [Line / NewLine] [string]`**  
+  Appends text data onto the end of a file. Use `Line` to paste characters on the active row, or `NewLine` to prefix a line break.  
+  *Syntax:* `MuteWrite log.txt NewLine "Appended system note."`
+* **`Truncate [filename]`**  
+  Instantly clears and zeroes out all data content inside a document without dropping the file pointer from your storage.  
+  *Syntax:* `Truncate log.txt`
+* **`Delete [filename]`**  
+  Hard-drops and permanently removes a targeted file path from your computer disk storage.  
+  *Syntax:* `Delete obsolete.txt`
+* **`Rename [old_filename] [new_filename]`**  
+  Modifies the naming characteristics of a target file path in-place.  
+  *Syntax:* `Rename records.txt old_records.txt`
+* **`Copy [source_path] [destination_path]`**  
+  Clones a localized file into a fresh directory lane safely.  
+  *Syntax:* `Copy data.txt backup_data.txt`
+* **`Move [filename] [directory_folder]`**  
+  Relocates an asset file out of your active workspace directory and paths it into a target folder directory.  
+  *Syntax:* `Move log.txt BackupsFolder`
+* **`SizeOf [unit] [filename]`**  
+  Uses pattern matching (`match-case`) to convert file weights into human-readable scales including `bytes`, `kb`, `mb`, `gb`, `tb`, `pb`, and `eb`.  
+  *Syntax:* `SizeOf mb archive.zip`
+* **`Backup [filename]`**  
+  Creates an automated timestamped duplicate copy of the target file for recovery purposes (e.g., `data_20260616_161022.txt`).  
+  *Syntax:* `Backup data.txt`
+
+### 3. Directory Management
+* **`MakeDir [base_directory] [new_folder_name]`**  
+  Joins variables securely to deploy a new nested workspace directory folder.  
+  *Syntax:* `MakeDir . "BackupsFolder"`
+* **`DelDir [directory_path]`**  
+  Flashes an engine warning prompt asking for explicit terminal confirmation (`yes/no`) before wiping a directory.  
+  *Syntax:* `DelDir BackupsFolder`
+
+### 4. Application Control & Cryptography
+* **`Run [executable.exe]`**  
+  Asynchronously spawns independent system application processes (like `notepad.exe`) without freezing your main interpreter loop.  
+  *Syntax:* `Run notepad.exe`
+* **`Open [filename]`**  
+  Launches a text document natively inside the operating system's standard text editor (Notepad).  
+  *Syntax:* `Open hello.txt`
+* **`Browse [URL]`**  
+  Triggers your default web browser tool to spin open and target a live web URL natively.  
+  *Syntax:* `Browse https://lpu.in`
+* **`Progress [seconds]`**  
+  Renders an active graphical loading progress tracking bar loop (`[██████░░░░]`) directly across the terminal row workspace console over X seconds.  
+  *Syntax:* `Progress 5`
+* **`Compress [folder_or_file_path]`**  
+  Packages an independent text file or an entire nested directory workspace into a compressed binary `.zip` archive payload.  
+  *Syntax:* `Compress "MyProjectFolder"`
+* **`Extract [source_archive.zip] [destination_folder]`**  
+  Extracts compressed zip archives directly into a targeted folder destination directory path.  
+  *Syntax:* `Extract archive.zip ExtractedFiles`
+* **`SystemInfo`**  
+  Pulls operational machine configurations, including kernel type, operating system version, processor architecture, and host network identity node parameters.  
+  *Syntax:* `SystemInfo`
+* **`Encrypt [filename]`**  
+  Recursively strips newline markers, processes file lines through a proprietary substitution cipher dictionary matrix, and overwrites with the scrambled hash text payload.  
+  *Syntax:* `Encrypt secrets.txt`
+* **`Decrypt [filename]`**  
+  Reverses encrypted files back into natural readable text using an advanced forward lookup character window scanner module.  
+  *Syntax:* `Decrypt secrets.txt`
+
+---
+
+## 🛠️ Example Automation Script (`main.nxs`)
+
+```text
+# Boot diagnostic evaluation sequences
+SystemInfo
+Wait 1
+
+# Manage backup files
+Create telemetry.txt
+Write telemetry.txt "NEXUS Automation Runtime"
+MuteWrite telemetry.txt NewLine "LPU Industrial Passed First Year Assessment"
+SizeOf kb telemetry.txt
+
+# Run background applications and secure records
+Run notepad.exe
+Encrypt telemetry.txt
+Speak "Process framework executed cleanly"
+Notify "NEXUS" "Automation routine finished."
+```

nexus_dsl-1.0.0/README.md

@@ -0,0 +1,147 @@
+# NEXUS: A Custom Domain-Specific Scripting Language (DSL)
+
+NEXUS is an elegant, cross-platform, domain-specific scripting language engineered entirely in Python. It abstracts complex localized operating system tasks, directory architectures, cryptographic transformations, and core machine telemetry workflows into a highly readable, human-centric syntax layout [Example 4].
+
+Developed as a breakthrough milestone during the First-Year Passed Industrial Training curriculum at Lovely Professional University (LPU), Jalandhar, this framework implements a modular token parsing architecture that lets you automate system scripts natively.
+
+---
+
+## 🚀 Installation & Setup
+
+Install the stable release of the NEXUS engine directly from PyPI using `pip`:
+
+```bash
+pip install nexus-dsl
+```
+
+*(Note: If the name 'nexus' is already reserved on PyPI, it is standard convention to register it as `nexus-dsl` or `nexus-runtime` while keeping the package import name as `nexus`.)*
+
+### External Dependencies
+NEXUS requires a few lightweight libraries to power its native notification toaster and hardware audio modules:
+```bash
+pip install colorama plyer pyttsx3
+```
+
+---
+
+## 💻 Python Integration API
+
+You can easily load and run `.nxs` automation scripts straight from your standard Python files.
+
+```python
+from nexus import nexus
+
+# Simply pass the path of your .nxs script file to the core execution engine
+nexus.nexus("main.nxs")
+```
+
+---
+
+## 📖 Keyword Reference Manual & Syntax Specs
+
+NEXUS statement expressions read line-by-line. Comments must begin with a `#` token. Any multi-word string parameters containing spaces must be cleanly wrapped inside double quotes (`"..."`).
+
+### 1. Console Operations & Core Logging
+* **`Show [string]`**  
+  Strips enclosing quote markers and prints clean string characters directly onto the active console view.  
+  *Syntax:* `Show "Hello, World!"`
+* **`Wait [seconds]`**  
+  Pauses the script execution stream for an integer or floating-point timeline duration. Generates a high-contrast red error message if the parameter value is non-numeric.  
+  *Syntax:* `Wait 1.5`
+* **`Speak [string]`**  
+  Hooks directly into your machine's hardware sound drivers to speak a line of text out loud natively using offline speech synthesis.  
+  *Syntax:* `Speak "Automation sequence initiated"`
+* **`Notify "[Title]" "[Message]"`**  
+  Uses a token slice delimiter to push a real, native desktop notification toast banner into the system screen space. Requires both parameters to be wrapped in double quotes.  
+  *Syntax:* `Notify "NEXUS Core" "Task Completed Successfully"`
+
+### 2. File & Storage Operations
+* **`Create [filename]`**  
+  Safely generates an empty file inside your active working workspace folder if it doesn't already exist.  
+  *Syntax:* `Create log.txt`
+* **`Write [filename] [string]`**  
+  Completely overwrites a file with a fresh text payload, wiping any trailing historical characters out of the file buffer.  
+  *Syntax:* `Write log.txt "Initial Payload"`
+* **`MuteWrite [filename] [Line / NewLine] [string]`**  
+  Appends text data onto the end of a file. Use `Line` to paste characters on the active row, or `NewLine` to prefix a line break.  
+  *Syntax:* `MuteWrite log.txt NewLine "Appended system note."`
+* **`Truncate [filename]`**  
+  Instantly clears and zeroes out all data content inside a document without dropping the file pointer from your storage.  
+  *Syntax:* `Truncate log.txt`
+* **`Delete [filename]`**  
+  Hard-drops and permanently removes a targeted file path from your computer disk storage.  
+  *Syntax:* `Delete obsolete.txt`
+* **`Rename [old_filename] [new_filename]`**  
+  Modifies the naming characteristics of a target file path in-place.  
+  *Syntax:* `Rename records.txt old_records.txt`
+* **`Copy [source_path] [destination_path]`**  
+  Clones a localized file into a fresh directory lane safely.  
+  *Syntax:* `Copy data.txt backup_data.txt`
+* **`Move [filename] [directory_folder]`**  
+  Relocates an asset file out of your active workspace directory and paths it into a target folder directory.  
+  *Syntax:* `Move log.txt BackupsFolder`
+* **`SizeOf [unit] [filename]`**  
+  Uses pattern matching (`match-case`) to convert file weights into human-readable scales including `bytes`, `kb`, `mb`, `gb`, `tb`, `pb`, and `eb`.  
+  *Syntax:* `SizeOf mb archive.zip`
+* **`Backup [filename]`**  
+  Creates an automated timestamped duplicate copy of the target file for recovery purposes (e.g., `data_20260616_161022.txt`).  
+  *Syntax:* `Backup data.txt`
+
+### 3. Directory Management
+* **`MakeDir [base_directory] [new_folder_name]`**  
+  Joins variables securely to deploy a new nested workspace directory folder.  
+  *Syntax:* `MakeDir . "BackupsFolder"`
+* **`DelDir [directory_path]`**  
+  Flashes an engine warning prompt asking for explicit terminal confirmation (`yes/no`) before wiping a directory.  
+  *Syntax:* `DelDir BackupsFolder`
+
+### 4. Application Control & Cryptography
+* **`Run [executable.exe]`**  
+  Asynchronously spawns independent system application processes (like `notepad.exe`) without freezing your main interpreter loop.  
+  *Syntax:* `Run notepad.exe`
+* **`Open [filename]`**  
+  Launches a text document natively inside the operating system's standard text editor (Notepad).  
+  *Syntax:* `Open hello.txt`
+* **`Browse [URL]`**  
+  Triggers your default web browser tool to spin open and target a live web URL natively.  
+  *Syntax:* `Browse https://lpu.in`
+* **`Progress [seconds]`**  
+  Renders an active graphical loading progress tracking bar loop (`[██████░░░░]`) directly across the terminal row workspace console over X seconds.  
+  *Syntax:* `Progress 5`
+* **`Compress [folder_or_file_path]`**  
+  Packages an independent text file or an entire nested directory workspace into a compressed binary `.zip` archive payload.  
+  *Syntax:* `Compress "MyProjectFolder"`
+* **`Extract [source_archive.zip] [destination_folder]`**  
+  Extracts compressed zip archives directly into a targeted folder destination directory path.  
+  *Syntax:* `Extract archive.zip ExtractedFiles`
+* **`SystemInfo`**  
+  Pulls operational machine configurations, including kernel type, operating system version, processor architecture, and host network identity node parameters.  
+  *Syntax:* `SystemInfo`
+* **`Encrypt [filename]`**  
+  Recursively strips newline markers, processes file lines through a proprietary substitution cipher dictionary matrix, and overwrites with the scrambled hash text payload.  
+  *Syntax:* `Encrypt secrets.txt`
+* **`Decrypt [filename]`**  
+  Reverses encrypted files back into natural readable text using an advanced forward lookup character window scanner module.  
+  *Syntax:* `Decrypt secrets.txt`
+
+---
+
+## 🛠️ Example Automation Script (`main.nxs`)
+
+```text
+# Boot diagnostic evaluation sequences
+SystemInfo
+Wait 1
+
+# Manage backup files
+Create telemetry.txt
+Write telemetry.txt "NEXUS Automation Runtime"
+MuteWrite telemetry.txt NewLine "LPU Industrial Passed First Year Assessment"
+SizeOf kb telemetry.txt
+
+# Run background applications and secure records
+Run notepad.exe
+Encrypt telemetry.txt
+Speak "Process framework executed cleanly"
+Notify "NEXUS" "Automation routine finished."
+```

nexus_dsl-1.0.0/nexus/function_executors.py

@@ -0,0 +1,217 @@
+import os
+import sys
+import subprocess
+import time
+import shutil
+import platform
+import zipfile
+import webbrowser
+import pyttsx3
+from colorama import Fore, init
+from plyer import notification
+from datetime import datetime
+from pathlib import Path
+
+engine = pyttsx3.init()
+engine.setProperty("rate", 150)
+
+init(autoreset=True)
+
+def check_if_file_exists(FILE_NAME):
+    if not os.path.exists(FILE_NAME):
+        print(Fore.RED + "FileNotFound Error: ", end = "")
+        print(f"Designated file: ", end = "")
+        print(Fore.GREEN + f"\"{FILE_NAME}\"", end = "")
+        print(" not found in the mentioned directory", end = "")
+        sys.exit()
+        
+def check_if_dir_exists(dir):
+    folder = Path(dir)
+    if not folder.is_dir():
+        print(Fore.RED + "DirectoryNotFound Error: ", end = "")
+        print(f"Designated directory: ", end = "")
+        print(Fore.GREEN + f"\"{dir}\"", end = "")
+        print(" not found")
+        sys.exit()
+
+def show(li: list | str):
+    if type(li)==list:
+        st = " ".join(li)
+        print(st)
+    else:
+        print(li)
+        
+def create(FILE_NAME: str):
+    if not os.path.exists(FILE_NAME):
+        with open(FILE_NAME, "w") as file:
+            pass
+    
+def write(FILE_NAME:str, text: str):
+    check_if_file_exists(FILE_NAME)
+        
+    file = open(FILE_NAME, "w")
+    file.write(text)
+    
+def open_file(FILE_NAME: str):
+    check_if_file_exists(FILE_NAME)
+    subprocess.Popen(['notepad.exe', FILE_NAME])
+    
+def delete(FILE_NAME: str):
+    check_if_file_exists(FILE_NAME)
+    os.remove(FILE_NAME)
+    
+def wait(time_d: int | float):
+    time.sleep(time_d)
+    
+def MuteWrite(FILE_NAME: str, text: str):
+    check_if_file_exists(FILE_NAME)
+    file = open(FILE_NAME, "a")
+    file.write(text)
+    
+def rename(FILE_NAME: str, FILE_NAME2: str):
+    check_if_file_exists(FILE_NAME)
+    os.rename(FILE_NAME, FILE_NAME2)
+    
+def copy(FILE_NAME: str, FILE_NAME2: str):
+    check_if_file_exists(FILE_NAME)
+    if not os.path.exists(FILE_NAME2):
+        shutil.copy(FILE_NAME, FILE_NAME2)
+    else:
+        print(Fore.RED + f"File with name {FILE_NAME2} already exists")
+        
+def run(Application_name: str):
+    try:
+        subprocess.run(Application_name, shell=True, check=True)
+    except Exception as e:
+        print(Fore.RED + f"Error while running the application: \"{Application_name}\"")
+        print(Fore.YELLOW + f"[OS Debug Details]: {e}")
+        
+def system_info():
+    print(f"OS Platform: {platform.system()}")
+    print(f"Kernel: {sys.platform}")
+    print(f"Architecture: {platform.architecture()}")
+    print(f"Release: {platform.release()}")
+    print(f"Version: {platform.version()}")
+    print(f"Processor: {platform.processor()}")
+    print(f"Machine: {platform.machine()}")
+    print(f"Connected Network: {platform.node()}")
+    
+def notify_(title: str, text: str):
+    notification.notify(
+        title = title,
+        message = text,
+        app_name = "AURA",
+        timeout = 5        
+    )
+    
+def browse(url: str):
+    webbrowser.open(url)
+    
+def backup(FILE_NAME: str):
+    check_if_file_exists(FILE_NAME)
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    name, ext = os.path.splitext(FILE_NAME)
+    backup_name = f"{name}_{timestamp}{ext}"
+    
+    copy(FILE_NAME, backup_name)
+    
+def speak(text: str):
+    engine.say(text)
+    engine.runAndWait()
+    
+def make_dir(dir: str, folder_name: str):
+    check_if_dir_exists(dir)
+    path = os.path.join(dir, folder_name)
+    os.makedirs(path, exist_ok=True)
+    
+def rem_dir(dir: str):
+    check_if_dir_exists(dir)
+    print(Fore.YELLOW + "Deleting folder will permanently erase all the data inside it!")
+    choice = input("Do you want to continue?(yes/no): ").lower()
+    if choice == "yes" or choice == "y":
+        shutil.rmtree(dir)
+    elif choice == "no" or choice =="n":
+        pass
+    else:
+        print(Fore.RED + f"Unknown command entered: {choice}, aborting deletion process")
+        
+def calc_size(FILE_NAME: str, unit: str):
+    check_if_file_exists(FILE_NAME)
+    bytes_ = os.path.getsize(FILE_NAME)
+    kb = round(bytes_/1024, 2)
+    mb = round(kb/1024, 2)
+    gb = round(mb/1024, 2)
+    tb = round(gb/1024, 2)
+    pb = round(tb/1024, 2)
+    eb = round(pb/1024, 2)
+    match(unit):
+            case "bytes":
+                print(f"Memory storage of file {FILE_NAME} is {bytes_} bytes")
+            case "kb":
+                print(f"Memory storage of file {FILE_NAME} is {kb} kb")
+            case "mb":
+                print(f"Memory storage of file {FILE_NAME} is {mb} mb")
+            case "gb":
+                print(f"Memory storage of file {FILE_NAME} is {gb} gb")
+            case "tb":
+                print(f"Memory storage of file {FILE_NAME} is {tb} tb")
+            case "pb":
+                print(f"Memory storage of file {FILE_NAME} is {pb} pb")
+            case "eb":
+                print(f"Memory storage of file {FILE_NAME} is {eb} eb")
+                
+def draw_progress(seconds: str | float):
+    total_time = float(seconds)
+    steps = 20
+    delay = total_time / steps
+    for i in range(steps + 1):
+        percent = int((i / steps) * 100)
+        bar = "█" * i + "░" * (steps - i)
+        sys.stdout.write(f"\r[{bar}] {percent}% Complete")
+        sys.stdout.flush()
+        time.sleep(delay)
+    print()
+
+def truncate(FILE_NAME):
+    check_if_file_exists(FILE_NAME)
+    with open(FILE_NAME, "w") as file:
+        file.write("")
+        
+def move(FILE_NAME: str, dir: str):
+    check_if_file_exists(FILE_NAME)
+    check_if_dir_exists(dir)
+    shutil.move(FILE_NAME, dir)
+    
+import zipfile
+
+def zip_unzip(Name: str | list, task: str):
+    if task == "zip":
+        check_if_file_exists(Name)
+            
+        path = Path(Name)
+        
+        if path.is_dir():
+            parent_dir = path.parent
+            folder_name = path.name
+            output_zip = parent_dir / folder_name
+            shutil.make_archive(
+                base_name=str(output_zip), 
+                format='zip', 
+                root_dir=str(parent_dir), 
+                base_dir=folder_name
+            )
+            
+        else:
+            zip_name = f"{path.stem}.zip"
+            with zipfile.ZipFile(zip_name, 'w', zipfile.ZIP_DEFLATED) as zipf:
+                zipf.write(Name, arcname=path.name)
+
+    elif task == "unzip":
+        check_if_file_exists(Name[0])
+            
+        check_if_dir_exists(Name[1])
+        archive = Path(Name[0])
+        target = Path(Name[1])
+        
+        with zipfile.ZipFile(archive, 'r') as zip_ref:
+            zip_ref.extractall(target)

nexus_dsl-1.0.0/nexus/function_passer.py

@@ -0,0 +1,178 @@
+from . import function_executors as fe
+from . import hash
+
+LANGUAGE_NAME = "AURA"
+
+def clean_quotes(text: str) -> str:
+    if text.startswith('"') and text.endswith('"'):
+        return text[1:-1]
+    return text
+
+def execute(list_of_commands: list):
+    li: list = list_of_commands
+    if "#" in li[0]:
+        pass
+    elif li[0]=="Show":
+        string = " ".join(li[1:len(li)])
+        string = clean_quotes(string)
+        fe.show(string)
+    
+    elif li[0]=="Create":
+        fe.create(li[1])
+        
+    elif li[0]=="Write":
+        string = " ".join(li[2:len(li)])
+        string = clean_quotes(string)
+        fe.write(str(li[1]), string)
+        
+    elif li[0]=="Open":
+        fe.open_file(li[1])
+        
+    elif li[0]=="Delete":
+        fe.delete(li[1])
+        
+    elif li[0]=="Wait":
+        try:
+            fe.wait(float(li[1]))
+        except ValueError:
+            print(fe.Fore.RED + "Given value is not an number for function wait")
+            fe.sys.exit()
+            
+    elif li[0]=="MuteWrite":
+            
+        if li[2]=="Line":
+            string = " ".join(li[3:len(li)])
+            string = clean_quotes(string)
+            fe.MuteWrite(li[1], string)
+            
+        elif li[2]=="NewLine":
+            string = " ".join(li[3:len(li)])
+            string = clean_quotes(string)
+            fe.MuteWrite(li[1], f"\n{string}")
+            
+        else:
+            print(fe.Fore.RED + f"Expected an argument after file name {li[1]}")
+            fe.sys.exit()
+            
+    elif li[0]=="Rename":
+        fe.rename(li[1], li[2])
+        
+    elif li[0]=="Copy":
+        fe.copy(li[1], li[2])
+        
+    elif li[0]=="Run":
+        fe.run(li[1])
+        
+    elif li[0]=="SystemInfo":
+        fe.system_info()
+        
+    elif li[0] == "Notify":
+        full_arguments = " ".join(li[1:len(li)])
+        
+        quote_indices = [index for index, char in enumerate(full_arguments) if char == '"']
+        
+        if len(quote_indices) == 4:
+            title = full_arguments[quote_indices[0] + 1 : quote_indices[1]]
+            message = full_arguments[quote_indices[2] + 1 : quote_indices[3]]
+            
+            fe.notify_(title, message)
+        else:
+            print(fe.Fore.RED + 'Syntax Error: Notify requires "Title" and "Message" wrapped in double quotes.')
+            fe.sys.exit()
+            
+    elif li[0] == "Browse":
+        fe.browse(li[1])
+        
+    elif li[0] == "Encrypt":
+        FILE_NAME = li[1]
+        fe.check_if_file_exists(FILE_NAME)
+        file = open(FILE_NAME, "r")
+        file1_list = FILE_NAME.split(".")
+        file1_list[0] = f"{file1_list[0]}2"
+        FILE_NAME2 = ".".join(file1_list)
+        
+        is_first_line = True
+        
+        with open(FILE_NAME2, "a") as file2:
+            for line in file:
+                line = line.replace("\n", "")
+                
+                if is_first_line:
+                    execute(["MuteWrite", FILE_NAME2, "Line", hash.hash(line)])
+                    is_first_line = False
+                else:
+                    execute(["MuteWrite", FILE_NAME2, "NewLine", hash.hash(line)])
+                
+        file.close()
+                    
+        execute(["Delete", FILE_NAME])
+        execute(["Rename", FILE_NAME2, FILE_NAME])
+
+        
+    elif li[0] == "Decrypt":
+        FILE_NAME = li[1]
+        fe.check_if_file_exists(FILE_NAME)
+        file = open(FILE_NAME, "r")
+        file1_list = FILE_NAME.split(".")
+        file1_list[0] = f"{file1_list[0]}2"
+        FILE_NAME2 = ".".join(file1_list)
+        
+        is_first_line = True
+        
+        with open(FILE_NAME2, "a") as file2:
+            for line in file:
+                line = line.replace("\n", "")
+                
+                if is_first_line:
+                    execute(["MuteWrite", FILE_NAME2, "Line", hash.hash(line, "dehash")])
+                    is_first_line = False
+                else:
+                    execute(["MuteWrite", FILE_NAME2, "NewLine", hash.hash(line, "dehash")])
+                
+        file.close()
+                    
+        execute(["Delete", FILE_NAME])
+        execute(["Rename", FILE_NAME2, FILE_NAME])
+
+        
+    elif li[0] == "Backup":
+        fe.backup(li[1])
+        
+    elif li[0] == "Speak":
+        string = " ".join(li[1:len(li)])
+        string = clean_quotes(string)
+        fe.speak(string)
+        
+    elif li[0] == "MakeDir":
+        fe.make_dir(li[1], li[2])
+        
+    elif li[0] == "DelDir":
+        if len(li) < 2:
+            print(fe.Fore.RED + "Syntax Error: DelDir requires a folder path parameter.")
+            fe.sys.exit()
+        fe.rem_dir(li[1])
+        
+    elif li[0] == "SizeOf":
+        fe.calc_size(li[2], li[1])
+        
+    elif li[0] == "Progress":
+        fe.draw_progress(li[1])
+        
+    elif li[0] == "Truncate":
+        fe.truncate(li[1])
+        
+    elif li[0] == "Move":
+        fe.move(li[1], li[2])
+        
+    elif li[0] == "Compress":
+        fe.zip_unzip(li[1], "zip")
+        
+    elif li[0] == "Extract":
+        fe.zip_unzip(li[1:3], "unzip")
+        
+    else:
+        print(fe.Fore.RED + f"Command ", end = "")
+        print(fe.Fore.MAGENTA + f"{li[0]}", end = "")
+        print(fe.Fore.RED + f" is not recognized as an internal or external command for the language", end = "")
+        print(fe.Fore.GREEN + f" {LANGUAGE_NAME}", end = "")
+        fe.sys.exit()

nexus_dsl-1.0.0/nexus/hash.py

@@ -0,0 +1,137 @@
+def hash(pw: str, hash_or_dehash: str = "hash") -> str:
+    default = {
+        ' ': "so48oz4igl",
+        '!': "cqp2bepgf",
+        '"': "6c31mk7ya1",
+        '#': "um9axgoy",
+        '$': "oo1z3dsz",
+        '%': "djetbm7els",
+        '&': "ll4vm8dl",
+        "'": "b3yc8g9j",
+        '(': "bg36gdd5bx",
+        ')': "ph1wirauz",
+        '*': "61a57ig7",
+        '+': "d2hw35n1",
+        ',': "pqks18l82n8",
+        '-': "xs9t9fzkmifw",
+        '.': "92qr5qfcs",
+        '/': "ianmknjsmsc",
+        '0': "4dw03kn541j",
+        '1': "scuiftsfsp",
+        '2': "aas1pwbx3",
+        '3': "tv4ltnwctc1",
+        '4': "fq1ilqiam9",
+        '5': "slo0v6vp0q",
+        '6': "h5yo2v70nu",
+        '7': "yub08e2w",
+        '8': "yfe5gtfs01xv",
+        '9': "rfq7srqcocs",
+        ':': "qo318v3zz",
+        ';': "dlazora1",
+        '<': "vy6lhq5y",
+        '=': "d507m414",
+        '>': "aqglfsk84",
+        '?': "b4rcvgil",
+        '@': "sg8m72f0bo",
+        'A': "cjdn0ga9",
+        'B': "gk2ba6vnh20",
+        'C': "eado9oi2y72",
+        'D': "gezn677xc",
+        'E': "ukarhuug",
+        'F': "iwje65vvza2p",
+        'G': "xz2442vkcdlk",
+        'H': "wiluw5ihsnnf",
+        'I': "5rodt3kw5g75",
+        'J': "6e5lgaps91i",
+        'K': "al4wlffp9",
+        'L': "puprq2gi",
+        'M': "52ywdv7ya948",
+        'N': "9skjt5m7w",
+        'O': "yxwe9ohi795l",
+        'P': "znrdsp60wr2a",
+        'Q': "okhf097ec",
+        'R': "eenm9r8n4ubk",
+        'S': "dj41hglrbp2",
+        'T': "ykb9lpk9k3",
+        'U': "qcu9e3tk7m",
+        'V': "k8d0hw03spaa",
+        'W': "nw7hp6g8",
+        'X': "8tl6yw08",
+        'Y': "d5bars9r",
+        'Z': "p9oznvvli8l",
+        '[': "01ycuakh8t9n",
+        '\\': "ppybqq9vvk",
+        ']': "0qht72y9yt",
+        '^': "me09ur5r",
+        '_': "t0uufklgauh",
+        '`': "gozq6or4n2",
+        'a': "ejx7jl1c23",
+        'b': "k0f6w3nkk80v",
+        'c': "9eltrwl6cje",
+        'd': "3cbfep0f2",
+        'e': "mvtesakcs",
+        'f': "e0qwgp3aml",
+        'g': "sux7tcww0uy2",
+        'h': "x6tnhlas5",
+        'i': "wcq0vme6o",
+        'j': "y4xx0nwah37l",
+        'k': "91icof91",
+        'l': "p128g8tfxj",
+        'm': "iqdntlynt9e9",
+        'n': "h6ernlqdvm",
+        'o': "95r3o7hkzjfb",
+        'p': "39wao8wz",
+        'q': "490pkeji1w",
+        'r': "bn6f6n0n",
+        's': "r7qvsssww0j",
+        't': "0vgi054zxl",
+        'u': "33cvw1kpfpa",
+        'v': "kv6ollgkui5e",
+        'w': "3vijck0s",
+        'x': "gy0ry24j9k",
+        'y': "sg2ussnoqi",
+        'z': "za6vzho263",
+        '{': "nso7ciav8",
+        '|': "fy9kjp5bgkk",
+        '}': "slg03rqso",
+        '~': "qh1qndxi0"
+    }
+    
+    if hash_or_dehash == "hash":
+        pwlist = list(pw)
+        new_list = []
+        i = 0
+        while i < len(pwlist):
+            char = pwlist[i]
+            if char in default:
+                new_list.append(default[char])
+            else:
+                new_list.append(char)
+            i += 1
+        return "".join(new_list)
+
+    elif hash_or_dehash == "dehash":
+        reverse_map = {value: key for key, value in default.items()}
+        
+        decoded_chars = []
+        index = 0
+        text_length = len(pw)
+        
+        while index < text_length:
+            matched = False
+            
+            for chunk_size in range(15, 0, -1):
+                if index + chunk_size <= text_length:
+                    substring_probe = pw[index : index + chunk_size]
+                    
+                    if substring_probe in reverse_map:
+                        decoded_chars.append(reverse_map[substring_probe])
+                        index += chunk_size
+                        matched = True
+                        break
+            
+            if not matched:
+                decoded_chars.append(pw[index])
+                index += 1
+                
+        return "".join(decoded_chars)

nexus_dsl-1.0.0/nexus/nexus.py

@@ -0,0 +1,28 @@
+import os
+from colorama import Fore, init
+import sys
+from . import function_passer as fp
+
+init(autoreset=True)
+
+def nexus(FILE_NAME: str):
+    if not os.path.exists(FILE_NAME):
+        print(Fore.RED + "FileNotFound Error: ", end = "")
+        print("Designated file: ", end = "")
+        print(Fore.GREEN + f"\"{FILE_NAME}\"", end = "")
+        print(" not found in the mentioned directory", end = "")
+        sys.exit()
+        
+    if not FILE_NAME.endswith(".nxs"):
+        print(Fore.RED + "Invalid FileType!")
+        sys.exit()    
+
+    file = open(FILE_NAME, "r+")
+
+    for Line in file:
+        line_list = Line.split()
+        if not line_list:
+            continue
+        fp.execute(line_list)
+        
+    file.close()

nexus_dsl-1.0.0/nexus_dsl.egg-info/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: nexus-dsl
+Version: 1.0.0
+Summary: NEXUS: A Custom Domain-Specific Scripting Language (DSL) for local automation
+Author-email: Yuvneil <yuvneiledu44@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: plyer>=2.1.0
+Requires-Dist: pyttsx3>=2.90
+
+# NEXUS: A Custom Domain-Specific Scripting Language (DSL)
+
+NEXUS is an elegant, cross-platform, domain-specific scripting language engineered entirely in Python. It abstracts complex localized operating system tasks, directory architectures, cryptographic transformations, and core machine telemetry workflows into a highly readable, human-centric syntax layout [Example 4].
+
+Developed as a breakthrough milestone during the First-Year Passed Industrial Training curriculum at Lovely Professional University (LPU), Jalandhar, this framework implements a modular token parsing architecture that lets you automate system scripts natively.
+
+---
+
+## 🚀 Installation & Setup
+
+Install the stable release of the NEXUS engine directly from PyPI using `pip`:
+
+```bash
+pip install nexus-dsl
+```
+
+*(Note: If the name 'nexus' is already reserved on PyPI, it is standard convention to register it as `nexus-dsl` or `nexus-runtime` while keeping the package import name as `nexus`.)*
+
+### External Dependencies
+NEXUS requires a few lightweight libraries to power its native notification toaster and hardware audio modules:
+```bash
+pip install colorama plyer pyttsx3
+```
+
+---
+
+## 💻 Python Integration API
+
+You can easily load and run `.nxs` automation scripts straight from your standard Python files.
+
+```python
+from nexus import nexus
+
+# Simply pass the path of your .nxs script file to the core execution engine
+nexus.nexus("main.nxs")
+```
+
+---
+
+## 📖 Keyword Reference Manual & Syntax Specs
+
+NEXUS statement expressions read line-by-line. Comments must begin with a `#` token. Any multi-word string parameters containing spaces must be cleanly wrapped inside double quotes (`"..."`).
+
+### 1. Console Operations & Core Logging
+* **`Show [string]`**  
+  Strips enclosing quote markers and prints clean string characters directly onto the active console view.  
+  *Syntax:* `Show "Hello, World!"`
+* **`Wait [seconds]`**  
+  Pauses the script execution stream for an integer or floating-point timeline duration. Generates a high-contrast red error message if the parameter value is non-numeric.  
+  *Syntax:* `Wait 1.5`
+* **`Speak [string]`**  
+  Hooks directly into your machine's hardware sound drivers to speak a line of text out loud natively using offline speech synthesis.  
+  *Syntax:* `Speak "Automation sequence initiated"`
+* **`Notify "[Title]" "[Message]"`**  
+  Uses a token slice delimiter to push a real, native desktop notification toast banner into the system screen space. Requires both parameters to be wrapped in double quotes.  
+  *Syntax:* `Notify "NEXUS Core" "Task Completed Successfully"`
+
+### 2. File & Storage Operations
+* **`Create [filename]`**  
+  Safely generates an empty file inside your active working workspace folder if it doesn't already exist.  
+  *Syntax:* `Create log.txt`
+* **`Write [filename] [string]`**  
+  Completely overwrites a file with a fresh text payload, wiping any trailing historical characters out of the file buffer.  
+  *Syntax:* `Write log.txt "Initial Payload"`
+* **`MuteWrite [filename] [Line / NewLine] [string]`**  
+  Appends text data onto the end of a file. Use `Line` to paste characters on the active row, or `NewLine` to prefix a line break.  
+  *Syntax:* `MuteWrite log.txt NewLine "Appended system note."`
+* **`Truncate [filename]`**  
+  Instantly clears and zeroes out all data content inside a document without dropping the file pointer from your storage.  
+  *Syntax:* `Truncate log.txt`
+* **`Delete [filename]`**  
+  Hard-drops and permanently removes a targeted file path from your computer disk storage.  
+  *Syntax:* `Delete obsolete.txt`
+* **`Rename [old_filename] [new_filename]`**  
+  Modifies the naming characteristics of a target file path in-place.  
+  *Syntax:* `Rename records.txt old_records.txt`
+* **`Copy [source_path] [destination_path]`**  
+  Clones a localized file into a fresh directory lane safely.  
+  *Syntax:* `Copy data.txt backup_data.txt`
+* **`Move [filename] [directory_folder]`**  
+  Relocates an asset file out of your active workspace directory and paths it into a target folder directory.  
+  *Syntax:* `Move log.txt BackupsFolder`
+* **`SizeOf [unit] [filename]`**  
+  Uses pattern matching (`match-case`) to convert file weights into human-readable scales including `bytes`, `kb`, `mb`, `gb`, `tb`, `pb`, and `eb`.  
+  *Syntax:* `SizeOf mb archive.zip`
+* **`Backup [filename]`**  
+  Creates an automated timestamped duplicate copy of the target file for recovery purposes (e.g., `data_20260616_161022.txt`).  
+  *Syntax:* `Backup data.txt`
+
+### 3. Directory Management
+* **`MakeDir [base_directory] [new_folder_name]`**  
+  Joins variables securely to deploy a new nested workspace directory folder.  
+  *Syntax:* `MakeDir . "BackupsFolder"`
+* **`DelDir [directory_path]`**  
+  Flashes an engine warning prompt asking for explicit terminal confirmation (`yes/no`) before wiping a directory.  
+  *Syntax:* `DelDir BackupsFolder`
+
+### 4. Application Control & Cryptography
+* **`Run [executable.exe]`**  
+  Asynchronously spawns independent system application processes (like `notepad.exe`) without freezing your main interpreter loop.  
+  *Syntax:* `Run notepad.exe`
+* **`Open [filename]`**  
+  Launches a text document natively inside the operating system's standard text editor (Notepad).  
+  *Syntax:* `Open hello.txt`
+* **`Browse [URL]`**  
+  Triggers your default web browser tool to spin open and target a live web URL natively.  
+  *Syntax:* `Browse https://lpu.in`
+* **`Progress [seconds]`**  
+  Renders an active graphical loading progress tracking bar loop (`[██████░░░░]`) directly across the terminal row workspace console over X seconds.  
+  *Syntax:* `Progress 5`
+* **`Compress [folder_or_file_path]`**  
+  Packages an independent text file or an entire nested directory workspace into a compressed binary `.zip` archive payload.  
+  *Syntax:* `Compress "MyProjectFolder"`
+* **`Extract [source_archive.zip] [destination_folder]`**  
+  Extracts compressed zip archives directly into a targeted folder destination directory path.  
+  *Syntax:* `Extract archive.zip ExtractedFiles`
+* **`SystemInfo`**  
+  Pulls operational machine configurations, including kernel type, operating system version, processor architecture, and host network identity node parameters.  
+  *Syntax:* `SystemInfo`
+* **`Encrypt [filename]`**  
+  Recursively strips newline markers, processes file lines through a proprietary substitution cipher dictionary matrix, and overwrites with the scrambled hash text payload.  
+  *Syntax:* `Encrypt secrets.txt`
+* **`Decrypt [filename]`**  
+  Reverses encrypted files back into natural readable text using an advanced forward lookup character window scanner module.  
+  *Syntax:* `Decrypt secrets.txt`
+
+---
+
+## 🛠️ Example Automation Script (`main.nxs`)
+
+```text
+# Boot diagnostic evaluation sequences
+SystemInfo
+Wait 1
+
+# Manage backup files
+Create telemetry.txt
+Write telemetry.txt "NEXUS Automation Runtime"
+MuteWrite telemetry.txt NewLine "LPU Industrial Passed First Year Assessment"
+SizeOf kb telemetry.txt
+
+# Run background applications and secure records
+Run notepad.exe
+Encrypt telemetry.txt
+Speak "Process framework executed cleanly"
+Notify "NEXUS" "Automation routine finished."
+```

nexus_dsl-1.0.0/nexus_dsl.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+nexus/__init__.py
+nexus/function_executors.py
+nexus/function_passer.py
+nexus/hash.py
+nexus/nexus.py
+nexus_dsl.egg-info/PKG-INFO
+nexus_dsl.egg-info/SOURCES.txt
+nexus_dsl.egg-info/dependency_links.txt
+nexus_dsl.egg-info/requires.txt
+nexus_dsl.egg-info/top_level.txt

nexus_dsl-1.0.0/nexus_dsl.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nexus_dsl-1.0.0/nexus_dsl.egg-info/requires.txt

@@ -0,0 +1,3 @@
+colorama>=0.4.6
+plyer>=2.1.0
+pyttsx3>=2.90

nexus_dsl-1.0.0/nexus_dsl.egg-info/top_level.txt

@@ -0,0 +1 @@
+nexus

nexus_dsl-1.0.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nexus-dsl"  # The unique download name registered on PyPI
+version = "1.0.0"
+authors = [
+    { name="Yuvneil", email="yuvneiledu44@gmail.com" }
+]
+description = "NEXUS: A Custom Domain-Specific Scripting Language (DSL) for local automation"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+]
+
+# AUTOMATIC DEPENDENCY RESOLUTION:
+# When users run pip install, these modules download automatically first!
+dependencies = [
+    "colorama>=0.4.6",
+    "plyer>=2.1.0",
+    "pyttsx3>=2.90"
+]

nexus_dsl-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+