check.feature

Feature: Basic check usage

  # Message "Updating to WordPress' newest minor version is strongly recommended." of type "error" appears.
  @broken @require-mysql
  Scenario: Use --spotlight to focus on warnings and errors
    Given a WP install
    And I run `wp plugin activate --all`
    And I run `wp plugin update --all`
    And I run `wp theme update --all`

    When I run `wp doctor list --format=count`
    Then save STDOUT as {CHECK_COUNT}

    When I run `wp doctor check --all --spotlight`
    Then STDOUT should be:
      """
      Success: All {CHECK_COUNT} checks report 'success'.
      """

    When I run `wp doctor check plugin-deactivated --spotlight`
    Then STDOUT should be:
      """
      Success: The check reports 'success'.
      """

    When I run `wp doctor check --all --spotlight --format=json`
    Then STDOUT should be:
      """
      []
      """

  Scenario: Filter check results
    Given a WP install
    # Akismet requires a newer WordPress version, but we don't really need it here.
    And I run `wp plugin uninstall akismet`
    And I run `wp plugin activate --all`
    And I run `wp plugin update --all`
    And I run `wp theme update --all`
    And I run `wp option update blog_public 0`
    And a wp-content/uploads/foo.php file:
      """
      <?php
      // Simple PHP file.
      """

    When I try `wp doctor check option-blog-public php-in-upload --format=csv --fields=name,status`
    Then STDOUT should contain:
      """
      php-in-upload,warning
      """
    And STDOUT should contain:
      """
      option-blog-public,error
      """
    And the return code should be 1

    When I try `wp doctor check option-blog-public php-in-upload --format=csv --fields=name,status --status=error`
    Then STDOUT should contain:
      """
      option-blog-public,error
      """
    And STDOUT should not contain:
      """
      php-in-upload,warning
      """
    And the return code should be 1

  Scenario: Use --spotlight to view warnings and errors
    Given a WP install
    And I run `wp option update blog_public 0`
    And a wp-content/plugins/foo.php file:
      """
      <?php
      // Plugin Name: Foo Plugin

      wp_cache_flush();
      """

    When I try `wp doctor check option-blog-public php-in-upload cache-flush --format=csv --fields=name,status`
    Then STDOUT should be:
      """
      name,status
      option-blog-public,error
      php-in-upload,success
      cache-flush,warning
      """
    And the return code should be 1

    When I run `wp doctor check php-in-upload plugin-active-count --spotlight`
    Then STDOUT should be:
      """
      Success: All 2 checks report 'success'.
      """
    And the return code should be 0

    When I run `wp doctor check plugin-active-count --spotlight`
    Then STDOUT should be:
      """
      Success: The check reports 'success'.
      """
    And the return code should be 0

    When I try `wp doctor check option-blog-public php-in-upload cache-flush --spotlight --format=csv --fields=name,status`
    Then STDOUT should be:
      """
      name,status
      option-blog-public,error
      cache-flush,warning
      """
    And the return code should be 1

    When I run `wp doctor check php-in-upload --spotlight --format=json`
    Then STDOUT should be:
      """
      []
      """
    And the return code should be 0

  Scenario: Error when no checks nor --all are provided
    Given a WP install

    When I try `wp doctor check`
    Then STDERR should be:
      """
      Error: Please specify one or more checks, or use --all.
      """
    And the return code should be 1

  Scenario: Error when an invalid check is provided.
    Given a WP install
    And a config.yml file:
      """
      """

    When I try `wp doctor check invalid-check`
    Then STDERR should be:
      """
      Error: Invalid check.
      """
    And the return code should be 1

    When I try `wp doctor check invalid-check invalid-check2`
    Then STDERR should be:
      """
      Error: Invalid checks.
      """
    And the return code should be 1

    When I try `wp doctor check --all --config=config.yml`
    Then STDERR should be:
      """
      Error: No checks registered.
      """
    And the return code should be 1

  Scenario: List all default checks
    Given a WP install

    When I run `wp doctor list --fields=name`
    Then STDOUT should be a table containing rows:
      | name                  |
      | autoload-options-size |
      | core-update           |
      | core-verify-checksums |
      | plugin-deactivated    |
      | plugin-update         |
      | theme-update          |

  Scenario: Discard redirects emitted by WordPress
    Given a WP install
    And a wp-content/mu-plugins/redirect.php file:
      """
      <?php
      add_action( 'template_redirect', function(){
        wp_redirect( 'http://google.com' );
        exit;
      });
      """

    When I try `wp doctor check autoload-options-size --fields=name,status`
    Then STDERR should contain:
      """
      Warning: Incomplete check execution. Some code is trying to do a URL redirect. Backtrace:
      """
    And STDOUT should be a table containing rows:
      | name                   | status             |
      | autoload-options-size  | success            |

  Scenario: Use --debug=doctor flag to see check progress
    Given a WP install

    When I try `wp doctor check autoload-options-size --debug=doctor`
    Then STDERR should contain:
      """
      Running check: autoload-options-size
      """
    And STDERR should contain:
      """
      Status:
      """

  Scenario: Use --debug=doctor flag with multiple checks
    Given a WP install

    When I try `wp doctor check autoload-options-size plugin-deactivated --debug=doctor`
    Then STDERR should contain:
      """
      Running check: autoload-options-size
      """
    And STDERR should contain:
      """
      Running check: plugin-deactivated
      """

  Scenario: Use --debug=doctor flag with file checks
    Given a WP install
    And a wp-content/plugins/foo.php file:
      """
      <?php
      // Plugin Name: Foo Plugin

      wp_cache_flush();
      """

    When I try `wp doctor check cache-flush --debug=doctor`
    Then STDERR should contain:
      """
      Scanning filesystem for file checks...
      """
    And STDERR should contain:
      """
      Running check: cache-flush
      """