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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
.. _install:
Installation
============
System-Wide Installation
------------------------
Installing the ``internetarchive`` library globally on your system can be done with `pip <http://www.pip-installer.org/>`_.
This is the recommended method for installing ``internetarchive`` (`see below <installation.html#installing-pip>`_ for details on installing pip)::
$ sudo pip install internetarchive
or, with `easy_install <http://pypi.python.org/pypi/setuptools>`_::
$ sudo easy_install internetarchive
Either of these commands will install the ``internetarchive`` Python library and ``ia`` command-line tool on your system.
**Note**: Some versions of Mac OS X come with Python libraries that are required by ``internetarchive`` (e.g. the Python package ``six``).
This can cause installation issues. If your installation is failing with a message that looks something like::
OSError: [Errno 1] Operation not permitted: '/var/folders/bk/3wx7qs8d0x79tqbmcdmsk1040000gp/T/pip-TGyjVo-uninstall/System/Library/Frameworks/Python.framework/Versions/2.7/Extras/lib/python/six-1.4.1-py2.7.egg-info'
You can use the ``--ignore-installed`` parameter in ``pip`` to ignore the libraries that are already installed, and continue with the rest of the installation::
$ sudo pip install --ignore-installed internetarchive
More details on this issue can be found here: https://github.com/pypa/pip/issues/3165
Installing Pip
~~~~~~~~~~~~~~
Pip can be `installed with the get-pip.py script <https://pip.pypa.io/en/stable/installing/>`_::
$ curl -LOs https://bootstrap.pypa.io/get-pip.py
$ python get-pip.py
virtualenv
----------
If you don't want to, or can't, install the package system-wide you can use ``virtualenv`` to create an isolated Python environment.
First, make sure ``virtualenv`` is installed on your system. If it's not, you can do so with pip::
$ sudo pip install virtualenv
With ``easy_install``::
$ sudo easy_install virtualenv
Or your systems package manager, ``apt-get`` for example::
$ sudo apt-get install python-virtualenv
Once you have ``virtualenv`` installed on your system, create a virtualenv::
$ mkdir myproject
$ cd myproject
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools, pip............done.
Activate your virtualenv::
$ . venv/bin/activate
Install ``internetarchive`` into your virtualenv::
$ pip install internetarchive
Binaries
--------
Binaries are also available for the ``ia`` command-line tool::
$ curl -LOs https://archive.org/download/ia-pex/ia
$ chmod +x ia
Binaries are generated with `PEX <https://github.com/pantsbuild/pex>`_. The only requirement for using the binaries is that you have Python 3 installed on a Unix-like operating system.
For more details on the command-line interface please refer to the `README <https://github.com/jjjake/internetarchive/blob/master/README.rst>`_, or ``ia help``.
Python 2
--------
If you are on an older operating system that only has Python 2 installed, it's highly suggested that you upgrade to Python 3. If for any reason you are not able to, the latest version of ``ia`` that supports Python 2 is 2.3.0.
You can install and use version v2.3.0 with pip::
$ pip install internetarchive==2.3.0
You can also download a binary of v2.3.0::
$ curl -LOs https://archive.org/download/ia-pex/ia-py2
$ chmod +x ia-py2
Snap
----
You can install the latest ``ia`` `snap <https://snapcraft.io>`_, and help testing the most recent changes of the master branch in `all the supported Linux distros <https://snapcraft.io/docs/core/install>`_ with::
$ sudo snap install ia --edge
Every time a new version of ``ia`` is pushed to the store, you will get it updated automatically.
Get the Code
------------
Internetarchive is `actively developed on GitHub <https://github.com/jjjake/internetarchive>`_.
You can either clone the public repository::
$ git clone git://github.com/jjjake/internetarchive.git
Download the `tarball <https://github.com/jjjake/internetarchive/tarball/master>`_::
$ curl -OL https://github.com/jjjake/internetarchive/tarball/master
Or, download the `zipball <https://github.com/jjjake/internetarchive/zipball/master>`_::
$ curl -OL https://github.com/jjjake/internetarchive/zipball/master
Once you have a copy of the source, you can install it into your site-packages easily::
$ python setup.py install
|
