100 lines
2.4 KiB
ReStructuredText
100 lines
2.4 KiB
ReStructuredText
.. _install:
|
|
|
|
Installation of Camelot
|
|
=======================
|
|
|
|
This part of the documentation covers how to install Camelot. First, you'll need to install the dependencies, which include `Tkinter`_ and `ghostscript`_.
|
|
|
|
.. _Tkinter: https://wiki.python.org/moin/TkInter
|
|
.. _ghostscript: https://www.ghostscript.com
|
|
|
|
Install the dependencies
|
|
------------------------
|
|
|
|
These can be installed using your system's package manager. You can run one of the following, based on your OS.
|
|
|
|
For Ubuntu
|
|
^^^^^^^^^^
|
|
::
|
|
|
|
$ apt install python-tk ghostscript
|
|
|
|
Or for Python 3::
|
|
|
|
$ apt install python3-tk ghostscript
|
|
|
|
For macOS
|
|
^^^^^^^^^
|
|
::
|
|
|
|
$ brew install tcl-tk ghostscript
|
|
|
|
For Windows
|
|
^^^^^^^^^^^
|
|
|
|
For Tkinter, you can download the `ActiveTcl Community Edition`_ from ActiveState. For ghostscript, you can get the installer at the `ghostscript downloads page`_.
|
|
|
|
After installing ghostscript, you'll need to reboot your system to make sure that the ghostscript executable's path is in the windows PATH environment variable. In case you don't want to reboot, you can manually add the ghostscript executable's path to the PATH variable, `as shown here`_.
|
|
|
|
.. _ActiveTcl Community Edition: https://www.activestate.com/activetcl/downloads
|
|
.. _ghostscript downloads page: https://www.ghostscript.com/download/gsdnld.html
|
|
.. _as shown here: https://java.com/en/download/help/path.xml
|
|
|
|
----
|
|
|
|
You can do the following checks to see if the dependencies were installed correctly.
|
|
|
|
For Tkinter
|
|
^^^^^^^^^^^
|
|
|
|
Launch Python, and then at the prompt, type::
|
|
|
|
>>> import Tkinter
|
|
|
|
Or in Python 3::
|
|
|
|
>>> import tkinter
|
|
|
|
If you have Tkinter, Python will not print an error message, and if not, you will see an ``ImportError``.
|
|
|
|
For ghostscript
|
|
^^^^^^^^^^^^^^^
|
|
|
|
Run the following to check the ghostscript version.
|
|
|
|
For Ubuntu/macOS::
|
|
|
|
$ gs -version
|
|
|
|
For Windows::
|
|
|
|
C:\> gswin64c.exe -version
|
|
|
|
Or for Windows 32-bit::
|
|
|
|
C:\> gswin32c.exe -version
|
|
|
|
If you have ghostscript, you should see the ghostscript version and copyright information.
|
|
|
|
$ pip install camelot-py
|
|
------------------------
|
|
|
|
After installing the dependencies, you can simply use pip to install Camelot::
|
|
|
|
$ pip install camelot-py
|
|
|
|
Get the source code
|
|
-------------------
|
|
|
|
Alternatively, you can install from the source by:
|
|
|
|
1. Cloning the GitHub repository.
|
|
::
|
|
|
|
$ git clone https://www.github.com/socialcopsdev/camelot
|
|
|
|
2. Then simply using pip again.
|
|
::
|
|
|
|
$ cd camelot
|
|
$ pip install . |