remoterf 0.0.7.27__tar.gz

remoterf-0.0.7.27/LICENSE

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

remoterf-0.0.7.27/MANIFEST.in

@@ -0,0 +1,2 @@
+# Include all .crt, .key, and .pem files
+recursive-include src/remoteRF *.crt *.key *.pem

remoterf-0.0.7.27/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.1
+Name: remoterf
+Version: 0.0.7.27
+Summary: A python API to remotely access signal centric hardware. Client-side only!
+Author: Ethan Ge
+Author-email: ethoGalaxy@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio==1.71.0
+Requires-Dist: protobuf
+Requires-Dist: numpy
+Requires-Dist: prompt_toolkit
+Requires-Dist: python-dotenv
+
+# Remote RF
+
+A python API to remotely access signal centric hardware. 
+
+Courtesy of Wireless Lab @ UCLA. - Ethan Ge
+
+## Prerequisites
+
+- **Python 3.10**: This package works in Python 3.10+. If you don’t have Python installed, you can download it from the [official Python website](https://www.python.org/downloads/).
+
+To check your current Python version, open a terminal and run:
+
+```bash
+python --version
+```
+
+- **UCLA VPN**: Please ensure that you are connected to the UCLA VPN. You can download and configure the VPN client from the following link: [UCLA VPN Client Download](https://www.it.ucla.edu/it-support-center/services/virtual-private-network-vpn-clients). If you’re not connected to the VPN, you will not have access to the lab servers.
+
+## Installation
+
+Use the package manager [pip](https://pip.pypa.io/en/stable/) to install remoteRF. It is recommended that you install this package within a [virtual environment](https://docs.python.org/3/library/venv.html).
+
+```bash
+python3 -m venv venv        # Create virtual environment
+source venv/bin/activate    # Activate virtual environment
+
+pip install remoteRF        # Install remoteRF
+```
+
+If `pip install` doesn't work, you can clone the [source](https://github.com/WirelessLabAtUCLA/RemoteRF-Client) directly from github.
+
+<!-- 1. **Clone the repository:**
+```bash
+git clone https://github.com/WirelessLabAtUCLA/RemoteRF-Client
+cd repository-name
+```
+2. **Install the package using** `pip` **in editable mode:**
+```bash
+pip install -e .
+```
+This command installs the package in "editable" mode, allowing for modifications to the local code without reinstalling. For more details on installing packages from local directories, refer to Python Packaging: [Installing from Local Archives](https://packaging.python.org/en/latest/tutorials/installing-packages/#installing-packages-from-local-archives). -->
+
+## Reservation
+
+Usage of the platform requires you to register a account and reserve a device in order to run scripts remotely. 
+
+### 1. **Start UCLA VPN**
+
+- Start the CISCO Secure client, login and connect to any of the options.
+
+### 2. **Register a account**:
+```bash
+remoterf-login  
+# Run in the terminal 
+# where the Python library is installed
+
+# Typically, this will be the terminal where you’ve activated the virtual environment if you’re using one
+```
+
+- Input `r` to register a account, or `l` to login to a existing one.
+
+<!-- 2. **You will be prompted with this**: -->
+```bash
+Welcome to Remote RF Account System.
+Please login or register to continue. (l/r):
+```
+
+- Once in, input `help` to see all avaliable commands.
+
+### 3. **Reserve Device**:
+```bash
+getdev  # To view all avaliable devices
+
+# Note the device ID. You will need this later to reserve said device
+```
+
+```bash
+getres  # To view times not avaliable
+
+# Optionally, you can also view all reservations, and determine a time slot you want a specific device reserved
+```
+```bash
+perms   # To view your permissions
+
+# Depending on your permission levels, you will be given different restrictions 
+```
+
+```bash
+resdev # To reserve a device
+
+# Input the number of days you want to view, and it will display available reservations in that time span.
+
+Reservation successful. Thy Token -> example_token
+
+# Take note of this token. You will need it to actually access the device.
+```
+
+## Remote Access
+
+With this token, you can now run scripts remotely. Please keep in mind that you MUST be connected to the UCLA VPN for this to work.
+Here is a explained sample script to get you going!
+
+#### Python Script:
+
+```python
+from remoteRF.drivers.adalm_pluto import *  # Imports device Pluto SDR remote drivers. Change depending on desired device.
+
+sdr = adi.Pluto(    # Device initialization.
+    token = 'example_token'     # Place the prior token here.
+)
+
+# You can now use this 'sdr' as you normally would with the default Pluto drivers.
+```
+
+If converting a existing `non-remoteRF` compatible script:
+
+```diff
+- import existing_device_drivers 
+
++ from remoteRF.drivers.device_drivers import *
+
+- device = device(init)
+
++ device = device(token = 'sample_token')
+```
+
+Nothing else needs changing! 
+
+## Closing
+
+This is fundamentally a experimental platform, and there will be many unknown bugs and issues. Some devices do not have universal support for all its functions at the moment, I am working on that aspect. 
+
+**So please submit feedback!**

remoterf-0.0.7.27/README.md

@@ -0,0 +1,133 @@
+# Remote RF
+
+A python API to remotely access signal centric hardware. 
+
+Courtesy of Wireless Lab @ UCLA. - Ethan Ge
+
+## Prerequisites
+
+- **Python 3.10**: This package works in Python 3.10+. If you don’t have Python installed, you can download it from the [official Python website](https://www.python.org/downloads/).
+
+To check your current Python version, open a terminal and run:
+
+```bash
+python --version
+```
+
+- **UCLA VPN**: Please ensure that you are connected to the UCLA VPN. You can download and configure the VPN client from the following link: [UCLA VPN Client Download](https://www.it.ucla.edu/it-support-center/services/virtual-private-network-vpn-clients). If you’re not connected to the VPN, you will not have access to the lab servers.
+
+## Installation
+
+Use the package manager [pip](https://pip.pypa.io/en/stable/) to install remoteRF. It is recommended that you install this package within a [virtual environment](https://docs.python.org/3/library/venv.html).
+
+```bash
+python3 -m venv venv        # Create virtual environment
+source venv/bin/activate    # Activate virtual environment
+
+pip install remoteRF        # Install remoteRF
+```
+
+If `pip install` doesn't work, you can clone the [source](https://github.com/WirelessLabAtUCLA/RemoteRF-Client) directly from github.
+
+<!-- 1. **Clone the repository:**
+```bash
+git clone https://github.com/WirelessLabAtUCLA/RemoteRF-Client
+cd repository-name
+```
+2. **Install the package using** `pip` **in editable mode:**
+```bash
+pip install -e .
+```
+This command installs the package in "editable" mode, allowing for modifications to the local code without reinstalling. For more details on installing packages from local directories, refer to Python Packaging: [Installing from Local Archives](https://packaging.python.org/en/latest/tutorials/installing-packages/#installing-packages-from-local-archives). -->
+
+## Reservation
+
+Usage of the platform requires you to register a account and reserve a device in order to run scripts remotely. 
+
+### 1. **Start UCLA VPN**
+
+- Start the CISCO Secure client, login and connect to any of the options.
+
+### 2. **Register a account**:
+```bash
+remoterf-login  
+# Run in the terminal 
+# where the Python library is installed
+
+# Typically, this will be the terminal where you’ve activated the virtual environment if you’re using one
+```
+
+- Input `r` to register a account, or `l` to login to a existing one.
+
+<!-- 2. **You will be prompted with this**: -->
+```bash
+Welcome to Remote RF Account System.
+Please login or register to continue. (l/r):
+```
+
+- Once in, input `help` to see all avaliable commands.
+
+### 3. **Reserve Device**:
+```bash
+getdev  # To view all avaliable devices
+
+# Note the device ID. You will need this later to reserve said device
+```
+
+```bash
+getres  # To view times not avaliable
+
+# Optionally, you can also view all reservations, and determine a time slot you want a specific device reserved
+```
+```bash
+perms   # To view your permissions
+
+# Depending on your permission levels, you will be given different restrictions 
+```
+
+```bash
+resdev # To reserve a device
+
+# Input the number of days you want to view, and it will display available reservations in that time span.
+
+Reservation successful. Thy Token -> example_token
+
+# Take note of this token. You will need it to actually access the device.
+```
+
+## Remote Access
+
+With this token, you can now run scripts remotely. Please keep in mind that you MUST be connected to the UCLA VPN for this to work.
+Here is a explained sample script to get you going!
+
+#### Python Script:
+
+```python
+from remoteRF.drivers.adalm_pluto import *  # Imports device Pluto SDR remote drivers. Change depending on desired device.
+
+sdr = adi.Pluto(    # Device initialization.
+    token = 'example_token'     # Place the prior token here.
+)
+
+# You can now use this 'sdr' as you normally would with the default Pluto drivers.
+```
+
+If converting a existing `non-remoteRF` compatible script:
+
+```diff
+- import existing_device_drivers 
+
++ from remoteRF.drivers.device_drivers import *
+
+- device = device(init)
+
++ device = device(token = 'sample_token')
+```
+
+Nothing else needs changing! 
+
+## Closing
+
+This is fundamentally a experimental platform, and there will be many unknown bugs and issues. Some devices do not have universal support for all its functions at the moment, I am working on that aspect. 
+
+**So please submit feedback!**

remoterf-0.0.7.27/setup.cfg

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

remoterf-0.0.7.27/setup.py

@@ -0,0 +1,33 @@
+from setuptools import setup, find_packages
+import os
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="remoterf",
+    version="0.0.7.27",
+    author="Ethan Ge",
+    author_email="ethoGalaxy@gmail.com",
+    description="A python API to remotely access signal centric hardware. Client-side only!",
+    long_description=long_description,  # Set the README content here
+    long_description_content_type="text/markdown",  # Specify that it's Markdown
+    packages=find_packages(where="src"),  # Automatically finds subpackages like core, deviceA, deviceB
+    package_dir={"": "src"},
+    license_file='MIT',
+    include_package_data=True,  # Includes files specified in MANIFEST.in
+    install_requires=[
+        "grpcio==1.71.0", "protobuf", "numpy", "prompt_toolkit", "python-dotenv"
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.10',
+    entry_points={
+        'console_scripts': [
+            'remoterf-login=remoteRF.core.acc_login:main',
+        ],
+    },
+)

remoterf-0.0.7.27/src/remoteRF/common/__init__.py

@@ -0,0 +1,2 @@
+from .grpc import *
+from .utils import *

remoterf-0.0.7.27/src/remoteRF/common/grpc/__init__.py

@@ -0,0 +1 @@
+from . import grpc_pb2, grpc_pb2_grpc

remoterf-0.0.7.27/src/remoteRF/common/grpc/grpc_pb2.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: grpc.proto
+# Protobuf Python Version: 5.29.0
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    29,
+    0,
+    '',
+    'grpc.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\ngrpc.proto\x12\tremote_rf\"\xa2\x01\n\x11GenericRPCRequest\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x34\n\x04\x61rgs\x18\x02 \x03(\x0b\x32&.remote_rf.GenericRPCRequest.ArgsEntry\x1a@\n\tArgsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x96\x01\n\x12GenericRPCResponse\x12;\n\x07results\x18\x01 \x03(\x0b\x32*.remote_rf.GenericRPCResponse.ResultsEntry\x1a\x43\n\x0cResultsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x19\n\nArrayShape\x12\x0b\n\x03\x64im\x18\x01 \x03(\x05\"+\n\rComplexNumber\x12\x0c\n\x04real\x18\x01 \x01(\x02\x12\x0c\n\x04imag\x18\x02 \x01(\x02\"a\n\x11\x43omplexNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12&\n\x04\x64\x61ta\x18\x02 \x03(\x0b\x32\x18.remote_rf.ComplexNumber\"D\n\x0eRealNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12\x0c\n\x04\x64\x61ta\x18\x02 \x03(\x02\"\xd7\x01\n\x08\x41rgument\x12\x16\n\x0cstring_value\x18\x01 \x01(\tH\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x15\n\x0b\x66loat_value\x18\x03 \x01(\x02H\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\rcomplex_array\x18\x05 \x01(\x0b\x32\x1c.remote_rf.ComplexNumpyArrayH\x00\x12/\n\nreal_array\x18\x06 \x01(\x0b\x32\x19.remote_rf.RealNumpyArrayH\x00\x42\x07\n\x05value2Q\n\nGenericRPC\x12\x43\n\x04\x43\x61ll\x12\x1c.remote_rf.GenericRPCRequest\x1a\x1d.remote_rf.GenericRPCResponseB\x1e\n\x10\x63om.example.demoB\nDemoProtosb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'grpc_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\020com.example.demoB\nDemoProtos'
+  _globals['_GENERICRPCREQUEST_ARGSENTRY']._loaded_options = None
+  _globals['_GENERICRPCREQUEST_ARGSENTRY']._serialized_options = b'8\001'
+  _globals['_GENERICRPCRESPONSE_RESULTSENTRY']._loaded_options = None
+  _globals['_GENERICRPCRESPONSE_RESULTSENTRY']._serialized_options = b'8\001'
+  _globals['_GENERICRPCREQUEST']._serialized_start=26
+  _globals['_GENERICRPCREQUEST']._serialized_end=188
+  _globals['_GENERICRPCREQUEST_ARGSENTRY']._serialized_start=124
+  _globals['_GENERICRPCREQUEST_ARGSENTRY']._serialized_end=188
+  _globals['_GENERICRPCRESPONSE']._serialized_start=191
+  _globals['_GENERICRPCRESPONSE']._serialized_end=341
+  _globals['_GENERICRPCRESPONSE_RESULTSENTRY']._serialized_start=274
+  _globals['_GENERICRPCRESPONSE_RESULTSENTRY']._serialized_end=341
+  _globals['_ARRAYSHAPE']._serialized_start=343
+  _globals['_ARRAYSHAPE']._serialized_end=368
+  _globals['_COMPLEXNUMBER']._serialized_start=370
+  _globals['_COMPLEXNUMBER']._serialized_end=413
+  _globals['_COMPLEXNUMPYARRAY']._serialized_start=415
+  _globals['_COMPLEXNUMPYARRAY']._serialized_end=512
+  _globals['_REALNUMPYARRAY']._serialized_start=514
+  _globals['_REALNUMPYARRAY']._serialized_end=582
+  _globals['_ARGUMENT']._serialized_start=585
+  _globals['_ARGUMENT']._serialized_end=800
+  _globals['_GENERICRPC']._serialized_start=802
+  _globals['_GENERICRPC']._serialized_end=883
+# @@protoc_insertion_point(module_scope)

remoterf-0.0.7.27/src/remoteRF/common/grpc/grpc_pb2_grpc.py

@@ -0,0 +1,97 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+from . import grpc_pb2 as grpc__pb2
+
+GRPC_GENERATED_VERSION = '1.71.0'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + f' but the generated code in grpc_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )
+
+
+class GenericRPCStub(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.Call = channel.unary_unary(
+                '/remote_rf.GenericRPC/Call',
+                request_serializer=grpc__pb2.GenericRPCRequest.SerializeToString,
+                response_deserializer=grpc__pb2.GenericRPCResponse.FromString,
+                _registered_method=True)
+
+
+class GenericRPCServicer(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def Call(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_GenericRPCServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'Call': grpc.unary_unary_rpc_method_handler(
+                    servicer.Call,
+                    request_deserializer=grpc__pb2.GenericRPCRequest.FromString,
+                    response_serializer=grpc__pb2.GenericRPCResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'remote_rf.GenericRPC', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('remote_rf.GenericRPC', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class GenericRPC(object):
+    """Missing associated documentation comment in .proto file."""
+
+    @staticmethod
+    def Call(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/remote_rf.GenericRPC/Call',
+            grpc__pb2.GenericRPCRequest.SerializeToString,
+            grpc__pb2.GenericRPCResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

remoterf-0.0.7.27/src/remoteRF/common/utils/__init__.py

@@ -0,0 +1,4 @@
+from .api_token import validate_token, generate_token, hash_token
+from .process_arg import unmap_arg, map_arg
+from .ansi_codes import printf, stylize, Sty
+from .list_string import list_to_str, str_to_list

remoterf-0.0.7.27/src/remoteRF/common/utils/ansi_codes.py

@@ -0,0 +1,120 @@
+from prompt_toolkit.styles import Style
+from prompt_toolkit.formatted_text import FormattedText
+from prompt_toolkit import print_formatted_text
+from enum import Enum
+
+class Sty(Enum):
+    # Basic colors
+    RED = 'red'
+    GREEN = 'green'
+    BLUE = 'blue'
+    YELLOW = 'yellow'
+    MAGENTA = 'magenta'
+    CYAN = 'cyan'
+    GRAY = 'gray'
+    
+    # Background colors
+    BG_RED = 'bg-red'
+    BG_GREEN = 'bg-green'
+    BG_BLUE = 'bg-blue'
+    
+    # Bright versions
+    BRIGHT_RED = 'bright-red'
+    BRIGHT_GREEN = 'bright-green'
+    BRIGHT_BLUE = 'bright-blue'
+    
+    # Formatting
+    BOLD = 'bold'
+    ITALIC = 'italic'
+    UNDERLINE = 'underline'
+    BLINK = 'blink'
+    REVERSE = 'reverse'
+    
+    # Combinations
+    ERROR = 'error'
+    WARNING = 'warning'
+    INFO = 'info'
+    
+    # Special
+    SELECTED = 'selected'
+    DEFAULT = 'default'
+
+# Define the styles based on ANSI codes
+style = Style.from_dict({
+    # Basic colors
+    'red': 'fg:#110000',
+    'green': 'fg:#003300',
+    'blue': 'fg:#0000ff',
+    'yellow': 'fg:#ffff00',
+    'magenta': 'fg:#ff00ff',
+    'cyan': 'fg:#00ffff',
+    'gray': 'fg:#808080',
+    
+    # Bright versions
+    'bright-red': 'fg:#ff5555',
+    'bright-green': 'fg:#00ff00',
+    'bright-blue': 'fg:#5555ff',
+    
+    # Formatting
+    'bold': 'bold',
+    'italic': 'italic',
+    'underline': 'underline',
+    'reverse': 'reverse',
+    
+    # Combinations
+    'error': 'bg:#ff0000 fg:#ffffff bold',
+    'warning': 'bg:#ffff00 fg:#000000 bold',
+    'info': 'bg:#0000ff fg:#ffffff italic underline',
+    
+    # Special
+    'selected': 'bg:#ffffff #000000 reverse',
+    'default':''
+})
+
+def printf(*args) -> str:
+    if len(args) % 2 != 0:
+        raise ValueError('Arguments must be in pairs of two.')
+    
+    # Create formatted text using the defined style
+    formatted_text = []
+    
+    for i in range(0, len(args), 2):
+        message = args[i]
+        styles = args[i+1]
+        
+        if not isinstance(styles, tuple):
+            styles = (styles,)
+            
+        resolved_styles = (s.value if isinstance(s, Enum) else s for s in styles)
+        
+        style_class = ' '.join(resolved_styles)
+        
+        formatted_text.append(('class:' + style_class, message))
+    
+    # Create FormattedText object from pairs
+    text = FormattedText(formatted_text)
+    
+    print_formatted_text(text, style=style)
+    return text
+
+def stylize(*args):
+    """
+    Create a styled prompt text based on pairs of (text, (Sty, ...), ...).
+    """
+    if len(args) % 2 != 0:
+        raise ValueError("Arguments must be in pairs of (text, style_class).")
+    
+    styled_parts = []
+    for i in range(0, len(args), 2):
+        text = args[i]
+        styles = args[i + 1]
+        
+        if not isinstance(styles, tuple):
+            styles = (styles,)
+            
+        resolved_styles = (s.value if isinstance(s, Enum) else s for s in styles)
+        
+        style_class = ' '.join(resolved_styles)
+        styled_parts.append(('class:' + style_class, text))
+    
+    return FormattedText(styled_parts)

remoterf-0.0.7.27/src/remoteRF/common/utils/api_token.py

@@ -0,0 +1,31 @@
+import os
+import hashlib
+import base64
+import secrets
+from dotenv import load_dotenv, find_dotenv
+
+### API Token Management
+# API Tokens are used to authenticate clients to the device
+# API Tokens are stored locally on the device in its .env file
+
+def generate_token(length=8) -> tuple[str, str, str]:
+    random_bytes = secrets.token_bytes(length)  # Generate a random byte string
+    token = base64.urlsafe_b64encode(random_bytes).decode('utf-8').rstrip('=')  # Encode the byte string in a URL-safe base64 format
+    salt = os.urandom(16).hex()  # 16 bytes of random salt
+    hashed = hashlib.sha256(bytes.fromhex(salt) + token.encode()).hexdigest()  # Hash to sha256 standard
+    return salt, hashed, token
+
+def validate_token(salt, hash, token) -> bool:
+    new_hashed = hashlib.sha256(bytes.fromhex(salt) + token.encode()).hexdigest()
+    return new_hashed == hash
+
+def hash_token(token: str) -> tuple[str, str]:
+    salt = os.urandom(16).hex()
+    hashed = hashlib.sha256(bytes.fromhex(salt) + token.encode()).hexdigest()
+    return salt, hashed
+
+# Example Usage:
+# if __name__ == '__main__':
+#     okay = generate_token()
+#     assert validate_token(okay[0], okay[1], okay[2] + "s"), "Token validation failed!"
+#     print("Token validation succeeded!")

remoterf-0.0.7.27/src/remoteRF/common/utils/list_string.py

@@ -0,0 +1,5 @@
+def list_to_str(list:list) -> str:
+    return ','.join(str(x) for x in list)
+
+def str_to_list(s:str) -> list[int]:
+    return [int(x) for x in s.split(',')]