Source code for nvflare.private.defs

# Copyright (c) 2021, NVIDIA CORPORATION.  All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

from nvflare.fuel.f3.message import Message
from nvflare.fuel.hci.server.constants import ConnProps


[docs]class SpecialTaskName(object): TRY_AGAIN = "__try_again__" END_RUN = "__end_run__"
[docs]class TaskConstant(object): WAIT_TIME = "__wait_time__"
[docs]class EngineConstant(object): FEDERATE_CLIENT = "federate_client" FL_TOKEN = "fl_token" CLIENT_TOKEN_FILE = "client_token.txt" ENGINE_TASK_NAME = "engine_task_name"
[docs]class InfoCollectorTopic(object): SHOW_STATS = "info.show_stats" SHOW_ERRORS = "info.show_errors" RESET_ERRORS = "info.reset_errors"
[docs]class ComponentCallerTopic(object): CALL_COMPONENT = "comp_caller.call"
[docs]class TrainingTopic(object): START = "train.start" ABORT = "train.abort" ABORT_TASK = "train.abort_task" DELETE_RUN = "train.delete_run" DEPLOY = "train.deploy" SHUTDOWN = "train.shutdown" RESTART = "train.restart" CHECK_STATUS = "train.check_status" SET_JOB_ID = "train.set_job_id" CHECK_RESOURCE = "scheduler.check_resource" ALLOCATE_RESOURCE = "scheduler.allocate_resource" CANCEL_RESOURCE = "scheduler.cancel_resource" START_JOB = "train.start_job" GET_SCOPES = "train.get_scopes" NOTIFY_JOB_STATUS = "train.notify_job_status"
[docs]class RequestHeader(object): JOB_ID = "job_id" JOB_STATUS = "job_status" TOPIC = "topic" JOB_META = "job_meta" APP_NAME = "app_name" CONTROL_COMMAND = "control_command" CALL_NAME = "call_name" COMPONENT_TARGET = "component_target" ADMIN_COMMAND = "admin_command" USER_NAME = ConnProps.USER_NAME USER_ORG = ConnProps.USER_ORG USER_ROLE = ConnProps.USER_ROLE SUBMITTER_NAME = ConnProps.SUBMITTER_NAME SUBMITTER_ORG = ConnProps.SUBMITTER_ORG SUBMITTER_ROLE = ConnProps.SUBMITTER_ROLE REQUIRE_AUTHZ = "require_authz"
[docs]class SysCommandTopic(object): SYS_INFO = "sys.info" SHELL = "sys.shell" REPORT_RESOURCES = "resource_manager.report_resources" REPORT_ENV = "sys.report_env"
[docs]class ControlCommandTopic(object): DO_COMMAND = "control.do_command"
[docs]class ControlCommandName(object): ABORT_TASK = "abort_task" END_RUN = "end_run"
[docs]class ClientStatusKey(object): JOB_ID = "job_id" CURRENT_TASK = "current_task" STATUS = "status" APP_NAME = "app_name" CLIENT_NAME = "client_name" RUNNING_JOBS = "running_jobs"
[docs]class ScopeInfoKey(object): SCOPE_NAMES = "scope_names" DEFAULT_SCOPE = "default_scope"
# TODO:: Remove some of these constants
[docs]class AppFolderConstants: """hard coded file names inside the app folder.""" CONFIG_TRAIN = "config_train.json" CONFIG_ENV = "environment.json"
[docs]class SSLConstants: """hard coded names related to SSL.""" CERT = "ssl_cert" PRIVATE_KEY = "ssl_private_key" ROOT_CERT = "ssl_root_cert"
[docs]class CellChannel: CLIENT_MAIN = "admin" AUX_COMMUNICATION = "aux_communication" SERVER_MAIN = "task" SERVER_COMMAND = "server_command" SERVER_PARENT_LISTENER = "server_parent_listener" CLIENT_COMMAND = "client_command" CLIENT_SUB_WORKER_COMMAND = "client_sub_worker_command" MULTI_PROCESS_EXECUTOR = "multi_process_executor" SIMULATOR_RUNNER = "simulator_runner" RETURN_ONLY = "return_only"
[docs]class CellChannelTopic: Register = "register" Quit = "quit" GET_TASK = "get_task" SUBMIT_RESULT = "submit_result" HEART_BEAT = "heart_beat" EXECUTE_RESULT = "execute_result" FIRE_EVENT = "fire_event" REPORT_JOB_FAILURE = "report_job_failure" SIMULATOR_WORKER_INIT = "simulator_worker_init"
ERROR_MSG_PREFIX = "NVFLARE_ERROR"
[docs]class CellMessageHeaderKeys: CLIENT_NAME = "client_name" CLIENT_IP = "client_ip" PROJECT_NAME = "project_name" TOKEN = "token" SSID = "ssid" UNAUTHENTICATED = "unauthenticated" JOB_ID = "job_id" JOB_IDS = "job_ids" MESSAGE = "message" ABORT_JOBS = "abort_jobs"
[docs]class JobFailureMsgKey: JOB_ID = "job_id" CODE = "code" REASON = "reason"
[docs]def new_cell_message(headers: dict, payload=None): msg_headers = {} if headers: msg_headers.update(headers) return Message(msg_headers, payload)