Alpha 3 release ready

.github/workflows/deploy-docs.yml

@@ -14,5 +14,6 @@ jobs:
         with:
           python-version: 3.x
       - run: pip install mkdocs
-      - run: pip install mkdocs-terminal
+      - run: pip install mkdocs-material
+      - run: pip install mkdocs-typer
       - run: cd docs && mkdocs gh-deploy --force --clean --verbose

.github/workflows/run-tests.yml

@@ -1,4 +1,4 @@
-name: Testing
+name: ci
 on:
   push:
     branches:
@@ -15,11 +15,11 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version-file: pyproject.toml
       - name: Install Task
-        uses: arduino/setup-task@v1
+        uses: arduino/setup-task@v2
         with:
           version: 3.x
           repo-token: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,3 +1,6 @@
+# SQlite databases
+*.sqlite
+
 # managed by direnv
 .envrc
 

CITATION.cff

@@ -0,0 +1,7 @@
+@misc{gallagher_github,
+    author = {Anomaly},
+    title = {Gallagher},
+    howpublished = {GitHub Repository},
+    url = {https://github.com/anomaly/gallagher},
+    note = {Accessed: 2024-05-02},
+}

CLI.md

@@ -0,0 +1,47 @@
+# Command Line Interface
+
+> The CLI is developed using [Typer](https://typer.tiangolo.com) which builds on the [infamous](https://click.palletsprojects.com/en/8.1.x/)
+
+Over the course of developing the Python idiomatic client for Gallagher, it became evident to us that the primary utility of the application will come from use facing tools that make the library immediately useful. This document outlines the scope of intent of the CLI and what feature it will provide (or initially anyway).
+
+## Objectives
+
+A big motivation for building this client library is efficiency in integrating Gallagher Command Centre into other systems. Integration primarily presents itself in the following forms:
+
+- Querying the state of the Command Centre and reacting to the information
+- Mutating the state of the system (e.g add a card holder, pass, access group, etc)
+- Synchronizing the information back to ta local system (talked in detail about in [SQL](SQL.md))
+
+While the API client is designed for structured programmatic access to the API, these use facing tools are designed to automate everyday use cases without needing to code.
+
+## Audience
+
+While the REST API client is aimed at developers (primarily Python developers) the CLI is intended for use by higher level uses for automation. The CLI still requires some technical knowledge and it targeted towards high level system integrator to build automation around the Gallagher ecosystem.
+
+## Design
+
+Following the [Unix philosophy](https://en.wikipedia.org/wiki/Unix_philosophy) of `Make each program do one thing well.` or summarised by [Peter H. Salus](https://en.wikipedia.org/wiki/Peter_H._Salus) as:
+
+- Write programs that do one thing and do it well.
+- Write programs to work together.
+- Write programs to handle text streams, because that is a universal interface.
+
+Each component presented by this project aims to do just that.
+
+> The primary objective of the CLI is to interact with the JSON API through the command line so users can build high level automation without having to interact directly with the JSON payloads. It uses the Python API client to ensure strict data rules when interacting with the API endpoints, thus preventing corruption.
+
+The project must provide complete documentation for the tool to be useful to an end user / system administrator.
+
+## Scope
+
+The initial version 
+
+- Cardholder
+- Visits
+- Alarms
+
+
+
+## Resources
+
+- [Command Line Interface Guidelines - clig.dev](https://clig.dev)

HARDWARE.md

@@ -0,0 +1,28 @@
+# Hardware
+
+The following are some notes and resources I used to get our [Controller 7000 Single door](https://products.security.gallagher.com/security/global/en/products/access-control-hardware/controller-7000-single-door/p/BVC400011) PoE+ controller with a [T15 Multi Tech Reader](https://products.security.gallagher.com/security/global/en/products/access-control-hardware/readers-and-terminals/t15-multi-tech-reader/p/BVC300480) online with our Command Centre hosted on an AWS EC2 instance.
+
+> [!WARNING]\
+> Our setup was completely for demonstration purposes and was never intended for use in a production environment. Please consult a professional for any production setups.
+
+A big thank you to [Gallagher Security](http://security.gallagher.com) for providing the hardware and software for this project.
+
+## Shopping list
+
+- [Controller 7000 Single door](https://products.security.gallagher.com/security/global/en/products/access-control-hardware/controller-7000-single-door/p/BVC400011)
+- [T15 Multi Tech Reader](https://products.security.gallagher.com/security/global/en/products/access-control-hardware/readers-and-terminals/t15-multi-tech-reader/p/BVC300480)
+- [Gallagher Command Centre](http://security.gallagher.com) software
+- [Gallagher Mobile Connect](http://security.gallagher.com) app
+
+## Reference videos
+
+Official video tutorials from Gallagher Security:
+
+- [Getting a Controller Online](https://www.youtube.com/watch?v=qDNjwEC2blU)
+- [Getting a Controller Online using webpage adressing](https://www.youtube.com/watch?v=a4CCq_Ip0LQ)
+
+Official documentation:
+
+- [Controller 7000 Single door](https://products.security.gallagher.com/security/global/en/products/access-control-hardware/controller-7000-single-door/p/BVC400011)
+
+- [Controller 7000 Single door documents](https://media.gallagher.com/web/1a00857c7c9c8d7/single-door-controller-7000-qr-code/?viewType=grid)