pyo3_ffi/cpython/
initconfig.rs

1/* --- PyStatus ----------------------------------------------- */
2
3use crate::Py_ssize_t;
4use libc::wchar_t;
5use std::ffi::{c_char, c_int, c_ulong};
6
7#[repr(C)]
8#[derive(Copy, Clone, Debug, PartialEq, Eq)]
9pub enum _PyStatus_TYPE {
10    _PyStatus_TYPE_OK = 0,
11    _PyStatus_TYPE_ERROR = 1,
12    _PyStatus_TYPE_EXIT = 2,
13}
14
15#[repr(C)]
16#[derive(Copy, Clone)]
17pub struct PyStatus {
18    pub _type: _PyStatus_TYPE,
19    pub func: *const c_char,
20    pub err_msg: *const c_char,
21    pub exitcode: c_int,
22}
23
24extern "C" {
25    pub fn PyStatus_Ok() -> PyStatus;
26    pub fn PyStatus_Error(err_msg: *const c_char) -> PyStatus;
27    pub fn PyStatus_NoMemory() -> PyStatus;
28    pub fn PyStatus_Exit(exitcode: c_int) -> PyStatus;
29    pub fn PyStatus_IsError(err: PyStatus) -> c_int;
30    pub fn PyStatus_IsExit(err: PyStatus) -> c_int;
31    pub fn PyStatus_Exception(err: PyStatus) -> c_int;
32}
33
34/* --- PyWideStringList ------------------------------------------------ */
35
36#[repr(C)]
37#[derive(Copy, Clone)]
38pub struct PyWideStringList {
39    pub length: Py_ssize_t,
40    pub items: *mut *mut wchar_t,
41}
42
43extern "C" {
44    pub fn PyWideStringList_Append(list: *mut PyWideStringList, item: *const wchar_t) -> PyStatus;
45    pub fn PyWideStringList_Insert(
46        list: *mut PyWideStringList,
47        index: Py_ssize_t,
48        item: *const wchar_t,
49    ) -> PyStatus;
50}
51
52/* --- PyPreConfig ----------------------------------------------- */
53
54#[repr(C)]
55#[derive(Copy, Clone)]
56pub struct PyPreConfig {
57    pub _config_init: c_int,
58    pub parse_argv: c_int,
59    pub isolated: c_int,
60    pub use_environment: c_int,
61    pub configure_locale: c_int,
62    pub coerce_c_locale: c_int,
63    pub coerce_c_locale_warn: c_int,
64
65    #[cfg(windows)]
66    pub legacy_windows_fs_encoding: c_int,
67
68    pub utf8_mode: c_int,
69    pub dev_mode: c_int,
70    pub allocator: c_int,
71}
72
73extern "C" {
74    pub fn PyPreConfig_InitPythonConfig(config: *mut PyPreConfig);
75    pub fn PyPreConfig_InitIsolatedConfig(config: *mut PyPreConfig);
76}
77
78/* --- PyConfig ---------------------------------------------- */
79
80#[repr(C)]
81#[derive(Copy, Clone)]
82pub struct PyConfig {
83    pub _config_init: c_int,
84    pub isolated: c_int,
85    pub use_environment: c_int,
86    pub dev_mode: c_int,
87    pub install_signal_handlers: c_int,
88    pub use_hash_seed: c_int,
89    pub hash_seed: c_ulong,
90    pub faulthandler: c_int,
91    #[cfg(all(Py_3_9, not(Py_3_10)))]
92    pub _use_peg_parser: c_int,
93    pub tracemalloc: c_int,
94    #[cfg(Py_3_12)]
95    pub perf_profiling: c_int,
96    #[cfg(Py_3_14)]
97    pub remote_debug: c_int,
98    pub import_time: c_int,
99    #[cfg(Py_3_11)]
100    pub code_debug_ranges: c_int,
101    pub show_ref_count: c_int,
102    #[cfg(not(Py_3_9))]
103    pub show_alloc_count: c_int,
104    pub dump_refs: c_int,
105    #[cfg(Py_3_11)]
106    pub dump_refs_file: *mut wchar_t,
107    pub malloc_stats: c_int,
108    pub filesystem_encoding: *mut wchar_t,
109    pub filesystem_errors: *mut wchar_t,
110    pub pycache_prefix: *mut wchar_t,
111    pub parse_argv: c_int,
112    #[cfg(Py_3_10)]
113    pub orig_argv: PyWideStringList,
114    pub argv: PyWideStringList,
115    #[cfg(not(Py_3_10))]
116    pub program_name: *mut wchar_t,
117    pub xoptions: PyWideStringList,
118    pub warnoptions: PyWideStringList,
119    pub site_import: c_int,
120    pub bytes_warning: c_int,
121    #[cfg(Py_3_10)]
122    pub warn_default_encoding: c_int,
123    pub inspect: c_int,
124    pub interactive: c_int,
125    pub optimization_level: c_int,
126    pub parser_debug: c_int,
127    pub write_bytecode: c_int,
128    pub verbose: c_int,
129    pub quiet: c_int,
130    pub user_site_directory: c_int,
131    pub configure_c_stdio: c_int,
132    pub buffered_stdio: c_int,
133    pub stdio_encoding: *mut wchar_t,
134    pub stdio_errors: *mut wchar_t,
135
136    #[cfg(windows)]
137    pub legacy_windows_stdio: c_int,
138
139    pub check_hash_pycs_mode: *mut wchar_t,
140    #[cfg(Py_3_11)]
141    pub use_frozen_modules: c_int,
142    #[cfg(Py_3_11)]
143    pub safe_path: c_int,
144    #[cfg(Py_3_12)]
145    pub int_max_str_digits: c_int,
146    #[cfg(Py_3_14)]
147    pub thread_inherit_context: c_int,
148    #[cfg(Py_3_14)]
149    pub context_aware_warnings: c_int,
150    #[cfg(all(Py_3_14, target_os = "macos"))]
151    pub use_system_logger: c_int,
152    #[cfg(Py_3_13)]
153    pub cpu_count: c_int,
154    #[cfg(Py_GIL_DISABLED)]
155    pub enable_gil: c_int,
156    #[cfg(all(Py_3_14, Py_GIL_DISABLED))]
157    pub tlbc_enabled: c_int,
158    #[cfg(Py_3_15)]
159    pub lazy_imports: c_int,
160    pub pathconfig_warnings: c_int,
161    #[cfg(Py_3_10)]
162    pub program_name: *mut wchar_t,
163    pub pythonpath_env: *mut wchar_t,
164    pub home: *mut wchar_t,
165    #[cfg(Py_3_10)]
166    pub platlibdir: *mut wchar_t,
167
168    pub module_search_paths_set: c_int,
169    pub module_search_paths: PyWideStringList,
170    #[cfg(Py_3_11)]
171    pub stdlib_dir: *mut wchar_t,
172    pub executable: *mut wchar_t,
173    pub base_executable: *mut wchar_t,
174    pub prefix: *mut wchar_t,
175    pub base_prefix: *mut wchar_t,
176    pub exec_prefix: *mut wchar_t,
177    pub base_exec_prefix: *mut wchar_t,
178    #[cfg(all(Py_3_9, not(Py_3_10)))]
179    pub platlibdir: *mut wchar_t,
180    pub skip_source_first_line: c_int,
181    pub run_command: *mut wchar_t,
182    pub run_module: *mut wchar_t,
183    pub run_filename: *mut wchar_t,
184    #[cfg(Py_3_13)]
185    pub sys_path_0: *mut wchar_t,
186    pub _install_importlib: c_int,
187    pub _init_main: c_int,
188    #[cfg(all(Py_3_9, not(Py_3_12)))]
189    pub _isolated_interpreter: c_int,
190    #[cfg(Py_3_11)]
191    pub _is_python_build: c_int,
192    #[cfg(all(Py_3_9, not(Py_3_10)))]
193    pub _orig_argv: PyWideStringList,
194    #[cfg(all(Py_3_13, py_sys_config = "Py_DEBUG"))]
195    pub run_presite: *mut wchar_t,
196}
197
198extern "C" {
199    pub fn PyConfig_InitPythonConfig(config: *mut PyConfig);
200    pub fn PyConfig_InitIsolatedConfig(config: *mut PyConfig);
201    pub fn PyConfig_Clear(config: *mut PyConfig);
202    pub fn PyConfig_SetString(
203        config: *mut PyConfig,
204        config_str: *mut *mut wchar_t,
205        str: *const wchar_t,
206    ) -> PyStatus;
207    pub fn PyConfig_SetBytesString(
208        config: *mut PyConfig,
209        config_str: *mut *mut wchar_t,
210        str: *const c_char,
211    ) -> PyStatus;
212    pub fn PyConfig_Read(config: *mut PyConfig) -> PyStatus;
213    pub fn PyConfig_SetBytesArgv(
214        config: *mut PyConfig,
215        argc: Py_ssize_t,
216        argv: *mut *const c_char,
217    ) -> PyStatus;
218    pub fn PyConfig_SetArgv(
219        config: *mut PyConfig,
220        argc: Py_ssize_t,
221        argv: *mut *const wchar_t,
222    ) -> PyStatus;
223    pub fn PyConfig_SetWideStringList(
224        config: *mut PyConfig,
225        list: *mut PyWideStringList,
226        length: Py_ssize_t,
227        items: *mut *mut wchar_t,
228    ) -> PyStatus;
229}
230
231/* --- Helper functions --------------------------------------- */
232
233extern "C" {
234    pub fn Py_GetArgcArgv(argc: *mut c_int, argv: *mut *mut *mut wchar_t);
235}
pyo3_ffi/cpython/initconfig.rs

pyo3_ffi/cpython/
initconfig.rs
