hyperdock 0.10.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ca01f647778c5873550eb4c9cb7746a34951e5ed
+  data.tar.gz: 9b88ea674ab4bee1d382181b54cdc472ade78f05
+SHA512:
+  metadata.gz: b88b28f88f7a8528a6a6c84885419757cade0ae4d98c6c58f38d6606f6aaf589bc970eccab2fcd86cb4d98d428560b6410a6659377a983a56265522bb83ff963
+  data.tar.gz: b6321e08db59681b4448530bab911422c70317d993bf7bb1308248deaf47f5a4247782d9cb39bc249eecf3f4f57d51dc5cddcae5367bbaf6c8c3365d7808a72f

data/LICENSE.txt

@@ -0,0 +1,21 @@
+
+The MIT License (MIT)
+Copyright © 2016 Chris Olstrom <chris@olstrom.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.org

@@ -0,0 +1,472 @@
+#+TITLE: HyperDock: A Hypermedia API for Docker
+#+LATEX: \pagebreak
+
+* Overview
+
+  ~HyperDock~ is a Hypermedia API for Docker. It augments the standard Docker
+  API with a discoverable, link-driven API conforming to the [[http://stateless.co/hal_specification.html][HAL Specification]].
+
+* Why does this exist?
+
+  Docker's internal structure is very graph-oriented, but the API is less so. It
+  should be possible for most clients to "write themselves" (or at least
+  configure themselves) using the data available through the API. At present,
+  this is cumbersome.
+
+* Status
+
+  ~HyperDock~ is probably not suitable for production use yet.
+
+* Installation
+
+  #+BEGIN_SRC shell
+    gem install hyperdock
+  #+END_SRC
+
+* Usage
+
+  To launch it, just run:
+
+  #+BEGIN_SRC shell
+    hyperdock-api
+  #+END_SRC
+
+  The API will be available on port =8080=.
+
+** Launch something with ~docker-compose~ (example)
+
+   For the purpose of documentation, we'll use ~cloud-surveyor~.
+
+   #+BEGIN_SRC shell
+     git clone https://github.com/colstrom/cloud-surveyor
+     cd cloud-surveyor
+     docker-compose up -d
+   #+END_SRC
+
+   This should run two service containers for ~cloud-surveyor~:
+     - ~redis~
+     - ~elasticmq~
+
+** Explore!
+
+*** The Root Resource
+
+    Let's see what we have at the root resource (this should be a
+    self-describing gateway to the rest of the API:
+
+    #+BEGIN_SRC shell
+      curl -s http://localhost:8080/ | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/"
+          },
+          "projects": {
+            "href": "/projects"
+          },
+          "project": {
+            "href": "/project/{project}",
+            "templated": true
+          },
+          "project:services": {
+            "href": "/project/{project}/services",
+            "templated": true
+          },
+          "containers": {
+            "href": "/containers"
+          },
+          "container": {
+            "href": "/container/{container}",
+            "templated": true
+          },
+          "container:ports": {
+            "href": "/container/{container}/ports",
+            "templated": true
+          }
+        },
+        "version": 1
+      }
+    #+END_SRC
+
+    What we see here (and in all the responses) is a list of resources reachable
+    from this resource. Since this is the root level, we have a rough map of the
+    main API.
+
+    =/containers= seems pretty standard for Docker, so let's check out
+    =projects= instead.
+
+*** Projects
+
+    =/projects= lists all ~docker-compose~ projects running on this docker host.
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/projects | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/projects"
+          },
+          "project:cloudsurveyor": {
+            "href": "/project/cloudsurveyor"
+          }
+        },
+        "projects": [
+          "cloudsurveyor"
+        ]
+      }
+    #+END_SRC
+
+    Let's follow the links, and see where we end up!
+
+*** Project
+
+    =/project/{project}= returns a project. Projects have things like
+    =services=, so we should expect a =link= for those.
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/projects/cloudsurveyor | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/project/cloudsurveyor"
+          },
+          "services": {
+            "href": "/project/cloudsurveyor/services"
+          }
+        }
+      }
+    #+END_SRC
+
+*** Services
+
+    =/project/{project}/services= returns a list of services for a project.
+    These should correspond to the services described in your
+    =docker-compose.yaml=.
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/projects/cloudsurveyor/services | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/project/cloudsurveyor/services"
+          },
+          "service:redis": {
+            "href": "/project/cloudsurveyor/service/redis"
+          },
+          "service:elasticmq": {
+            "href": "/project/cloudsurveyor/service/elasticmq"
+          }
+        },
+        "services": [
+          "redis",
+          "elasticmq"
+        ]
+      }
+    #+END_SRC
+
+    We can see two services here: =redis= and =elasticmq=. Compare this to the
+    =docker-compose.yaml= in the ~cloud-surveyor~ repository:
+
+    #+BEGIN_SRC yaml
+      ---
+      version: "2"
+      services:
+        elasticmq:
+          image: colstrom/elasticmq
+          ports:
+            - "9324:9324"
+        redis:
+          image: redis:alpine
+          ports:
+            - "6379"
+    #+END_SRC
+
+    Let's have a look at that =redis= service, shall we?
+
+*** Service
+
+    =/project/{project}/service/{service}= returns a list of containers for the
+    specified service.
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/projects/cloudsurveyor/service/redis | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/project/cloudsurveyor/service/redis"
+          },
+          "containers": [
+            {
+              "href": "/container/27d6320f12e28b57ea7b2cbf423e647ab7f56793d7622069c9dc1d2f7a8d362b"
+            }
+          ]
+        }
+      }
+    #+END_SRC
+
+    Well, look at that: something that isn't nested deeper under the same path!
+
+    What happens if we scale up the redis containers a bit?
+
+    #+BEGIN_SRC shell
+      docker-compose scale redis=3
+    #+END_SRC
+
+    And then check the =service= links again?
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/projects/cloudsurveyor/service/redis | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/project/cloudsurveyor/service/redis"
+          },
+          "containers": [
+            {
+              "href": "/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351"
+            },
+            {
+              "href": "/container/5dd8c8db1b7e767ca5529165bf337e70096e32e635346208eda173a0a1eb6c3c"
+            },
+            {
+              "href": "/container/27e0bc50a08b7f54f375ba098a64733720e1287e0f18763c56150feb4869bd1b"
+            }
+          ]
+        }
+      }
+    #+END_SRC
+
+    But what do those =containers= look like?
+
+*** Container
+
+    =/container/{container}= returns information about a specific container, as
+    you might expect.
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351 | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351"
+          },
+          "mounts": {
+            "href": "/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351/mounts"
+          },
+          "networks": {
+            "href": "/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351/networks"
+          },
+          "ports": {
+            "href": "/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351/ports"
+          }
+        },
+        "info": {
+          "Names": [
+            "/cloudsurveyor_redis_2"
+          ],
+          "Image": "redis:alpine",
+          "ImageID": "sha256:2aabafe89cbffe63a812e3965137f36df73488488a6ad4ba641272a3cf384cd1",
+          "Command": "docker-entrypoint.sh redis-server",
+          "Created": 1471154629,
+          "Ports": [
+            {
+              "IP": "0.0.0.0",
+              "PrivatePort": 6379,
+              "PublicPort": 32770,
+              "Type": "tcp"
+            }
+          ],
+          "Labels": {
+            "com.docker.compose.config-hash": "7823e6dcfbb9d488dc1be2e26cff00c9019451db8fcc5187f711f17e4a161a4f",
+            "com.docker.compose.container-number": "2",
+            "com.docker.compose.oneoff": "False",
+            "com.docker.compose.project": "cloudsurveyor",
+            "com.docker.compose.service": "redis",
+            "com.docker.compose.version": "1.8.0"
+          },
+          "State": "running",
+          "Status": "Up 4 minutes",
+          "HostConfig": {
+            "NetworkMode": "cloudsurveyor_default"
+          },
+          "NetworkSettings": {
+            "Networks": {
+              "cloudsurveyor_default": {
+                "IPAMConfig": null,
+                "Links": null,
+                "Aliases": null,
+                "NetworkID": "b6665ba6532fb26f8595c2155c1a5ca6fd9397b69c1033dc39ddfecc7abe470b",
+                "EndpointID": "f416509bd5386316bfb84197d01ee173e41b741a6ef4b3a3545e7c03ead48a11",
+                "Gateway": "172.19.0.1",
+                "IPAddress": "172.19.0.5",
+                "IPPrefixLen": 16,
+                "IPv6Gateway": "",
+                "GlobalIPv6Address": "",
+                "GlobalIPv6PrefixLen": 0,
+                "MacAddress": "02:42:ac:13:00:05"
+              }
+            }
+          },
+          "Mounts": [
+            {
+              "Name": "eba94001326155110ed4901f12936c5a0c05c79ca550fd023fa55e12df965a13",
+              "Source": "/var/lib/docker/volumes/eba94001326155110ed4901f12936c5a0c05c79ca550fd023fa55e12df965a13/_data",
+              "Destination": "/data",
+              "Driver": "local",
+              "Mode": "",
+              "RW": true,
+              "Propagation": ""
+            }
+          ],
+          "id": "a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351"
+        }
+      }
+    #+END_SRC
+
+
+*** Ports
+
+    =/container/{container}/ports= returns port information in various
+    configurations, for convenient discovery.
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351/ports | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351/ports"
+          }
+        },
+        "all": [
+          {
+            "IP": "0.0.0.0",
+            "PrivatePort": 6379,
+            "PublicPort": 32770,
+            "Type": "tcp"
+          }
+        ],
+        "PublicPort": {
+          "32770": [
+            {
+              "IP": "0.0.0.0",
+              "PrivatePort": 6379,
+              "PublicPort": 32770,
+              "Type": "tcp"
+            }
+          ]
+        },
+        "PrivatePort": {
+          "6379": [
+            {
+              "IP": "0.0.0.0",
+              "PrivatePort": 6379,
+              "PublicPort": 32770,
+              "Type": "tcp"
+            }
+          ]
+        },
+        "IP": {
+          "0.0.0.0": [
+            {
+              "IP": "0.0.0.0",
+              "PrivatePort": 6379,
+              "PublicPort": 32770,
+              "Type": "tcp"
+            }
+          ]
+        },
+        "Type": {
+          "tcp": [
+            {
+              "IP": "0.0.0.0",
+              "PrivatePort": 6379,
+              "PublicPort": 32770,
+              "Type": "tcp"
+            }
+          ]
+        },
+        "tcp": [
+          {
+            "IP": "0.0.0.0",
+            "PrivatePort": 6379,
+            "PublicPort": 32770,
+            "Type": "tcp"
+          }
+        ],
+        "udp": []
+      }
+    #+END_SRC
+
+    So, from the top, we've found the ports bound on the host for a service
+    container associated with a project. In the simple example here, that's easy
+    enough to dig out of the Docker API, but navigating by relationships gives
+    us more flexibility and helps keep things manageable at scale.
+
+*** Containers
+
+    =/containers/= returns a list of all containers running on the host, with no
+    particular ordering or filters.
+
+    #+BEGIN_SRC shell
+      curl -s localhost:8080/containers | jq .
+    #+END_SRC
+
+    #+BEGIN_SRC json
+      {
+        "_links": {
+          "self": {
+            "href": "/containers"
+          },
+          "container:a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351": {
+            "href": "/container/a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351"
+          },
+          "container:5dd8c8db1b7e767ca5529165bf337e70096e32e635346208eda173a0a1eb6c3c": {
+            "href": "/container/5dd8c8db1b7e767ca5529165bf337e70096e32e635346208eda173a0a1eb6c3c"
+          },
+          "container:27e0bc50a08b7f54f375ba098a64733720e1287e0f18763c56150feb4869bd1b": {
+            "href": "/container/27e0bc50a08b7f54f375ba098a64733720e1287e0f18763c56150feb4869bd1b"
+          },
+          "container:47c9f36e225e722380ce0bf3a7a41365b754fad8df8c1a3c64b2223a6d6e3548": {
+            "href": "/container/47c9f36e225e722380ce0bf3a7a41365b754fad8df8c1a3c64b2223a6d6e3548"
+          }
+        },
+        "containers": [
+          "a59c2bdc3691df1cd895c3705c1d260d1ef74323d5d032535e4c34f2d9b29351",
+          "5dd8c8db1b7e767ca5529165bf337e70096e32e635346208eda173a0a1eb6c3c",
+          "27e0bc50a08b7f54f375ba098a64733720e1287e0f18763c56150feb4869bd1b",
+          "47c9f36e225e722380ce0bf3a7a41365b754fad8df8c1a3c64b2223a6d6e3548"
+        ]
+      }
+    #+END_SRC
+
+* License
+
+  ~hyperdock~ is available under the [[https://tldrlegal.com/license/mit-license][MIT License]]. See ~LICENSE.txt~ for the full text.
+
+* Contributors
+
+  - [[https://colstrom.github.io/][Chris Olstrom]] | [[mailto:chris@olstrom.com][e-mail]] | [[https://twitter.com/ChrisOlstrom][Twitter]]

data/bin/hyperdock-api

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+require 'rakuna'
+require_relative '../lib/hyperdock'
+
+Webmachine.application.routes do
+  add [], HyperDock::Resource::Root
+  add ['projects'], HyperDock::Resource::Projects
+  add ['project', :project], HyperDock::Resource::Project
+  add ['project', :project, 'services'], HyperDock::Resource::ProjectServices
+  add ['project', :project, 'service', :service], HyperDock::Resource::ProjectService
+  add ['containers'], HyperDock::Resource::Containers
+  add ['container', :container], HyperDock::Resource::Container
+  add ['container', :container, 'ports'], HyperDock::Resource::ContainerPorts
+end
+
+Webmachine.application.run

data/hyperdock.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |gem|
+  gem.name        = 'hyperdock'
+  gem.version     = `git describe --tags --abbrev=0`.chomp
+  gem.licenses    = 'MIT'
+  gem.authors     = ['Chris Olstrom']
+  gem.email       = 'chris@olstrom.com'
+  gem.homepage    = 'https://github.com/colstrom/hyperdock'
+  gem.summary     = 'Hypermedia API for Docker'
+
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  gem.require_paths = ['lib']
+
+  gem.add_runtime_dependency 'rakuna', '~> 1.0', '>= 1.0.1'
+  gem.add_runtime_dependency 'docker-api', '~> 1.31', '>= 1.31.0'
+  gem.add_runtime_dependency 'contracts', '~> 0.14', '>= 0.14.0'
+end

data/lib/hyperdock.rb

@@ -0,0 +1 @@
+require_relative 'hyperdock/resources'

data/lib/hyperdock/resource/container.rb

@@ -0,0 +1,35 @@
+require 'docker-api'
+require_relative 'core'
+
+module HyperDock
+  module Resource
+    class Container < Core
+      Contract None => Maybe[::Docker::Container]
+      def container
+        @container ||= ::Docker::Container.all.select do |container|
+          container.id == request.path_info[:container]
+        end.first
+        #::Docker::Container.get id
+      end
+
+      Contract None => Bool
+      def resource_exists?
+        !container.nil?
+      rescue ::Docker::Error::NotFoundError
+        false
+      end
+
+      def links
+        @links ||= {
+          mounts: { href: "/#{request.disp_path}/mounts" },
+          networks: { href: "/#{request.disp_path}/networks" },
+          ports: { href: "/#{request.disp_path}/ports" }
+        }
+      end
+
+      def attributes
+        { info: container.info }
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/container_ports.rb

@@ -0,0 +1,48 @@
+require_relative 'container'
+
+module HyperDock
+  module Resource
+    class ContainerPorts < Container
+      Contract None => ArrayOf[Hash]
+      def ports
+        @ports ||= container.info.fetch('Ports') { [] }
+      end
+
+      def public_port
+        @public_port ||= ports.group_by { |port| port['PublicPort'] }
+      end
+
+      def private_port
+        @private_port ||= ports.group_by { |port| port['PrivatePort'] }
+      end
+
+      def ip
+        @ip ||= ports.group_by { |port| port['IP'] }
+      end
+
+      def type
+        @type ||= ports.group_by { |port| port['Type'] }
+      end
+
+      def tcp
+        @tcp ||= ports.select { |port| port['Type'] == 'tcp' }
+      end
+
+      def udp
+        @udp ||= ports.select { |port| port['Type'] == 'udp' }
+      end
+
+      def attributes
+        {
+          all: ports,
+          PublicPort: public_port,
+          PrivatePort: private_port,
+          IP: ip,
+          Type: type,
+          tcp: tcp,
+          udp: udp
+        }
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/containers.rb

@@ -0,0 +1,22 @@
+require 'docker-api'
+require_relative 'core'
+
+module HyperDock
+  module Resource
+    class Containers < Core
+      def containers
+        @containers ||= ::Docker::Container.all.map(&:id)
+      end
+
+      def links
+        @links ||= containers.map do |container|
+          { "container:#{container}" => { href: "/container/#{container}" } }
+        end.reduce(&:merge)
+      end
+
+      def attributes
+        { containers: containers }
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/core.rb

@@ -0,0 +1,37 @@
+require 'contracts'
+require 'rakuna'
+
+module HyperDock
+  module Resource
+    class Core < ::Rakuna::Resource::Basic
+      include ::Contracts::Core
+      include ::Contracts::Builtin
+      include ::Rakuna::Provides::JSON
+
+      Contract None => ArrayOf[String]
+      def allowed_methods
+        ['GET', 'HEAD']
+      end
+
+      Contract None => HashOf[RespondTo[:to_s], HashOf[RespondTo[:to_s], Any]]
+      def _links
+        { self: { href: "/#{request.disp_path}" } }
+      end
+
+      Contract None => HashOf[RespondTo[:to_s], HashOf[RespondTo[:to_s], Hash]]
+      def links
+        {}
+      end
+
+      Contract None => HashOf[RespondTo[:to_s], Any]
+      def attributes
+        {}
+      end
+
+      Contract None => RespondTo[:to_json]
+      def output
+        { _links: _links.merge(links) }.merge(attributes)
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/project.rb

@@ -0,0 +1,26 @@
+require 'docker-api'
+require_relative 'core'
+
+module HyperDock
+  module Resource
+    class Project < Core
+      Contract None => ArrayOf[String]
+      def projects
+        @projects ||= ::Docker::Container.all.map do |container|
+          container.info.dig 'Labels', 'com.docker.compose.project'
+        end
+      end
+
+      Contract None => Bool
+      def resource_exists?
+        projects.include? request.path_info[:project]
+      end
+
+      def links
+        @links ||= {
+          services: { href: "/#{request.disp_path}/services" }
+        }
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/project_service.rb

@@ -0,0 +1,41 @@
+require 'docker-api'
+require_relative 'core'
+
+module HyperDock
+  module Resource
+    class ProjectService < Core
+      PROJECT_LABEL = 'com.docker.compose.project'.freeze
+      SERVICE_LABEL = 'com.docker.compose.service'.freeze
+
+      def project
+        @project ||= request.path_info[:project]
+      end
+
+      def service
+        @service ||= request.path_info[:service]
+      end
+
+      def matches_project?(container)
+        container.info.dig('Labels', PROJECT_LABEL) == project
+      end
+
+      def matches_service?(container)
+        container.info.dig('Labels', SERVICE_LABEL) == service
+      end
+
+      def containers
+        @containers ||= ::Docker::Container.all.select do |container|
+          matches_project?(container) && matches_service?(container)
+        end.map(&:id)
+      end
+
+      def links
+        @links ||= {
+          'containers' => containers.map do |container|
+            { href: "/container/#{container}" }
+          end
+        }
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/project_services.rb

@@ -0,0 +1,47 @@
+require 'docker-api'
+require_relative 'core'
+
+module HyperDock
+  module Resource
+    class ProjectServices < Core
+      Contract None => String
+      def project
+        @project ||= request.path_info[:project]
+      end
+
+      Contract None => ArrayOf[::Docker::Container]
+      def containers
+        @containers ||= ::Docker::Container.all.select do |container|
+          container.info.dig('Labels', 'com.docker.compose.project') == project
+        end
+      end
+
+      Contract None => Bool
+      def resource_exists?
+        !containers.empty?
+      end
+
+      Contract None => ArrayOf[String]
+      def services
+        @services ||= containers.map do |container|
+          container.info.dig('Labels', 'com.docker.compose.service')
+        end.uniq
+      end
+
+      Contract None => HashOf[RespondTo[:to_s], Hash]
+      def links
+        @links ||= services.map do |service|
+          {
+            "service:#{service}" => {
+              href: "/project/#{project}/service/#{service}"
+            }
+          }
+        end.reduce(&:merge)
+      end
+
+      def attributes
+        { services: services }
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/projects.rb

@@ -0,0 +1,26 @@
+require 'docker-api'
+require_relative 'core'
+
+module HyperDock
+  module Resource
+    class Projects < Core
+      Contract None => ArrayOf[String]
+      def projects
+        @projects ||= ::Docker::Container.all.map do |container|
+          container.info.dig 'Labels', 'com.docker.compose.project'
+        end.uniq
+      end
+
+      Contract None => HashOf[RespondTo[:to_s], Hash]
+      def links
+        @links ||= projects.map do |project|
+          { "project:#{project}" => { href: "/project/#{project}" } }
+        end.reduce(&:merge)
+      end
+
+      def attributes
+        { projects: projects }
+      end
+    end
+  end
+end

data/lib/hyperdock/resource/root.rb

@@ -0,0 +1,24 @@
+require_relative 'core'
+
+module HyperDock
+  module Resource
+    class Root < Core
+      VERSION = 1
+
+      def attributes
+        { version: VERSION }
+      end
+
+      def links
+        @links ||= {
+          projects: { href: '/projects' },
+          project: { href: '/project/{project}', templated: true },
+          'project:services' => { href: '/project/{project}/services', templated: true },
+          containers: { href: '/containers' },
+          container: { href: '/container/{container}', templated: true },
+          'container:ports' => { href: '/container/{container}/ports', templated: true }
+        }
+      end
+    end
+  end
+end

data/lib/hyperdock/resources.rb

@@ -0,0 +1,8 @@
+require_relative 'resource/container'
+require_relative 'resource/container_ports'
+require_relative 'resource/containers'
+require_relative 'resource/project'
+require_relative 'resource/project_service'
+require_relative 'resource/project_services'
+require_relative 'resource/projects'
+require_relative 'resource/root'

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: hyperdock
+version: !ruby/object:Gem::Version
+  version: 0.10.2
+platform: ruby
+authors:
+- Chris Olstrom
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rakuna
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: docker-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.31'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.31.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.31'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.31.0
+- !ruby/object:Gem::Dependency
+  name: contracts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+description: 
+email: chris@olstrom.com
+executables:
+- hyperdock-api
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.org
+- bin/hyperdock-api
+- hyperdock.gemspec
+- lib/hyperdock.rb
+- lib/hyperdock/resource/container.rb
+- lib/hyperdock/resource/container_ports.rb
+- lib/hyperdock/resource/containers.rb
+- lib/hyperdock/resource/core.rb
+- lib/hyperdock/resource/project.rb
+- lib/hyperdock/resource/project_service.rb
+- lib/hyperdock/resource/project_services.rb
+- lib/hyperdock/resource/projects.rb
+- lib/hyperdock/resource/root.rb
+- lib/hyperdock/resources.rb
+homepage: https://github.com/colstrom/hyperdock
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Hypermedia API for Docker
+test_files: []