Wpcli

Simple wrapper for wp-cli (http://wp-cli.org/).

Download as .zip Download as .tar.gz View on GitHub

Wpcli

Simple wrapper for wp-cli (http://wp-cli.org/).

Just pass commands (http://wp-cli.org/commands/) to run method and use returned hash as you wish.

Installation

Add this line to your application's Gemfile:

gem 'wpcli', "~> 0.2.9"

And then execute:

$ bundle

Or install it yourself as:

$ gem install wpcli

Rails

Simplest way to use in rails is to create config file and use methods from module.

Generate example config

rails g wpcli:config

Generated file (config/wpcli.yml)

apps:
    key_for_installation: /absolute/path/for/my/wp-installation

In controller include module

class MyController < ApplicationController
  include Wpcli

And then you can use client with key:

 users = wpcli(:key_for_installation).run "user list"

You can check if there is any apps in config with

wp_apps?

Alternative way

If you like to use client for example in command line, you can create instance with path of wordpress installation

@wpcli = Wpcli::Client.new "path/to/wp"
users = @wpcli.run "user list"

Docker

Easiest way to test the gem is to use Docker.

First build image with

docker-compose build

Then start the containers

docker-compose up -d

Note: On the first time, go to http://localhost:8080 and go through wordpress' installation wizard.

Access to irb

docker exec -it wpcli_wpcli_1 /wpcli/bin/irb

Use the client

Wpcli::Client.new("/var/www/html").run "user list"

Contributing

  1. Fork it
  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 new Pull Request

Gem Version Build StatusCoverage Status