feat: Planar Clarity Video Wall

.ameba.yml

@@ -0,0 +1,57 @@
+Excluded:
+  - repositories/**/*.cr
+
+# NOTE: These should all be reviewed on an individual basis to see if their
+#       complexity can be reasonably reduced.
+Metrics/CyclomaticComplexity:
+  Description: Disallows methods with a cyclomatic complexity higher than `MaxComplexity`
+  MaxComplexity: 10
+  Excluded:
+  - drivers/helvar/net.cr
+  - drivers/mulesoft/booking_api.cr
+  - drivers/samsung/displays/mdc_protocol.cr
+  - drivers/cisco/dna_spaces.cr
+  - drivers/cisco/meraki/dashboard.cr
+  - drivers/cisco/switch/snooping_catalyst.cr
+  - drivers/gantner/relaxx/protocol_json.cr
+  - drivers/place/bookings.cr
+  - drivers/place/area_management.cr
+  - drivers/place/smtp.cr
+  - drivers/hitachi/projector/cp_tw_series_basic.cr
+  - drivers/panasonic/projector/nt_control.cr
+  - drivers/lumens/dc193.cr
+  Enabled: false
+  Severity: Convention
+
+Lint/UselessAssign:
+  Description: Disallows useless variable assignments
+  # NOTE: Not enabled due to the extremely large hit count.
+  #       Discussion with driver authors on whether this pattern is intended.
+  Enabled: false
+  Severity: Warning
+
+Style/VerboseBlock:
+  Description: Identifies usage of collapsible single expression blocks.
+  ExcludeCallsWithBlock: false
+  ExcludeMultipleLineBlocks: true
+  ExcludeOperators: false
+  ExcludePrefixOperators: false
+  ExcludeSetters: true
+  Enabled: false
+  Severity: Convention
+
+Style/VariableNames:
+  Description: Enforces variable names to be in underscored case
+  # NOTE: Not enabled due to the extremely large hit count.
+  #       Discussion with driver authors on whether this pattern is intended.
+  Enabled: false
+  Severity: Convention
+
+# NOTE: These appear to be triggered by assignment in case expressions, could be an ameba bug
+Lint/ShadowingOuterLocalVar:
+  Description: Disallows the usage of the same name as outer local variables for block
+    or proc arguments.
+  Excluded:
+  - drivers/cisco/switch/snooping_catalyst.cr
+  Enabled: true
+  Severity: Warning

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: 'Bug: A concise description of the behaviour'
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+
+Steps to reproduce the behaviour or a minimal code snippet that demonstrates the behaviour.
+
+**Expected behaviour**
+
+A clear and concise description of what you expected to happen.
+
+**Screenshots or a paste of terminal output**
+
+If applicable, add screenshots to help explain your problem.
+
+**Versions (please complete the following information):**
+
+- Output of `$ crystal version`
+- Driver version [e.g. 3.x] 
+
+**Additional context**
+
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/driver_migration.md

@@ -0,0 +1,20 @@
+---
+name: Driver Migration
+about: Migrate existing Ruby Engine Driver to Crystal
+title: 'Driver Migration: Migrate existing Ruby driver'
+labels: driver
+assignees: ''
+
+---
+
+**Driver to be Migrated**
+
+Information about the driver to be migrated.
+
+**Link to Existing Driver**
+
+Link to existing Driver on Ruby Drivers Repo.
+
+**Additional context**
+
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/driver_request.md

@@ -0,0 +1,32 @@
+---
+name: Driver Request
+about: Request a new driver to be created
+title: 'Driver Request: Information required to create a new driver'
+labels: driver
+assignees: ''
+
+---
+
+**Driver Type**
+
+Logic/Device/SSH/Websocket
+
+**Manufacturer**
+
+Manufacturer of device, software or service
+
+**Model/Service**
+
+Model or Service
+
+**Link to or Attach Device API or Protocol**
+
+If applicable, add screenshots to help explain your problem.
+
+**Describe any desired functionality**
+
+- Control all aspects of device
+
+**Additional context**
+
+Add any other context about the driver request here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: 'RFC: Concise description of desired feature'
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+
+Add any other context or screenshots about the feature request here.

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/ci.yml

@@ -0,0 +1,92 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  schedule:
+    - cron: "0 6 * * 1"
+
+jobs:
+  style:
+    name: "Style"
+    runs-on: ubuntu-latest
+    container: crystallang/crystal
+    steps:
+      - uses: actions/checkout@v2
+      - name: Format
+        run: crystal tool format --check
+      - name: Lint
+        uses: crystal-ameba/github-action@v0.2.12
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  subset-report:
+    name: "Subset Report - crystal: ${{ matrix.crystal }}, stable: ${{ matrix.stable }}"
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ !matrix.stable }}
+    strategy:
+      fail-fast: false
+      matrix:
+        stable: [true]
+        crystal:
+          - 1.0.0
+        include:
+          - stable: false
+            crystal: nightly
+    steps:
+      - id: changes
+        uses: trilom/file-changes-action@v1.2.4
+        with:
+          output: ' '
+      - uses: actions/checkout@v2
+      - name: Cache shards
+        uses: actions/cache@v2
+        with:
+          path: lib
+          key: ${{ hashFiles('shard.lock') }}
+      - name: Driver Report
+        # Skip subset report if dependencies have changed
+        if: ${{ !contains(steps.changes.outputs.files, 'shard.yml') && !contains(steps.changes.outputs.files, 'shard.lock')  }}
+        run: ./harness report ${{ steps.changes.outputs.files }}
+        env:
+          CRYSTAL_VERSION: ${{ matrix.crystal }}
+      - name: Upload failure logs
+        if: ${{ failure() }}
+        uses: actions/upload-artifact@v2
+        with:
+          name: logs-${{ matrix.crystal }}-${{ github.sha }}
+          path: .logs/*.log
+
+  full-report:
+    name: "Full Report - crystal: ${{ matrix.crystal }}, stable: ${{ matrix.stable }}"
+    needs: subset-report
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ !matrix.stable }}
+    strategy:
+      fail-fast: false
+      matrix:
+        stable: [true]
+        crystal:
+          - 1.0.0
+        include:
+          - stable: false
+            crystal: nightly
+    steps:
+      - uses: actions/checkout@v2
+      - name: Cache shards
+        uses: actions/cache@v2
+        with:
+          path: lib
+          key: ${{ hashFiles('shard.lock') }}
+      - name: Driver Report
+        run: ./harness report
+        env:
+          CRYSTAL_VERSION: ${{ matrix.crystal }}
+      - name: Upload failure logs
+        if: ${{ failure() }}
+        uses: actions/upload-artifact@v2
+        with:
+          name: logs-${{ matrix.crystal }}-${{ github.sha }}
+          path: .logs/*.log

.gitignore

@@ -1,6 +1,12 @@
-doc
-lib
+*.dwarf
+*.rdb
+.DS_Store
 .crystal
 .shards
 app
-*.dwarf
+bin
+doc
+docs
+lib
+.logs
+repositories/*

.vscode/launch.json

@@ -0,0 +1,16 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Debug",
+      "type": "gdb",
+      "request": "launch",
+      "target": "./bin/test-harness",
+      "cwd": "${workspaceRoot}",
+      "preLaunchTask": "Compile",
+      "setupCommands": [
+        { "text": "-gdb-set follow-fork-mode child" }
+      ]
+    }
+  ]
+}

.vscode/tasks.json

@@ -0,0 +1,10 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Compile",
+      "command": "shards build --debug drivers",
+      "type": "shell"
+    }
+  ]
+}

README.md

@@ -1,41 +1,52 @@
-# Spider-Gazelle Application Template
+# PlaceOS Drivers
 
-[![Build Status](https://travis-ci.org/spider-gazelle/spider-gazelle.svg?branch=master)](https://travis-ci.org/spider-gazelle/spider-gazelle)
+[![CI](https://github.com/PlaceOS/drivers/actions/workflows/ci.yml/badge.svg)](https://github.com/PlaceOS/drivers/actions/workflows/ci.yml)
 
-Clone this repository to start building your own spider-gazelle based application
+Manage and test [PlaceOS](https://place.technology) drivers.
 
-## Documentation
+## Development
 
-* [Action Controller](https://github.com/spider-gazelle/action-controller) base class for building [Controllers](http://guides.rubyonrails.org/action_controller_overview.html)
-* [Active Model](https://github.com/spider-gazelle/active-model) base class for building [ORMs](https://en.wikipedia.org/wiki/Object-relational_mapping)
-* [Habitat](https://github.com/luckyframework/habitat) configuration and settings for Crystal projects
-* [router.cr](https://github.com/tbrand/router.cr) base request handling
-* [Radix](https://github.com/luislavena/radix) Radix Tree implementation for request routing
-* [HTTP::Server](https://crystal-lang.org/api/latest/HTTP/Server.html) built-in Crystal Lang HTTP server
-  * Request
-  * Response
-  * Cookies
-  * Headers
-  * Params etc
+### `harness`
 
+`harness` is a helper for easing development of PlaceOS Drivers.
 
-Spider-Gazelle builds on the amazing performance of **router.cr** [here](https://github.com/tbrand/which_is_the_fastest).:rocket:
+```
+Usage: ./harness [-h|--help] [command]
 
+Helper script for interfacing with the PlaceOS Driver spec runner
 
-## Testing
+Command:
+    report                  check all drivers' compilation status
+    up                      starts the harness
+    down                    stops the harness
+    format                  formats driver code
+    help                    display this message
+```
 
-`crystal spec`
+To spin up the test harness, clone the repository and run...
 
-* to run in development mode `crystal ./src/app.cr`
+```shell-session
+$ ./harness up
+```
 
-## Compiling
+Point a browser to [localhost:8085](http://localhost:8085), and you're good to go.
 
-`crystal build ./src/app.cr`
+When the environment is not in use, remember to run...
 
-### Deploying
+```shell-session
+$ ./harness down
+```
 
-Once compiled you are left with a binary `./app`
+Before committing, please run...
 
-* for help `./app --help`
-* viewing routes `./app --routes`
-* run on a different port or host `./app -h 0.0.0.0 -p 80`
+```shell-session
+$ ./harness format
+```
+
+## Contributing
+
+1. [Fork it](https://github.com/PlaceOS/drivers/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request