# `platform` — 하부 플랫폼의 식별 데이터에 대한 액세스

소스 코드: Lib/platform.py

참고

각 플랫폼은 알파벳순으로 나열되고, 리눅스는 유닉스 절에 포함됩니다.

## Cross platform

platform.architecture(executable=sys.executable, bits='', linkage='')

  다양한 아키텍처 정보에 대해 주어진 실행 파일(기본값은 파이썬 인터프리터 바이너리)을 조회합니다.

  실행 파일에 사용된 비트 아키텍처와 링크 형식에 대한 정보가 들어있는 튜플 `(bits, linkage)`를 반환합니다. 두 값은 모두 문자열로 반환됩니다.

  결정할 수 없는 값은 매개 변수 사전 설정에 따라 반환됩니다. bits가 `''`로 주어지면, `sizeof(pointer)`(또는 파이썬 버전 < 1.5.2 에서는 `sizeof(long)`)가 지원되는 포인터 크기를 나타내는 데 사용됩니다.

  함수는 시스템의 `file` 명령을 사용하여 실제 작업을 수행합니다. 이것은 대부분(전부가 아니라면)의 유닉스 플랫폼과 일부 유닉스가 아닌 플랫폼에서 가능하며 실행 파일이 파이썬 인터프리터를 가리키는 경우에만 가능합니다. 위의 요구가 충족되지 않으면 합리적인 기본값이 사용됩니다.

  참고

  맥 OS(그리고 아마도 다른 플랫폼에서도)에서, 실행 파일은 다중 아키텍처를 포함하는 유니버설 파일일 수 있습니다.

  현재 인터프리터가 “64-비트” 인지를 판단하려면, `sys.maxsize` 어트리뷰트를 조회하는 것이 더 신뢰성 있습니다.:

      is_64bits = sys.maxsize > 2**32

platform.machine()

  기계 유형을 반환합니다, 예를 들어 `'AMD64'`. 값을 판별할 수 없으면 빈 문자열이 반환됩니다.

  The output is platform-dependent and may differ in casing and naming conventions.

platform.node()

  컴퓨터의 네트워크 이름을 반환합니다 (완전히 정규화되지 않았을 수 있습니다!). 값을 판별할 수 없으면 빈 문자열이 반환됩니다.

platform.platform(aliased=False, terse=False)

  하부 플랫폼을 식별하는 가능한 한 많은 유용한 정보를 포함하는 단일 문자열을 반환합니다.

  출력은 기계가 구문 분석하기보다는 사람이 읽을 수 있도록 합니다. 다른 플랫폼에서는 다르게 보일 수 있는데, 이는 의도 된 것입니다.

  aliased가 참이면, 함수는 일반 이름과 다른 시스템 이름을 보고하는 다양한 플랫폼에 대해 별칭을 사용합니다, 예를 들어 SunOS는 Solaris로 보고됩니다. 이를 구현하는 데 `system_alias()` 함수가 사용됩니다.

  terse를 참으로 설정하면 함수가 플랫폼을 식별하는 데 필요한 절대적으로 최소한의 정보만 반환합니다.

  버전 3.8에서 변경: macOS에서, 이 함수는 이제 darwin 버전 대신 macOS 버전을 얻기 위해 `mac_ver()` 를 사용합니다 (비어 있지 않은 릴리스 문자열을 반환한다면).

platform.processor()

  (실제) 프로세서 이름을 반환합니다, 예를 들어 `'amdk6'`.

  값을 판별할 수 없으면 빈 문자열이 반환됩니다. 많은 플랫폼이 이 정보를 제공하지 않거나 단순히 `machine()`과 같은 값을 반환함에 유의하십시오. NetBSD가 그렇습니다.

platform.python_build()

  파이썬 빌드 번호와 날짜를 문자열로 나타내는 튜플 `(buildno, builddate)`를 반환합니다.

platform.python_compiler()

  파이썬 컴파일에 사용된 컴파일러를 식별하는 문자열을 반환합니다.

platform.python_branch()

  파이썬 구현 SCM 브랜치를 식별하는 문자열을 반환합니다.

platform.python_implementation()

  파이썬 구현을 식별하는 문자열을 반환합니다. 가능한 반환 값은 이렇습니다: ‘CPython’, ‘IronPython’, ‘Jython’, ‘PyPy’.

platform.python_revision()

  파이썬 구현 SCM 리비전을 식별하는 문자열을 반환합니다.

platform.python_version()

  파이썬 버전을 문자열 `'major.minor.patchlevel'`로 반환합니다.

  파이썬 `sys.version`과 달리, 반환 값은 항상 patchlevel을 포함함에 유의하십시오 (기본값은 0입니다).

platform.python_version_tuple()

  파이썬 버전을 문자열의 튜플 `(major, minor, patchlevel)`로 반환합니다.

  파이썬 `sys.version`과 달리, 반환 값은 항상 patchlevel을 포함함에 유의하십시오 (기본값은 `'0'`입니다).

platform.release()

  시스템의 릴리스를 반환합니다, 예를 들어 `'2.2.0'`이나 `'NT'`. 값을 판별할 수 없으면 빈 문자열이 반환됩니다.

platform.system()

  시스템/OS 이름을 반환합니다, 가령 `'Linux'`, `'Darwin'`, `'Java'`, `'Windows'`. 값을 판별할 수 없으면 빈 문자열이 반환됩니다.

  On iOS and Android, this returns the user-facing OS name (i.e, `'iOS`, `'iPadOS'` or `'Android'`). To obtain the kernel name (`'Darwin'` or `'Linux'`), use `os.uname()`.

platform.system_alias(system, release, version)

  일부 시스템에서 사용되는 상용 마케팅 이름으로 별칭 된 `(system, release, version)`을 반환합니다. 혼동을 일으킬 수 있는 일부 경우에 정보의 순서를 변경하기도 합니다.

platform.version()

  시스템의 릴리스 버전을 반환합니다, 예를 들어 `'#3 on degas'`. 값을 판별할 수 없으면 빈 문자열이 반환됩니다.

  On iOS and Android, this is the user-facing OS version. To obtain the Darwin or Linux kernel version, use `os.uname()`.

platform.uname()

  꽤 이식성 있는 uname 인터페이스. `system`, `node`, `release`, `version`, `machine`, `processor`의 6개의 어트리뷰트를 포함한 `namedtuple()`를 반환합니다.

  `processor`는 요청 시 늦게 확인됩니다.

  Note: the first two attribute names differ from the names presented by `os.uname()`, where they are named `sysname` and `nodename`.

  결정할 수 없는 항목은 `''`로 설정됩니다.

  버전 3.3에서 변경: 결과가 튜플에서 `namedtuple()`로 변경되었습니다.

  버전 3.9에서 변경: `processor` is resolved late instead of immediately.

platform.invalidate_caches()

  Clear out the internal cache of information, such as the `uname()`. This is typically useful when the platform’s `node()` is changed by an external process and one needs to retrieve the updated value.

  Added in version 3.14.

## Windows platform

platform.win32_ver(release='', version='', csd='', ptype='')

  윈도우 레지스트리에서 추가 버전 정보를 얻고 OS 릴리스, 버전 번호, CSD 수준 (서비스 팩) 및 OS 유형(다중/단일 프로세서)을 가리키는 튜플 `(release, version, csd, ptype)`를 반환합니다. 파악할 수 없는 값은 매개 변수로 주어지는 기본값(모두 빈 문자열이 기본값입니다)으로 설정됩니다.

  힌트: ptype은 단일 프로세서 NT 기계에서는 `'Uniprocessor Free'`이고 다중 프로세서 기계에서는 `'Multiprocessor Free'`입니다. `'Free'`는 디버깅 코드가 없는 OS 버전을 나타냅니다. 또한 `'Checked'`를 언급할 수 있는데, OS 버전이 디버깅 코드, 즉 인자, 범위 등을 검사하는 코드를 사용한다는 것을 뜻합니다.

platform.win32_edition()

  현재 윈도우 에디션을 나타내는 문자열을 반환합니다. 값을 파악할 수 없으면 `None`을 반환합니다. 가능한 값은 `'Enterprise'`, `'IoTUAP'`, `'ServerStandard'` 및 `'nanoserver'`를 포함하지만 이에 국한되지는 않습니다.

  Added in version 3.8.

platform.win32_is_iot()

  `win32_edition()`에 의해 반환된 윈도우 에디션이 IoT 에디션으로 인식되면 `True`를 반환합니다.

  Added in version 3.8.

## macOS platform

platform.mac_ver(release='', versioninfo=('', '', ''), machine='')

  맥 OS 버전 정보를 얻고 튜플 `(release, versioninfo, machine)`으로 반환하는데, versioninfo는 튜플 `(version, dev_stage, non_release_version)`입니다.

  결정할 수 없는 항목은 `''`로 설정됩니다. 모든 튜플 항목은 문자열입니다.

## iOS platform

platform.ios_ver(system='', release='', model='', is_simulator=False)

  Get iOS version information and return it as a `namedtuple()` with the following attributes:

  - `system` is the OS name; either `'iOS'` or `'iPadOS'`.

  - `release` is the iOS version number as a string (e.g., `'17.2'`).

  - `model` is the device model identifier; this will be a string like `'iPhone13,2'` for a physical device, or `'iPhone'` on a simulator.

  - `is_simulator` is a boolean describing if the app is running on a simulator or a physical device.

  판단할 수 없는 항목은 매개 변수로 주어지는 기본값으로 설정됩니다.

## Unix platforms

platform.libc_ver(executable=sys.executable, lib='', version='', chunksize=16384)

  파일 executable(기본값은 파이썬 인터프리터입니다)이 링크된 libc 버전을 확인하려고 시도합니다. 문자열의 튜플 `(lib, version)`을 반환하는데, 조회가 실패하면 지정된 매개 변수를 기본값으로 사용합니다.

  다른 libc 버전이 실행 파일에 심볼을 추가하는 방법에 대해 이 함수가 가진 지식은 아마도 gcc로 컴파일된 실행 파일에서만 사용 가능하다는 것에 유의하십시오.

  파일은 chunksize 바이트의 청크 단위로 읽고 스캔됩니다.

## Linux platforms

platform.freedesktop_os_release()

  Get operating system identification from `os-release` file and return it as a dict. The `os-release` file is a freedesktop.org standard and is available in most Linux distributions. A noticeable exception is Android and Android-based distributions.

  Raises `OSError` or subclass when neither `/etc/os-release` nor `/usr/lib/os-release` can be read.

  On success, the function returns a dictionary where keys and values are strings. Values have their special characters like `"` and `$` unquoted. The fields `NAME`, `ID`, and `PRETTY_NAME` are always defined according to the standard. All other fields are optional. Vendors may include additional fields.

  Note that fields like `NAME`, `VERSION`, and `VARIANT` are strings suitable for presentation to users. Programs should use fields like `ID`, `ID_LIKE`, `VERSION_ID`, or `VARIANT_ID` to identify Linux distributions.

  예제:

      def get_like_distro():
          info = platform.freedesktop_os_release()
          ids = [info["ID"]]
          if "ID_LIKE" in info:
              # id 들은 공백으로 구분되고 우선 순위에 따라 정렬됩니다
              ids.extend(info["ID_LIKE"].split())
          return ids

  Added in version 3.10.

## Android platform

platform.android_ver(release='', api_level=0, manufacturer='', model='', device='', is_emulator=False)

  Get Android device information. Returns a `namedtuple()` with the following attributes. Values which cannot be determined are set to the defaults given as parameters.

  - `release` - Android version, as a string (e.g. `"14"`).

  - `api_level` - API level of the running device, as an integer (e.g. `34` for Android 14). To get the API level which Python was built against, see `sys.getandroidapilevel()`.

  - `manufacturer` - Manufacturer name.

  - `model` - Model name – typically the marketing name or model number.

  - `device` - Device name – typically the model number or a codename.

  - `is_emulator` - `True` if the device is an emulator; `False` if it’s a physical device.

  Google maintains a list of known model and device names.

  Added in version 3.13.

## Command-line usage

`platform` can also be invoked directly using the `-m` switch of the interpreter:

    python -m platform [--terse] [--nonaliased] [{nonaliased,terse} ...]

The following options are accepted:

--terse

  Print terse information about the platform. This is equivalent to calling `platform.platform()` with the terse argument set to `True`.

--nonaliased

  Print platform information without system/OS name aliasing. This is equivalent to calling `platform.platform()` with the aliased argument set to `True`.

You can also pass one or more positional arguments (`terse`, `nonaliased`) to explicitly control the output format. These behave similarly to their corresponding options.