66 lines
1.5 KiB
ReStructuredText
66 lines
1.5 KiB
ReStructuredText
Installation
|
|
============
|
|
|
|
Install the ``snap-pac`` package using pacman:
|
|
|
|
.. code-block:: bash
|
|
|
|
pacman -S snap-pac
|
|
|
|
Alternatively download the `latest release and signature
|
|
<https://github.com/wesbarnett/snap-pac/releases>`_. Then, verify the download:
|
|
|
|
.. code-block:: bash
|
|
|
|
gpg --verify snap-pac-<version>.tar.gz.sig
|
|
|
|
where ``<version>`` is the version number you downloaded.
|
|
|
|
Finally, run:
|
|
|
|
.. code-block:: bash
|
|
|
|
make install
|
|
|
|
I have signed the release tarball and commits with my PGP key. Starting with release
|
|
2.2, the tarballs are signed with my key with fingerprint
|
|
``F7B28C61944FE30DABEEB0B01070BCC98C18BD66``.
|
|
|
|
For previous releases, the key's fingerprint was
|
|
``8535CEF3F3C38EE69555BF67E4B5E45AA3B8C5C3``.
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
``python``, ``pacman``, and ``snapper`` are all required.
|
|
|
|
Testing
|
|
-------
|
|
|
|
For testing, ``pytest`` is required. To run the tests do:
|
|
|
|
.. code-block:: bash
|
|
|
|
make test
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Typically, you will not need to build the documentation on your own and can simply
|
|
access it by visiting the `online documentation
|
|
<https://wesbarnett.github.io/snap-pac/>`_ or by accessing the manpage:
|
|
|
|
.. code-block:: bash
|
|
|
|
man 8 snap-pac
|
|
|
|
To build the documentation, ``sphinx`` is required. To build the documentation you can
|
|
do:
|
|
|
|
.. code-block:: bash
|
|
|
|
make docs
|
|
|
|
The resulting html documentation will then be located at ``docs/build/index.html``.
|
|
Additionally, this generates the manpage which will be located under ``man8``.
|