Squashed 'includes/lib/action-scheduler/' content from commit c82834771

git-subtree-dir: includes/lib/action-scheduler
git-subtree-split: c828347715e6c3318c8ab8b4fea2d87b31d51aac

classes/ActionScheduler_InvalidActionException.php

@@ -0,0 +1,49 @@
+<?php
+
+/**
+ * InvalidAction Exception.
+ *
+ * Used for identifying actions that are invalid in some way.
+ *
+ * @package ActionScheduler
+ */
+class ActionScheduler_InvalidActionException extends \InvalidArgumentException implements ActionScheduler_Exception {
+
+	/**
+	 * Create a new exception when the action's schedule cannot be fetched.
+	 *
+	 * @param string $action_id The action ID with bad args.
+	 * @param mixed  $schedule  Passed schedule.
+	 * @return static
+	 */
+	public static function from_schedule( $action_id, $schedule ) {
+		$message = sprintf(
+			/* translators: 1: action ID 2: schedule */
+			__( 'Action [%1$s] has an invalid schedule: %2$s', 'action-scheduler' ),
+			$action_id,
+			var_export( $schedule, true )
+		);
+
+		return new static( $message );
+	}
+
+	/**
+	 * Create a new exception when the action's args cannot be decoded to an array.
+	 *
+	 * @author Jeremy Pry
+	 *
+	 * @param string $action_id The action ID with bad args.
+	 * @param mixed  $args      Passed arguments.
+	 * @return static
+	 */
+	public static function from_decoding_args( $action_id, $args = array() ) {
+		$message = sprintf(
+			/* translators: 1: action ID 2: arguments */
+			__( 'Action [%1$s] has invalid arguments. It cannot be JSON decoded to an array. $args = %2$s', 'action-scheduler' ),
+			$action_id,
+			var_export( $args, true )
+		);
+
+		return new static( $message );
+	}
+}