nautilus_trading/controller.rs
1// -------------------------------------------------------------------------------------------------
2// Copyright (C) 2015-2026 Nautech Systems Pty Ltd. All rights reserved.
3// https://nautechsystems.io
4//
5// Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6// You may not use this file except in compliance with the License.
7// You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16use std::collections::HashMap;
17
18use serde::{Deserialize, Serialize};
19
20/// Configuration for creating controllers from importable paths.
21#[cfg_attr(
22 feature = "python",
23 expect(
24 clippy::unsafe_derive_deserialize,
25 reason = "config deserializes plain fields; unsafe methods come from generated PyO3 integration"
26 )
27)]
28#[derive(Debug, Clone, Deserialize, Serialize)]
29#[serde(deny_unknown_fields)]
30#[cfg_attr(
31 feature = "python",
32 pyo3::pyclass(module = "nautilus_trader.core.nautilus_pyo3.trading", from_py_object)
33)]
34#[cfg_attr(
35 feature = "python",
36 pyo3_stub_gen::derive::gen_stub_pyclass(module = "nautilus_trader.trading")
37)]
38pub struct ImportableControllerConfig {
39 /// The fully qualified name of the Controller class.
40 pub controller_path: String,
41 /// The fully qualified name of the Controller config class.
42 pub config_path: String,
43 /// The controller configuration as a dictionary.
44 pub config: HashMap<String, serde_json::Value>,
45}