파이썬 초기화 구성
******************

버전 3.8에 추가.

구조체:

* "PyConfig"

* "PyPreConfig"

* "PyStatus"

* "PyWideStringList"

함수:

* "PyConfig_Clear()"

* "PyConfig_InitIsolatedConfig()"

* "PyConfig_InitPythonConfig()"

* "PyConfig_Read()"

* "PyConfig_SetArgv()"

* "PyConfig_SetBytesArgv()"

* "PyConfig_SetBytesString()"

* "PyConfig_SetString()"

* "PyConfig_SetWideStringList()"

* "PyPreConfig_InitIsolatedConfig()"

* "PyPreConfig_InitPythonConfig()"

* "PyStatus_Error()"

* "PyStatus_Exception()"

* "PyStatus_Exit()"

* "PyStatus_IsError()"

* "PyStatus_IsExit()"

* "PyStatus_NoMemory()"

* "PyStatus_Ok()"

* "PyWideStringList_Append()"

* "PyWideStringList_Insert()"

* "Py_ExitStatusException()"

* "Py_InitializeFromConfig()"

* "Py_PreInitialize()"

* "Py_PreInitializeFromArgs()"

* "Py_PreInitializeFromBytesArgs()"

* "Py_RunMain()"

* "Py_GetArgcArgv()"

사전 구성("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".

   wchar_t* platlibdir

      "sys.platlibdir": 플랫폼 라이브러리 디렉터리 이름, "--with-
      platlibdir"로 구성 시간에 설정됩니다, "PYTHONPLATLIBDIR" 환경 변
      수로 재정의할 수 있습니다.

      버전 3.9에 추가.

   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

      0이 아니면, 파이썬 개발 모드를 활성화합니다.

   int dump_refs

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

      "Py_TRACE_REFS" 매크로가 빌드에서 정의되어야 합니다.

   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_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".

   int _use_peg_parser

      PEG 구문 분석기를 활성화합니까? 기본값: 1.

      "-X oldparser"와 "PYTHONOLDPARSER"로 0으로 설정합니다.

      **PEP 617**도 참조하십시오.

      Deprecated since version 3.9, will be removed in version 3.10.

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

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

버전 3.9에서 변경: "show_alloc_count" 필드가 제거되었습니다.


PyConfig를 사용한 초기화
========================

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

PyStatus Py_InitializeFromConfig(const PyConfig *config)

   *config* 구성에서 파이썬을 초기화합니다.

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

If "PyImport_FrozenModules()", "PyImport_AppendInittab()" or
"PyImport_ExtendInittab()" are used, they must be set or called after
Python preinitialization and before the Python initialization. If
Python is initialized multiple times, "PyImport_AppendInittab()" or
"PyImport_ExtendInittab()" must be called before each Python
initialization.

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

   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()"
함수는 시스템에서 파이썬을 격리하는 구성을 만듭니다. 예를 들어, 파이썬
을 응용 프로그램에 내장하기 위해.

This configuration ignores global configuration variables, environment
variables, command line arguments ("PyConfig.argv" is not parsed) and
user site directory. The C standard streams (ex: "stdout") and the
LC_CTYPE locale are left unchanged. Signal handlers are not installed.

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


파이썬 구성
===========

"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.platlibdir"

  * "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는 파이썬 버전입니다).

* 경로 구성 출력 필드:

  * "PyConfig.base_exec_prefix"

  * "PyConfig.base_executable"

  * "PyConfig.base_prefix"

  * "PyConfig.exec_prefix"

  * "PyConfig.executable"

  * "PyConfig.module_search_paths_set", "PyConfig.module_search_paths"

  * "PyConfig.prefix"

적어도 하나의 "출력 필드"가 설정되어 있지 않으면, 파이썬은 설정되지 않
은 필드를 채우기 위해 경로 구성을 계산합니다.
"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()"을 사용하여 항상 격리 모드에서 실행되는 사용자 정의 파이
썬의 예는 파이썬 구성을 참조하십시오.


Py_GetArgcArgv()
================

void Py_GetArgcArgv(int *argc, wchar_t ***argv)

   파이썬이 수정하기 전의, 원래 명령 줄 인자를 가져옵니다.


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

This section is a private provisional API introducing multi-phase
initialization, the core feature of **PEP 432**:

* "핵심(Core)" 초기화 단계, "최소한의 파이썬":

  * 내장형;

  * 내장 예외;

  * 내장과 프로즌 모듈(frozen modules);

  * "sys" 모듈은 부분적으로만 초기화됩니다 (예를 들어: "sys.path"는 아
    직 존재하지 않습니다).

* "주(Main)" 초기화 단계, 파이썬이 완전히 초기화됩니다:

  * "importlib"를 설치하고 구성합니다;

  * 경로 구성을 적용합니다;

  * 시그널 처리기를 설치합니다;

  * "sys" 모듈 초기화를 완료합니다 (예를 들어: "sys.stdout"과
    "sys.path"를 만듭니다);

  * "faulthandler"와 "tracemalloc"과 같은 선택적 기능을 활성화합니다;

  * "site" 모듈을 임포트 합니다;

  * 등등

비공개 잠정적 API:

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

* "PyConfig._isolated_interpreter": 0이 아니면, 스레드, 서브 프로세스
  및 포크를 허용하지 않습니다.

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);
       }
   }
