community-zero 1.0.0

data/lib/community_zero/endpoint.rb

@@ -0,0 +1,112 @@
+#
+# Copyright 2013, Seth Vargo <sethvargo@gmail.com>
+# Copyright 2013, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module CommunityZero
+  # The base class for any endpoint.
+  #
+  # @author Seth Vargo <sethvargo@gmail.com>
+  class Endpoint
+    require 'community_zero/endpoints/cookbook_endpoint'
+    require 'community_zero/endpoints/cookbook_versions_version_endpoint'
+    require 'community_zero/endpoints/cookbooks_endpoint'
+    require 'community_zero/endpoints/not_found_endpoint'
+    require 'community_zero/endpoints/search_endpoint'
+
+    METHODS = [:get, :put, :post, :delete].freeze
+
+    attr_reader :server
+
+    # Create a new endpoint.
+    #
+    # @param [CommunityZero::Server] server
+    #   the server to respond to this endpoint
+    def initialize(server)
+      @server = server
+    end
+
+    # Generate the URL for the given cookbook.
+    #
+    # @param [CommunityZero::Cookbook] cookbook
+    #   the coookbook to generate the URL for
+    #
+    # @return [String]
+    #   the URL
+    def url_for(cookbook)
+      "#{server.url}/cookbooks/#{cookbook.name}"
+    end
+
+    # Generate the version URL for the given cookbook and version.
+    #
+    # @param [CommunityZero::Cookbook] cookbook
+    #   the coookbook to generate the URL for
+    # @param [String]  version
+    #   the version to generate a string for
+    #
+    # @return [String]
+    #   the URL
+    def version_url_for(cookbook, version)
+      "#{server.url}/cookbooks/#{cookbook.name}/versions/#{version.gsub('.', '_')}"
+    end
+
+    # Call the request.
+    #
+    # @param [CommunityZero::Request] request
+    #   the request object
+    def call(request)
+      m = request.method.downcase.to_sym
+
+      # Only respond to listed methods
+      unless respond_to?(m)
+        allowed = METHODS.select { |m| respond_to?(m) }.map(&:upcase).join(', ')
+        return [
+          405,
+          { 'Content-Type' => 'text/plain', 'Allow' => allowed },
+          "Method not allowed: '#{request.env['REQUEST_METHOD']}'"
+        ]
+      end
+
+      # Must accept JSON
+      unless request.env['HTTP_ACCEPT'].to_s.split(';').include?('application/json')
+        return [
+          406,
+          { 'Content-Type' => 'text/plain' },
+          'Must accept application/json'
+        ]
+      end
+
+      begin
+        send(m, request)
+      rescue RestError => e
+        error(e.response_code, e.error)
+      end
+    end
+
+    private
+      def error(response_code, error)
+        respond(response_code, { 'error' => error })
+      end
+
+      def respond(response_code = 200, content)
+        [
+          response_code,
+          { 'Content-Type' => 'application/json' },
+          JSON.pretty_generate(content)
+        ]
+      end
+
+  end
+end

data/lib/community_zero/endpoints/cookbook_endpoint.rb

@@ -0,0 +1,68 @@
+#
+# Copyright 2013, Seth Vargo <sethvargo@gmail.com>
+# Copyright 2013, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module CommunityZero
+  # The endpoint for interacting with a single cookbook.
+  #
+  # @author Seth Vargo <sethvargo@gmail.com>
+  class CookbookEndpoint < Endpoint
+    # GET /cookbooks/:name
+    def get(request)
+      name = request.path.last
+      cookbook = Store.find(name)
+
+      if cookbook = Store.find(name)
+        respond({
+          'name'            => cookbook.name,
+          'maintainer'      => cookbook.maintainer,
+          'category'        => cookbook.category,
+          'external_url'    => cookbook.external_url,
+          'description'     => cookbook.description,
+          'average_rating'  => cookbook.average_rating,
+          'versions'        => cookbook.versions.map { |i| version_url_for(cookbook, i) },
+          'latest_version'  => version_url_for(cookbook, cookbook.latest_version),
+          'created_at'      => cookbook.created_at,
+          'updated_at'      => cookbook.upadated_at,
+        })
+      else
+        respond(404,
+          {
+            'error_code' => 'NOT_FOUND',
+            'error_messages' => ['Resource not found'],
+          }
+        )
+      end
+    end
+
+    # DELETE /cookbooks/:name
+    def delete(request)
+      name = request.path.last
+
+      if cookbook = Store.find(name)
+        cookbook.destroy
+        respond({})
+      else
+        respond(404,
+          {
+            'error_code' => 'NOT_FOUND',
+            'error_messages' => ['Resource not found'],
+          }
+        )
+      end
+    end
+  end
+end

data/lib/community_zero/endpoints/cookbook_versions_version_endpoint.rb

@@ -0,0 +1,59 @@
+#
+# Copyright 2013, Seth Vargo <sethvargo@gmail.com>
+# Copyright 2013, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module CommunityZero
+  # The endpoint for interacting with a single cookbook version.
+  #
+  # @author Seth Vargo <sethvargo@gmail.com>
+  class CookbookVersionsVersionEndpoint < Endpoint
+    def get(request)
+      name, version = request.path[1], request.path[-1].gsub('_', '.')
+
+      unless cookbook = Store.find(name)
+        return respond(404,
+          {
+            'error_code' => 'NOT_FOUND',
+            'error_messages' => ['Resource not found'],
+          }
+        )
+      end
+
+      version = cookbook.latest_version if version == 'latest'
+      cookbook = Store.find(name, version)
+      respond(response_hash_for(cookbook))
+    end
+
+    private
+      # The response hash for this cookbook.
+      #
+      # @param [CommunityZero::Cookbook] cookbook
+      #   the cookbook to generate a hash for
+      def response_hash_for(cookbook)
+        {
+          'cookbook'           => url_for(cookbook),
+          'average_rating'     => cookbook.average_rating,
+          'version'            => cookbook.version,
+          'license'            => cookbook.license,
+          'file'               => "http://s3.amazonaws.com/#{cookbook.name}.tgz",
+          'tarball_file_size'  => cookbook.name.split('').map(&:ord).inject(&:+) * 25, # don't even
+          'created_at'         => cookbook.created_at,
+          'updated_at'         => cookbook.upadated_at,
+        }
+      end
+
+  end
+end

data/lib/community_zero/endpoints/cookbooks_endpoint.rb

@@ -0,0 +1,102 @@
+#
+# Copyright 2013, Seth Vargo <sethvargo@gmail.com>
+# Copyright 2013, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module CommunityZero
+  # The endpoint for all cookbooks.
+  #
+  # @author Seth Vargo <sethvargo@gmail.com>
+  class CookbooksEndpoint < Endpoint
+    require 'rubygems/package'
+    require 'zlib'
+
+    # GET /cookbooks
+    def get(request)
+      start = Integer(request.query_params['start'] || 0)
+      items = Integer(request.query_params['items'] || 10)
+      cookbooks = Store.cookbooks[start...items] || []
+
+      respond({
+        'items' => cookbooks.collect { |cookbook|
+          {
+            'cookbook_name'        => cookbook.name,
+            'cookbook_description' => cookbook.description,
+            'cookbook'             => url_for(cookbook),
+            'cookbook_maintainer'  => cookbook.maintainer
+          }
+        },
+        'total' => Store.size,
+        'start' => start.to_i,
+      })
+    end
+
+    # POST /cookbooks
+    def post(request)
+      params = Rack::Utils::Multipart.parse_multipart(request.env)
+      cookbook = params['cookbook']
+      tarball = params['tarball']
+
+      metadata = Metadata.new(read_tarball(tarball))
+
+      if Store.find(metadata.name, metadata.version)
+        respond(401,
+          {
+            'error_code' => 'ALREADY_EXISTS',
+            'error_messages' => ['Resource already exists'],
+          }
+        )
+      else
+        respond(create_cookbook(metadata).to_hash)
+      end
+    end
+
+    private
+      # Create the cookbook from the metadata.
+      #
+      # @param [CommunityZero::Metadata] metadata
+      #   the metadata to create the cookbook from
+      def create_cookbook(metadata)
+        Cookbook.create(
+          :name => metadata.name,
+          :category => nil,
+          :maintainer => metadata.maintainer,
+          :description => metadata.description,
+          :version => metadata.version
+        )
+      end
+
+      # Parse the metadata from the tarball.
+      #
+      # @param [Tempfile] tarball
+      #   the temporarily uploaded file
+      def read_tarball(tarball)
+        gzip = Zlib::GzipReader.new(tarball[:tempfile])
+        tar = Gem::Package::TarReader.new(gzip)
+        metadata = nil
+
+        tar.each do |entry|
+          if entry.full_name =~ /metadata\.rb$/
+            metadata = entry.read
+            break
+          end
+        end
+        tar.close
+
+        return metadata
+      end
+
+  end
+end

data/lib/community_zero/endpoints/not_found_endpoint.rb

@@ -0,0 +1,37 @@
+#
+# Copyright 2013, Seth Vargo <sethvargo@gmail.com>
+# Copyright 2013, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module CommunityZero
+  # The general 404 endpoint.
+  #
+  # @author Seth Vargo <sethvargo@gmail.com>
+  class NotFoundEndpoint < Endpoint
+    def call(request)
+      error("Object not found: #{request.env['REQUEST_PATH']}")
+    end
+
+    private
+      def error(message)
+        [
+          404,
+          { 'Content-Type' => 'application/json' },
+          JSON.pretty_generate({ 'error' => message })
+        ]
+      end
+
+  end
+end

data/lib/community_zero/endpoints/search_endpoint.rb

@@ -0,0 +1,44 @@
+#
+# Copyright 2013, Seth Vargo <sethvargo@gmail.com>
+# Copyright 2013, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module CommunityZero
+  # The endpoint for searching for cookbooks.
+  #
+  # @author Seth Vargo <sethvargo@gmail.com>
+  class SearchEndpoint < Endpoint
+    # GET /search?q=QUERY
+    def get(request)
+      q = request.query_params['q'].to_s
+      start = Integer(request.query_params['start'] || 0)
+      items = Integer(request.query_params['items'] || 10)
+      cookbooks = Store.search(q)[start...items] || []
+
+      respond({
+        'items' => cookbooks.collect { |cookbook|
+          {
+            'cookbook_name'        => cookbook.name,
+            'cookbook_description' => cookbook.description,
+            'cookbook'             => url_for(cookbook),
+            'cookbook_maintainer'  => cookbook.maintainer
+          }
+        },
+        'total' => cookbooks.size,
+        'start' => start,
+      })
+    end
+  end
+end

data/lib/community_zero/error.rb

@@ -0,0 +1,25 @@
+#
+# Copyright 2013, Seth Vargo <sethvargo@gmail.com>
+# Copyright 2013, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+module CommunityZero
+  # The base class for errors.
+  #
+  # @author Seth Vargo <sethvargo@gmail.com>
+  class Error < StandardError; end
+
+  require 'community_zero/errors/rest_error'
+end