PyPy 다운로드 및 설치
=====================

CPython과 마찬가지로, 기본 인터프리터 환경이 필요하며 이후 추가 패키지를 설치할 수 있습니다. 기본 인터프리터를 설치하는 방법에는 다음과 같은 선택지가 있습니다:

- conda 사용(x86_64 windows, macOS, linux, arm64 linux)
- 배포판 패키지 관리자를 사용하세요(리눅스)
- Homebrew 사용(macOS)
- 미리 빌드된 tarball 사용하기
- 소스에서 빌드하기

conda 사용하기
~~~~~~~~~~~~~~

SciPy와 같은 컴파일된 (C 확장) 모듈이 필요하다면, Windows10, macOS, linux x86_64에서 동작하는 conda와 pypy3.9를 사용하는 것을 권장합니다. 이에 대한 자세한 내용은 `blog post`_\ 에서 확인할 수 있습니다.

.. code-block:: console

    $ conda create -c conda-forge -n my_cool_pypy pypy python=3.9
    $ conda activate my_cool_pypy
    $ conda install scipy

Homebrew 사용
~~~~~~~~~~~~~

macOS에서는 서명된 패키지를 제공하는 homebrew도 사용할 수 있습니다. 2024년 5월 기준으로 pypy3.9와 pypy3.10을 그곳에서 찾을 수 있습니다.

.. _`blog post`: https://www.pypy.org/posts/2022/11/pypy-and-conda-forge.html

리눅스 배포판
~~~~~~~~~~~~~

일부 리눅스 배포판은 pypy 패키지를 제공합니다. 컴파일이 필요한 추가 모듈을 설치하려면 pypy-dev와 같은 추가 패키지를 설치해야 할 수도 있다는 점에 유의하십시오. 이 경우 "missing Python.h"에 관한 오류로 나타납니다. 배포판들은 아직 pypy에 대응하는 패키지를 많이 제공하지 않으므로, 추가 모듈이 필요하다면 virtualenv를 만들고 pip를 사용하는 것을 권장합니다.

.. _prebuilt-pypy:

미리 빌드된 PyPy 다운로드
~~~~~~~~~~~~~~~~~~~~~~~~~

PyPy 사용을 시작하는 가장 빠른 방법은 사용자의 OS와 아키텍처에 맞는 미리 빌드된 바이너리를 다운로드하는 것입니다. 사용자는 `most recent release`_\ 나 저희의 `development nightly build`_\ 중 하나를 사용할 수 있습니다.

나이틀리 빌드는 공식 릴리스만큼 안정적이라고 보장되지 않으므로, 사용에 따른 위험은 사용자 본인이 감수해야 함에 유의하시기 바랍니다. 또한 macOS 바이너리는 서명되어 있지 않으므로, macOS가 이를 안전하다고 인식하도록 사용자가 직접 설정해\ 주어야 합니다.

.. _most recent release: https://pypy.org/download.html
.. _development nightly build: https://buildbot.pypy.org/nightly/trunk/
.. _Linux binaries: https://pypy.org/download.html#linux-binaries-and-common-distributions

PyPy는 tarball 또는 zip 파일의 압축을 풀자마자 바로 실행할 수 있으며, 특정 위치에 설치할 필요가 없습니다:

.. code-block:: console

    $ tar xf pypy-x.y.z.tar.bz2
    $ ./pypy-x.y.z/bin/pypy
    Python 2.7.x (xxxxxxxxxxxx, Date, Time)
    [PyPy x.y.z with GCC x.y.z] on linux2
    Type "help", "copyright", "credits" or "license" for more information.
    And now for something completely different: ``PyPy is an exciting technology
    that lets you to write fast, portable, multi-platform interpreters with less
    effort''
    >>>>

PyPy를 시스템 전역에서 사용할 수 있게 하려면, ``pypy`` 실행 파일에 대한 심볼릭 링크를 ``/usr/local/bin``\ 에 넣을 수 있습니다. 바이너리를 그곳으로 옮기지 말고 심볼릭 링크를 넣는 것이 중요합니다. 그렇지 않으면 PyPy가 라이브러리를 찾을 수 없게 됩니다.

추가 모듈 설치
~~~~~~~~~~~~~~

서드파티 라이브러리를 설치하고 싶다면, 가장 편리한 방법은 ensurepip_\ 를 사용해 pip_\ 를 설치하는 것입니다(아래에서 설명하는 것처럼 virtualenv를 설치하려는 경우가 아니라면; 그런 경우에는 virtualenv 안에서 pip를 직접 사용할 수 있습니다):

.. code-block:: console

    $ ./pypy-xxx/bin/pypy -m ensurepip
    $ ./pypy-xxx/bin/pypy -mpip install -U pip wheel # to upgrade to the latest versions
    $ ./pypy-xxx/bin/pypy -mpip install pygments  # for example

서드 파티 라이브러리는 ``pypy-xxx/site-packages``\ 에 설치됩니다. CPython과 마찬가지로, 리눅스와 macOS에서 스크립트는 ``pypy-xxx/bin``\ 에 있고, 윈도우에서는 ``pypy-xxx/Scripts``\ 에 있습니다.


virtualenv\ 를 사용하여 설치하기
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

virtualenv 안에서 pypy를 실행하면 편리한 경우가 많습니다. 이를 위해서는 1.6.1 이상 버전의 virtualenv가 필요합니다. 그런 다음 미리 컴파일된 tarball이나 번역(translation) 후의 git checkout을 통해 PyPy를 설치할 수 있습니다.::

	# from a tarball
	$ virtualenv -p /opt/pypy-xxx/bin/pypy my-pypy-env

	# from the git checkout
	$ virtualenv -p /path/to/pypy/pypy/translator/goal/pypy-c my-pypy-env

	# in any case activate it
	$ source my-pypy-env/bin/activate

my-pypy-env/bin/python은 이제 my-pypy-env/bin/pypy에 대한 심볼릭 링크이므로, 다음과 같이 입력하는 것만으로 pypy를 실행할 수 있습니다::

    $ python

그래도 다음 명령을 통해 pip와 wheel을 최신 버전으로 업그레이드해야 합니다::

    $ my-pypy-env/bin/pypy -mpip install -U pip wheel

.. _pip: https://pypi.python.org/pypi/pip
.. _ensurepip: https://docs.python.org/3/library/ensurepip.html

소스에서\ 빌드하기
~~~~~~~~~~~~~~~~~~

더 많이 참여하거나 PyPy로 다른 것을 해보는 데 관심이 있다면, :doc:`the build instructions <build>`\ 을 참고하세요.