handbook/behat-steps/given-an-file-cache-file.md

Given /^an? ([^\s]+) (file|cache file):$/

Creates a file with the given contents.

---

Usage

The file can be created either in the current working directory or in the cache directory.

Scenario: My example scenario
  Given a wp-cli.yml file:
    """
    @foo:
      path: foo
      user: admin
    """

Behat steps documentation is generated from the WP-CLI codebase on every release. To suggest improvements, please submit a pull request.

---

Related

• Given an empty directory - Creates an empty directory.
• Given /^an? (empty|non-existent) ([^\s]+) directory$/ - Creates or deletes a specific directory.
• Given an empty cache - Clears the WP-CLI cache directory.
• Given /^"([^"]+)" replaced with "([^"]+)" in the ([^\s]+) file$/ - Search and replace a string in a file using regex.
• Given /^that HTTP requests to (.*?) will respond with:$/ - Mock HTTP requests to a given URL.
• Given WP files - Download WordPress files without installing.
• Given wp-config.php - Create a wp-config.php file using `wp config create`.
• Given a database - Creates an empty database.
• Given /^a WP( \d[^\s]+)? install(?:ation)?$/ - Installs WordPress.
• Given /^a WP( [^\s]+)? install(?:ation)? in ['"]?([^'"]+)['"]?$/ - Installs WordPress in a given directory.
• Given a WP install(ation) with Composer - Installs WordPress with Composer.
• Given a WP install(ation) with Composer and a custom vendor directory :vendor_directory - Installs WordPress with Composer and a custom vendor directory.
• Given /^a WP multisite (subdirectory|subdomain)?\s?(install|installation)$/ - Installs WordPress Multisite.
• Given these installed and active plugins: - Installs and activates one or more plugins.
• Given a custom wp-content directory - Configure a custom `wp-content` directory.
• Given download: - Download multiple files into the given destinations.
• Given /^save (STDOUT|STDERR) ([\'].+[^\'])?\s?as \{(\w+)\}$/ - Store STDOUT or STDERR contents in a variable.
• Given /^a new Phar with (?:the same version|version "([^"]+)")$/ - Build a new WP-CLI Phar file with a given version.
• Given /^a downloaded Phar with (?:the same version|version "([^"]+)")$/ - Download a specific WP-CLI Phar version from GitHub.
• Given /^save the (.+) file ([\'].+[^\'])?as \{(\w+)\}$/ - Stores the contents of the given file in a variable.
• Given a misconfigured WP_CONTENT_DIR constant directory - Modify wp-config.php to set `WP_CONTENT_DIR` to an empty string.
• Given a dependency on current wp-cli - Add `wp-cli/wp-cli` as a Composer dependency.
• Given a PHP built-in web server - Start a PHP built-in web server in the current directory.
• Given a PHP built-in web server to serve :subdir - Start a PHP built-in web server in the given subdirectory.