# `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