RemoteRF 0.0.1__tar.gz

remoterf-0.0.1/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.1/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.1
+Name: remoteRF
+Version: 0.0.1
+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.6
+License-File: LICENSE
+Requires-Dist: grpcio
+Requires-Dist: protobuf
+Requires-Dist: numpy
+Requires-Dist: prompt_toolkit
+Requires-Dist: python-dotenv

remoterf-0.0.1/setup.cfg

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

remoterf-0.0.1/setup.py

@@ -0,0 +1,25 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="remoteRF",
+    version="0.0.1",
+    author="Ethan Ge",
+    author_email="ethoGalaxy@gmail.com",
+    description="A python API to remotely access signal centric hardware. Client-side only!",
+    packages=find_packages(where="src"),  # Automatically finds subpackages like core, deviceA, deviceB
+    package_dir={"": "src"},
+    install_requires=[
+        "grpcio", "protobuf", "numpy", "prompt_toolkit", "python-dotenv"
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.6',
+    entry_points={
+        'console_scripts': [
+            'remoterf-login=remoteRF.core.acc_login:main',
+        ],
+    },
+)

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

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

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

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

remoterf-0.0.1/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.27.1
+"""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,
+    27,
+    1,
+    '',
+    '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.1/src/remoteRF/common/grpc/grpc_pb2_grpc.py

@@ -0,0 +1,102 @@
+# 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.64.1'
+GRPC_VERSION = grpc.__version__
+EXPECTED_ERROR_RELEASE = '1.65.0'
+SCHEDULED_RELEASE_DATE = 'June 25, 2024'
+_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:
+    warnings.warn(
+        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}.'
+        + f' This warning will become an error in {EXPECTED_ERROR_RELEASE},'
+        + f' scheduled for release on {SCHEDULED_RELEASE_DATE}.',
+        RuntimeWarning
+    )
+
+
+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.1/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.1/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.1/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.1/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(',')]

remoterf-0.0.1/src/remoteRF/common/utils/process_arg.py

@@ -0,0 +1,80 @@
+from ..grpc import grpc_pb2, grpc_pb2_grpc
+import numpy as np
+
+def unmap_arg(arg):
+    if arg.HasField('int64_value'):
+        return arg.int64_value
+    elif arg.HasField('float_value'):
+        return arg.float_value
+    elif arg.HasField('string_value'):
+        return arg.string_value
+    elif arg.HasField('bool_value'):
+        return arg.bool_value
+    elif arg.HasField('real_array'):
+        shape = tuple(arg.real_array.shape.dim)
+        return np.array(arg.real_array.data, dtype=np.float64).reshape(shape)
+    elif arg.HasField('complex_array'):
+        shape = tuple(arg.complex_array.shape.dim)
+        data = [complex(c.real, c.imag) for c in arg.complex_array.data]
+        return np.array(data, dtype=np.complex64).reshape(shape)
+    else:
+        raise ValueError(f"Unknown argument type during unmapping: {arg}")
+    
+def map_arg(value):
+    arg = grpc_pb2.Argument()
+    
+    if isinstance(value, int):
+        arg.int64_value = value
+    elif isinstance(value, float):
+        arg.float_value = value
+    elif isinstance(value, str):
+        arg.string_value = value
+    elif isinstance(value, bool):
+        arg.bool_value = value
+    elif isinstance(value, np.ndarray):
+        if np.iscomplexobj(value):
+            complex_array = arg.complex_array
+            complex_array.shape.dim.extend(value.shape)
+            for num in value.ravel():
+                complex_num = complex_array.data.add()
+                complex_num.real = num.real
+                complex_num.imag = num.imag
+        else:
+            float_array = arg.real_array
+            float_array.shape.dim.extend(value.shape)
+            float_array.data.extend(value.ravel())
+    else:
+        raise ValueError(f"Unknown argument type during mapping: {value}")
+    return arg
+        
+def map_array_proto(np_array):
+    arg = grpc_pb2.Argument()
+    
+    # Check if the array is complex
+    if np.iscomplexobj(np_array):
+        complex_array = grpc_pb2.ComplexArray()
+        for num in np_array.flat:
+            complex_number = complex_array.data.add()
+            complex_number.real = num.real
+            complex_number.imag = num.imag
+        arg.complex_array.CopyFrom(complex_array)
+    else:
+        # Handle as a regular float array
+        float_array = grpc_pb2.FloatArray()
+        float_array.data.extend(np_array.flat)
+        arg.float_array.CopyFrom(float_array)
+
+    return arg
+
+def unmap_array_proto(arg):
+    # Check which type of array is available and convert appropriately
+    if arg.HasField('complex_array'):
+        # Convert ComplexArray to a numpy array of complex numbers
+        data = [complex(cn.real, cn.imag) for cn in arg.complex_array.data]
+        return np.array(data, dtype=np.complex64)
+    elif arg.HasField('float_array'):
+        # Convert FloatArray to a numpy array of floats
+        return np.array(arg.float_array.data, dtype=np.float32)
+    else:
+        raise ValueError("Argument does not contain a recognizable array.")
+

remoterf-0.0.1/src/remoteRF/core/__init__.py

@@ -0,0 +1,2 @@
+from .grpc_client import rpc_client
+from .grpc_acc import RemoteRFAccount

remoterf-0.0.1/src/remoteRF/core/acc_login.py

@@ -0,0 +1,4 @@
+from . import app as client
+
+def main():
+    pass

remoterf-0.0.1/src/remoteRF/core/app.py

@@ -0,0 +1,270 @@
+from . import *
+from ..common.utils import *
+
+import getpass
+import os
+import datetime
+import time
+import ast
+
+from prompt_toolkit import PromptSession
+
+account = RemoteRFAccount()
+session = PromptSession()
+
+def welcome():
+    printf("Welcome to Remote RF Account System.", (Sty.BOLD, Sty.BLUE))
+    try:
+        inpu = session.prompt(stylize("Please ", Sty.DEFAULT, "login", Sty.GREEN, " or ", Sty.DEFAULT, "register", Sty.RED, " to continue. (", Sty.DEFAULT, 'l', Sty.GREEN, "/", Sty.DEFAULT, 'r', Sty.RED, "):", Sty.DEFAULT))
+        if inpu == 'r':
+            print("Registering new account ...")
+            account.username = input("Username: ")
+            double_check = True
+            while double_check:
+                password = getpass.getpass("Password: ")
+                password2 = getpass.getpass("Confirm Password: ")
+                if password == password2:
+                    double_check = False
+                else:
+                    print("Passwords do not match. Try again")
+                    
+            account.password = password
+            account.email = input("Email: ")  # TODO: Email verification.
+            # check if login was valid
+            os.system('cls' if os.name == 'nt' else 'clear')
+            
+            if not account.create_user():
+                welcome()
+        else:
+            account.username = input("Username: ")
+            account.password = getpass.getpass("Password: ")
+            # check if login was valid
+            if not account.login_user():
+                os.system('cls' if os.name == 'nt' else 'clear')
+                print("Invalid login. Try again.")
+                welcome()
+    except KeyboardInterrupt:
+        exit()
+    except EOFError:
+        exit()
+
+def title():
+    printf(f"Remote RF Account System", Sty.BOLD)
+    # printf(f"Logged in as: ", Sty.DEFAULT, f'{account.username}', Sty.MAGENTA)
+    printf(f"Input ", Sty.DEFAULT, "'help' ", Sty.BRIGHT_GREEN, "for avaliable commands.", Sty.DEFAULT)  
+
+def commands():
+    printf("Commands:", Sty.BOLD)
+    printf("'clear' ", Sty.MAGENTA, "- Clear Terminal", Sty.DEFAULT)
+    printf("'getdev' ", Sty.MAGENTA, "- View Devices", Sty.DEFAULT)
+    printf("'help' ", Sty.MAGENTA, "- Show this help message", Sty.DEFAULT)
+    printf("'perms' ", Sty.MAGENTA, "- View Permissions", Sty.DEFAULT)
+    printf("'exit' ", Sty.MAGENTA, "- Exit", Sty.DEFAULT)
+    printf("'getres' ", Sty.MAGENTA, "- View All Reservations", Sty.DEFAULT)
+    printf("'myres' ", Sty.MAGENTA, "- View My Reservations", Sty.DEFAULT)
+    printf("'cancelres' ", Sty.MAGENTA, "- Cancel a Reservation", Sty.DEFAULT)
+    printf("'resdev' ", Sty.MAGENTA, "- Reserve a Device", Sty.DEFAULT)
+    
+def clear():
+    os.system('cls' if os.name == 'nt' else 'clear')
+    title()
+    
+def reservations():
+    data = account.get_reservations()
+    if 'ace' in data.results:
+        print(f"Error: {unmap_arg(data.results['ace'])}")
+        return
+    entries = []
+
+    for key, value in data.results.items():
+        parts = unmap_arg(value).split(',')
+        # Create a dictionary for each entry with named fields
+        entry = {
+            'username': parts[0],
+            'device_id': int(parts[1]),  # Convert device_id to integer for proper numerical sorting
+            'start_time': datetime.datetime.strptime(parts[2], '%Y-%m-%d %H:%M:%S'),  # Convert start_time to datetime
+            'end_time': parts[3]
+        }
+        entries.append(entry)
+        
+    if (entries == []):
+        printf("No reservations found.", Sty.BOLD)
+        return
+    
+    printf("Reservations:", Sty.BOLD)
+
+    # Sort the entries by device_id and then by start_time
+    sorted_entries = sorted(entries, key=lambda x: (x['device_id'], x['start_time']))
+
+    # Format the sorted entries into strings
+    for entry in sorted_entries:
+        printf(f'Device ID: ', Sty.RED, f'{entry["device_id"]}', Sty.MAGENTA, f', Start Time: ', Sty.RED, f'{entry["start_time"].strftime("%Y-%m-%d %H:%M:%S")}', Sty.BLUE, f', End Time: ', Sty.RED, f'{entry["end_time"]}', Sty.BLUE)
+        
+def my_reservations():
+    data = account.get_reservations()
+    if 'ace' in data.results:
+        print(f"Error: {unmap_arg(data.results['ace'])}")
+        return
+    entries = []
+
+    for key, value in data.results.items():
+        parts = unmap_arg(value).split(',')
+        # Create a dictionary for each entry with named fields
+        entry = {
+            'username': parts[0],
+            'device_id': int(parts[1]),  # Convert device_id to integer for proper numerical sorting
+            'start_time': datetime.datetime.strptime(parts[2], '%Y-%m-%d %H:%M:%S'),  # Convert start_time to datetime
+            'end_time': parts[3]
+        }
+        entries.append(entry)
+        
+    if (entries == []):
+        printf("No reservations found.", Sty.BOLD)
+        return
+    
+    printf("Reservations under: ", Sty.BOLD, f'{account.username}', Sty.MAGENTA)
+
+    # Sort the entries by device_id and then by start_time
+    sorted_entries = sorted(entries, key=lambda x: (x['device_id'], x['start_time']))
+    
+    for entry in sorted_entries:
+        if account.username == entry['username']:
+            printf(f'Device ID: ', Sty.RED, f'{entry["device_id"]}', Sty.MAGENTA, f', Start Time: ', Sty.RED, f'{entry["start_time"].strftime("%Y-%m-%d %H:%M:%S")}', Sty.BLUE, f', End Time: ', Sty.RED, f'{entry["end_time"]}', Sty.BLUE)
+
+def cancel_my_reservation():
+    ## print all of ur reservations and their ids
+    ## ask for id to cancel
+    ## remove said reservation
+    data = account.get_reservations()
+    if 'ace' in data.results:
+        print(f"Error: {unmap_arg(data.results['ace'])}")
+        return
+    
+    entries:list = []
+
+    for key, value in data.results.items():
+        parts = unmap_arg(value).split(',')
+        # Create a dictionary for each entry with named fields
+        entry = {
+            'id': -1,
+            'internal_id': key,
+            'username': parts[0],
+            'device_id': int(parts[1]),  # Convert device_id to integer for proper numerical sorting
+            'start_time': datetime.datetime.strptime(parts[2], '%Y-%m-%d %H:%M:%S'),  # Convert start_time to datetime
+            'end_time': parts[3]
+        }
+        if account.username == entry['username']:
+            entries.append(entry)
+    
+    printf("Current Reservation(s) under ", Sty.BOLD, f'{account.username}:', Sty.MAGENTA)
+    
+    sorted_entries = sorted(entries, key=lambda x: (x['device_id'], x['start_time'])) # sort by device_id and start_time
+    for i, entry in enumerate(sorted_entries):  # label all reservations with unique id
+        entry['id'] = i
+        printf(f'Reservation ID: ', Sty.GRAY, f'{i}', Sty.MAGENTA, f' Device ID: ', Sty.GRAY, f'{entry["device_id"]}', Sty.BRIGHT_GREEN, f' Start Time: ', Sty.GRAY, f'{entry["start_time"].strftime("%Y-%m-%d %H:%M:%S")}', Sty.BLUE, f' End Time: ', Sty.GRAY, f'{entry["end_time"]}', Sty.BLUE)
+        # print(f"Reservation ID {i}, Device ID: {entry['device_id']}, Start Time: {entry['start_time'].strftime('%Y-%m-%d %H:%M:%S')}, End Time: {entry['end_time']}")
+        
+    if sorted_entries == []:
+        printf("No reservations found.", Sty.BOLD)
+        return    
+        
+    inpu = session.prompt(stylize("Enter the ID of the reservation you would like to cancel ", Sty.BOLD, '(abort with any non number key input)', Sty.RED, ': ', Sty.BOLD))
+    
+    if inpu.isdigit():
+        id = int(inpu)
+        if id >= len(sorted_entries):
+            print("Invalid ID.")
+            return
+        
+        #grab the reservation
+        for entry in sorted_entries:
+            if entry['id'] == id:
+                db_id = entry['internal_id']
+                if session.prompt(stylize(f'Cancel reservation ID ', Sty.DEFAULT, f'{id}', Sty.MAGENTA, f' Device ID: ', Sty.DEFAULT, f'{entry["device_id"]}', Sty.BRIGHT_GREEN, f' Start Time: ', Sty.GRAY, f'{entry["start_time"].strftime("%Y-%m-%d %H:%M:%S")}', Sty.BLUE, f' End Time: ', Sty.DEFAULT, f'{entry["end_time"]}', Sty.BLUE, f' ? (y/n):', Sty.DEFAULT)) == 'y':
+                    response = account.cancel_reservation(db_id)
+                    if 'ace' in response.results:
+                        print(f"Error: {unmap_arg(response.results['ace'])}")
+                    elif 'UC' in response.results:
+                        printf(f"Reservation ID ", Sty.DEFAULT, f'{id}', Sty.BRIGHT_BLUE, ' successfully canceled.', Sty.DEFAULT)
+                else:
+                    print("Aborting. User canceled action.")
+                return
+            
+        print(f"Error: No reservation found with ID {id}.")
+    else:
+        print("Aborting. A non integer key was given.")
+
+def devices():
+    data = account.get_devices()
+    if 'ace' in data.results:
+        print(f"Error: {unmap_arg(data.results['ace'])}")
+        return
+    printf("Devices:", Sty.BOLD)
+    
+    for key in sorted(data.results, key=int):
+        printf(f"Device ID:", Sty.DEFAULT, f' {key}', Sty.MAGENTA, f" Device Name: ", Sty.DEFAULT, f"{unmap_arg(data.results[key])}", Sty.GRAY)
+
+def get_datetime(question:str):
+    timestamp = session.prompt(stylize(f'{question}', Sty.DEFAULT, ' (YYYY-MM-DD HH:MM): ', Sty.GRAY))
+    return datetime.datetime.strptime(timestamp + ':00', '%Y-%m-%d %H:%M:%S')
+
+def reserve():
+    try:
+        id = session.prompt(stylize("Enter the device ID you would like to reserve: ", Sty.DEFAULT))
+        token = account.reserve_device(int(id), get_datetime("Reserve Start Time"), get_datetime("Reserve End Time"))
+        if token != '':
+            printf(f"Reservation successful. Thy Token -> ", Sty.BOLD, f"{token}", Sty.BG_GREEN)
+            printf(f"Please keep this token safe, as it is not saved on server side, and cannot be regenerated/reretrieved. ", Sty.DEFAULT)
+    except Exception as e:
+        printf(f"Error: {e}", Sty.BRIGHT_RED)
+
+def perms():
+    data = account.get_perms()
+    if 'ace' in data.results:
+        print(f"Error: {unmap_arg(data.results['ace'])}")
+        return
+    
+    results = ast.literal_eval(unmap_arg(data.results['UC']))[0]
+    printf(f'Permission Level: ', Sty.BOLD, f'{results[0]}', Sty.BLUE)
+    if results[0] == 'Normal User':
+        print(unmap_arg(data.results['details']))
+    elif results[0] == 'Power User':
+        printf(f'Max Reservations: ', Sty.DEFAULT, f'{results[3]}', Sty.MAGENTA)
+        printf(f'Max Reservation Duration (min): ', Sty.DEFAULT, f'{int(results[4]/60)}', Sty.MAGENTA)
+        printf(f'Device IDs allowed Access to: ', Sty.DEFAULT, f'{results[5]}', Sty.MAGENTA)
+    elif results[0] == 'Admin':
+        printf(f'No restrictions on reservation count or duration.', Sty.DEFAULT)
+    else:
+        printf(f"Error: Unknown permission level {results[0]}", Sty.BRIGHT_RED)
+
+welcome()
+clear()
+
+while True:
+    try:
+        inpu = session.prompt(stylize(f'{account.username}@remote_rf: ', Sty.BLUE))
+        if inpu == "clear":
+            clear()
+        elif inpu == "getdev":
+            devices()
+        elif inpu == "help" or inpu == "h":
+            commands()
+        elif inpu == "perms":
+            perms()
+        elif inpu == "quit" or inpu == "exit":
+            break
+        elif inpu == "getres":
+            reservations()
+        elif inpu == "myres":
+            my_reservations()
+        elif inpu == "resdev":
+            reserve()
+        elif inpu == 'cancelres':
+            cancel_my_reservation()
+        else:
+            print(f"Unknown command: {inpu}")
+    except KeyboardInterrupt:
+        break
+    except EOFError:
+        break
+        

remoterf-0.0.1/src/remoteRF/core/grpc_acc.py

@@ -0,0 +1,52 @@
+from .grpc_client import rpc_client
+from ..common.utils import *
+
+import datetime
+
+class RemoteRFAccount:
+    def __init__(self, username:str=None, password:str=None, email:str=None):
+        self.username = username
+        self.password = password
+        self.email = email
+    
+    def create_user(self):
+        response = rpc_client(function_name="ACC:create_user", args={"un":map_arg(self.username), "pw":map_arg(self.password), "em":map_arg(self.email)})
+        if 'UC' in response.results:
+            print(f'User {unmap_arg(response.results["UC"])} successfully created.')
+            return True
+        elif 'UE' in response.results:
+            print(f'Error: {unmap_arg(response.results["UE"])}')
+            return False
+    
+    def login_user(self):
+        username = self.username
+        password = self.password
+        response = rpc_client(function_name="ACC:login", args={"un":map_arg(username), "pw":map_arg(password)})
+        if 'UC' in response.results:
+            print(f'User {unmap_arg(response.results["UC"])} successful login.')
+            return True
+        elif 'UE' in response.results:
+            print(f'Error: {unmap_arg(response.results["UE"])}')
+            return False
+    
+    def reserve_device(self, device_id:int, start_time:datetime, end_time:datetime):
+        response = rpc_client(function_name="ACC:reserve_device", args={"un":map_arg(self.username), "pw":map_arg(self.password), "dd":map_arg(device_id), "st":map_arg(int(start_time.timestamp())), "et":map_arg(int(end_time.timestamp()))})
+        
+        if 'ace' in response.results:
+            raise Exception(f'{unmap_arg(response.results["ace"])}')
+        elif 'Token' in response.results:
+            return unmap_arg(response.results["Token"])
+            
+    def get_reservations(self):
+        return rpc_client(function_name='ACC:get_res', args={"un":map_arg(self.username), "pw":map_arg(self.password)})
+    
+    def get_devices(self):
+        return rpc_client(function_name='ACC:get_dev', args={"un":map_arg(self.username), "pw":map_arg(self.password)})
+    
+    def cancel_reservation(self, res_id:int):
+        return rpc_client(function_name='ACC:cancel_res', args={"un":map_arg(self.username), "pw":map_arg(self.password), "res_id":map_arg(res_id)})
+    
+    def get_perms(self):
+        return rpc_client(function_name='ACC:get_perms', args={"un":map_arg(self.username), "pw":map_arg(self.password)})
+    
+    

remoterf-0.0.1/src/remoteRF/core/grpc_client.py

@@ -0,0 +1,92 @@
+import socket
+import getpass
+from pathlib import Path
+
+import grpc
+from ..common.grpc import grpc_pb2
+from ..common.grpc import grpc_pb2_grpc
+from ..common.utils import *
+
+# wlab credentials
+server_ip = '164.67.195.207'
+server_port = '61005'
+
+# Server.crt
+certs_path = Path(__file__).resolve().parent.parent/'core'/'certs'/'server.crt'
+with certs_path.open('rb') as f:
+    trusted_certs = f.read()
+    
+credentials = grpc.ssl_channel_credentials(root_certificates=trusted_certs)
+channel = grpc.secure_channel(f'{server_ip}:{server_port}', credentials)
+stub = grpc_pb2_grpc.GenericRPCStub(channel)
+
+tcp_calls = 0
+
+def get_tcp_calls():
+    return tcp_calls
+        
+def rpc_client(*, function_name, args):
+    global tcp_calls
+    tcp_calls += 1
+    # print(tcp_calls)
+    # if not is_connected:
+    #     response = rpc_client(function_name="UserLogin", args={"username": grpc_pb2.Argument(string_value=input("Username: ")), "password": grpc_pb2.Argument(string_value=getpass.getpass("Password: ")), "client_ip": grpc_pb2.Argument(string_value=local_ip)})
+    #     if (response.results['status'].string_value == 'Success'):
+    #         print("Login successful.")
+    #         is_connected = True
+    
+    # TODO: Handle user login
+    
+    # print(f"Opening connection to {server_ip}:{server_port}")
+    
+    # TODO: Handle Errors
+    
+    # print(f"Calling function: {function_name}")
+    response = stub.Call(grpc_pb2.GenericRPCRequest(function_name=function_name, args=args))
+    
+    if 'a' in response.results:
+        print(f"Error: {unmap_arg(response.results['a'])}")
+        exit()
+        
+    if 'UE' in response.results:
+        print(f"UserError: {unmap_arg(response.results['UE'])}")
+        input("Hit enter to continue...")
+            
+    
+    return response
+
+#region Example Usage
+
+# if __name__ == '__main__':
+#     args={
+#         "key1": grpc_pb2.Argument(string_value="Hello"),
+#         "key2": grpc_pb2.Argument(int32_value=123),
+#         "key3": grpc_pb2.Argument(float_value=4.56),
+#         "key4": grpc_pb2.Argument(bool_value=True),
+#         "client_ip": grpc_pb2.Argument(string_value=local_ip)
+#     }
+    
+#     response = rpc_client(function_name="echo", args=args)
+    
+#     if 'client_ip' in response.results:
+#         del response.results['client_ip']
+    
+#     # Print results
+#     print("Received response:")
+#     for key, arg in response.results.items():
+#         # Decode the oneof fields
+#         if arg.HasField('string_value'):
+#             value = arg.string_value
+#         elif arg.HasField('int32_value'):
+#             value = arg.int32_value
+#         elif arg.HasField('float_value'):
+#             value = arg.float_value
+#         elif arg.HasField('bool_value'):
+#             value = arg.bool_value
+#         else:
+#             value = "Undefined"
+            
+#         print(f"{key}: {value}")
+
+#endregion
+    

remoterf-0.0.1/src/remoteRF.egg-info/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.1
+Name: remoteRF
+Version: 0.0.1
+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.6
+License-File: LICENSE
+Requires-Dist: grpcio
+Requires-Dist: protobuf
+Requires-Dist: numpy
+Requires-Dist: prompt_toolkit
+Requires-Dist: python-dotenv

remoterf-0.0.1/src/remoteRF.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+LICENSE
+README.md
+setup.py
+src/remoteRF/__init__.py
+src/remoteRF.egg-info/PKG-INFO
+src/remoteRF.egg-info/SOURCES.txt
+src/remoteRF.egg-info/dependency_links.txt
+src/remoteRF.egg-info/entry_points.txt
+src/remoteRF.egg-info/requires.txt
+src/remoteRF.egg-info/top_level.txt
+src/remoteRF/common/__init__.py
+src/remoteRF/common/grpc/__init__.py
+src/remoteRF/common/grpc/grpc_pb2.py
+src/remoteRF/common/grpc/grpc_pb2_grpc.py
+src/remoteRF/common/utils/__init__.py
+src/remoteRF/common/utils/ansi_codes.py
+src/remoteRF/common/utils/api_token.py
+src/remoteRF/common/utils/list_string.py
+src/remoteRF/common/utils/process_arg.py
+src/remoteRF/core/__init__.py
+src/remoteRF/core/acc_login.py
+src/remoteRF/core/app.py
+src/remoteRF/core/grpc_acc.py
+src/remoteRF/core/grpc_client.py

remoterf-0.0.1/src/remoteRF.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

remoterf-0.0.1/src/remoteRF.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+remoterf-login = remoteRF.core.acc_login:main

remoterf-0.0.1/src/remoteRF.egg-info/requires.txt

@@ -0,0 +1,5 @@
+grpcio
+protobuf
+numpy
+prompt_toolkit
+python-dotenv

remoterf-0.0.1/src/remoteRF.egg-info/top_level.txt

@@ -0,0 +1 @@
+remoteRF