summaryrefslogtreecommitdiff
path: root/docs/user/install.rst
blob: 1dd9de8e5cfdb93f9bda8f9659b4a5413b61a07b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
.. _install:

Installation of Requests
========================

.. image:: https://farm5.staticflickr.com/4230/35550376215_da1bf77a8c_k_d.jpg


This part of the documentation covers the installation of Requests.
The first step to using any software package is getting it properly installed.


$ pipenv install requests
-------------------------

To install Requests, simply run this simple command in your terminal of choice::

    $ pipenv install requests

If you don't have `pipenv <http://pipenv.org/>`_ installed (tisk tisk!), head over to the Pipenv website for installation instructions. Or, if you prefer to just use pip and don't have it installed,
`this Python installation guide <http://docs.python-guide.org/en/latest/starting/installation/>`_
can guide you through the process.

Get the Source Code
-------------------

Requests is actively developed on GitHub, where the code is
`always available <https://github.com/requests/requests>`_.

You can either clone the public repository::

    $ git clone git://github.com/requests/requests.git

Or, download the `tarball <https://github.com/requests/requests/tarball/master>`_::

    $ curl -OL https://github.com/requests/requests/tarball/master
    # optionally, zipball is also available (for Windows users).

Once you have a copy of the source, you can embed it in your own Python
package, or install it into your site-packages easily::

    $ cd requests
    $ pip install .