# `urllib.parse` — URL을 구성 요소로 구문 분석

소스 코드: Lib/urllib/parse.py

이 모듈은 URL(Uniform Resource Locator) 문자열을 구성 요소(주소 지정 체계, 네트워크 위치, 경로 등)로 분리하고, 구성 요소를 다시 URL 문자열로 결합하고, “상대 URL”을 주어진 “기본 URL”에 따라 절대 URL로 변환하는 표준 인터페이스를 정의합니다.

이 모듈은 상대 URL(Relative Uniform Resource Locators)의 인터넷 RFC와 일치하도록 설계되었습니다. 다음과 같은 URL 스킴을 지원합니다: `file`, `ftp`, `gopher`, `hdl`, `http`, `https`, `imap`, `itms-services`, `mailto`, `mms`, `news`, `nntp`, `prospero`, `rsync`, `rtsp`, `rtsps`, `rtspu`, `sftp`, `shttp`, `sip`, `sips`, `snews`, `svn`, `svn+ssh`, `telnet`, `wais`, `ws`, `wss`.

CPython 구현 상세: The inclusion of the `itms-services` URL scheme can prevent an app from passing Apple’s App Store review process for the macOS and iOS App Stores. Handling for the `itms-services` scheme is always removed on iOS; on macOS, it may be removed if CPython has been built with the `--with-app-store-compliance` option.

The `urllib.parse` module defines functions that fall into two broad categories: URL parsing and URL quoting. These are covered in detail in the following sections.

This module’s functions use the deprecated term `netloc` (or `net_loc`), which was introduced in RFC 1808. However, this term has been obsoleted by RFC 3986, which introduced the term `authority` as its replacement. The use of `netloc` is continued for backward compatibility.

## URL 구문 분석

URL 구문 분석 함수는 URL 문자열을 구성 요소로 분할하거나 URL 구성 요소를 URL 문자열로 결합하는 데 중점을 둡니다.

urllib.parse.urlsplit(urlstring, scheme=None, allow_fragments=True, *, missing_as_none=False)

  Parse a URL into five components, returning a 5-item named tuple `SplitResult` or `SplitResultBytes`. This corresponds to the general structure of a URL: `scheme://netloc/path?query#fragment`. Each tuple item is a string, possibly empty, or `None` if missing_as_none is true. Not defined component are represented an empty string (by default) or `None` if missing_as_none is true. The components are not broken up into smaller parts (for example, the network location is a single string), and % escapes are not expanded. The delimiters as shown above are not part of the result, except for a leading slash in the path component, which is retained if present. For example:

      >>> from urllib.parse import urlsplit
      >>> urlsplit("scheme://netloc/path?query#fragment")
      SplitResult(scheme='scheme', netloc='netloc', path='/path',
                  query='query', fragment='fragment')
      >>> o = urlsplit("http://docs.python.org:80/3/library/urllib.parse.html?"
      ...              "highlight=params#url-parsing")
      >>> o
      SplitResult(scheme='http', netloc='docs.python.org:80',
                  path='/3/library/urllib.parse.html',
                  query='highlight=params', fragment='url-parsing')
      >>> o.scheme
      'http'
      >>> o.netloc
      'docs.python.org:80'
      >>> o.hostname
      'docs.python.org'
      >>> o.port
      80
      >>> o._replace(fragment="").geturl()
      'http://docs.python.org:80/3/library/urllib.parse.html?highlight=params'
      >>> urlsplit("http://docs.python.org?")
      SplitResult(scheme='http', netloc='docs.python.org', path='',
                  query='', fragment='')
      >>> urlsplit("http://docs.python.org?", missing_as_none=True)
      SplitResult(scheme='http', netloc='docs.python.org', path='',
                  query='', fragment=None)

  Following the syntax specifications in RFC 1808, `urlsplit()` recognizes a netloc only if it is properly introduced by ‘//’. Otherwise the input is presumed to be a relative URL and thus to start with a path component.

      >>> from urllib.parse import urlsplit
      >>> urlsplit('//www.cwi.nl:80/%7Eguido/Python.html')
      SplitResult(scheme='', netloc='www.cwi.nl:80', path='/%7Eguido/Python.html',
                  query='', fragment='')
      >>> urlsplit('www.cwi.nl/%7Eguido/Python.html')
      SplitResult(scheme='', netloc='', path='www.cwi.nl/%7Eguido/Python.html',
                  query='', fragment='')
      >>> urlsplit('help/Python.html')
      SplitResult(scheme='', netloc='', path='help/Python.html',
                  query='', fragment='')
      >>> urlsplit('help/Python.html', missing_as_none=True)
      SplitResult(scheme=None, netloc=None, path='help/Python.html',
                  query=None, fragment=None)

  The scheme argument gives the default addressing scheme, to be used only if the URL does not specify one. It should be the same type (text or bytes) as urlstring or `None`, except that the `''` is always allowed, and is automatically converted to `b''` if appropriate.

  If the allow_fragments argument is false, fragment identifiers are not recognized. Instead, they are parsed as part of the path or query component, and `fragment` is set to `None` or the empty string (depending on the value of missing_as_none) in the return value.

  반환 값은 네임드 튜플입니다. 즉, 다음과 같은 인덱스나 이름있는 어트리뷰트로 해당 항목에 액세스 할 수 있습니다:

  어트리뷰트 | 인덱스 | 값 | 존재하지 않을 때의 값
  --- | --- | --- | ---
  `scheme` | 0 | URL 스킴 지정자 | scheme parameter or empty string [1]
  `netloc` | 1 | 네트워크 위치 부분 | `None` or empty string [1]
  `path` | 2 | 계층적 경로 | 빈 문자열
  `query` | 3 | 쿼리 구성 요소 | `None` or empty string [1]
  `fragment` | 4 | 프래그먼트 식별자 | `None` or empty string [1]
  `username` |  | 사용자 이름 | `None`
  `password` |  | 비밀번호 | `None`
  `hostname` |  | 호스트 이름 (소문자) | `None`
  `port` |  | 존재하면, 정수로 표시되는 포트 번호 | `None`

  [1] (1,2,3,4)

  Depending on the value of the missing_as_none argument.

  URL에 잘못된 포트가 지정된 경우 `port` 어트리뷰트를 읽으면 `ValueError`가 발생합니다. 결과 객체에 대한 자세한 내용은 구조화된 구문 분석 결과 섹션을 참조하십시오.

  `netloc` 어트리뷰트에서 대괄호(square brackets)가 일치하지 않으면 `ValueError`가 발생합니다.

  (IDNA 인코딩에서 사용되는) NFKC 정규화에서 `/`, `?`, `#`, `@` 또는 `:` 중 하나로 분해(decompose)되는 `netloc` 어트리뷰트의 문자는 `ValueError`를 발생시킵니다. 구문 분석하기 전에 URL이 분해(decompose)되면, 에러가 발생하지 않습니다.

  Following some of the WHATWG spec that updates RFC 3986, leading C0 control and space characters are stripped from the URL. `\n`, `\r` and tab `\t` characters are removed from the URL at any position.

  As is the case with all named tuples, the subclass has a few additional methods and attributes that are particularly useful. One such method is `_replace()`. The `_replace()` method will return a new `SplitResult` object replacing specified fields with new values.

      >>> from urllib.parse import urlsplit
      >>> u = urlsplit('//www.cwi.nl:80/%7Eguido/Python.html')
      >>> u
      SplitResult(scheme='', netloc='www.cwi.nl:80', path='/%7Eguido/Python.html',
                  query='', fragment='')
      >>> u._replace(scheme='http')
      SplitResult(scheme='http', netloc='www.cwi.nl:80', path='/%7Eguido/Python.html',
                  query='', fragment='')

  경고

  `urlsplit()` does not perform validation. See URL parsing security for details.

  버전 3.2에서 변경: IPv6 URL 구문 분석 기능이 추가되었습니다.

  버전 3.3에서 변경: RFC 3986에 따라, 프래그먼트는 이제 모든 URL 스킴에 대해 구문 분석됩니다 (allow_fragments가 거짓이 아니라면). 이전에는, 프래그먼트를 지원하는 스킴의 수락 목록이 있었습니다.

  버전 3.6에서 변경: Out-of-range port numbers now raise `ValueError`, instead of returning `None`.

  버전 3.8에서 변경: NFKC 정규화에서 netloc 구문 분석에 영향을 주는 문자는 이제 `ValueError`를 발생시킵니다.

  버전 3.10에서 변경: ASCII newline and tab characters are stripped from the URL.

  버전 3.12에서 변경: Leading WHATWG C0 control and space characters are stripped from the URL.

  버전 3.15.0a5 (unreleased)에서 변경: Added the missing_as_none parameter.

urllib.parse.parse_qs(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None, separator='&')

  문자열 인자(application/x-www-form-urlencoded 유형의 데이터)로 제공된 쿼리 문자열을 구문 분석합니다. 데이터는 딕셔너리로 반환됩니다. 딕셔너리 키는 고유한 쿼리 변수 이름이고 값은 각 이름의 값 리스트입니다.

  선택적 인자 keep_blank_values는 퍼센트 인코딩된 쿼리의 빈 값을 빈 문자열로 처리해야 하는지를 나타내는 플래그입니다. 참값은 빈 값을 빈 문자열로 유지해야 함을 나타냅니다. 기본 거짓 값은 빈 값이 무시되고 포함되지 않은 것처럼 처리됨을 나타냅니다.

  선택적 인자 strict_parsing은 구문 분석 에러 시 수행할 작업을 나타내는 플래그입니다. 거짓(기본값)이면, 에러가 조용히 무시됩니다. 참이면, 에러는 `ValueError` 예외를 발생시킵니다.

  선택적 encoding과 errors 매개 변수는 `bytes.decode()` 메서드에서 받아들이는 것처럼 퍼센트 인코딩된 시퀀스를 유니코드 문자로 디코딩하는 방법을 지정합니다.

  선택적 인자 max_num_fields는 읽을 최대 필드 수입니다. 설정되면, max_num_fields 필드보다 많은 것을 읽을 때 `ValueError`가 발생합니다.

  선택적 인자 separator는 쿼리 인자를 구분하는 데 사용할 기호입니다. 기본값은 `&`입니다.

  이러한 딕셔너리를 쿼리 문자열로 변환하려면 `urllib.parse.urlencode()` 함수를 (`doseq` 매개 변수를 `True`로 설정해서) 사용하십시오.

  버전 3.2에서 변경: encoding과 errors 매개 변수를 추가합니다.

  버전 3.8에서 변경: max_num_fields 매개 변수를 추가했습니다.

  버전 3.10에서 변경: 기본값이 `&` 인 separator 매개 변수를 추가했습니다. 파이썬 3.10 이전의 파이썬 버전에서는 쿼리 매개 변수 구분 기호로 `;`와 `&`를 모두 사용할 수 있었습니다. `&`를 기본 구분자 기호로 사용하여, 단일 구분자 키만 허용하도록 변경되었습니다.

  버전 3.14부터 폐지됨: Accepting objects with false values (like `0` and `[]`) except empty strings and byte-like objects and `None` is now deprecated.

urllib.parse.parse_qsl(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None, separator='&')

  문자열 인자(application/x-www-form-urlencoded 유형의 데이터)로 제공된 쿼리 문자열을 구문 분석합니다. 데이터는 이름, 값 쌍의 리스트로 반환됩니다.

  선택적 인자 keep_blank_values는 퍼센트 인코딩된 쿼리의 빈 값을 빈 문자열로 처리해야 하는지를 나타내는 플래그입니다. 참값은 빈 값을 빈 문자열로 유지해야 함을 나타냅니다. 기본 거짓 값은 빈 값이 무시되고 포함되지 않은 것처럼 처리됨을 나타냅니다.

  선택적 인자 strict_parsing은 구문 분석 에러 시 수행할 작업을 나타내는 플래그입니다. 거짓(기본값)이면, 에러가 조용히 무시됩니다. 참이면, 에러는 `ValueError` 예외를 발생시킵니다.

  선택적 encoding과 errors 매개 변수는 `bytes.decode()` 메서드에서 받아들이는 것처럼 퍼센트 인코딩된 시퀀스를 유니코드 문자로 디코딩하는 방법을 지정합니다.

  선택적 인자 max_num_fields는 읽을 최대 필드 수입니다. 설정되면, max_num_fields 필드보다 많은 것을 읽을 때 `ValueError`가 발생합니다.

  선택적 인자 separator는 쿼리 인자를 구분하는 데 사용할 기호입니다. 기본값은 `&`입니다.

  이러한 쌍의 리스트를 쿼리 문자열로 변환하려면 `urllib.parse.urlencode()` 함수를 사용하십시오.

  버전 3.2에서 변경: encoding과 errors 매개 변수를 추가합니다.

  버전 3.8에서 변경: max_num_fields 매개 변수를 추가했습니다.

  버전 3.10에서 변경: 기본값이 `&` 인 separator 매개 변수를 추가했습니다. 파이썬 3.10 이전의 파이썬 버전에서는 쿼리 매개 변수 구분 기호로 `;`와 `&`를 모두 사용할 수 있었습니다. `&`를 기본 구분자 기호로 사용하여, 단일 구분자 키만 허용하도록 변경되었습니다.

urllib.parse.urlunsplit(parts)
urllib.parse.urlunsplit(parts, *, keep_empty)

  Construct a URL from a tuple as returned by `urlsplit()`. The parts argument can be any five-item iterable.

  This may result in a slightly different, but equivalent URL, if the URL that was parsed originally had unnecessary delimiters (for example, a `?` with an empty query; the RFC states that these are equivalent).

  If keep_empty is true, empty strings are kept in the result (for example, a `?` for an empty query), only `None` components are omitted. This allows rebuilding a URL that was parsed with option `missing_as_none=True`. By default, keep_empty is true if parts is the result of the `urlsplit()` call with `missing_as_none=True`.

  버전 3.15.0a5 (unreleased)에서 변경: Added the keep_empty parameter.

urllib.parse.urlparse(urlstring, scheme=None, allow_fragments=True, *, missing_as_none=False)

  This is similar to `urlsplit()`, but additionally splits the path component on path and params. This function returns a 6-item named tuple `ParseResult` or `ParseResultBytes`. Its items are the same as for the `urlsplit()` result, except that params is inserted at index 3, between path and query.

  This function is based on obsoleted RFC 1738 and RFC 1808, which listed params as the main URL component. The more recent URL syntax allows parameters to be applied to each segment of the path portion of the URL (see RFC 3986). `urlsplit()` should generally be used instead of `urlparse()`. A separate function is needed to separate the path segments and parameters.

urllib.parse.urlunparse(parts)
urllib.parse.urlunparse(parts, *, keep_empty)

  Combine the elements of a tuple as returned by `urlparse()` into a complete URL as a string. The parts argument can be any six-item iterable.

  This may result in a slightly different, but equivalent URL, if the URL that was parsed originally had unnecessary delimiters (for example, a `?` with an empty query; the RFC states that these are equivalent).

  If keep_empty is true, empty strings are kept in the result (for example, a `?` for an empty query), only `None` components are omitted. This allows rebuilding a URL that was parsed with option `missing_as_none=True`. By default, keep_empty is true if parts is the result of the `urlparse()` call with `missing_as_none=True`.

  버전 3.15.0a5 (unreleased)에서 변경: Added the keep_empty parameter.

urllib.parse.urljoin(base, url, allow_fragments=True)

  “기본 URL”(base)을 다른 URL(url)과 결합하여 전체 (“절대”) URL을 구성합니다. 비형식적으로, 이것은 기본 URL의 구성 요소, 특히 주소 지정 체계, 네트워크 위치 및 경로(의 일부)를 사용하여 상대 URL에 누락된 구성 요소를 제공합니다. 예를 들면:

      >>> from urllib.parse import urljoin
      >>> urljoin('http://www.cwi.nl/%7Eguido/Python.html', 'FAQ.html')
      'http://www.cwi.nl/%7Eguido/FAQ.html'

  The allow_fragments argument has the same meaning and default as for `urlsplit()`.

  참고

  url이 절대 URL이면 (즉, `//`나 `scheme://`로 시작하면), url의 호스트명 및/또는 스킴이 결과에 나타납니다. 예를 들면:

      >>> urljoin('http://www.cwi.nl/%7Eguido/Python.html',
      ...         '//www.python.org/%7Eguido')
      'http://www.python.org/%7Eguido'

  이런 동작을 원하지 않으면, url을 `urlsplit()`과 `urlunsplit()`으로 사전 처리하여 가능한 scheme과 netloc 부분을 제거하십시오.

  경고

  Because an absolute URL may be passed as the `url` parameter, it is generally not secure to use `urljoin` with an attacker-controlled `url`. For example in, `urljoin("https://website.com/users/", username)`, if `username` can contain an absolute URL, the result of `urljoin` will be the absolute URL.

  버전 3.5에서 변경: RFC 3986에 정의된 의미론과 일치하도록 동작이 갱신되었습니다.

urllib.parse.urldefrag(url, *, missing_as_none=False)

  If url contains a fragment identifier, return a modified version of url with no fragment identifier, and the fragment identifier as a separate string. If there is no fragment identifier in url, return url unmodified and an empty string (by default) or `None` if missing_as_none is true.

  반환 값은 네임드 튜플입니다, 항목은 인덱스나 이름 붙은 어트리뷰트로 액세스 할 수 있습니다:

  어트리뷰트 | 인덱스 | 값 | 존재하지 않을 때의 값
  --- | --- | --- | ---
  `url` | 0 | 프래그먼트 없는 URL | 빈 문자열
  `fragment` | 1 | 프래그먼트 식별자 | `None` or empty string [3]

  [ 3 ]

  Depending on the value of the missing_as_none argument.

  결과 객체에 대한 자세한 정보는 섹션 구조화된 구문 분석 결과를 참조하십시오.

  버전 3.2에서 변경: 결과는 단순한 2-튜플이 아닌 구조화된 객체입니다.

  버전 3.15.0a5 (unreleased)에서 변경: Added the missing_as_none parameter.

urllib.parse.unwrap(url)

  래핑 된 URL(즉, `<URL:scheme://host/path>`, `<scheme://host/path>`, `URL:scheme://host/path` 또는 `scheme://host/path` 형식의 문자열)에서 URL을 추출합니다. url이 래핑 된 URL이 아니면, 변경 없이 반환됩니다.

## URL 구문 분석 보안

The `urlsplit()` and `urlparse()` APIs do not perform validation of inputs. They may not raise errors on inputs that other applications consider invalid. They may also succeed on some inputs that might not be considered URLs elsewhere. Their purpose is for practical functionality rather than purity.

Instead of raising an exception on unusual input, they may instead return some component parts as empty strings or `None` (depending on the value of the missing_as_none argument). Or components may contain more than perhaps they should.

We recommend that users of these APIs where the values may be used anywhere with security implications code defensively. Do some verification within your code before trusting a returned component part. Does that `scheme` make sense? Is that a sensible `path`? Is there anything strange about that `hostname`? etc.

What constitutes a URL is not universally well defined. Different applications have different needs and desired constraints. For instance the living WHATWG spec describes what user facing web clients such as a web browser require. While RFC 3986 is more general. These functions incorporate some aspects of both, but cannot be claimed compliant with either. The APIs and existing user code with expectations on specific behaviors predate both standards leading us to be very cautious about making API behavior changes.

## ASCII로 인코딩된 바이트열 구문 분석

URL 구문 분석 함수는 원래 문자열에서만 작동하도록 설계되었습니다. 실제로는, 적절히 인용되고 인코딩된 URL을 ASCII 바이트 시퀀스로 조작할 수 있으면 유용합니다. 따라서, 이 모듈의 URL 구문 분석 함수는 모두 `str` 객체 외에 `bytes`와 `bytearray` 객체에서 작동합니다.

`str` 데이터가 전달되면, 결과에는 `str` 데이터만 포함됩니다. `bytes`나 `bytearray` 데이터가 전달되면, 결과에는 `bytes` 데이터만 포함됩니다.

단일 함수 호출에서 `str` 데이터를 `bytes`나 `bytearray`와 혼합하려고 시도하면 `TypeError`가 발생하는 반면, 비 ASCII 바이트 값을 전달하면 `UnicodeDecodeError`가 트리거 됩니다.

`str`과 `bytes` 간에 결과 객체를 쉽게 변환 할 수 있도록, URL 구문 분석 함수의 모든 반환 값은 `encode()` 메서드(결과에 `str` 데이터가 포함될 때)나 `decode()` 메서드(결과에 `bytes` 데이터가 포함될 때)를 제공합니다. 이러한 메서드의 서명은 해당 `str`와 `bytes` 메서드의 서명과 일치합니다 (기본 인코딩이 `'utf-8'`가 아니라 `'ascii'`라는 점은 예외입니다). 각각은 `bytes` 데이터(`encode()` 메서드의 경우)나 `str` 데이터(`decode()` 메서드의 경우)를 포함하는 해당 형의 값을 생성합니다.

ASCII가 아닌 데이터를 포함할 수 있는 잘못 인용된 URL에서 작동할 가능성이 있는 응용 프로그램은 URL 구문 분석 메서드를 호출하기 전에 바이트열에서 문자로 자체 디코딩을 수행할 필요가 있습니다.

이 섹션에서 설명하는 동작은 URL 구문 분석 함수에만 적용됩니다. URL 인용 함수는 개별 URL 인용 함수의 설명서에 기술된 대로 바이트 시퀀스를 생성하거나 소비할 때 자체 규칙을 사용합니다.

버전 3.2에서 변경: URL 구문 분석 함수는 이제 ASCII 인코딩된 바이트 시퀀스를 받아들입니다.

## 구조화된 구문 분석 결과

The result objects from the `urlsplit()`, `urlparse()` and `urldefrag()` functions are subclasses of the `tuple` type. These subclasses add the attributes listed in the documentation for those functions, the encoding and decoding support described in the previous section, as well as an additional method:

urllib.parse.SplitResult.geturl()

  Return the re-combined version of the original URL as a string. This may differ from the original URL in that the scheme may be normalized to lower case and empty components may be dropped. Specifically, empty parameters, queries, and fragment identifiers will be removed unless the URL was parsed with `missing_as_none=True`.

  `urldefrag()` 결과의 경우, 빈 프래그먼트 식별자만 제거됩니다. `urlsplit()`과 `urlparse()` 결과의 경우, 이 메서드가 반환한 URL에 대해 언급된 모든 변경 사항이 적용됩니다.

  이 메서드의 결과는 원래 구문 분석 함수를 통해 다시 전달될 때 변경되지 않은 상태로 유지됩니다:

      >>> from urllib.parse import urlsplit
      >>> url = 'HTTP://www.Python.org/doc/#'
      >>> r1 = urlsplit(url)
      >>> r1.geturl()
      'http://www.Python.org/doc/'
      >>> r2 = urlsplit(r1.geturl())
      >>> r2.geturl()
      'http://www.Python.org/doc/'
      >>> r3 = urlsplit(url, missing_as_none=True)
      >>> r3.geturl()
      'http://www.Python.org/doc/#'

다음 클래스는 `str` 객체에서 작동할 때 구조화된 구문 분석 결과의 구현을 제공합니다:

class urllib.parse.DefragResult(url, fragment)

  `str` 데이터를 포함하는 `urldefrag()` 결과의 구상 클래스. `encode()` 메서드는 `DefragResultBytes` 인스턴스를 반환합니다.

  Added in version 3.2.

class urllib.parse.ParseResult(scheme, netloc, path, params, query, fragment)

  `str` 데이터를 포함하는 `urlparse()` 결과의 구상 클래스. `encode()` 메서드는 `ParseResultBytes` 인스턴스를 반환합니다.

class urllib.parse.SplitResult(scheme, netloc, path, query, fragment)

  `str` 데이터를 포함하는 `urlsplit()` 결과의 구상 클래스. `encode()` 메서드는 `SplitResultBytes` 인스턴스를 반환합니다.

다음 클래스는 `bytes`나 `bytearray` 객체에서 작동할 때 구문 분석 결과의 구현을 제공합니다:

class urllib.parse.DefragResultBytes(url, fragment)

  `bytes` 데이터를 포함하는 `urldefrag()` 결과의 구상 클래스. `decode()` 메서드는 `DefragResult` 인스턴스를 반환합니다.

  Added in version 3.2.

class urllib.parse.ParseResultBytes(scheme, netloc, path, params, query, fragment)

  `bytes` 데이터를 포함하는 `urlparse()` 결과의 구상 클래스. `decode()` 메서드는 `ParseResult` 인스턴스를 반환합니다.

  Added in version 3.2.

class urllib.parse.SplitResultBytes(scheme, netloc, path, query, fragment)

  `bytes` 데이터를 포함하는 `urlsplit()` 결과의 구상 클래스. `decode()` 메서드는 `SplitResult` 인스턴스를 반환합니다.

  Added in version 3.2.

## URL 인용

URL 인용(quoting) 함수는 특수 문자를 인용하고 비 ASCII 텍스트를 적절히 인코딩하여 프로그램 데이터를 취해서 URL 구성 요소로 안전하게 사용할 수 있도록 하는 데 중점을 둡니다. 또한 해당 작업이 위의 URL 구문 분석 함수로 처리되지 않는 경우 URL 구성 요소의 내용에서 원래 데이터를 다시 만들기 위해 이러한 작업을 뒤집는 것도 지원합니다.

urllib.parse.quote(string, safe='/', encoding=None, errors=None)

  `%xx` 이스케이프를 사용하여 string의 특수 문자를 치환합니다. 글자, 숫자 및 문자 `'_.-~'`는 절대 인용되지 않습니다. 기본적으로, 이 함수는 URL의 경로 섹션을 인용하기 위한 것입니다. 선택적 safe 매개 변수는 인용해서는 안 되는 추가 ASCII 문자를 지정합니다 — 기본값은 `'/'`입니다.

  string은 `str`이나 `bytes` 객체일 수 있습니다.

  버전 3.7에서 변경: URL 문자열 인용을 RFC 2396에서 RFC 3986으로 옮겼습니다. “~”는 이제 예약되지 않은 문자 집합에 포함됩니다.

  선택적 encoding과 errors 매개 변수는 `str.encode()` 메서드에서 받아들이는 것처럼 비 ASCII 문자를 처리하는 방법을 지정합니다. encoding의 기본값은 `'utf-8'`입니다. errors의 기본값은 `'strict'`로, 지원되지 않는 문자는 `UnicodeEncodeError`를 발생시킴을 의미합니다. string이 `bytes`이면 encoding과 errors를 제공해서는 안 됩니다, 그렇지 않으면 `TypeError`가 발생합니다.

  `quote(string, safe, encoding, errors)`는 `quote_from_bytes(string.encode(encoding, errors), safe)`와 동등함에 유의하십시오.

  예: `quote('/El Niño/')`는 `'/El%20Ni%C3%B1o/'`를 산출합니다.

urllib.parse.quote_plus(string, safe='', encoding=None, errors=None)

  `quote()`와 유사하지만, URL로 이동하기 위한 쿼리 문자열을 만들 때 HTML 폼값을 인용하는 데 필요한 대로 스페이스를 더하기 부호로 치환하기도 합니다. safe에 포함되지 않으면 원래 문자열의 더하기 부호가 이스케이프 됩니다. 또한 safe의 기본값은 `'/'`가 아닙니다.

  예: `quote_plus('/El Niño/')`는 `'%2FEl+Ni%C3%B1o%2F'`를 산출합니다.

urllib.parse.quote_from_bytes(bytes, safe='/')

  `quote()`와 유사하지만, `str` 대신 `bytes` 객체를 받아들이고, 문자열을 바이트열로 인코딩하지 않습니다.

  예: `quote_from_bytes(b'a&\xef')`는 `'a%26%EF'`를 산출합니다.

urllib.parse.unquote(string, encoding='utf-8', errors='replace')

  `%xx` 이스케이프를 동등한 단일 문자로 대체합니다. 선택적 encoding과 errors 매개 변수는 `bytes.decode()` 메서드에서 받아들이는 것처럼 퍼센트 인코딩된 시퀀스를 유니코드 문자로 디코딩하는 방법을 지정합니다.

  string은 `str`이나 `bytes` 객체일 수 있습니다.

  encoding의 기본값은 `'utf-8'`입니다. errors의 기본값은 `'replace'`로, 유효하지 않은 시퀀스는 자리 표시자 문자(placeholder character)로 대체됩니다.

  예: `unquote('/El%20Ni%C3%B1o/')`는 `'/El Niño/'`를 산출합니다.

  버전 3.9에서 변경: string 매개 변수는 바이트열과 문자열 객체를 지원합니다 (이전에는 문자열만 지원했습니다).

urllib.parse.unquote_plus(string, encoding='utf-8', errors='replace')

  `unquote()`와 유사하지만, HTML 폼값을 인용 해제할 때 요구되는 것처럼, 더하기 부호를 스페이스로 치환하기도 합니다.

  string은 `str`이어야 합니다.

  예: `unquote_plus('/El+Ni%C3%B1o/')`는 `'/El Niño/'`를 산출합니다.

urllib.parse.unquote_to_bytes(string)

  `%xx` 이스케이프를 해당 단일 옥텟(octet)으로 대체하고, `bytes` 객체를 반환합니다.

  string은 `str`이나 `bytes` 객체일 수 있습니다.

  `str`이면, string의 이스케이프 되지 않은 비 ASCII 문자는 UTF-8 바이트열로 인코딩됩니다.

  예: `unquote_to_bytes('a%26%EF')`는 `b'a&\xef'`를 산출합니다.

urllib.parse.urlencode(query, doseq=False, safe='', encoding=None, errors=None, quote_via=quote_plus)

  `str`이나 `bytes` 객체를 포함할 수 있는 매핑 객체나 두 요소 튜플의 시퀀스를 퍼센트 인코딩된 ASCII 텍스트 문자열로 변환합니다. 결과 문자열을 `urlopen()` 함수를 사용하여 POST 연산을 위한 data로 사용하려면, 바이트열로 인코딩해야 합니다, 그렇지 않으면 `TypeError`가 발생합니다.

  결과 문자열은 `'&'` 문자로 구분된 일련의 `key=value` 쌍이고, 여기서 key와 value는 quote_via 함수를 사용하여 인용됩니다. 기본적으로, `quote_plus()`가 값을 인용하는 데 사용되는데, 스페이스는 `'+'` 문자로 인용되고 ‘/’ 문자는 `%2F`로 인코딩되어 GET 요청 표준(`application/x-www-form-urlencoded`)을 따름을 뜻합니다. quote_via로 전달될 수 있는 대체 함수는 `quote()`이며, 스페이스를 `%20`로 인코딩하고 ‘/’ 문자를 인코딩하지 않습니다. 무엇을 인용할지를 최대한 제어하려면, `quote`를 사용하고 safe의 값을 지정하십시오.

  query 인자에 두 요소 튜플의 시퀀스가 사용될 때, 각 튜플의 첫 번째 요소는 키이고 두 번째 요소는 값입니다. 값 요소 자체는 시퀀스일 수 있으며, 이 경우 선택적 매개 변수 doseq가 `True`로 평가되면, `'&'`로 구분된 개별 `key=value` 쌍이 키에 대한 값 시퀀스의 각 요소에 대해 생성됩니다. 인코딩된 문자열의 파라미터 순서는 시퀀스의 파라미터 튜플 순서와 일치합니다.

  safe, encoding 및 errors 매개 변수는 quote_via로 전달됩니다 (encoding과 errors 매개 변수는 쿼리 요소가 `str`일 때만 전달됩니다).

  이 인코딩 프로세스를 뒤집기 위해, 쿼리 문자열을 파이썬 데이터 구조로 구문 분석하기 위해 이 모듈에서 `parse_qs()`와 `parse_qsl()`이 제공됩니다.

  `urllib.parse.urlencode()` 메서드를 사용하여 URL의 쿼리 문자열이나 POST 요청의 데이터를 생성하는 방법을 알아보려면 urllib 예제를 참조하십시오.

  버전 3.2에서 변경: query 매개 변수는 바이트열과 문자열 객체를 지원합니다.

  버전 3.5에서 변경: quote_via 매개 변수를 추가했습니다.

  버전 3.14부터 폐지됨: Accepting objects with false values (like `0` and `[]`) except empty strings and byte-like objects and `None` is now deprecated.

더 보기

WHATWG - URL Living standard

  Working Group for the URL Standard that defines URLs, domains, IP addresses, the application/x-www-form-urlencoded format, and their API.

RFC 3986 - Uniform Resource Identifiers

  이것이 현재 표준입니다 (STD66). urllib.parse 모듈에 대한 모든 변경 사항은 이를 준수해야 합니다. 특정 편차가 관찰될 수 있는데, 이는 대부분 이전 버전과의 호환성과 주요 브라우저에서 일반적으로 관찰되는 사실상의 구문 분석 요구 사항을 위한 것입니다.

RFC 2732 - Format for Literal IPv6 Addresses in URL’s.

  IPv6 URL의 구문 분석 요구 사항을 지정합니다.

RFC 2396 - Uniform Resource Identifiers (URI): Generic Syntax

  URN(Uniform Resource Names)과 URL(Uniform Resource Locator)에 대한 일반적인 문법 요구 사항을 설명하는 문서.

RFC 2368 - The mailto URL scheme.

  mailto URL 스킴에 대한 구문 분석 요구 사항.

RFC 1808 - Relative Uniform Resource Locators

  이 RFC는 경계 사례의 처리를 정의하는 꽤 많은 수의 “비정상적인 예”를 포함하여, 절대와 상대 URL을 결합하는 규칙을 포함합니다.

RFC 1738 - Uniform Resource Locators (URL)

  절대 URL의 형식 문법과 의미를 지정합니다.