danielbachhuber / unholy
Markup testing for WordPress using jQuery-style selectors.
Installs: 3 815
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 4
Forks: 2
Open Issues: 1
Requires
- php: >=5.3.0
- masterminds/html5: ^2.1
- querypath/querypath: ^3.0.4
This package is auto-updated.
Last update: 2024-10-24 04:54:55 UTC
README
Markup testing for WordPress using jQuery-style selectors. Uses PHPUnit, the WordPress Unit Test Suite, QueryPath, and HTML5-PHP.
It's unholy, but it works.
Installing
These instructions presuppose you're already using PHPUnit and the WordPress Unit Test Suite with your project. If you do, you can:
- Require Unholy using Composer:
composer require danielbachhuber/unholy
- Install dependencies using Composer:
composer install
- Load Unholy into your test suite by appending
require dirname( dirname( __FILE__ ) ) . '/vendor/autoload.php';
to the end of yourbootstrap.php
.
Using
The Unholy_Testcase
class extends the WP_UnitTestcase
class. Update your project's test classes to extend Unholy_Testcase
.
Extending the Unholy_Testcase
class exposes two helper methods: get_permalink_as_dom()
and get_feed_as_dom()
. These can be used to get a DOMDocument-esque object representing the view. Then, use the qp()
function to navigate the object using jQuery-style selectors.
As an example, here is how you might test the Twenty Fifteen theme for the site title and description in the header:
<?php class Test_TwentyFifteen_Theme extends Unholy_Testcase { public function test_header() { update_option( 'blogname', 'Unholy Site Title' ); update_option( 'blogdescription', 'Unholy Site Description' ); $dom = $this->get_permalink_as_dom( '/' ); $this->assertEquals( 'Unholy Site Title', qp( $dom, '#masthead .site-title' )->text() ); $this->assertEquals( 'Unholy Site Description', qp( $dom, '#masthead .site-description' )->text() ); } }
And here is how you might test your RSS feed for a post:
<?php class Test_RSS_Feed extends Unholy_Testcase { public function test_rss_feed_loads_post() { $user_id = $this->factory->user->create( array( 'display_name' => 'Unholy Author' ) ); $this->factory->post->create( array( 'post_title' => 'Unholy Post Title', 'post_author' => $user_id ) ); $dom = $this->get_feed_as_dom( '/feed/' ); $this->assertEquals( 'Unholy Post Title', qp( $dom, 'channel item title' )->eq(0)->text() ); $this->assertEquals( 'Unholy Author', qp( $dom, 'channel item dc|creator')->eq(0)->text() ); } }