modernizr.drush.inc in Modernizr 8

drush integration for modernizr.

File

drush/modernizr.drush.inc

<?php

/**
 * @file
 *   drush integration for modernizr.
 */

// The development version of Modernizr can be located here.
define('MODERNIZR_DOWNLOAD_DEV', 'http://www.modernizr.com/downloads/modernizr-2.6.2.js');

/**
 * Implementation of hook_drush_command().
 *
 * In this hook, you specify which commands your
 * drush module makes available, what it does and
 * description.
 *
 * Notice how this structure closely resembles how
 * you define menu hooks.
 *
 * @See drush_parse_command() for a list of recognized keys.
 *
 * @return
 *   An associative array describing your command(s).
 */
function modernizr_drush_command() {
  $items = array();
  $items['modernizr-dev'] = array(
    'callback' => '_modernizr_drush_download_dev',
    'description' => dt('Downloads the dev version of Modernizr from @dev', array(
      '@dev' => MODERNIZR_DOWNLOAD_DEV,
    )),
    'aliases' => array(
      'mdl',
    ),
    'arguments' => array(
      'path' => dt('Optional. A destination for the Modernizr library. If omitted Drush will use one of the default locations.'),
    ),
  );
  $items['modernizr-build'] = array(
    'callback' => '_modernizr_drush_custom_build',
    'description' => dt('Requests a custom build of Modernizr based on your Drupal module settings. Depends on node.js/npm.'),
    'aliases' => array(
      'mcb',
    ),
    'arguments' => array(),
  );
  return $items;
}

/**
 * Implementation of hook_drush_help().
 *
 * This function is called whenever a drush user calls
 * 'drush help <name-of-your-command>'
 *
 * @param
 *   A string with the help section (prepend with 'drush:')
 *
 * @return
 *   A string with the help text for your command.
 */
function modernizr_drush_help($section) {
  switch ($section) {
    case 'drush:modernizr-dev':
      return dt("Downloads the dev version of Modernizr from @dev. Accepts an optional destination argument.", array(
        '@dev' => MODERNIZR_DOWNLOAD_DEV,
      ));
    case 'drush:modernizr-build':
      return dt('Queries Drupal modules for any Modernizr tests they require, and creates a request for a node.js-powered CLI builder. You must install node.js, npm, and the CLI builder beforehand.');
  }
}

/**
 * Helper function downloads the uncompressed development copy of Modernizr.
 */
function _modernizr_drush_download_dev() {
  $args = func_get_args();
  $dir = '';
  $drush_context = '';

  // If the user supplied a destination, use that path
  if ($args[0]) {
    $dir = $args[0];
  }
  else {
    $drush_context = drush_get_context('DRUSH_DRUPAL_ROOT');

    // Can we use Libraries API?
    if (module_exists('libraries') && function_exists('libraries_get_path')) {
      $libraries_dir = libraries_get_path('modernizr');
    }

    // Load the path
    $dir = $libraries_dir ? $drush_context . '/' . $libraries_dir : $drush_context . '/sites/all/libraries/modernizr';
  }

  // Build full path including filename
  $path = _modernizr_scan_for_library(array(
    $dir,
  ));

  // If the directory exists and contains a recognized file, we're finished.
  if (modernizr_get_path()) {
    drush_log('Modernizr already present. No download required.', 'ok');
    return;
  }
  else {

    // The file was not present. Create the directory to hold it.
    drush_mkdir($dir);

    // Attempt to download the file and log the outcome.
    if (drush_op('chdir', $dir) && drush_shell_exec('wget ' . MODERNIZR_DOWNLOAD_DEV)) {
      drush_log(dt('The latest Modernizr dev library has been downloaded to @path', array(
        '@path' => $dir,
      )), 'success');
    }
    else {
      drush_log(dt('Drush was unable to download Modernizr dev to @path', array(
        '@path' => $dir,
      )), 'error');
    }
  }
}

/**
 * Implements drush_MODULE_post_COMMAND().
 */
function drush_modernizr_post_pm_enable() {
  $extensions = func_get_args();

  // Deal with comma delimited extension list.
  if (strpos($extensions[0], ',') !== FALSE) {
    $extensions = explode(',', $extensions[0]);
  }
  if (in_array('modernizr', $extensions) && !drush_get_option('skip')) {
    _modernizr_drush_download_dev();
  }
}

/**
 * Helper function that generates a list of Modernizr tests
 * from other modules and sends them to the node.js CLI builder.
 */
function _modernizr_drush_custom_build() {
  $output_args = array();
  $args = modernizr_api_list();
  $output = '';

  // Get the map of Modernizr args.
  include_once drupal_get_path('module', 'modernizr') . '/modernizr.args.inc';

  // Fetch all the tests, and record which modules supplied them.
  foreach ($args as $key => $test) {
    $meta = _modernizr_args_return($key);
    $type = $meta['type'];
    $output_args[$type][] = $key;
  }

  // Collapse tests into the format accepted by the node builder.
  $tests = isset($output_args['tests']) ? ' -t ' . implode(' ', $output_args['tests']) : '';
  $extras = isset($output_args['extras']) ? ' -e ' . implode(' ', $output_args['extras']) : '';
  $groups = isset($output_args['groups']) ? ' -g ' . implode(' ', $output_args['groups']) : '';
  $not = isset($output_args['not']) ? ' -n ' . implode(' ', $output_args['not']) : '';
  $output = $tests . $extras . $groups . $not;
  return $output;
}

Functions

Name	Description
drush_modernizr_post_pm_enable	Implements drush_MODULE_post_COMMAND().
modernizr_drush_command	Implementation of hook_drush_command().
modernizr_drush_help	Implementation of hook_drush_help().
_modernizr_drush_custom_build	Helper function that generates a list of Modernizr tests from other modules and sends them to the node.js CLI builder.
_modernizr_drush_download_dev	Helper function downloads the uncompressed development copy of Modernizr.

Constants

Name	Description
MODERNIZR_DOWNLOAD_DEV