From 185915df34140037ba0997c1d3b123f17ae532d8 Mon Sep 17 00:00:00 2001 From: Alex Kelly Date: Mon, 4 Oct 2021 12:29:40 -0400 Subject: [PATCH] docs: add installation section --- docs/source/index.rst | 1 + docs/source/install.rst | 26 ++++++++++++++++++++++++++ 2 files changed, 27 insertions(+) create mode 100644 docs/source/install.rst diff --git a/docs/source/index.rst b/docs/source/index.rst index da81419..f97319f 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -11,6 +11,7 @@ Welcome to checkcert's documentation! :caption: Contents: introduction + install diff --git a/docs/source/install.rst b/docs/source/install.rst new file mode 100644 index 0000000..31fe33b --- /dev/null +++ b/docs/source/install.rst @@ -0,0 +1,26 @@ +Installation +============ + +From Pypi +--------- + +The easiest way is to install via pypi via: + +``pip install checkcert`` + +If you already have checkcert installed and wish to update it, run: + +``pip install -U checkcert`` + +This will upgrade the currently-installed version to the latest. + +From Git +-------- + +There are many methods for running within a virtual environment isolated for a particular package. Certcheck has been built with poetry, so this document details that method, but there are certainly other ways to accomplish the same thing + +1. clone the repo ``git clone https://github.com/kellya/checkcert.git`` +2. cd to the directory you just cloned ``cd checkcert`` +3. install the required packages ``poetry install`` +4. activate the poetry-built venv ``poetry shell`` +5. run with ``python certcheck/certcheck.py``