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

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

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

The "mimetypes" module converts between a filename or URL and the MIME
type associated with the filename extension.  Conversions are provided
from filename to MIME type and from MIME type to filename extension;
encodings are not supported for the latter conversion.

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

아래에 설명된 함수는 이 모듈의 기본 인터페이스를 제공합니다. 모듈이 초
기화되지 않았으면, 함수가 "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* 헤더가 **아닙니다**. 매핑은 테이블 기반입니다.
   인코딩 접미사는 대소 문자를 구분합니다; 유형 접미사는 먼저 대소 문
   자를 구분해서 시도한 후에, 대소 문자를 구분하지 않고 시도합니다.

   The optional *strict* argument is a flag specifying whether the
   list of known MIME types is limited to only the official types
   registered with IANA. However, the behavior of this module also
   depends on the underlying operating system. Only file types
   recognized by the OS or explicitly registered with Python's
   internal database can be identified. When *strict* is "True" (the
   default), only the IANA types are supported; when *strict* is
   "False", some additional non-standard but commonly used MIME types
   are also recognized.

   버전 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 objects
=================

The "MimeTypes" class may be useful for applications which may want
more than one MIME-type database; it provides an interface similar to
the one of the "mimetypes" module.

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)

      Add a mapping from the MIME type *type* to the extension *ext*.
      Valid extensions start with a '.' or are empty. When the
      extension is already known, the new type will replace the old
      one. When the type is already known the extension will be added
      to the list of known extensions.

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

      Deprecated since version 3.14, will be removed in version 3.16:
      Invalid, undotted extensions will raise a "ValueError" in Python
      3.16.


Command-line usage
==================

The "mimetypes" module can be executed as a script from the command
line.

   python -m mimetypes [-h] [-e] [-l] type [type ...]

The following options are accepted:

-h
--help

   Show the help message and exit.

-e
--extension

   Guess extension instead of type.

-l
--lenient

   Additionally search for some common, but non-standard types.

By default the script converts MIME types to file extensions. However,
if "--extension" is specified, it converts file extensions to MIME
types.

For each "type" entry, the script writes a line into the standard
output stream. If an unknown type occurs, it writes an error message
into the standard error stream and exits with the return code "1".


Command-line example
====================

Here are some examples of typical usage of the "mimetypes" command-
line interface:

   $ # get a MIME type by a file name
   $ python -m mimetypes filename.png
   type: image/png encoding: None

   $ # get a MIME type by a URL
   $ python -m mimetypes https://example.com/filename.txt
   type: text/plain encoding: None

   $ # get a complex MIME type
   $ python -m mimetypes filename.tar.gz
   type: application/x-tar encoding: gzip

   $ # get a MIME type for a rare file extension
   $ python -m mimetypes filename.pict
   error: unknown extension of filename.pict

   $ # now look in the extended database built into Python
   $ python -m mimetypes --lenient filename.pict
   type: image/pict encoding: None

   $ # get a file extension by a MIME type
   $ python -m mimetypes --extension text/javascript
   .js

   $ # get a file extension by a rare MIME type
   $ python -m mimetypes --extension text/xul
   error: unknown type text/xul

   $ # now look in the extended database again
   $ python -m mimetypes --extension --lenient text/xul
   .xul

   $ # try to feed an unknown file extension
   $ python -m mimetypes filename.sh filename.nc filename.xxx filename.txt
   type: application/x-sh encoding: None
   type: application/x-netcdf encoding: None
   error: unknown extension of filename.xxx

   $ # try to feed an unknown MIME type
   $ python -m mimetypes --extension audio/aac audio/opus audio/future audio/x-wav
   .aac
   .opus
   error: unknown type audio/future
