wordpress_client 0.0.1

data/spec/connection_spec.rb

@@ -0,0 +1,270 @@
+require "spec_helper"
+
+module WordpressClient
+  describe Connection do
+    subject(:connection) {
+      Connection.new(url: "http://example.com/", username: "jane", password: "doe")
+    }
+
+    let(:base_url) { "http://jane:doe@example.com/wp/v2" }
+    let(:model) { class_double(Post, parse: model_instance) }
+    let(:model_instance) { instance_double(Post) }
+
+    it "is constructed with a url, username and a password" do
+      connection = Connection.new(url: "http://example.com/wp-json", username: "x", password: "x")
+      expect(connection.url).to eq('http://example.com/wp-json')
+    end
+
+    it "does not show password when inspected" do
+      connection = Connection.new(url: "/", username: "x", password: "secret")
+      expect(connection.to_s).to_not include "secret"
+      expect(connection.inspect).to_not include "secret"
+    end
+
+    describe "get" do
+      it "can get a single model" do
+        stub_get("#{base_url}/foo?some_param=12", returns: {title: "Foo"})
+        expect(model).to receive(:parse).with("title" => "Foo").and_return(model_instance)
+        expect(connection.get(model, "foo", some_param: 12)).to eq model_instance
+      end
+
+      it "can get several models" do
+        stub_get("#{base_url}/foos?some_param=12&page=1&per_page=1", returns: ["result"], total: 1)
+
+        expect(model).to receive(:parse).with("result").and_return(model_instance)
+
+        expect(
+          connection.get_multiple(model, "foos", some_param: 12, page: 1, per_page: 1).to_a
+        ).to eq [model_instance]
+      end
+
+      it "paginates the result when fetching multiple models" do
+        stub_get("#{base_url}/foos?page=4&per_page=15", returns: ["result"], total: 62)
+        collection = connection.get_multiple(model, "foos", page: 4, per_page: 15)
+
+        expect(collection).to be_instance_of(PaginatedCollection)
+        expect(collection.total).to eq 62
+        expect(collection.current_page).to eq 4
+        expect(collection.per_page).to eq 15
+      end
+
+      it "raises WordpressClient::TimeoutError when requests time out" do
+        stub_request(:get, /./).to_timeout
+        expect { connection.get(model, "foo") }.to raise_error(TimeoutError)
+        expect { connection.get_multiple(model, "foo") }.to raise_error(TimeoutError)
+      end
+
+      it "raises ServerError if response is invalid JSON" do
+        stub_get(/./, body: "[")
+        expect { connection.get(model, "foo") }.to raise_error(ServerError, /parse/)
+        expect { connection.get_multiple(model, "foo") }.to raise_error(ServerError, /parse/)
+      end
+
+      it "raises ServerError if response is not application/json" do
+        stub_get(/./, content_type: "text/plain")
+        expect { connection.get(model, "foo") }.to raise_error(ServerError, /plain/)
+        expect { connection.get_multiple(model, "foo") }.to raise_error(ServerError, /plain/)
+      end
+
+      it "raises NotFoundError if response is 404" do
+        stub_get(/./, status: 404)
+        expect { connection.get(model, "foo") }.to raise_error(NotFoundError)
+        expect { connection.get_multiple(model, "foo") }.to raise_error(NotFoundError)
+      end
+    end
+
+    describe "creating" do
+      it "can create models" do
+        stub_successful_post_with_redirect(
+          "#{base_url}/foos", {title: "Bar"}, redirects_to: "#{base_url}/foos/1"
+        )
+        stub_get("#{base_url}/foos/1", returns: {id: 1, title: "Bar"})
+
+        expect(model).to receive(:parse).with(
+          "id" => 1, "title" => "Bar"
+        ).and_return(model_instance)
+
+        response = connection.create(model, "foos", title: "Bar")
+        expect(response).to eq model_instance
+      end
+
+      it "can ignore the response" do
+        stub_successful_post_with_redirect(
+          "#{base_url}/foos", {title: "Bar"}, redirects_to: "#{base_url}/foos/1"
+        )
+
+        response = connection.create_without_response("foos", title: "Bar")
+        expect(response).to be true
+      end
+
+      it "can pass extra parameters when following redirect" do
+        stub_successful_post_with_redirect(
+          "#{base_url}/foos", {title: "Bar"}, redirects_to: "#{base_url}/foos/1"
+        )
+        redirect = stub_get("#{base_url}/foos/1?extra=param", returns: {})
+
+        connection.create(model, "foos", {title: "Bar"}, redirect_params: {extra: "param"})
+        expect(redirect).to have_been_made
+      end
+
+      it "raises NotFoundError if response is 400 with rest_post_invalid_id as error code" do
+        stub_failing_post(/./, returns: json_fixture("invalid-post-id.json"), status: 400)
+
+        expect { connection.create(model, "foo", {}) }.to raise_error(NotFoundError, /post id/i)
+        expect { connection.create_without_response("foo", {}) }.to raise_error(NotFoundError)
+      end
+
+      it "raises ValidationError on any other 400 responses" do
+        stub_failing_post(/./, returns: json_fixture("validation-error.json"), status: 400)
+
+        expect {
+          connection.create(model, "foo", {})
+        }.to raise_error(ValidationError, /status is not one of/)
+
+        expect {
+          connection.create_without_response("foo", {})
+        }.to raise_error(ValidationError, /status is not one of/)
+      end
+    end
+
+    describe "patching" do
+      it "can patch models" do
+        stub_patch("#{base_url}/foos/1", {title: "Bar"}, returns: {id: 1, title: "Bar"})
+
+        expect(model).to receive(:parse).with(
+          "id" => 1, "title" => "Bar"
+        ).and_return(model_instance)
+
+        response = connection.patch(model, "foos/1", title: "Bar")
+        expect(response).to eq model_instance
+      end
+
+      it "can ignore responses" do
+        stub_patch("#{base_url}/foos/1", {title: "Bar"}, returns: {id: 1, title: "Bar"})
+        response = connection.patch_without_response("foos/1", title: "Bar")
+        expect(response).to be true
+      end
+
+      it "raises NotFoundError if response is 400 with rest_post_invalid_id as error code" do
+        stub_patch(/./, {}, returns: json_fixture("invalid-post-id.json"), status: 400)
+        expect { connection.patch(model, "foo", {}) }.to raise_error(NotFoundError, /post id/i)
+        expect { connection.patch_without_response("foo", {}) }.to raise_error(NotFoundError)
+      end
+
+      it "raises ValidationError on any other 400 responses" do
+        stub_patch(/./, {}, returns: json_fixture("validation-error.json"), status: 400)
+
+        expect {
+          connection.patch(model, "foo", {})
+        }.to raise_error(ValidationError, /status is not one of/)
+
+        expect {
+          connection.patch_without_response("foo", {})
+        }.to raise_error(ValidationError, /status is not one of/)
+      end
+    end
+
+    describe "deleting" do
+      it "can delete paths" do
+        encoding = "".encoding
+
+        stub_request(:delete, "#{base_url}/foos/1").with(
+          headers: {"content-type" => "application/json; charset=#{encoding}"},
+          body: {"force" => true}.to_json,
+        ).to_return(
+          headers: {"content-type" => "application/json; charset=utf-8"},
+          body: {status: "Heyhoo! Nice one!"}.to_json,
+        )
+
+        response = connection.delete("foos/1", force: true)
+        expect(response).to be true
+      end
+
+      it "raises ValidationError on 400 responses" do
+        stub_request(:delete, /./).to_return(
+          status: 400,
+          body: "{}",
+          headers: {"content-type" => "application/json; charset=utf-8"},
+        )
+
+        expect {
+          connection.delete("foo", {})
+        }.to raise_error(ValidationError)
+      end
+    end
+
+    describe "uploading" do
+      it "posts the given IO and returns the resulting model" do
+        stub_request(:post, "#{base_url}/files").with(
+          headers: {
+            "content-length" => "11",
+            "content-type" => "text/plain",
+            # WP API does not parse normal Content-Disposition and instead ops
+            # to using their own format:
+            # https://github.com/WP-API/WP-API/issues/1744
+            "content-disposition" => 'filename=foo.txt',
+          },
+          body: "hello world",
+        ).to_return(
+          status: 201, # Created
+          headers: {"Location" => "#{base_url}/files/67"}
+        )
+        stub_get("#{base_url}/files/67", returns: {id: 67})
+
+        model_instance = double("some model instance")
+        model = double("some model")
+
+        expect(model).to receive(:parse).with("id" => 67).and_return model_instance
+
+        result = connection.upload(
+          model, "files", StringIO.new("hello world"), mime_type: "text/plain", filename: "foo.txt"
+        )
+
+        expect(result).to eq model_instance
+      end
+    end
+
+    def stub_get(
+      path,
+      returns: {},
+      status: 200,
+      body: returns.to_json,
+      total: nil,
+      content_type: "application/json"
+    )
+      headers = {"content-type" => "#{content_type}; charset=utf-8"}
+      headers["X-WP-Total"] = total.to_s if total
+
+      stub_request(:get, path).to_return(status: status, body: body, headers: headers)
+    end
+
+    def stub_successful_post_with_redirect(path, data, redirects_to:)
+      stub_request(:post, path).with(
+        headers: {"content-type" => "application/json; charset=#{"".encoding}"},
+        body: data.to_json,
+      ).to_return(
+        status: 201, # Created
+        headers: {"Location" => redirects_to}
+      )
+    end
+
+    def stub_failing_post(path, returns:, status:)
+      stub_request(:post, path).to_return(
+        status: status,
+        body: returns.to_json,
+        headers: {"content-type" => "application/json; charset=utf-8"},
+      )
+    end
+
+    def stub_patch(path, data, returns:, status: 200)
+      stub_request(:patch, path).with(
+        headers: {"content-type" => "application/json; charset=#{"".encoding}"},
+        body: data.to_json,
+      ).to_return(
+        status: status,
+        headers: {"content-type" => "application/json; charset=utf-8"},
+        body: returns.to_json,
+      )
+    end
+  end
+end

data/spec/docker/Dockerfile

@@ -0,0 +1,40 @@
+FROM appcontainers/wordpress
+
+# base image only contains American timezones
+RUN yum install -y tzdata
+
+ENV APP_NAME testapp.com
+ENV APACHE_SVRALIAS www.testapp.com localhost
+ENV MYSQL_SERVER localhost
+ENV MYSQL_CLIENT localhost
+ENV MYSQL_PASS P@ssw0rd
+ENV MYSQL_DB testapp
+ENV APP_USER admin
+ENV APP_PASS P@ssw0rd
+ENV WP_KEY ILoveFlappyjacks
+
+# Restore a copy of a set up database on first boot
+COPY dbdump.sql.gz /tmp/dbdump.sql.gz
+COPY restore-dbdump.sh /tmp/.restore-dbdump.sh
+RUN chmod +x /tmp/.restore-dbdump.sh && \
+    echo "if [ -f /tmp/.restore-dbdump.sh ]; then /tmp/.restore-dbdump.sh; rm -fr /tmp/.restore-dbdump.sh; fi" >> /root/.bashrc
+
+### Install API and API Basic Auth plugins
+
+# We need tar to unpack the WP plugins
+RUN yum install -y tar
+
+# WP API
+# Get download link from https://wordpress.org/plugins/rest-api/
+RUN curl -SL -o /tmp/rest-api.zip https://downloads.wordpress.org/plugin/rest-api.2.0-beta8.zip \
+  && unzip /tmp/rest-api.zip -d /var/www/html/wordpress/wp-content/plugins/ \
+  && rm /tmp/rest-api.zip
+
+# Basic Auth
+# Get download link from GitHub or something.
+RUN curl -SL https://github.com/WP-API/Basic-Auth/archive/master.tar.gz \
+  | tar -xzC /var/www/html/wordpress/wp-content/plugins/ \
+  && mv /var/www/html/wordpress/wp-content/plugins/Basic-Auth* /var/www/html/wordpress/wp-content/plugins/basic-auth
+
+# Make pretty permalinks work so API is accessible
+COPY htaccess /var/www/html/wordpress/.htaccess

data/spec/docker/README.md

@@ -0,0 +1,37 @@
+# How this was built
+
+## dbdump
+
+If you need to regenerate the dbdump, remove the part where the file is copied and restored from the `Dockerfile`, then build and start the image.
+
+```bash
+docker build -t wpclient-test .
+docker run -it -p 8181:80 wpclient-test
+```
+
+You'll get a prompt inside the container. Open your browser and go to the newly booted application (`localhost:8181` if you have native Docker; otherwise go to your `$DOCKER_HOST_IP:8181` URL – see `echo $DOCKER_HOST` in your local shell).
+
+You'll be greeted by the Wordpress installer. Fill in everything and complete the installation.
+
+Then, **in your container's terminal**, run the following command:
+
+```bash
+mysqldump -u "$MYSQL_USER" --password="$MYSQL_PASS" --host="$MYSQL_HOST" "$MYSQL_DB" | gzip -9 > /tmp/dbdump.sql.gz
+```
+
+You can then copy the file to your host using the `docker cp` command:
+
+```bash
+docker ps | grep wpclient-test
+# See the container ID or name of your running container
+docker cp THE-CONTAINER-ID:/tmp/dbdump.sql.gz .
+```
+
+You can then shut down your container by logging out of the container terminal.
+
+Restore the DB loading code from the `Dockerfile`, commit this file to the repo and rebuild everything and verify that Wordpress is still set up correctly when the dump is restored.
+
+`spec/docker/restore-dbdump.sh` hard codes an expectation that the IP in your
+datadump is a specfic IP. So you will need to change that hard coded
+expectation to match the new IP used in your data dump. You can find out what
+that IP is by examining the dumo but it is probably the value set in `$DOCKER_HOST`.

data/spec/docker/htaccess

@@ -0,0 +1,10 @@
+# BEGIN WordPress
+<IfModule mod_rewrite.c>
+RewriteEngine On
+RewriteBase /
+RewriteRule ^index\.php$ - [L]
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule . /index.php [L]
+</IfModule>
+# END WordPress

data/spec/docker/restore-dbdump.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+service mysqld start
+
+gunzip -c /tmp/dbdump.sql.gz | \
+  sed "s/192\.168\.99\.100:8181/${WORDPRESS_HOST:-localhost:8181}/g" | \
+  mysql \
+    --user="$MYSQL_USER" \
+    --password="$MYSQL_PASS" \
+    --host="$MYSQL_SERVER" \
+    --batch \
+    "$MYSQL_DB"
+
+rm /tmp/dbdump.sql.gz

data/spec/fixtures/category.json

@@ -0,0 +1 @@
+{"id":1,"count":1,"description":"","link":"http:\/\/192.168.99.100:8080\/category\/uncategorized\/","name":"Uncategorized","slug":"uncategorized","taxonomy":"category","parent":0,"_links":{"self":[{"href":"http:\/\/192.168.99.100:8080\/wp-json\/wp\/v2\/terms\/category\/1"}],"collection":[{"href":"http:\/\/192.168.99.100:8080\/wp-json\/wp\/v2\/terms\/category"}]}}

data/spec/fixtures/image-media.json

@@ -0,0 +1 @@
+{"id":5,"date":"2015-11-17T14:51:26","guid":{"rendered":"http:\/\/example.com\/wp-content\/uploads\/2015\/11\/thoughtful.jpg"},"modified":"2015-11-17T14:51:26","modified_gmt":"2015-11-17T14:51:26","slug":"thoughtful","type":"attachment","link":"http:\/\/example.com\/?attachment_id=5","title":{"rendered":"thoughtful"},"author":1,"comment_status":"open","ping_status":"closed","alt_text":"","caption":"","description":"","media_type":"image","media_details":{"width":600,"height":800,"file":"2015\/11\/thoughtful.jpg","image_meta":{"aperture":0,"credit":"","camera":"","caption":"","created_timestamp":0,"copyright":"\u00a9 JoeDaEskimo - http:\/\/www.redbubble.com\/people\/JoeDaEskim","focal_length":0,"iso":0,"shutter_speed":0,"title":"","orientation":0},"sizes":{}},"post":null,"source_url":"http:\/\/example.com\/wp-content\/uploads\/2015\/11\/thoughtful.jpg","_links":{"self":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/media\/5"}],"collection":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/media"}],"author":[{"embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/comments?post_id=5"}]}}

data/spec/fixtures/invalid-post-id.json

@@ -0,0 +1 @@
+{"code":"rest_post_invalid_id","message":"Invalid post ID.","data":{"status":404}}

data/spec/fixtures/post-with-forbidden-metadata.json

@@ -0,0 +1 @@
+{"id":4,"date":null,"guid":{"rendered":"http:\/\/192.168.99.100:8181\/?p=4"},"modified":null,"modified_gmt":null,"slug":"","type":"post","link":"http:\/\/192.168.99.100:8181\/?p=4","title":{"rendered":"Metadata creation"},"content":{"rendered":""},"excerpt":{"rendered":""},"author":1,"featured_image":0,"comment_status":"open","ping_status":"open","sticky":false,"format":"standard","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts"}],"author":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/comments?post_id=4"}],"version-history":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/revisions"}],"https:\/\/api.w.org\/attachment":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/media?post_parent=4"}],"https:\/\/api.w.org\/term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/terms\/category"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/terms\/tag"},{"taxonomy":"post_format","embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/terms\/post_format"}],"https:\/\/api.w.org\/meta":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/meta"}]},"_embedded":{"author":[{"avatar_urls":{"24":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=24&d=mm&r=g","48":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=48&d=mm&r=g","96":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=96&d=mm&r=g"},"description":"","id":1,"link":"http:\/\/192.168.99.100:8181\/author\/test\/","name":"test","url":"","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/users\/1"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/users"}]}}],"replies":[[{"id":1,"parent":0,"author":0,"author_name":"Mr WordPress","author_url":"https:\/\/wordpress.org\/","author_avatar_urls":{"24":"http:\/\/1.gravatar.com\/avatar\/?s=24&d=mm&r=g","48":"http:\/\/1.gravatar.com\/avatar\/?s=48&d=mm&r=g","96":"http:\/\/2.gravatar.com\/avatar\/?s=96&d=mm&r=g"},"date":"2015-11-03T07:47:41","content":{"rendered":"<p>Hi, this is a comment.<br \/>\nTo delete a comment, just log in and view the post&#039;s comments. There you will have the option to edit or delete them.<\/p>\n"},"link":"http:\/\/192.168.99.100:8181\/2015\/11\/03\/hello-world\/#comment-1","type":"comment","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/comments\/1"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/comments"}],"up":[{"embeddable":true,"post_type":"post","href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/1"}]}}]],"https:\/\/api.w.org\/term":[[{"id":1,"link":"http:\/\/192.168.99.100:8181\/category\/uncategorized\/","name":"Uncategorized","slug":"uncategorized","taxonomy":"category","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/terms\/category\/1"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/terms\/category"}]}}],[],[{"code":"rest_no_route","message":"No route was found matching the URL and request method","data":{"status":404}}]],"https:\/\/api.w.org\/meta":[[{"code":"rest_forbidden","message":"Sorry, you cannot view the meta for this post.","data":{"status":403}}]]}}

data/spec/fixtures/post-with-metadata.json

@@ -0,0 +1 @@
+{"id":4,"date":null,"guid":{"rendered":"http:\/\/192.168.99.100:8181\/?p=4"},"modified":null,"modified_gmt":null,"slug":"","type":"post","link":"http:\/\/192.168.99.100:8181\/?p=4","title":{"rendered":"Metadata creation"},"content":{"rendered":""},"excerpt":{"rendered":""},"author":1,"featured_image":0,"comment_status":"open","ping_status":"open","sticky":false,"format":"standard","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts"}],"author":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/comments?post_id=4"}],"version-history":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/revisions"}],"https:\/\/api.w.org\/attachment":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/media?post_parent=4"}],"https:\/\/api.w.org\/term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/terms\/category"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/terms\/tag"},{"taxonomy":"post_format","embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/terms\/post_format"}],"https:\/\/api.w.org\/meta":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/4\/meta"}]},"_embedded":{"author":[{"avatar_urls":{"24":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=24&d=mm&r=g","48":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=48&d=mm&r=g","96":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=96&d=mm&r=g"},"description":"","id":1,"link":"http:\/\/192.168.99.100:8181\/author\/test\/","name":"test","url":"","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/users\/1"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/users"}]}}],"replies":[[{"id":1,"parent":0,"author":0,"author_name":"Mr WordPress","author_url":"https:\/\/wordpress.org\/","author_avatar_urls":{"24":"http:\/\/1.gravatar.com\/avatar\/?s=24&d=mm&r=g","48":"http:\/\/1.gravatar.com\/avatar\/?s=48&d=mm&r=g","96":"http:\/\/2.gravatar.com\/avatar\/?s=96&d=mm&r=g"},"date":"2015-11-03T07:47:41","content":{"rendered":"<p>Hi, this is a comment.<br \/>\nTo delete a comment, just log in and view the post&#039;s comments. There you will have the option to edit or delete them.<\/p>\n"},"link":"http:\/\/192.168.99.100:8181\/2015\/11\/03\/hello-world\/#comment-1","type":"comment","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/comments\/1"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/comments"}],"up":[{"embeddable":true,"post_type":"post","href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/posts\/1"}]}}]],"https:\/\/api.w.org\/term":[[{"id":1,"link":"http:\/\/192.168.99.100:8181\/category\/uncategorized\/","name":"Uncategorized","slug":"uncategorized","taxonomy":"category","_links":{"self":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/terms\/category\/1"}],"collection":[{"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/v2\/terms\/category"}]}}],[],[{"code":"rest_no_route","message":"No route was found matching the URL and request method","data":{"status":404}}]],"https:\/\/api.w.org\/meta":[[{"id":2,"key":"foo","value":"bar","_links":{"about":[{"embeddable":true,"href":"http:\/\/192.168.99.100:8181\/wp-json\/wp\/posts\/4"}]}}]]}}

data/spec/fixtures/simple-post.json

@@ -0,0 +1 @@
+{"id":1,"date":"2015-11-03T07:47:41","guid":{"rendered":"http:\/\/example.com\/?p=1"},"modified":"2015-11-17T09:18:22","modified_gmt":"2015-11-17T09:18:22","slug":"hello-world","type":"post","link":"http:\/\/example.com\/2015\/11\/03\/hello-world\/","title":{"rendered":"Hello world!"},"content":{"rendered":"<p>Welcome to WordPress. This is your first post. Edit or delete it, then start writing!<\/p>\n"},"excerpt":{"rendered":"<p>Welcome to WordPress. This is your first post. Edit or delete it, then start writing!<\/p>\n"},"author":1,"featured_image":0,"comment_status":"open","ping_status":"open","sticky":false,"format":"standard","_links":{"self":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/posts\/1"}],"collection":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/posts"}],"author":[{"embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/comments?post_id=1"}],"version-history":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/posts\/1\/revisions"}],"https:\/\/api.w.org\/attachment":[{"embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/media?post_parent=1"}],"https:\/\/api.w.org\/term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/example.com\/wp-json\/wp\/v2\/posts\/1\/terms\/category"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/posts\/1\/terms\/tag"},{"taxonomy":"post_format","embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/posts\/1\/terms\/post_format"}],"https:\/\/api.w.org\/meta":[{"embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/v2\/posts\/1\/meta"}]},"_embedded":{"author":[{"avatar_urls":{"24":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=24&d=mm&r=g","48":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=48&d=mm&r=g","96":"http:\/\/2.gravatar.com\/avatar\/55502f40dc8b7c769880b10874abc9d0?s=96&d=mm&r=g"},"description":"","id":1,"link":"http:\/\/example.com\/author\/test\/","name":"test","url":"","_links":{"self":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/users\/1"}],"collection":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/users"}]}}],"replies":[[{"id":1,"parent":0,"author":0,"author_name":"Mr WordPress","author_url":"http:\/\/wordpress.org\/","author_avatar_urls":{"24":"http:\/\/1.gravatar.com\/avatar\/?s=24&d=mm&r=g","48":"http:\/\/2.gravatar.com\/avatar\/?s=48&d=mm&r=g","96":"http:\/\/2.gravatar.com\/avatar\/?s=96&d=mm&r=g"},"date":"2015-11-03T07:47:41","content":{"rendered":"<p>Hi, this is a comment.<br \/>\nTo delete a comment, just log in and view the post&#039;s comments. There you will have the option to edit or delete them.<\/p>\n"},"link":"http:\/\/example.com\/2015\/11\/03\/hello-world\/#comment-1","type":"comment","_links":{"self":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/comments\/1"}],"collection":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/comments"}],"up":[{"embeddable":true,"post_type":"post","href":"http:\/\/example.com\/wp-json\/wp\/v2\/posts\/1"}]}}]],"https:\/\/api.w.org\/term":[[{"id":1,"link":"http:\/\/example.com\/category\/uncategorized\/","name":"Uncategorized","slug":"uncategorized","taxonomy":"category","_links":{"self":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/terms\/category\/1"}],"collection":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/terms\/category"}]}}],[{"id":2,"link":"http:\/\/example.com\/tag\/foo\/","name":"Foo","slug":"foo","taxonomy":"post_tag","_links":{"self":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/terms\/tag\/2"}],"collection":[{"href":"http:\/\/example.com\/wp-json\/wp\/v2\/terms\/tag"}]}}],[{"code":"rest_no_route","message":"No route was found matching the URL and request method","data":{"status":404}}]],"https:\/\/api.w.org\/meta":[[{"id":3,"key":"Some test","value":"Definitely","_links":{"about":[{"embeddable":true,"href":"http:\/\/example.com\/wp-json\/wp\/posts\/1"}]}}]]}}

data/spec/fixtures/tag.json

@@ -0,0 +1 @@
+{"id":2,"count":1,"description":"","link":"http:\/\/192.168.99.100:8080\/tag\/foo\/","name":"Foo","slug":"foo","taxonomy":"post_tag","_links":{"self":[{"href":"http:\/\/192.168.99.100:8080\/wp-json\/wp\/v2\/terms\/tag\/2"}],"collection":[{"href":"http:\/\/192.168.99.100:8080\/wp-json\/wp\/v2\/terms\/tag"}]}}

data/spec/fixtures/validation-error.json

@@ -0,0 +1 @@
+{"code":"rest_invalid_param","message":"Invalid parameter(s): status (status is not one of publish, future, draft, pending, private)","data":{"status":400,"params":["status (status is not one of publish, future, draft, pending, private)"]}}

data/spec/integration/attachments_crud_spec.rb

@@ -0,0 +1,51 @@
+require "spec_helper"
+
+describe "Attachments" do
+  setup_integration_client
+
+  it "can be created" do
+    media = open_fixture("thoughtful.jpg") do |io|
+      client.upload(io, mime_type: "image/jpeg", filename: "thoughtful.jpg")
+    end
+
+    expect(media).to be_instance_of(WordpressClient::Media)
+
+    expect(client.find_media(media.id)).to be_instance_of(WordpressClient::Media)
+  end
+
+  it "can be created from a file on disk" do
+    path = fixture_path("thoughtful.jpg")
+    media = client.upload_file(path, mime_type: "image/jpeg")
+
+    expect(media).to be_instance_of(WordpressClient::Media)
+
+    expect(client.find_media(media.id)).to be_instance_of(WordpressClient::Media)
+  end
+
+  it "can be updated" do
+    media = find_or_create_attachment
+    updated = client.update_media(media.id, title: "Totally updated media")
+    expect(updated.title_html).to eq "Totally updated media"
+  end
+
+  it "can be listed" do
+    find_or_create_attachment
+
+    media = client.media(per_page: 1)
+
+    expect(media.size).to be > 0
+    expect(media.first).to be_instance_of(WordpressClient::Media)
+  end
+
+  it "uses HTML for the title" do
+    media = find_or_create_attachment
+    updated = client.update_media(media.id, title: "Images & paint")
+    expect(updated.title_html).to eq "Images & paint"
+  end
+
+  def find_or_create_attachment
+    client.media(per_page: 1).first || open_fixture("thoughtful.jpg") do |io|
+      client.upload(io, mime_type: "image/jpeg", filename: "thoughtful.jpg")
+    end
+  end
+end