"mimetypes" --- 파일명을 MIME 유형에 매핑
*****************************************

**소스 코드:** Lib/mimetypes.py

======================================================================

"mimetypes" 모듈은 파일명이나 URL과 파일명 확장자와 연관된 MIME 유형
간의 변환을 제공합니다. 변환은 파일명에서 MIME 유형으로, MIME 유형에서
파일 이름 확장자로 제공됩니다; 후자의 변환에서는 인코딩이 지원되지 않
습니다.

이 모듈은 하나의 클래스와 여러 편리 함수를 제공합니다. 함수가 이 모듈
에 대한 일반 인터페이스이지만, 일부 응용 프로그램은 클래스에도 관심이
있을 수 있습니다.

아래에 설명된 함수는 이 모듈의 기본 인터페이스를 제공합니다. 모듈이 초
기화되지 않았으면, 함수가 "init()"가 설정하는 정보에 의존하면 "init()"
를 호출합니다.

mimetypes.guess_type(url, strict=True)

   *url*로 주어진 파일명, 경로 또는 URL에 기반한 파일의 유형을 추측합
   니다. URL은 문자열이나 *경로류 객체*일 수 있습니다.

   반환 값은 튜플 "(type, encoding)"인데, *type*은 MIME *content-type*
   헤더에 사용할 수 있는 "'type/subtype'" 형식의 문자열이거나, 유형을
   추측할 수 없으면 (없거나 알려지지 않은 확장자) "None"입니다.

   *encoding*은 인코딩에 사용된 프로그램의 이름(예를 들어,
   **compress**나 **gzip**)이거나, 인코딩이 없으면 "None"입니다. 인코
   딩은 *Content-Encoding* 헤더로 사용하기에 적합합니다, *Content-
   Transfer-Encoding* 헤더가 **아닙니다**. 매핑은 테이블 기반입니다.
   인코딩 접미사는 대소 문자를 구분합니다; 유형 접미사는 먼저 대소 문
   자를 구분해서 시도한 후에, 대소 문자를 구분하지 않고 시도합니다.

   선택적 *strict* 인자는 알려진 MIME 유형 목록을 IANA에 등록된 공식
   유형으로만 제한할지를 지정하는 플래그입니다. *strict*가 "True"(기본
   값)이면 IANA 유형만 지원됩니다; *strict*가 "False"일 때, 추가로 표
   준이 아니지만, 일반적으로 사용되는 MIME 유형도 인식됩니다.

   버전 3.8에서 변경: *경로류 객체* *url*에 대한 지원이 추가되었습니다
   .

   버전 3.13부터 폐지됨: Passing a file path instead of URL is *soft
   deprecated*. Use "guess_file_type()" for this.

mimetypes.guess_file_type(path, *, strict=True)

   *path*로 주어진 경로에 기반하여 파일의 유형을 추측합니다.
   "guess_type()" 함수와 유사하지만, URL 대신 경로를 받습니다. 경로는
   문자열, 바이트열 객체 혹은 *경로류 객체*일 수 있습니다.

   Added in version 3.13.

mimetypes.guess_all_extensions(type, strict=True)

   *type*으로 주어진 MIME 유형을 기반으로 파일의 확장자를 추측합니다.
   반환 값은 가능한 모든 파일명 확장자를 제공하는 문자열 리스트인데,
   선행 점("'.'")을 포함합니다. 확장자는 특정 데이터 스트림과 연관되었
   음이 보장되지는 않지만, "guess_type()"과 "guess_file_type()"에 의해
   MIME 유형 *type*으로 매핑됩니다.

   선택적 *strict* 인자는 "guess_type()" 함수에서와 같은 의미를 가집니
   다.

mimetypes.guess_extension(type, strict=True)

   *type*으로 주어진 MIME 유형을 기반으로 파일의 확장자를 추측합니다.
   반환 값은 파일명 확장자를 제공하는 문자열인데, 선행 점("'.'")을 포
   함합니다. 확장자는 특정 데이터 스트림과 연관되었음이 보장되지는 않
   지만, "guess_type()"과 "guess_file_type()"에 의해 MIME 유형 *type*
   으로 매핑됩니다. *type*에 대해 추측할 수 있는 확장이 없으면, "None"
   이 반환됩니다.

   선택적 *strict* 인자는 "guess_type()" 함수에서와 같은 의미를 가집니
   다.

일부 추가 함수와 데이터 항목은 모듈의 동작을 제어하는 데 사용할 수 있
습니다.

mimetypes.init(files=None)

   내부 데이터 구조를 초기화합니다. 주어지면, *files*는 기본 유형 맵을
   보강하는 데 사용해야 하는 파일 이름의 시퀀스여야 합니다. 생략하면,
   사용할 파일 이름은 "knownfiles"에서 가져옵니다; 윈도우에서는, 현재
   레지스트리 설정이 로드됩니다. *files*나 "knownfiles"에서 명명된 각
   파일은 그 앞에서 명명된 파일보다 우선합니다. 반복적으로 "init()"를
   호출할 수 있습니다.

   *files*에 빈 리스트를 지정하면 시스템 기본값이 적용되지 않습니다:
   내장 리스트로부터 온 잘 알려진 값만 나타납니다.

   *files*가 "None"이면 내부 데이터 구조가 초기 기본값으로 완전히 다시
   만들어집니다. 이것은 안정적인 연산이며 여러 번 호출 될 때 같은 결과
   를 생성합니다.

   버전 3.2에서 변경: 이전에는, 윈도우 레지스트리 설정이 무시되었습니
   다.

mimetypes.read_mime_types(filename)

   *filename* 파일이 있으면, 그 파일에 주어진 유형 맵을 로드합니다. 유
   형 맵은 선행 점("'.'")을 포함하는 파일명 확장자를 "'type/subtype'"
   형식의 문자열로 매핑하는 딕셔너리로 반환됩니다. *filename* 파일이
   없거나 읽을 수 없으면 "None"이 반환됩니다.

mimetypes.add_type(type, ext, strict=True)

   MIME 유형 *type*에서 확장자 *ext*로의 매핑을 추가합니다. 확장자가
   이미 알려져 있으면, 새 유형이 이전 유형을 대체합니다. 유형이 이미
   알려져 있으면, 확장이 알려진 확장 리스트에 추가됩니다.

   *strict*가 "True"(기본값)이면, 매핑이 공식 MIME 유형에 추가되고, 그
   렇지 않으면 비표준 MIME 유형에 추가됩니다.

mimetypes.inited

   전역 데이터 구조가 초기화되었는지를 나타내는 플래그. 이것은
   "init()"에 의해 "True"로 설정됩니다.

mimetypes.knownfiles

   일반적으로 설치된 유형 맵 파일 이름의 리스트입니다. 이 파일들은 일
   반적으로 "mime.types"로 명명되며 패키지별로 다른 위치에 설치됩니다.

mimetypes.suffix_map

   접미사를 접미사에 매핑하는 딕셔너리. 인코딩과 유형이 같은 확장자로
   표시되는 인코딩된 파일을 인식하도록 하는 데 사용됩니다. 예를 들어,
   ".tgz" 확장자는 인코딩과 유형을 별도로 인식 할 수 있도록, ".tar.gz"
   에 매핑됩니다.

mimetypes.encodings_map

   파일명 확장자를 인코딩 유형에 매핑하는 딕셔너리.

mimetypes.types_map

   파일명 확장자를 MIME 유형에 매핑하는 딕셔너리.

mimetypes.common_types

   파일명 확장자를 비표준이지만 일반적으로 발견되는 MIME 유형에 매핑하
   는 딕셔너리.

모듈의 사용 예:

   >>> import mimetypes
   >>> mimetypes.init()
   >>> mimetypes.knownfiles
   ['/etc/mime.types', '/etc/httpd/mime.types', ... ]
   >>> mimetypes.suffix_map['.tgz']
   '.tar.gz'
   >>> mimetypes.encodings_map['.gz']
   'gzip'
   >>> mimetypes.types_map['.tgz']
   'application/x-tar-gz'


MimeTypes 객체
==============

"MimeTypes" 클래스는 하나 이상의 MIME 유형 데이터베이스가 필요한 응용
프로그램에 유용 할 수 있습니다. "mimetypes" 모듈과 유사한 인터페이스를
제공합니다.

class mimetypes.MimeTypes(filenames=(), strict=True)

   이 클래스는 MIME 유형 데이터베이스를 나타냅니다. 기본적으로, 이 모
   듈의 나머지 부분과 같은 데이터베이스에 대한 액세스를 제공합니다. 초
   기 데이터베이스는 모듈이 제공하는 것의 사본이며, "read()"나
   "readfp()" 메서드를 사용하여 추가 "mime.types"-스타일 파일을 데이터
   베이스에 로드하여 확장할 수 있습니다. 기본 데이터가 필요하지 않으면
   , 추가 데이터를 로드하기 전에 매핑 딕셔너리를 지울 수도 있습니다.

   선택적 *filenames* 매개 변수는 기본 데이터베이스의 "위"에 추가 파일
   을 로드하게 하는 데 사용할 수 있습니다.

   suffix_map

      접미사를 접미사에 매핑하는 딕셔너리. 인코딩과 유형이 같은 확장자
      로 표시되는 인코딩된 파일을 인식하도록 하는 데 사용됩니다. 예를
      들어, ".tgz" 확장자는 인코딩과 유형을 별도로 인식 할 수 있도록,
      ".tar.gz"에 매핑됩니다. 이것은 초기에는 모듈에 정의된 전역
      "suffix_map"의 사본입니다.

   encodings_map

      파일명 확장자를 인코딩 유형에 매핑하는 딕셔너리. 이것은 초기에는
      모듈에 정의된 전역 "encodings_map"의 사본입니다.

   types_map

      파일명 확장자를 MIME 유형으로 매핑하는 두 개의 딕셔너리를 포함하
      는 튜플: 첫 번째 딕셔너리는 비표준 유형 용이고 두 번째는 표준 유
      형 용입니다. "common_types"와 "types_map"으로 초기화됩니다.

   types_map_inv

      MIME 타입을 파일명 확장자 리스트로 매핑하는 두 개의 딕셔너리를
      포함하는 튜플: 첫 번째 딕셔너리는 비표준 유형 용이고 두 번째는
      표준 유형 용입니다. "common_types"와 "types_map"으로 초기화됩니
      다.

   guess_extension(type, strict=True)

      "guess_extension()" 함수와 유사하고, 객체의 일부로 저장된 테이블
      을 사용합니다.

   guess_type(url, strict=True)

      "guess_type()" 함수와 유사하고, 객체의 일부로 저장된 테이블을 사
      용합니다.

   guess_file_type(path, *, strict=True)

      "guess_file_type()" 함수와 유사하고, 객체의 일부로 저장된 테이블
      을 사용합니다.

      Added in version 3.13.

   guess_all_extensions(type, strict=True)

      "guess_all_extensions()" 함수와 유사하고, 객체의 일부로 저장된
      테이블을 사용합니다.

   read(filename, strict=True)

      *filename*이라는 이름의 파일에서 MIME 정보를 로드합니다.
      "readfp()"를 사용하여 파일을 구문 분석합니다.

      *strict*가 "True"이면, 정보는 표준 유형 리스트에 추가되고, 그렇
      지 않으면 비표준 유형 리스트에 추가됩니다.

   readfp(fp, strict=True)

      열린 파일 *fp*에서 MIME 유형 정보를 로드합니다. 파일은 표준
      "mime.types" 파일의 형식이어야 합니다.

      *strict*가 "True"이면, 정보는 표준 유형 리스트에 추가되고, 그렇
      지 않으면 비표준 유형 리스트에 추가됩니다.

   read_windows_registry(strict=True)

      윈도우 레지스트리에서 MIME 유형 정보를 로드합니다.

      가용성: Windows.

      *strict*가 "True"이면, 정보는 표준 유형 리스트에 추가되고, 그렇
      지 않으면 비표준 유형 리스트에 추가됩니다.

      Added in version 3.2.

   add_type(type, ext, strict=True)

      MIME 유형 *type*에서 확장자 *ext*로의 매핑을 추가합니다. 확장자
      가 이미 알려져 있으면, 새 유형이 이전 유형을 대체합니다. 유형이
      이미 알려져 있으면, 확장이 알려진 확장 리스트에 추가됩니다.

      *strict*가 "True"(기본값)이면, 매핑이 공식 MIME 유형에 추가되고,
      그렇지 않으면 비표준 MIME 유형에 추가됩니다.
