Add font library commands for WordPress 6.5+

composer.json

@@ -63,6 +63,17 @@
             "comment unspam",
             "comment untrash",
             "comment update",
+            "font",
+            "font collection",
+            "font collection get",
+            "font collection is-registered",
+            "font collection list",
+            "font collection list-categories",
+            "font collection list-families",
+            "font face",
+            "font face install",
+            "font family",
+            "font family install",
             "menu",
             "menu create",
             "menu delete",

entity-command.php

@@ -113,3 +113,19 @@
 		},
 	)
 );
+
+if ( class_exists( 'WP_CLI\Dispatcher\CommandNamespace' ) ) {
+	WP_CLI::add_command( 'font', 'Font_Namespace' );
+}
+
+$wpcli_entity_font_version_check = array(
+	'before_invoke' => function () {
+		if ( Utils\wp_version_compare( '6.5', '<' ) ) {
+			WP_CLI::error( 'Requires WordPress 6.5 or greater.' );
+		}
+	},
+);
+
+WP_CLI::add_command( 'font collection', 'Font_Collection_Command', $wpcli_entity_font_version_check );
+WP_CLI::add_command( 'font family', 'Font_Family_Command', $wpcli_entity_font_version_check );
+WP_CLI::add_command( 'font face', 'Font_Face_Command', $wpcli_entity_font_version_check );

features/font-collection.feature

@@ -0,0 +1,82 @@
+Feature: Manage WordPress font collections
+
+  Background:
+    Given a WP install
+
+  @require-wp-6.5
+  Scenario: Listing font collections
+    When I try `wp font collection list`
+    Then STDOUT should be a table containing rows:
+      | slug         | name         | description                                                                | categories                                                                                                         |
+      | google-fonts | Google Fonts | Install from Google Fonts. Fonts are copied to and served from your site.  | Sans Serif (sans-serif), Display (display), Serif (serif), Handwriting (handwriting), Monospace (monospace)        |
+
+  @require-wp-6.5
+  Scenario: Getting a non-existent font collection
+    When I try `wp font collection get nonexistent-collection`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      doesn't exist
+      """
+
+  @require-wp-6.5
+  Scenario: Checking whether a font collection is registered
+    When I try `wp font collection is-registered nonexistent-collection`
+    Then the return code should be 1
+
+    When I run `wp font collection is-registered google-fonts`
+    Then the return code should be 0
+
+  @require-wp-6.5
+  Scenario: Listing font families in a collection
+    When I run `wp font collection list-families google-fonts --format=count`
+    Then STDOUT should be a number
+
+  @require-wp-6.5
+  Scenario: Listing font families in a collection with fields
+    When I run `wp font collection list-families google-fonts --fields=slug,name --format=csv`
+    Then STDOUT should contain:
+      """
+      slug,name
+      """
+
+  @require-wp-6.5
+  Scenario: Filtering font families by category
+    When I run `wp font collection list-families google-fonts --category=sans-serif --format=count`
+    Then STDOUT should be a number
+
+  @require-wp-6.5
+  Scenario: Listing categories in a collection
+    When I run `wp font collection list-categories google-fonts --format=csv`
+    Then STDOUT should contain:
+      """
+      slug,name
+      """
+
+  @require-wp-6.5
+  Scenario: Getting a non-existent collection for list-families
+    When I try `wp font collection list-families nonexistent-collection`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      doesn't exist
+      """
+
+  @require-wp-6.5
+  Scenario: Getting a non-existent collection for list-categories
+    When I try `wp font collection list-categories nonexistent-collection`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      doesn't exist
+      """
+
+  @less-than-wp-6.5
+  Scenario: Font collection commands fail on WordPress < 6.5
+    Given a WP install
+    When I try `wp font collection list`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      Requires WordPress 6.5 or greater
+      """

features/font-face.feature

@@ -0,0 +1,68 @@
+Feature: Manage WordPress font faces
+
+  Background:
+    Given a WP install
+
+  @require-wp-6.5
+  Scenario: Installing a font face
+    Given I run `wp post create --post_type=wp_font_family --post_title="Test Family" --post_status=publish --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+
+    When I run `wp font face install {FONT_FAMILY_ID} --src="https://example.com/font.woff2" --porcelain`
+    Then STDOUT should be a number
+    And save STDOUT as {FONT_FACE_ID}
+
+    When I run `wp post get {FONT_FACE_ID} --field=post_parent`
+    Then STDOUT should be:
+      """
+      {FONT_FAMILY_ID}
+      """
+
+  @require-wp-6.5
+  Scenario: Installing a font face with custom properties
+    Given I run `wp post create --post_type=wp_font_family --post_title="Test Family" --post_status=publish --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+
+    When I run `wp font face install {FONT_FAMILY_ID} --src="font.woff2" --font-weight=700 --font-style=italic --porcelain`
+    Then STDOUT should be a number
+    And save STDOUT as {FONT_FACE_ID}
+
+    When I run `wp post get {FONT_FACE_ID} --field=post_title`
+    Then STDOUT should contain:
+      """
+      700
+      """
+    And STDOUT should contain:
+      """
+      italic
+      """
+
+  @require-wp-6.5
+  Scenario: Installing a font face with invalid parent
+    When I try `wp font face install 999999 --src="font.woff2"`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      doesn't exist
+      """
+
+  @require-wp-6.5
+  Scenario: Installing a font face without required src parameter
+    Given I run `wp post create --post_type=wp_font_family --post_title="Test Family" --post_status=publish --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+
+    When I try `wp font face install {FONT_FAMILY_ID}`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      missing --src parameter
+      """
+
+  @less-than-wp-6.5
+  Scenario: Font face install commands fail on WordPress < 6.5
+    When I try `wp font face install 1 --src=test.woff2`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      Requires WordPress 6.5 or greater
+      """

features/font-family.feature

@@ -0,0 +1,46 @@
+Feature: Manage WordPress font families
+
+  Background:
+    Given a WP install
+
+  @require-wp-6.5
+  Scenario: Installing a font family from a collection
+    When I run `wp font family install google-fonts "roboto" --porcelain`
+    Then STDOUT should be a number
+    And save STDOUT as {FONT_FAMILY_ID}
+
+    When I run `wp post get {FONT_FAMILY_ID} --field=post_title`
+    Then STDOUT should contain:
+      """
+      Roboto
+      """
+
+    When I run `wp post list --post_type=wp_font_face --post_parent={FONT_FAMILY_ID} --format=count`
+    Then STDOUT should be a number
+
+  @require-wp-6.5
+  Scenario: Installing a font family from a non-existent collection
+    When I try `wp font family install nonexistent-collection roboto`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      doesn't exist
+      """
+
+  @require-wp-6.5
+  Scenario: Installing a non-existent font family from a collection
+    When I try `wp font family install google-fonts nonexistent-family`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      not found
+      """
+
+  @less-than-wp-6.5
+  Scenario: Font family install commands fail on WordPress < 6.5
+    When I try `wp font family install google-fonts roboto`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      Requires WordPress 6.5 or greater
+      """

phpcs.xml.dist

@@ -61,6 +61,8 @@
 	<rule ref="WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedClassFound">
 		<exclude-pattern>*/src/Taxonomy_Command\.php$</exclude-pattern>
 		<exclude-pattern>*/src/Comment(_Meta)?_Command\.php$</exclude-pattern>
+		<exclude-pattern>*/src/Font(_Collection|_Face|_Family)?_Command\.php$</exclude-pattern>
+		<exclude-pattern>*/src/Font_Namespace\.php$</exclude-pattern>
 		<exclude-pattern>*/src/Menu(_Item|_Location)?_Command\.php$</exclude-pattern>
 		<exclude-pattern>*/src/Network_Meta_Command\.php$</exclude-pattern>
 		<exclude-pattern>*/src/Network_Namespace\.php$</exclude-pattern>