remoterf 0.1.0.3__py3-none-any.whl

remoteRF/common/__init__.py

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

remoteRF/common/grpc/__init__.py

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

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/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/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/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/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/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/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/config/cert_fetcher.py

@@ -0,0 +1,118 @@
+# cert_fetcher.py
+
+from __future__ import annotations
+
+import hashlib
+import os
+import socket
+import urllib.request
+from pathlib import Path
+from typing import Optional
+
+
+CERT_FILENAME_DEFAULT = "ca.crt"
+
+
+def _default_config_dir() -> Path:
+    # Cross-platform-ish default; adjust if you already have a standard in your project.
+    # Linux: ~/.config/remoterf
+    # macOS: also acceptable; if you want Apple-standard, use ~/Library/Application Support/remoterf
+    base = Path(os.path.expanduser("~")) / ".config" / "remoterf"
+    return base
+
+
+def _ensure_parent_dir(p: Path) -> None:
+    p.parent.mkdir(parents=True, exist_ok=True)
+
+
+def _looks_like_pem_cert(data: bytes) -> bool:
+    return b"BEGIN CERTIFICATE" in data and b"END CERTIFICATE" in data
+
+
+def sha256_fingerprint_pem(pem_bytes: bytes) -> str:
+    h = hashlib.sha256(pem_bytes).hexdigest()
+    return ":".join(h[i:i+2] for i in range(0, len(h), 2))
+
+
+def _fetch_http(host: str, port: int, timeout_sec: float) -> bytes:
+    url = f"http://{host}:{port}/ca.crt"
+    req = urllib.request.Request(url, method="GET")
+    with urllib.request.urlopen(req, timeout=timeout_sec) as resp:
+        data = resp.read()
+    return data
+
+
+def _fetch_raw_tcp(host: str, port: int, timeout_sec: float) -> bytes:
+    chunks: list[bytes] = []
+    with socket.create_connection((host, port), timeout=timeout_sec) as s:
+        s.settimeout(timeout_sec)
+        while True:
+            try:
+                b = s.recv(4096)
+            except socket.timeout:
+                break
+            if not b:
+                break
+            chunks.append(b)
+    return b"".join(chunks)
+
+
+def fetch_and_save_ca_cert(
+    host: str,
+    port: int,
+    *,
+    out_path: Optional[str | Path] = None,
+    profile: Optional[str] = None,
+    timeout_sec: float = 3.0,
+    overwrite: bool = True,
+) -> bool:
+    """
+    Fetch CA cert from the server bootstrap endpoint and save it to disk.
+
+    Args:
+        host: server host/ip running cert_provider
+        port: cert_provider port (NOT the TLS gRPC port)
+        out_path: explicit output path (overrides profile/default location)
+        profile: if provided, saves as ~/.config/remoterf/certs/<profile>.crt
+        timeout_sec: network timeout
+        overwrite: whether to overwrite existing file
+
+    Returns:
+        True on success, False on any failure.
+    """
+    try:
+        if not isinstance(port, int):
+            port = int(port)
+
+        # Determine destination path
+        if out_path is not None:
+            dest = Path(out_path).expanduser().resolve()
+        else:
+            cfg = _default_config_dir()
+            certs_dir = cfg / "certs"
+            name = f"{profile}.crt" if profile else CERT_FILENAME_DEFAULT
+            dest = certs_dir / name
+
+        _ensure_parent_dir(dest)
+
+        if dest.exists() and not overwrite:
+            return True  # already present, treat as success
+
+        # Fetch (HTTP first, then raw TCP fallback)
+        data = b""
+        try:
+            data = _fetch_http(host, port, timeout_sec)
+        except Exception:
+            data = _fetch_raw_tcp(host, port, timeout_sec)
+
+        if not data or not _looks_like_pem_cert(data):
+            return False
+
+        # Save
+        dest.write_bytes(data)
+
+        # Optional: you may want to return/print fingerprint, but requested API is bool.
+        return True
+
+    except Exception:
+        return False

remoteRF/config/config.py

@@ -0,0 +1,135 @@
+# src/remoteRF/core/remoterf_config.py
+
+from __future__ import annotations
+
+import os
+import sys
+import shutil
+from pathlib import Path
+from typing import Optional, Sequence, Tuple
+import argparse
+
+from .cert_fetcher import fetch_and_save_ca_cert
+
+
+
+# -----------------------------
+# Local config locations
+# -----------------------------
+def _config_root() -> Path:
+    return Path(os.path.expanduser("~")) / ".config" / "remoterf"
+
+def _env_path() -> Path:
+    return _config_root() / ".env"
+
+def _certs_dir() -> Path:
+    return _config_root() / "certs"
+
+def _parse_hostport(s: str) -> Tuple[str, int]:
+    s = s.strip()
+    if "://" in s:
+        s = s.split("://", 1)[1]
+
+    if ":" not in s:
+        raise ValueError("Expected format host:port")
+
+    host, port_str = s.rsplit(":", 1)
+    host = host.strip()
+    port = int(port_str.strip())
+    if not host:
+        raise ValueError("Host is empty")
+    if port <= 0 or port > 65535:
+        raise ValueError("Port out of range")
+    return host, port
+
+def _write_env_kv(path: Path, kv: dict[str, str]) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    lines: list[str] = []
+    for k, v in kv.items():
+        if any(c.isspace() for c in v) or any(c in v for c in ['"', "'"]):
+            v = v.replace('"', '\\"')
+            lines.append(f'{k}="{v}"')
+        else:
+            lines.append(f"{k}={v}")
+    path.write_text("\n".join(lines) + "\n", encoding="utf-8")
+
+def _confirm_wipe(root: Path) -> bool:
+    prompt = (
+        f"This will permanently delete ALL RemoteRF config at:\n"
+        f"  {root}\n\n"
+        f"Type 'wipe' to confirm: "
+    )
+    try:
+        return input(prompt).strip().lower() == "wipe"
+    except KeyboardInterrupt:
+        print("\nCancelled.")
+        return False
+
+def _wipe_config(root: Path) -> None:
+    if not root.exists():
+        print(f"No config found at: {root}")
+        return
+    if not root.is_dir():
+        raise RuntimeError(f"Config root exists but is not a directory: {root}")
+    shutil.rmtree(root)
+    print(f"Wiped RemoteRF config: {root}")
+
+def configure(host: str, port: int, cert_port: int) -> int:
+    # Basic validation
+    host = (host or "").strip()
+    if not host:
+        print("Error: host is empty", file=sys.stderr)
+        return 2
+    if port <= 0 or port > 65535:
+        print("Error: port out of range", file=sys.stderr)
+        return 2
+
+    grpc_port = int(port)
+    cert_port = int(cert_port)
+
+    profile = "default"
+    timeout_sec = 3.0
+    overwrite = True
+
+    certs_dir = _certs_dir()
+    certs_dir.mkdir(parents=True, exist_ok=True)
+    ca_out = certs_dir / f"{profile}.crt"
+
+    fetched_ok = fetch_and_save_ca_cert(
+        host,
+        cert_port,
+        out_path=ca_out,
+        timeout_sec=timeout_sec,
+        overwrite=overwrite,
+    )
+    if not fetched_ok:
+        print(f"Failed to fetch CA cert from {host}:{cert_port}.", file=sys.stderr)
+        return 1
+
+    env_file = _env_path()
+    _write_env_kv(env_file, {
+        "REMOTERF_ADDR": f"{host}:{grpc_port}",
+        "REMOTERF_CA_CERT": str(ca_out),
+        "REMOTERF_PROFILE": profile,
+    })
+
+    print("RemoteRF configured successfully.")
+    print(f"  gRPC target : {host}:{grpc_port}")
+    print(f"  cert port   : {host}:{cert_port}")
+    print(f"  CA cert     : {ca_out}")
+    print(f"  env file    : {env_file}")
+
+def wipe_config(*, yes: bool = False) -> int:
+    """
+    Optional helper if you want wipe behavior without argparse.
+    """
+    root = _config_root()
+    if not yes and not _confirm_wipe(root):
+        print("Wipe aborted.")
+        return 1
+    try:
+        _wipe_config(root)
+        return 0
+    except Exception as e:
+        print(f"Error wiping config: {e}", file=sys.stderr)
+        return 1

remoteRF/core/__init__.py

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

remoteRF/core/acc_login.py

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