feat(place): event scrape

.ameba.yml

@@ -0,0 +1,63 @@
+# This configuration file was generated by `ameba --gen-config`
+# on 2019-10-15 23:45:35 UTC using Ameba version 0.10.1.
+# The point is for the user to remove these configuration records
+# one by one as the reported problems are removed from the code base.
+
+# Run `ameba --only Metrics/CyclomaticComplexity` for details
+Metrics/CyclomaticComplexity:
+  Description: Disallows methods with a cyclomatic complexity higher than `MaxComplexity`
+  MaxComplexity: 12
+  Enabled: true
+  Severity: Convention
+
+# Run `ameba --only Lint/ShadowingOuterLocalVar` for details
+Lint/ShadowingOuterLocalVar:
+  Description: Disallows the usage of the same name as outer local variables for block
+    or proc arguments.
+  Enabled: true
+  Severity: Warning
+
+# Run `ameba --only Style/ConstantNames` for details
+Style/ConstantNames:
+  Description: Enforces constant names to be in screaming case
+  Enabled: False
+  Severity: Convention
+
+# Run `ameba --only Style/UnlessElse` for details
+Style/UnlessElse:
+  Description: Disallows the use of an `else` block with the `unless`
+  Enabled: true
+  Severity: Convention
+
+# Run `ameba --only Lint/UnusedArgument` for details
+Lint/UnusedArgument:
+  Description: Disallows unused arguments
+  IgnoreDefs: true
+  IgnoreBlocks: false
+  IgnoreProcs: false
+  Enabled: true
+  Severity: Warning
+
+# Run `ameba --only Lint/UselessAssign` for details
+Lint/UselessAssign:
+  Description: Disallows useless variable assignments
+  Enabled: true
+  Severity: Warning
+  Excluded:
+  - repositories/private_drivers/lib/redis/spec/redis_spec.cr
+  - repositories/private_drivers/lib/pool/test/pool_test.cr
+  - repositories/private_drivers/lib/pool/test/connection_pool_test.cr
+
+# Run `ameba --only Lint/UnreachableCode` for details
+Lint/UnreachableCode:
+  Description: Reports unreachable code
+  Enabled: true
+  Severity: Warning
+  Excluded:
+  - repositories/private_drivers/lib/driver/src/driver/protocol/management.cr
+
+# Run `ameba --only Style/VariableNames` for details
+Style/VariableNames:
+  Description: Enforces variable names to be in underscored case
+  Enabled: true
+  Severity: Convention

.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/workflows/crystal.yml

@@ -0,0 +1,21 @@
+name: Crystal CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  style:
+    runs-on: ubuntu-latest
+    container:
+      image: crystallang/crystal
+    steps:
+    - uses: actions/checkout@v2
+    - name: Format
+      run: crystal tool format
+    - name: Lint
+      uses: crystal-ameba/github-action@v0.2.6
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -4,3 +4,7 @@ lib
 .shards
 app
 *.dwarf
+repositories/*
+bin
+.DS_Store
+*.rdb

.travis.yml

@@ -1 +1,9 @@
+dist: xenial
+sudo: required
+
 language: crystal
+install:
+  - docker-compose up -d
+  - sleep 10
+script:
+  - docker exec -it drivers crystal spec

.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"
+    }
+  ]
+}

Dockerfile

@@ -0,0 +1,20 @@
+FROM crystallang/crystal:0.36.1-alpine
+COPY . /src
+WORKDIR /src
+
+# Install the latest version of LibSSH2 and the GDB debugger
+RUN apk update
+RUN apk add --no-cache libssh2 libssh2-dev libssh2-static iputils gdb
+
+# Add trusted CAs for communicating with external services
+RUN apk update && apk add --no-cache ca-certificates tzdata && update-ca-certificates
+
+# Build App
+RUN rm -rf lib bin
+RUN mkdir -p /src/bin/drivers
+RUN shards build --error-trace --production
+
+# Run the app binding on port 8080
+EXPOSE 8080
+ENTRYPOINT ["/src/bin/test-harness"]
+CMD ["/src/bin/test-harness", "-b", "0.0.0.0", "-p", "8080"]

README.md

@@ -1,41 +1,15 @@
-# 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)
+[![Build Status](https://travis-ci.org/placeos/drivers.svg?branch=master)](https://travis-ci.org/placeos/drivers)
 
-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
+To spin up the test harness, clone the repository and run...
 
+```bash
+$ docker-compose up -d
+```
 
-Spider-Gazelle builds on the amazing performance of **router.cr** [here](https://github.com/tbrand/which_is_the_fastest).:rocket:
-
-
-## Testing
-
-`crystal spec`
-
-* to run in development mode `crystal ./src/app.cr`
-
-## Compiling
-
-`crystal build ./src/app.cr`
-
-### Deploying
-
-Once compiled you are left with a binary `./app`
-
-* for help `./app --help`
-* viewing routes `./app --routes`
-* run on a different port or host `./app -h 0.0.0.0 -p 80`
+Point a browser to [localhost:8085](http://localhost:8085), and you're good to go.

docker-compose.yml

@@ -0,0 +1,30 @@
+version: "3.7"
+services:
+  redis:
+    image: eqalpha/keydb
+    restart: always
+    container_name: redis
+    hostname: redis
+    environment:
+      - TZ=$TZ
+
+  drivers:
+    build: .
+    image: placeos/drivers
+    restart: always
+    container_name: drivers
+    hostname: drivers
+    environment:
+      - CRYSTAL_PATH=lib:/lib/local-shards
+    depends_on:
+      - redis
+    ports:
+      - 127.0.0.1:8085:8080
+      - 127.0.0.1:4444:4444
+    volumes:
+      - ./drivers/:/src/drivers/
+      - ./repositories/:/src/repositories/
+      - ./lib/:/lib/local-shards/
+    environment:
+      - REDIS_URL=redis://redis:6379
+      - TZ=$TZ

docs/directory_structure.md

@@ -0,0 +1,20 @@
+# Directory Structures
+
+PlaceOS core / drivers makes the assumption that the working directory one level
+up from the scratch directory. An example deployment structure:
+
+* Working dir: `/home/placeos/core`
+* Executable: `/home/placeos/core/bin/core`
+* Driver repositories: `/home/placeos/repositories`
+  * PlaceOS Drivers: `/home/placeos/repositories/drivers`
+* Driver executables: `/home/placeos/core/bin/drivers`
+  * Samsung driver: `/home/placeos/core/bin/drivers/353b53_samsung_display_md_series_cr`
+
+However when developing the structure will look more like:
+
+* Working dir: `/home/steve/drivers`
+* Driver repository: `/home/steve/drivers`
+* Driver executables: `/home/steve/drivers/bin/drivers`
+  * Samsung driver: `/home/placeos/core/bin/drivers/353b53_samsung_display_md_series_cr`
+
+The primary difference between production and development is PlaceOS core, in production, will be cloning repositories and installing shards as required.

docs/gdb-entitlement.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>com.apple.security.cs.debugger</key>
+    <true/>
+</dict>
+</plist>
+</pre>
+