Add font library commands for WordPress 6.5+

composer.json

@@ -63,6 +63,27 @@
             "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 create",
+            "font face delete",
+            "font face get",
+            "font face install",
+            "font face list",
+            "font face update",
+            "font family",
+            "font family create",
+            "font family delete",
+            "font family get",
+            "font family install",
+            "font family list",
+            "font family update",
             "menu",
             "menu create",
             "menu delete",

entity-command.php

@@ -108,3 +108,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                                                                |
+      | google-fonts | Google Fonts | Install from Google Fonts. Fonts are copied to and served from your site.  |
+
+  @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,192 @@
+Feature: Manage WordPress font faces
+
+  Background:
+    Given a WP install
+
+  @require-wp-6.5
+  Scenario: Creating a font face
+    Given I run `wp font family create --post_title="Test Family" --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+
+    When I run `wp font face create --post_parent={FONT_FAMILY_ID} --post_title="Regular" --porcelain`
+    Then STDOUT should be a number
+    And save STDOUT as {FONT_FACE_ID}
+
+    When I run `wp font face get {FONT_FACE_ID} --field=post_title`
+    Then STDOUT should be:
+      """
+      Regular
+      """
+
+  @require-wp-6.5
+  Scenario: Listing font faces
+    Given I run `wp font family create --post_title="Test Family" --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+    And I run `wp font face create --post_parent={FONT_FAMILY_ID} --post_title="Regular" --porcelain`
+    And save STDOUT as {FACE1}
+    And I run `wp font face create --post_parent={FONT_FAMILY_ID} --post_title="Bold" --porcelain`
+    And save STDOUT as {FACE2}
+
+    When I run `wp font face list --format=csv --fields=ID,post_title,post_parent`
+    Then STDOUT should contain:
+      """
+      Regular
+      """
+    And STDOUT should contain:
+      """
+      Bold
+      """
+
+  @require-wp-6.5
+  Scenario: Listing font faces by family
+    Given I run `wp font family create --post_title="Family One" --porcelain`
+    And save STDOUT as {FAMILY1}
+    And I run `wp font family create --post_title="Family Two" --porcelain`
+    And save STDOUT as {FAMILY2}
+    And I run `wp font face create --post_parent={FAMILY1} --post_title="F1 Regular" --porcelain`
+    And I run `wp font face create --post_parent={FAMILY2} --post_title="F2 Regular" --porcelain`
+
+    When I run `wp font face list --post_parent={FAMILY1} --format=csv --fields=post_title`
+    Then STDOUT should contain:
+      """
+      F1 Regular
+      """
+    And STDOUT should not contain:
+      """
+      F2 Regular
+      """
+
+  @require-wp-6.5
+  Scenario: Getting a font face
+    Given I run `wp font family create --post_title="Test Family" --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+    And I run `wp font face create --post_parent={FONT_FAMILY_ID} --post_title="Bold" --porcelain`
+    And save STDOUT as {FONT_FACE_ID}
+
+    When I try `wp font face get {FONT_FACE_ID}`
+    Then the return code should be 0
+    And STDOUT should contain:
+      """
+      Bold
+      """
+
+  @require-wp-6.5
+  Scenario: Updating a font face
+    Given I run `wp font family create --post_title="Test Family" --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+    And I run `wp font face create --post_parent={FONT_FAMILY_ID} --post_title="Old Name" --porcelain`
+    And save STDOUT as {FONT_FACE_ID}
+
+    When I run `wp font face update {FONT_FACE_ID} --post_title="New Name"`
+    Then STDOUT should contain:
+      """
+      Success: Updated font face
+      """
+
+    When I run `wp font face get {FONT_FACE_ID} --field=post_title`
+    Then STDOUT should be:
+      """
+      New Name
+      """
+
+  @require-wp-6.5
+  Scenario: Deleting a font face
+    Given I run `wp font family create --post_title="Test Family" --porcelain`
+    And save STDOUT as {FONT_FAMILY_ID}
+    And I run `wp font face create --post_parent={FONT_FAMILY_ID} --post_title="Delete Me" --porcelain`
+    And save STDOUT as {FONT_FACE_ID}
+
+    When I run `wp font face delete {FONT_FACE_ID}`
+    Then STDOUT should contain:
+      """
+      Success: Deleted font face
+      """
+
+    When I try `wp font face get {FONT_FACE_ID}`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      doesn't exist
+      """
+
+  @require-wp-6.5
+  Scenario: Creating a font face requires parent
+    When I try `wp font face create --post_title="Regular"`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      --post_parent parameter is required
+      """
+
+  @require-wp-6.5
+  Scenario: Creating a font face with invalid parent
+    When I try `wp font face create --post_parent=999999 --post_title="Regular"`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      doesn't exist
+      """
+
+  @require-wp-6.5
+  Scenario: Installing a font face
+    Given I run `wp font family create --post_title="Test Family" --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 font face 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 font family create --post_title="Test Family" --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 font face 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 font family create --post_title="Test Family" --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:
+      """
+      --src parameter is required
+      """
+
+  @less-than-wp-6.5
+  Scenario: Font face commands fail on WordPress < 6.5
+    When I try `wp font face list`
+    Then the return code should be 1
+    And STDERR should contain:
+      """
+      Requires WordPress 6.5 or greater
+      """