# 모듈 임포트 하기

PyObject* `PyImport_ImportModule`(const char *name)
  Return value: New reference.

  이것은 아래 `PyImport_ImportModuleEx()` 에 대한 단순화된 인터페이스입니다. globals와 locals 인자를 `NULL`로 설정하고 level은 0으로 설정합니다. name 인자에 점이 포함되면 (패키지의 서브 모듈을 지정할 때), fromlist 인자는 리스트 `['*']`로 설정해서 반환 값이 그렇지 않았을 때 반환되는 최상위 수준 패키지 대신에 이름 지정된 모듈이 되도록 합니다. (안타깝게도, name이 실제로 서브 모듈 대신 서브 패키지를 지정하면 추가적인 부작용이 발생합니다: 패키지의 `__all__` 변수에 지정된 서브 모듈들이 로드됩니다.) 임포트 한 모듈에 대한 새로운 참조를 반환하거나 실패 시 예외가 설정된 `NULL`을 반환합니다. 모듈을 임포트 하는 데 실패하면 `sys.modules`에 모듈을 남기지 않습니다.

  이 함수는 항상 절대 임포트를 사용합니다.

PyObject* `PyImport_ImportModuleNoBlock`(const char *name)
  Return value: New reference.

  이 함수는 `PyImport_ImportModule()`의 폐지된 별칭입니다.

  버전 3.3에서 변경: 이 기능은 다른 스레드가 임포트 잠금을 보유한 경우 즉시 실패했었습니다. 그러나 파이썬 3.3에서는, 잠금 방식이 대부분의 목적에서 모듈 단위 잠금으로 전환되었기 때문에, 이 함수의 특수한 동작은 더는 필요하지 않습니다.

PyObject* `PyImport_ImportModuleEx`(const char *name, PyObject *globals, PyObject *locals, PyObject *fromlist)
  Return value: New reference.

  모듈을 임포트 합니다. 내장 파이썬 함수 `__import__()`를 통해 가장 잘 설명할 수 있습니다.

  반환 값은 임포트 된 모듈이나 최상위 패키지에 대한 새로운 참조, 또는 실패 시 예외가 설정된 `NULL`입니다. `__import__()`와 마찬가지로, 비어 있지 않은 fromlist가 제공되지 않는 한, 패키지의 서브 모듈이 요청되었을 때의 반환 값은 최상위 패키지입니다.

  임포트 실패는 `PyImport_ImportModule()`처럼 불완전한 모듈 객체를 제거합니다.

PyObject* `PyImport_ImportModuleLevelObject`(PyObject *name, PyObject *globals, PyObject *locals, PyObject *fromlist, int level)
  Return value: New reference.

  모듈을 임포트 합니다. 표준 `__import__()` 함수가 이 함수를 직접 호출하기 때문에, 내장 파이썬 함수 `__import__()`를 통해 가장 잘 설명할 수 있습니다.

  반환 값은 임포트 된 모듈이나 최상위 패키지에 대한 새로운 참조, 또는 실패 시 예외가 설정된 `NULL`입니다. `__import__()`와 마찬가지로, 비어 있지 않은 fromlist가 제공되지 않는 한, 패키지의 서브 모듈이 요청되었을 때의 반환 값은 최상위 패키지입니다.

  버전 3.3에 추가.

PyObject* `PyImport_ImportModuleLevel`(const char *name, PyObject *globals, PyObject *locals, PyObject *fromlist, int level)
  Return value: New reference.

  `PyImport_ImportModuleLevelObject()`와 비슷하지만, name은 유니코드 객체 대신 UTF-8로 인코딩된 문자열입니다.

  버전 3.3에서 변경: level의 음수 값은 더는 허용되지 않습니다.

PyObject* `PyImport_Import`(PyObject *name)
  Return value: New reference.

  이것은 현재 “임포트 훅 함수”를 호출하는 고수준 인터페이스입니다 (명시적인 level 0을 사용하는데, 절대 임포트를 뜻합니다). 현재 전역의 `__builtins__`에 있는 `__import__()` 함수를 호출합니다. 이는 현재 환경에 설치된 임포트 훅을 사용하여 임포트가 수행됨을 의미합니다.

  이 함수는 항상 절대 임포트를 사용합니다.

PyObject* `PyImport_ReloadModule`(PyObject *m)
  Return value: New reference.

  모듈을 다시 로드(reload)합니다. 다시 로드된 모듈에 대한 참조를 반환하거나, 실패 시 예외가 설정된 `NULL`을 반환합니다 (이때 모듈은 여전히 존재합니다).

PyObject* `PyImport_AddModuleObject`(PyObject *name)
  Return value: Borrowed reference.

  모듈 이름에 해당하는 모듈 객체를 반환합니다. name 인자는 `package.module` 형식일 수 있습니다. 먼저 모듈 딕셔너리에 있는지 확인하고, 없으면 새로 만들어 모듈 딕셔너리에 삽입합니다. 실패 시 예외를 설정하고 `NULL`을 반환합니다.

  참고

  이 함수는 모듈을 로드하거나 임포트 하지 않습니다; 모듈이 아직 로드되지 않았으면, 빈 모듈 객체를 얻게 됩니다. 모듈을 임포트 하려면 `PyImport_ImportModule()`이나 그 변형 중 하나를 사용하십시오. name에서 점으로 구분된 이름으로 암시된 패키지 구조는 이미 존재하지 않는다면 만들어지지 않습니다.

  버전 3.3에 추가.

PyObject* `PyImport_AddModule`(const char *name)
  Return value: Borrowed reference.

  `PyImport_AddModuleObject()`와 비슷하지만, name은 유니코드 객체 대신 UTF-8로 인코딩된 문자열입니다.

PyObject* `PyImport_ExecCodeModule`(const char *name, PyObject *co)
  Return value: New reference.

  주어진 모듈 이름(name)(`package.module` 형식일 수 있습니다)과 파이썬 바이트 코드 파일에서 읽거나 내장 함수 `compile()`로 얻은 코드 객체로, 모듈을 로드합니다. 모듈 객체에 대한 새로운 참조를 반환하거나, 또는 에러가 발생하면 예외가 설정된 `NULL`을 반환합니다. 에러가 발생하면 `sys.modules`에서 name이 제거됩니다, `PyImport_ExecCodeModule()` 에 진입할 때 name이 `sys.modules`에 이미 있어도 그렇습니다. `sys.modules`에 불완전하게 초기화된 모듈을 남겨 두는 것은 위험합니다, 그러한 모듈을 임포트 할 때 모듈 객체가 알 수 없는 (그리고 아마도 모듈 작성자의 의도에 비추어볼 때 손상된) 상태에 있음을 알 방법이 없기 때문입니다.

  모듈의 `__spec__`과 `__loader__`는 아직 설정되지 않았다면 적절한 값으로 설정됩니다. 스펙의 로더는 모듈의 `__loader__`(설정되었다면)로 설정되고, 그렇지 않으면 `SourceFileLoader` 의 인스턴스로 설정됩니다.

  모듈의 `__file__` 어트리뷰트는 코드 객체의 `co_filename`으로 설정됩니다. 해당한다면, `__cached__`도 설정됩니다.

  이 함수는 이미 임포트 되었다면 모듈을 다시 로드합니다. 모듈을 다시 로드하는 의도된 방법은 `PyImport_ReloadModule()`을 참조하십시오.

  name이 `package.module` 형식의 점으로 구분된 이름을 가리키면, 이미 만들어지지 않은 패키지 구조는 여전히 만들어지지 않습니다.

  `PyImport_ExecCodeModuleEx()`와 `PyImport_ExecCodeModuleWithPathnames()`도 참조하십시오.

PyObject* `PyImport_ExecCodeModuleEx`(const char *name, PyObject *co, const char *pathname)
  Return value: New reference.

  `PyImport_ExecCodeModule()`과 유사하지만, 모듈 객체의 `__file__` 어트리뷰트는 `NULL`이 아니라면 pathname으로 설정됩니다.

  `PyImport_ExecCodeModuleWithPathnames()`도 참조하십시오.

PyObject* `PyImport_ExecCodeModuleObject`(PyObject *name, PyObject *co, PyObject *pathname, PyObject *cpathname)
  Return value: New reference.

  `PyImport_ExecCodeModuleEx()`와 유사하지만, 모듈 객체의 `__cached__` 어트리뷰트는 `NULL`이 아니라면 cpathname으로 설정됩니다. 세 가지 함수 중 이것이 선호되는 것입니다.

  버전 3.3에 추가.

PyObject* `PyImport_ExecCodeModuleWithPathnames`(const char *name, PyObject *co, const char *pathname, const char *cpathname)
  Return value: New reference.

  `PyImport_ExecCodeModuleObject()`와 유사하지만, name, pathname 및 cpathname은 UTF-8로 인코딩된 문자열입니다. pathname의 값이 `NULL`로 설정된 경우 어떤 값이 cpathname에서 와야하는지 알아내려고 합니다.

  버전 3.2에 추가.

  버전 3.3에서 변경: 바이트 코드 경로만 제공되면 소스 경로를 계산할 때 `imp.source_from_cache()`를 사용합니다.

long `PyImport_GetMagicNumber`()

  파이썬 바이트 코드 파일(일명 `.pyc` 파일)의 매직 번호(magic number)를 반환합니다. 매직 번호는 바이트 코드 파일의 처음 4바이트에 리틀 엔디안 바이트 순서로 존재해야 합니다. 에러 시 `-1`을 반환합니다.

  버전 3.3에서 변경: 실패 시 `-1`을 반환합니다.

const char * `PyImport_GetMagicTag`()

  PEP 3147 형식 파이썬 바이트 코드 파일 이름의 매직 태그 문자열을 반환합니다. `sys.implementation.cache_tag`의 값은 신뢰할 수 있고 이 함수 대신 사용해야 함에 유의하십시오.

  버전 3.2에 추가.

PyObject* `PyImport_GetModuleDict`()
  Return value: Borrowed reference.

  모듈 관리에 사용되는 딕셔너리(일명 `sys.modules`)를 반환합니다. 이것은 인터프리터마다 존재하는 변수임에 유의하십시오.

PyObject* `PyImport_GetModule`(PyObject *name)
  Return value: New reference.

  주어진 이름으로 이미 임포트 된 모듈을 반환합니다. 모듈이 아직 임포트 되지 않았다면 `NULL`을 반환하지만 에러는 설정하지 않습니다. 조회에 실패하면 `NULL`을 반환하고 에러를 설정합니다.

  버전 3.7에 추가.

PyObject* `PyImport_GetImporter`(PyObject *path)
  Return value: New reference.

  `sys.path`/`pkg.__path__` 항목 path를 위한 파인더 객체를 반환합니다, `sys.path_importer_cache` 딕셔너리에서 꺼낼 수도 있습니다. 아직 캐시 되지 않았으면, 경로 항목을 처리할 수 있는 훅이 발견될 때까지 `sys.path_hooks`를 탐색합니다. 훅이 없으면 `None`을 반환합니다; 이것은 호출자에게 경로 기반 파인더가 이 경로 항목에 대한 파인더를 찾을 수 없음을 알려줍니다. `sys.path_importer_cache`에 결과를 캐시 합니다. 파인더 객체에 대한 새로운 참조를 반환합니다.

int `PyImport_ImportFrozenModuleObject`(PyObject *name)
  Return value: New reference.

  name이라는 이름의 프로즌 모듈(frozen module)을 로드합니다. 성공하면 `1`을, 모듈을 찾지 못하면 `0`을, 초기화에 실패하면 예외를 설정하고 `-1`을 반환합니다. 로드가 성공할 때 임포트 된 모듈에 액세스하려면 `PyImport_ImportModule()`을 사용하십시오. (잘못된 이름에 주의하십시오 — 이 함수는 모듈이 이미 임포트 되었을 때 다시 로드합니다.)

  버전 3.3에 추가.

  버전 3.4에서 변경: `__file__` 어트리뷰트는 더는 모듈에 설정되지 않습니다.

int `PyImport_ImportFrozenModule`(const char *name)

  `PyImport_ImportFrozenModuleObject()`와 비슷하지만, name은 유니코드 객체 대신 UTF-8로 인코딩된 문자열입니다.

struct `_frozen`

  이것은 freeze 유틸리티(파이썬 소스 배포의 `Tools/freeze/`를 참조하십시오)가 생성한 프로즌 모듈 디스크립터를 위한 구조체 형 정의입니다. `Include/import.h`에 있는 정의는 다음과 같습니다:

      struct _frozen {
          const char *name;
          const unsigned char *code;
          int size;
      };

const struct _frozen* `PyImport_FrozenModules`

  이 포인터는 `struct _frozen` 레코드의 배열을 가리키도록 초기화되는데, 멤버가 모두 `NULL`이나 0인 레코드로 끝납니다. 프로즌 모듈이 임포트 될 때, 이 테이블에서 검색됩니다. 제삼자 코드는 이것을 사용하여 동적으로 생성된 프로즌 모듈 컬렉션을 제공할 수 있습니다.

int `PyImport_AppendInittab`(const char *name, PyObject* (*initfunc)(void))

  기존의 내장 모듈 테이블에 단일 모듈을 추가합니다. 이것은 `PyImport_ExtendInittab()`을 감싸는 편리한 래퍼인데, 테이블을 확장할 수 없으면 `-1`을 반환합니다. 새 모듈은 name이라는 이름으로 임포트 될 수 있으며, initfunc 함수를 처음 시도한 임포트에서 호출되는 초기화 함수로 사용합니다. `Py_Initialize()` 전에 호출해야 합니다.

struct `_inittab`

  내장 모듈 목록에 있는 단일 항목을 기술하는 구조체. 각 구조체는 인터프리터에 내장된 모듈의 이름과 초기화 함수를 제공합니다. 이름은 ASCII로 인코딩된 문자열입니다. 파이썬을 내장하는 프로그램은 `PyImport_ExtendInittab()`과 함께 이러한 구조체의 배열을 사용하여 추가 내장 모듈을 제공 할 수 있습니다. 구조체는 `Include/import.h`에서 다음과 같이 정의됩니다:

      struct _inittab {
          const char *name;           /* ASCII encoded string */
          PyObject* (*initfunc)(void);
      };

int `PyImport_ExtendInittab`(struct _inittab *newtab)

  Add a collection of modules to the table of built-in modules. The newtab array must end with a sentinel entry which contains `NULL` for the `name` field; failure to provide the sentinel value can result in a memory fault. Returns `0` on success or `-1` if insufficient memory could be allocated to extend the internal table. In the event of failure, no modules are added to the internal table. This must be called before `Py_Initialize()`.

  If Python is initialized multiple times, `PyImport_AppendInittab()` or `PyImport_ExtendInittab()` must be called before each Python initialization.