파이썬 초기화 구성¶

버전 3.8에 추가.

구조체:

PyConfig
PyPreConfig
PyStatus
PyWideStringList

함수:

사전 구성(PyPreConfig 형)은 _PyRuntime.preconfig에 저장되고 구성(PyConfig 형)은 PyInterpreterState.config에 저장됩니다.

초기화, 파이널리제이션 및 스레드도 참조하십시오.

PEP 587 “파이썬 초기화 구성”.

PyWideStringList¶

PyWideStringList¶

wchar_t* 문자열의 리스트.

length가 0이 아니면, items는 NULL이 아니어야 하고 모든 문자열은 NULL이 아니어야 합니다.

메서드:

PyStatus PyWideStringList_Append(PyWideStringList *list, const wchar_t *item)¶

item을 list에 추가합니다.

이 함수를 호출하려면 파이썬을 사전 초기화해야 합니다.

PyStatus PyWideStringList_Insert(PyWideStringList *list, Py_ssize_t index, const wchar_t *item)¶

item을 list의 index에 삽입합니다.

index가 list 길이보다 크거나 같으면, item을 list에 추가(append)합니다.

index는 0보다 크거나 같아야 합니다.

이 함수를 호출하려면 파이썬을 사전 초기화해야 합니다.

구조체 필드:

Py_ssize_t length¶: 리스트 길이.

wchar_t** items¶: 리스트 항목들.

PyStatus¶

PyStatus¶

초기화 함수 상태를 저장하는 구조체: 성공, 에러 또는 종료.

에러의 경우, 에러를 만든 C 함수 이름을 저장할 수 있습니다.

구조체 필드:

int exitcode¶: 종료 코드. exit()에 전달된 인자.

const char *err_msg¶: 에러 메시지.

const char *func¶: 에러를 만든 함수의 이름, NULL일 수 있습니다.

상태를 만드는 함수:

PyStatus PyStatus_Ok(void)¶: 성공.

PyStatus PyStatus_Error(const char *err_msg)¶: 메시지가 포함된 초기화 에러.

PyStatus PyStatus_NoMemory(void)¶: 메모리 할당 실패 (메모리 부족).

PyStatus PyStatus_Exit(int exitcode)¶: 지정된 종료 코드로 파이썬을 종료합니다.

상태를 처리하는 함수:

int PyStatus_Exception(PyStatus status)¶: 상태가 에러입니까? 아니면 종료입니까? 참이면, 예외를 처리해야 합니다; 예를 들어 Py_ExitStatusException() 을 호출하여.

int PyStatus_IsError(PyStatus status)¶: 결과가 에러입니까?

int PyStatus_IsExit(PyStatus status)¶: 결과가 종료입니까?

void Py_ExitStatusException(PyStatus status)¶: status가 종료이면 exit(exitcode)를 호출합니다. status가 에러이면 에러 메시지를 인쇄하고 0이 아닌 종료 코드로 종료합니다. PyStatus_Exception(status)가 0이 아닐 때만 호출해야 합니다.

참고

내부적으로, 파이썬은 PyStatus.func를 설정하는 데는 매크로를 사용하는 반면, func가 NULL로 설정된 상태를 만드는 데는 함수를 사용합니다.

예:

PyStatus alloc(void **ptr, size_t size)
{
    *ptr = PyMem_RawMalloc(size);
    if (*ptr == NULL) {
        return PyStatus_NoMemory();
    }
    return PyStatus_Ok();
}

int main(int argc, char **argv)
{
    void *ptr;
    PyStatus status = alloc(&ptr, 16);
    if (PyStatus_Exception(status)) {
        Py_ExitStatusException(status);
    }
    PyMem_Free(ptr);
    return 0;
}

PyPreConfig¶

PyPreConfig¶

파이썬을 사전 초기화하는 데 사용되는 구조체:

파이썬 메모리 할당자를 설정합니다
LC_CTYPE 로케일을 구성합니다
UTF-8 모드를 설정합니다

사전 구성을 초기화하는 함수:

void PyPreConfig_InitPythonConfig(PyPreConfig *preconfig)¶: 파이썬 구성으로 사전 구성을 초기화합니다.

void PyPreConfig_InitIsolatedConfig(PyPreConfig *preconfig)¶: 격리된 구성으로 사전 구성을 초기화합니다.

구조체 필드:

int allocator¶

메모리 할당자의 이름:

PYMEM_ALLOCATOR_NOT_SET (0): 메모리 할당자를 변경하지 않습니다 (기본값을 사용합니다)
PYMEM_ALLOCATOR_DEFAULT (1): 기본 메모리 할당자
PYMEM_ALLOCATOR_DEBUG (2): 디버그 훅이 있는 기본 메모리 할당자
PYMEM_ALLOCATOR_MALLOC (3): malloc()의 사용을 강제합니다
PYMEM_ALLOCATOR_MALLOC_DEBUG (4): 디버그 훅이 있는 malloc()의 사용을 강제합니다
PYMEM_ALLOCATOR_PYMALLOC (5): 파이썬 pymalloc 메모리 할당자
PYMEM_ALLOCATOR_PYMALLOC_DEBUG (6): 디버그 훅이 있는 파이썬 pymalloc 메모리 할당자

파이썬이 --without-pymalloc을 사용하여 구성되면 PYMEM_ALLOCATOR_PYMALLOC과 PYMEM_ALLOCATOR_PYMALLOC_DEBUG은 지원되지 않습니다

메모리 관리를 참조하십시오.

int configure_locale¶: LC_CTYPE 로케일을 사용자 선호 로케일로 설정합니까?? 0과 같으면, coerce_c_locale과 coerce_c_locale_warn을 0으로 설정합니다.

int coerce_c_locale¶: 2와 같으면, C 로케일을 강제합니다; 1과 같으면, LC_CTYPE 로케일을 읽고 강제할지 결정합니다.

int coerce_c_locale_warn¶: 0이 아니면, C 로케일이 강제될 때 경고가 발생합니다.

int dev_mode¶: PyConfig.dev_mode를 참조하십시오.

int isolated¶: PyConfig.isolated를 참조하십시오.

int legacy_windows_fs_encoding(Windows only)¶

0이 아니면, UTF-8 모드를 비활성화하고, 파이썬 파일 시스템 인코딩을 mbcs로 설정하고, 파일 시스템 에러 처리기를 replace로 설정합니다.

윈도우에서만 사용 가능합니다. #ifdef MS_WINDOWS 매크로는 윈도우 특정 코드에 사용할 수 있습니다.

int parse_argv¶: 0이 아니면, Py_PreInitializeFromArgs()와 Py_PreInitializeFromBytesArgs()는 일반 파이썬이 명령 줄 인자를 구문 분석하는 것과 같은 방식으로 argv 인자를 구문 분석합니다. 명령 줄 인자를 참조하십시오.

int use_environment¶: PyConfig.use_environment를 참조하십시오.

int utf8_mode¶: 0이 아니면, UTF-8 모드를 활성화합니다.

PyPreConfig를 사용한 사전 초기화¶

파이썬을 사전 초기화하는 함수:

PyStatus Py_PreInitialize(const PyPreConfig *preconfig)¶: preconfig 사전 구성에서 파이썬을 사전 초기화합니다.

PyStatus Py_PreInitializeFromBytesArgs(const PyPreConfig *preconfig, int argc, char * const *argv)¶: preconfig 사전 구성과 명령 줄 인자(바이트 문자열)에서 파이썬을 사전 초기화합니다.

PyStatus Py_PreInitializeFromArgs(const PyPreConfig *preconfig, int argc, wchar_t * const * argv)¶: preconfig 사전 구성과 명령 줄 인자(와이드 문자열)에서 파이썬을 사전 초기화합니다.

호출자는 PyStatus_Exception()과 Py_ExitStatusException() 을 사용하여 예외(에러나 종료)를 처리해야 합니다.

파이썬 구성(PyPreConfig_InitPythonConfig())의 경우, 명령 줄 인자로 파이썬을 초기화하면, 인코딩과 같은 사전 구성에 영향을 주기 때문에, 파이썬을 사전 구성하기 위해 명령 줄 인자도 전달되어야 합니다. 예를 들어, -X utf8 명령 줄 옵션은 UTF-8 모드를 활성화합니다.

PyMem_SetAllocator()는 Py_PreInitialize() 이후에 Py_InitializeFromConfig() 이전에 호출하여 사용자 정의 메모리 할당자를 설치할 수 있습니다. PyPreConfig.allocator가 PYMEM_ALLOCATOR_NOT_SET으로 설정되면 Py_PreInitialize() 전에 호출할 수 있습니다.

PyMem_RawMalloc()과 같은 파이썬 메모리 할당 함수는 파이썬 사전 초기화 전에 사용해서는 안 되지만, malloc()과 free()를 직접 호출하는 것은 항상 안전합니다. 사전 초기화 전에 Py_DecodeLocale()을 호출하면 안 됩니다.

UTF-8 모드를 활성화하기 위해 사전 초기화를 사용하는 예:

PyStatus status;
PyPreConfig preconfig;
PyPreConfig_InitPythonConfig(&preconfig);

preconfig.utf8_mode = 1;

status = Py_PreInitialize(&preconfig);
if (PyStatus_Exception(status)) {
    Py_ExitStatusException(status);
}

/* at this point, Python will speak UTF-8 */

Py_Initialize();
/* ... use Python API here ... */
Py_Finalize();

PyConfig¶

PyConfig¶

파이썬을 구성하기 위한 대부분의 파라미터를 포함하는 구조체.

구조체 메서드:

void PyConfig_InitPythonConfig(PyConfig *config)¶: 파이썬 구성으로 구성을 초기화합니다.

void PyConfig_InitIsolatedConfig(PyConfig *config)¶: 격리된 구성으로 구성을 초기화합니다.

PyStatus PyConfig_SetString(PyConfig *config, wchar_t * const *config_str, const wchar_t *str)¶

와이드 문자열 str을 *config_str로 복사합니다.

필요하면 파이썬을 사전 초기화합니다.

PyStatus PyConfig_SetBytesString(PyConfig *config, wchar_t * const *config_str, const char *str)¶

Py_DecodeLocale()을 사용하여 str을 디코딩하고 결과를 *config_str에 설정합니다.

필요하면 파이썬을 사전 초기화합니다.

PyStatus PyConfig_SetArgv(PyConfig *config, int argc, wchar_t * const *argv)¶

와이드 문자열로 명령 줄 인자를 설정합니다.

필요하면 파이썬을 사전 초기화합니다.

PyStatus PyConfig_SetBytesArgv(PyConfig *config, int argc, char * const *argv)¶

명령 줄 인자를 설정합니다: Py_DecodeLocale()를 사용하여 바이트열을 디코딩합니다.

필요하면 파이썬을 사전 초기화합니다.

PyStatus PyConfig_SetWideStringList(PyConfig *config, PyWideStringList *list, Py_ssize_t length, wchar_t **items)¶

와이드 문자열 리스트 list를 length와 items로 설정합니다.

필요하면 파이썬을 사전 초기화합니다.

PyStatus PyConfig_Read(PyConfig *config)¶

모든 파이썬 구성을 읽습니다.

이미 초기화된 필드는 변경되지 않습니다.

필요하면 파이썬을 사전 초기화합니다.

void PyConfig_Clear(PyConfig *config)¶: 구성 메모리를 해제합니다.

대부분의 PyConfig 메서드는 필요하면 파이썬을 사전 초기화합니다. 이 경우, PyConfig를 기반으로 하는 파이썬 사전 초기화 구성입니다. PyPreConfig와 공통인 구성 필드가 조정되면, PyConfig 메서드를 호출하기 전에 설정해야 합니다:

dev_mode
isolated
parse_argv
use_environment

또한, PyConfig_SetArgv()나 PyConfig_SetBytesArgv()가 사용되면, 사전 초기화 구성이 명령 줄 인자 (parse_argv가 0이 아니면)에 의존하기 때문에 다른 메서드보다 먼저 이 메서드를 호출해야 합니다.

이 메서드의 호출자는 PyStatus_Exception()과 Py_ExitStatusException() 을 사용하여 예외(에러나 종료)를 처리해야 합니다.

구조체 필드:

PyWideStringList argv¶: 명령 줄 인자, sys.argv. 일반 파이썬이 파이썬 명령 줄 인자를 구문 분석하는 것과 같은 방식으로 argv를 구문 분석하려면 parse_argv를 참조하십시오. argv가 비어 있으면, 빈 문자열이 추가되어 sys.argv가 항상 존재하고 절대로 비어 있지 않도록 합니다.

wchar_t* base_exec_prefix¶: sys.base_exec_prefix.

wchar_t* base_executable¶: sys._base_executable: __PYVENV_LAUNCHER__ 환경 변숫값, 또는 PyConfig.executable의 사본.

wchar_t* base_prefix¶: sys.base_prefix.

int buffered_stdio¶

0과 같으면, 버퍼링 되지 않는 모드를 활성화하여, stdout과 stderr 스트림을 버퍼링하지 않도록 합니다.

stdin은 항상 버퍼링 모드로 열립니다.

int bytes_warning¶: 1과 같으면, bytes나 bytearray를 str와 비교하거나, 또는 bytes를 int와 비교할 때 경고를 발행합니다. 2 이상이면, BytesWarning 예외를 발생시킵니다.

wchar_t* check_hash_pycs_mode¶

해시 기반 .pyc 파일의 유효성 검증 동작을 제어합니다 (PEP 552를 참조하십시오): --check-hash-based-pycs 명령 줄 옵션 값.

유효한 값: always, never 및 default.

기본값은 default입니다.

int configure_c_stdio¶: 0이 아니면, C 표준 스트림(stdio, stdout, stdout)을 구성합니다. 예를 들어, 윈도우에서 해당 모드를 O_BINARY로 설정합니다.

int dev_mode¶: 개발 모드: -X dev를 참조하십시오.

int dump_refs¶

0이 아니면, 종료 시 여전히 활성 상태인 모든 객체를 덤프합니다.

파이썬의 디버그 빌드가 필요합니다 (Py_REF_DEBUG 매크로를 정의해야 합니다).

wchar_t* exec_prefix¶: sys.exec_prefix.

wchar_t* executable¶: sys.executable.

int faulthandler¶: 0이 아니면, 시작 시 faulthandler.enable()을 호출합니다.

wchar_t* filesystem_encoding¶: 파일 시스템 인코딩, sys.getfilesystemencoding().

wchar_t* filesystem_errors¶: 파일 시스템 인코딩 에러, sys.getfilesystemencodeerrors().

unsigned long hash_seed¶

int use_hash_seed¶

무작위 해시 함수 시드.

use_hash_seed가 0이면, 파이썬 시작 시 시드가 무작위로 선택되고, hash_seed는 무시됩니다.

wchar_t* home¶

파이썬 홈 디렉터리.

기본적으로 PYTHONHOME 환경 변숫값에서 초기화됩니다.

int import_time¶: 0이 아니면, 임포트 시간을 프로파일 합니다.

int inspect¶: 스크립트나 명령을 실행한 후 대화식 모드로 들어갑니다.

int install_signal_handlers¶: 시그널 처리기를 설치합니까?

int interactive¶: 대화식 모드.

int isolated¶

0보다 크면, 격리 모드를 활성화합니다:

sys.path에는 스크립트 디렉터리(argv[0]이나 현재 디렉터리에서 계산됩니다)도 사용자의 site-packages 디렉터리도 없습니다.
파이썬 REPL은 대화식 프롬프트에서 readline을 임포트 하지도 기본 readline 구성을 활성화하지도 않습니다.
use_environment와 user_site_directory를 0으로 설정합니다.

int legacy_windows_stdio¶

0이 아니면, sys.stdin, sys.stdout 및 sys.stderr에 io.WindowsConsoleIO 대신 io.FileIO를 사용합니다.

윈도우에서만 사용 가능합니다. #ifdef MS_WINDOWS 매크로는 윈도우 특정 코드에 사용할 수 있습니다.

int malloc_stats¶

0이 아니면, 종료 시 파이썬 pymalloc 메모리 할당자에 대한 통계를 덤프합니다.

파이썬이 --without-pymalloc을 사용하여 빌드되면 이 옵션은 무시됩니다.

wchar_t* pythonpath_env¶

DELIM(os.path.pathsep)으로 구분된 문자열로 표현된 모듈 검색 경로.

기본적으로 PYTHONPATH 환경 변숫값에서 초기화됩니다.

PyWideStringList module_search_paths¶

int module_search_paths_set¶: sys.path. module_search_paths_set이 0과 같으면, 경로 구성을 계산하는 함수가 module_search_paths를 재정의합니다.

int optimization_level¶

컴파일 최적화 수준:

0: 틈 구멍 최적화기(Peephole optimizer) (그리고 __debug__이 True로 설정됩니다)
1: 어서션을 제거합니다, __debug__을 False로 설정합니다
2: 독스트링을 제거합니다

int parse_argv¶: 0이 아니면, 일반 파이썬 명령 줄 인자와 같은 방식으로 argv를 구문 분석하고, argv에서 파이썬 인자를 제거합니다: 명령 줄 인자를 참조하십시오.

int parser_debug¶: 0이 아니면, 구문 분석기 디버깅 출력을 켭니다 (컴파일 옵션에 따라, 전문가용입니다).

int pathconfig_warnings¶: 0과 같으면, 경로 구성을 계산할 때 경고를 억제합니다 (유닉스 전용, 윈도우는 아무런 경고도 로그 하지 않습니다). 그렇지 않으면, 경고가 stderr에 기록됩니다.

wchar_t* prefix¶: sys.prefix.

wchar_t* program_name¶: 프로그램 이름. executable을 초기화하는 데 사용되며, 초기 에러 메시지에서도 사용됩니다.

wchar_t* pycache_prefix¶

sys.pycache_prefix: .pyc 캐시 접두사.

NULL이면, sys.pycache_prefix는 None으로 설정됩니다.

int quiet¶: 침묵 모드. 예를 들어, 대화식 모드에서 저작권과 버전 메시지를 표시하지 않습니다.

wchar_t* run_command¶: python3 -c COMMAND 인자. Py_RunMain()에서 사용합니다.

wchar_t* run_filename¶: python3 FILENAME 인자. Py_RunMain()에서 사용합니다.

wchar_t* run_module¶: python3 -m MODULE 인자. Py_RunMain()에서 사용합니다.

int show_alloc_count¶

종료 시 할당 횟수를 표시합니까?

-X showalloccount 명령 줄 옵션으로 1로 설정됩니다.

COUNT_ALLOCS 매크로가 정의된 특수한 파이썬 빌드가 필요합니다.

int show_ref_count¶

종료 시 총 참조 횟수를 표시합니까?

-X showrefcount 명령 줄 옵션으로 1로 설정됩니다.

파이썬의 디버그 빌드가 필요합니다 (Py_REF_DEBUG 매크로를 정의해야 합니다).

int site_import¶: 시작할 때 site 모듈을 임포트 합니까?

int skip_source_first_line¶: 소스의 첫 줄을 건너뜁니까?

wchar_t* stdio_encoding¶

wchar_t* stdio_errors¶: sys.stdin, sys.stdout 및 sys.stderr의 인코딩과 인코딩 에러.

int tracemalloc¶: 0이 아니면, 시작 시 tracemalloc.start()를 호출합니다.

int use_environment¶: 0보다 크면, 환경 변수를 사용합니다.

int user_site_directory¶: 0이 아니면, 사용자 사이트 디렉터리를 sys.path에 추가합니다.

int verbose¶: 0이 아니면, 상세 모드를 활성화합니다.

PyWideStringList warnoptions¶

sys.warnoptions: 경고 필터를 빌드하기 위한 warnings 모듈의 옵션: 가장 낮은 것에서 가장 높은 우선순위로.

warnings 모듈은 sys.warnoptions를 역순으로 추가합니다: 마지막 PyConfig.warnoptions 항목은 가장 먼저 검사되는 warnings.filters의 첫 번째 항목이 됩니다 (가장 높은 우선순위).

int write_bytecode¶

0이 아니면, .pyc 파일을 기록합니다.

sys.dont_write_bytecode는 write_bytecode의 반전된 값으로 초기화됩니다.

PyWideStringList xoptions¶: sys._xoptions.

parse_argv가 0이 아니면, 일반 파이썬이 명령 줄 인자를 구문 분석하는 것과 같은 방식으로 argv 인자가 구문 분석되고, argv에서 파이썬 인자가 제거됩니다: 명령 줄 인자를 참조하십시오.

xoptions 옵션은 다른 옵션을 설정하기 위해 구문 분석됩니다: -X 옵션을 참조하십시오.

PyConfig를 사용한 초기화¶

파이썬을 초기화하는 함수:

PyStatus Py_InitializeFromConfig(const PyConfig *config)¶: config 구성에서 파이썬을 초기화합니다.

호출자는 PyStatus_Exception()과 Py_ExitStatusException() 을 사용하여 예외(에러나 종료)를 처리해야 합니다.

PyImport_FrozenModules, PyImport_AppendInittab() 또는 PyImport_ExtendInittab() 을 사용하면, 파이썬 사전 초기화 후에 그리고 파이썬 초기화 전에 설정하거나 호출해야 합니다.

프로그램 이름을 설정하는 예:

void init_python(void)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);

    /* Set the program name. Implicitly preinitialize Python. */
    status = PyConfig_SetString(&config, &config.program_name,
                                L"/path/to/my_program");
    if (PyStatus_Exception(status)) {
        goto fail;
    }

    status = Py_InitializeFromConfig(&config);
    if (PyStatus_Exception(status)) {
        goto fail;
    }
    PyConfig_Clear(&config);
    return;

fail:
    PyConfig_Clear(&config);
    Py_ExitStatusException(status);
}

기본 구성을 수정하는 더 완전한 예, 구성을 읽은 다음 일부 파라미터를 대체합니다:

PyStatus init_python(const char *program_name)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);

    /* Set the program name before reading the configuration
       (decode byte string from the locale encoding).

       Implicitly preinitialize Python. */
    status = PyConfig_SetBytesString(&config, &config.program_name,
                                  program_name);
    if (PyStatus_Exception(status)) {
        goto done;
    }

    /* Read all configuration at once */
    status = PyConfig_Read(&config);
    if (PyStatus_Exception(status)) {
        goto done;
    }

    /* Append our custom search path to sys.path */
    status = PyWideStringList_Append(&config.module_search_paths,
                                     L"/path/to/more/modules");
    if (PyStatus_Exception(status)) {
        goto done;
    }

    /* Override executable computed by PyConfig_Read() */
    status = PyConfig_SetString(&config, &config.executable,
                                L"/path/to/my_executable");
    if (PyStatus_Exception(status)) {
        goto done;
    }

    status = Py_InitializeFromConfig(&config);

done:
    PyConfig_Clear(&config);
    return status;
}

격리된 구성¶

PyPreConfig_InitIsolatedConfig()와 PyConfig_InitIsolatedConfig() 함수는 시스템에서 파이썬을 격리하는 구성을 만듭니다. 예를 들어, 파이썬을 응용 프로그램에 내장하기 위해.

이 구성은 전역 구성 변수, 환경 변수, 명령 줄 인자 (PyConfig.argv가 구문 분석되지 않습니다) 및 사용자 사이트 디렉터리를 무시합니다. C 표준 스트림(예를 들어 stdout)과 LC_CTYPE 로케일은 변경되지 않습니다. 시그널 처리기가 설치되지 않습니다.

구성 파일은 여전히 이 구성에 사용됩니다. 이러한 구성 파일을 무시하고 기본 경로 구성을 계산하는 함수를 피하려면 경로 구성( “출력 필드”) 을 설정하십시오.

파이썬 구성¶

PyPreConfig_InitPythonConfig()와 PyConfig_InitPythonConfig() 함수는 일반 파이썬처럼 동작하는 사용자 정의된 파이썬을 빌드하기 위한 구성을 만듭니다.

환경 변수와 명령 줄 인자는 파이썬을 구성하는 데 사용되는 반면, 전역 구성 변수는 무시됩니다.

이 함수는 LC_CTYPE 로케일, PYTHONUTF8 및 PYTHONCOERCECLOCALE 환경 변수에 따라 C 로케일 강제(PEP 538)와 UTF-8 모드(PEP 540)를 활성화합니다.

항상 격리 모드에서 실행되는 사용자 정의 파이썬의 예:

int main(int argc, char **argv)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);
    config.isolated = 1;

    /* Decode command line arguments.
       Implicitly preinitialize Python (in isolated mode). */
    status = PyConfig_SetBytesArgv(&config, argc, argv);
    if (PyStatus_Exception(status)) {
        goto fail;
    }

    status = Py_InitializeFromConfig(&config);
    if (PyStatus_Exception(status)) {
        goto fail;
    }
    PyConfig_Clear(&config);

    return Py_RunMain();

fail:
    PyConfig_Clear(&config);
    if (PyStatus_IsExit(status)) {
        return status.exitcode;
    }
    /* Display the error message and exit the process with
       non-zero exit code */
    Py_ExitStatusException(status);
}

경로 구성¶

PyConfig에는 경로 구성을 위한 여러 필드가 포함되어 있습니다:

경로 구성 입력:
- PyConfig.home
- PyConfig.pathconfig_warnings
- PyConfig.program_name
- PyConfig.pythonpath_env
- 현재 작업 디렉터리: 절대 경로를 얻기 위해
- (PyConfig.program_name에서) 프로그램 전체 경로를 얻기 위한 PATH 환경 변수
- __PYVENV_LAUNCHER__ 환경 변수
- (윈도우 전용) HKEY_CURRENT_USER와 HKEY_LOCAL_MACHINE의 “SoftwarePythonPythonCoreX.YPythonPath” 아래에 있는 레지스트리의 응용 프로그램 경로 (여기서 X.Y는 파이썬 버전입니다).
경로 구성 출력 필드:

적어도 하나의 “출력 필드”가 설정되어 있지 않으면, 파이썬은 설정되지 않은 필드를 채우기 위해 경로 구성을 계산합니다. module_search_paths_set이 0이면, module_search_paths가 재정의되고 module_search_paths_set이 1로 설정됩니다.

위에 나열된 모든 경로 구성 출력 필드를 명시적으로 설정하여 기본 경로 구성을 계산하는 함수를 완전히 무시할 수 있습니다. 비어 있지 않아도 문자열은 설정된 것으로 간주합니다. module_search_paths_set이 1로 설정되면 module_search_paths는 설정된 것으로 간주합니다. 이 경우, 경로 구성 입력 필드도 무시됩니다.

경로 구성을 계산할 때 경고를 억제하려면 pathconfig_warnings를 0으로 설정하십시오 (유닉스 전용, 윈도우는 어떤 경고도 로그 하지 않습니다).

base_prefix나 base_exec_prefix 필드가 설정되지 않으면, 각각 prefix와 exec_prefix의 값을 상속합니다.

Py_RunMain()과 Py_Main()은 sys.path를 수정합니다:

run_filename이 설정되고 __main__.py 스크립트를 포함하는 디렉터리이면, run_filename을 sys.path 앞에 추가합니다.
isolated가 0이면:
- run_module이 설정되면, 현재 디렉터리를 sys.path 앞에 추가합니다. 현재 디렉터리를 읽을 수 없으면 아무것도 하지 않습니다.
- run_filename이 설정되면, 파일명의 디렉터리를 sys.path 앞에 추가합니다.
- 그렇지 않으면, 빈 문자열을 sys.path 앞에 추가합니다.

site_import가 0이 아니면, site 모듈이 sys.path를 수정할 수 있습니다. user_site_directory가 0이 아니고 사용자의 site-package 디렉터리가 존재하면, site 모듈은 사용자의 site-package 디렉터리를 sys.path에 추가합니다.

다음과 같은 구성 파일이 경로 구성에 사용됩니다:

pyvenv.cfg
python._pth (윈도우 전용)
pybuilddir.txt (유닉스 전용)

__PYVENV_LAUNCHER__ 환경 변수는 PyConfig.base_executable을 설정하는 데 사용됩니다

Py_RunMain()¶

int Py_RunMain(void)¶

명령 줄이나 구성에서 지정된 명령 (PyConfig.run_command), 스크립트 (PyConfig.run_filename) 또는 모듈 (PyConfig.run_module)을 실행합니다.

기본적으로, 그리고 -i 옵션을 사용할 때, REPL을 실행합니다.

마지막으로, 파이썬을 파이널라이즈 하고 exit() 함수에 전달할 수 있는 종료 상태를 반환합니다.

Py_RunMain()을 사용하여 항상 격리 모드에서 실행되는 사용자 정의 파이썬의 예는 파이썬 구성을 참조하십시오.

다단계 초기화 비공개 잠정적 API¶

이 섹션은 PEP 432의 핵심 기능인 다단계 초기화를 소개하는 비공개 잠정적 API입니다:

“핵심(Core)” 초기화 단계, “최소한의 파이썬”:
- 내장형;
- 내장 예외;
- 내장과 프로즌 모듈(frozen modules);
- sys 모듈은 부분적으로만 초기화됩니다 (예를 들어: sys.path는 아직 존재하지 않습니다).
“주(Main)” 초기화 단계, 파이썬이 완전히 초기화됩니다:
- importlib를 설치하고 구성합니다;
- 경로 구성을 적용합니다;
- 시그널 처리기를 설치합니다;
- sys 모듈 초기화를 완료합니다 (예를 들어: sys.stdout과 sys.path를 만듭니다);
- faulthandler와 tracemalloc과 같은 선택적 기능을 활성화합니다;
- site 모듈을 임포트 합니다;
- 등등

비공개 잠정적 API:

PyConfig._init_main: 0으로 설정되면, Py_InitializeFromConfig()는 “핵심” 초기화 단계에서 중단합니다.

PyStatus _Py_InitializeMain(void)¶: “주” 초기화 단계로 이동하여, 파이썬 초기화를 완료합니다.

“핵심” 단계에서는 아무런 모듈도 임포트 하지 않고 importlib 모듈이 구성되지 않습니다: 경로 구성은 “주” 단계에서만 적용됩니다. 경로 구성을 재정의하거나 조정하기 위해 파이썬에서 파이썬을 사용자 정의할 수 있으며, 사용자 정의 sys.meta_path 임포터(importer)나 임포트 훅 등을 설치할 수 있습니다.

핵심 단계 이후에 주 단계 이전에 파이썬에서 경로 구성을 계산할 수 있게 될 수 있고, 이것이 PEP 432의 동기 중 하나입니다.

“핵심” 단계가 제대로 정의되지 않았습니다: 이 단계에서 무엇을 사용할 수 있고, 무엇이 그렇지 않아야 하는지는 아직 지정되지 않았습니다. API는 비공개이자 잠정적인 것으로 표시됩니다: 적절한 공개 API가 설계될 때까지 언제든지 API를 수정하거나 제거할 수 있습니다.

“핵심”과 “주” 초기화 단계 사이에서 파이썬 코드를 실행하는 예제:

void init_python(void)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);
    config._init_main = 0;

    /* ... customize 'config' configuration ... */

    status = Py_InitializeFromConfig(&config);
    PyConfig_Clear(&config);
    if (PyStatus_Exception(status)) {
        Py_ExitStatusException(status);
    }

    /* Use sys.stderr because sys.stdout is only created
       by _Py_InitializeMain() */
    int res = PyRun_SimpleString(
        "import sys; "
        "print('Run Python code before _Py_InitializeMain', "
               "file=sys.stderr)");
    if (res < 0) {
        exit(1);
    }

    /* ... put more configuration code here ... */

    status = _Py_InitializeMain();
    if (PyStatus_Exception(status)) {
        Py_ExitStatusException(status);
    }
}

파이썬 초기화 구성¶

PyWideStringList¶

PyStatus¶

PyPreConfig¶

PyPreConfig를 사용한 사전 초기화¶

PyConfig¶

PyConfig를 사용한 초기화¶

격리된 구성¶

파이썬 구성¶

경로 구성¶

Py_RunMain()¶

다단계 초기화 비공개 잠정적 API¶

목차

이전 항목

다음 항목

현재 문서