Add a date range query to Macros

Summary:
Ref T1163. Ref T2625. This could probably use some tweaks, but I kept things mostly-generic.

I added a new control for freeform dates so we can have it render help or whatever later on.

Test Plan: See screenshots.

Reviewers: chad, btrahan

Reviewed By: btrahan

CC: aran

Maniphest Tasks: T2625, T1163

Differential Revision: https://secure.phabricator.com/D6084

resources/sql/patches/20130530.macrodatekey.sql

···
+ALTER TABLE {$NAMESPACE}_file.file_imagemacro
+  ADD KEY `key_dateCreated` (dateCreated);

src/__phutil_library_map__.php

···
     'PHUIFeedStoryExample' => 'applications/uiexample/examples/PHUIFeedStoryExample.php',
     'PHUIFeedStoryView' => 'view/phui/PHUIFeedStoryView.php',
     'PHUIFormDividerControl' => 'view/form/control/PHUIFormDividerControl.php',
+    'PHUIFormFreeformDateControl' => 'view/form/control/PHUIFormFreeformDateControl.php',
     'PHUIFormMultiSubmitControl' => 'view/form/control/PHUIFormMultiSubmitControl.php',
     'PHUIFormPageView' => 'view/form/PHUIFormPageView.php',
     'PHUIIconExample' => 'applications/uiexample/examples/PHUIIconExample.php',
···
     'PHUIFeedStoryExample' => 'PhabricatorUIExample',
     'PHUIFeedStoryView' => 'AphrontView',
     'PHUIFormDividerControl' => 'AphrontFormControl',
+    'PHUIFormFreeformDateControl' => 'AphrontFormControl',
     'PHUIFormMultiSubmitControl' => 'AphrontFormControl',
     'PHUIFormPageView' => 'AphrontView',
     'PHUIIconExample' => 'PhabricatorUIExample',

src/applications/macro/query/PhabricatorMacroQuery.php

···
   private $authors;
   private $names;
   private $nameLike;
+  private $dateCreatedAfter;
+  private $dateCreatedBefore;
 
   private $status = 'status-any';
   const STATUS_ANY = 'status-any';
···
 
   public function withStatus($status) {
     $this->status = $status;
+    return $this;
+  }
+
+  public function withDateCreatedBefore($date_created_before) {
+    $this->dateCreatedBefore = $date_created_before;
+    return $this;
+  }
+
+  public function withDateCreatedAfter($date_created_after) {
+    $this->dateCreatedAfter = $date_created_after;
     return $this;
   }
 
···
         break;
       default:
         throw new Exception("Unknown status '{$this->status}'!");
+    }
+
+    if ($this->dateCreatedAfter) {
+      $where[] = qsprintf(
+        $conn,
+        'm.dateCreated >= %d',
+        $this->dateCreatedAfter);
+    }
+
+    if ($this->dateCreatedBefore) {
+      $where[] = qsprintf(
+        $conn,
+        'm.dateCreated <= %d',
+        $this->dateCreatedBefore);
     }
 
     $where[] = $this->buildPagingClause($conn);

src/applications/macro/query/PhabricatorMacroSearchEngine.php

···
     $saved->setParameter('status', $request->getStr('status'));
     $saved->setParameter('names', $request->getStrList('names'));
     $saved->setParameter('nameLike', $request->getStr('nameLike'));
+    $saved->setParameter('createdStart', $request->getStr('createdStart'));
+    $saved->setParameter('createdEnd', $request->getStr('createdEnd'));
 
     return $saved;
   }
···
       $query->withNameLike($like);
     }
 
+    $start = $this->parseDateTime($saved->getParameter('createdStart'));
+    $end = $this->parseDateTime($saved->getParameter('createdEnd'));
+
+    if ($start) {
+      $query->withDateCreatedAfter($start);
+    }
+
+    if ($end) {
+      $query->withDateCreatedBefore($end);
+    }
+
     return $query;
   }
 
···
           ->setName('names')
           ->setLabel(pht('Exact Names'))
           ->setValue($names));
+
+    $this->buildDateRange(
+      $form,
+      $saved_query,
+      'createdStart',
+      pht('Created After'),
+      'createdEnd',
+      pht('Created Before'));
   }
 
   protected function getURI($path) {

src/applications/search/controller/PhabricatorApplicationSearchController.php

···
 
     $engine->buildSearchForm($form, $saved_query);
 
+    $errors = $engine->getErrors();
+    if ($errors) {
+      $run_query = false;
+      $errors = id(new AphrontErrorView())
+        ->setTitle(pht('Query Errors'))
+        ->setErrors($errors);
+    }
+
     $submit = id(new AphrontFormSubmitControl())
       ->setValue(pht('Execute Query'));
 
···
       } else {
         $nav->appendChild($pager);
       }
+    }
+
+    if ($errors) {
+      $nav->appendChild($errors);
     }
 
     if ($named_query) {

src/applications/search/engine/PhabricatorApplicationSearchEngine.php

···
  *
  * @task builtin  Builtin Queries
  * @task uri      Query URIs
+ * @task dates    Date Filters
  *
  * @group search
  */
 abstract class PhabricatorApplicationSearchEngine {
 
   private $viewer;
+  private $errors = array();
 
   public function setViewer(PhabricatorUser $viewer) {
     $this->viewer = $viewer;
···
     AphrontFormView $form,
     PhabricatorSavedQuery $query);
 
+  public function getErrors() {
+    return $this->errors;
+  }
+
+  public function addError($error) {
+    $this->errors[] = $error;
+    return $this;
+  }
 
   /**
    * Return an application URI corresponding to the results page of a query.
···
    */
   public function buildSavedQueryFromBuiltin($query_key) {
     throw new Exception("Builtin '{$query_key}' is not supported!");
+  }
+
+
+/* -(  Dates  )-------------------------------------------------------------- */
+
+
+  /**
+   * @task dates
+   */
+  protected function parseDateTime($date_time) {
+    if (!strlen($date_time)) {
+      return null;
+    }
+
+    $viewer = $this->requireViewer();
+
+    $timezone = new DateTimeZone($viewer->getTimezoneIdentifier());
+
+    try {
+      $date = new DateTime($date_time, $timezone);
+      $timestamp = $date->format('U');
+    } catch (Exception $e) {
+      $timestamp = null;
+    }
+
+    return $timestamp;
+  }
+
+
+  /**
+   * @task dates
+   */
+  protected function buildDateRange(
+    AphrontFormView $form,
+    PhabricatorSavedQuery $saved_query,
+    $start_key,
+    $start_name,
+    $end_key,
+    $end_name) {
+
+    $start_str = $saved_query->getParameter($start_key);
+    $start = null;
+    if (strlen($start_str)) {
+      $start = $this->parseDateTime($start_str);
+      if (!$start) {
+        $this->addError(
+          pht(
+            '"%s" date can not be parsed.',
+            $start_name));
+      }
+    }
+
+
+    $end_str = $saved_query->getParameter($end_key);
+    $end = null;
+    if (strlen($end_str)) {
+      $end = $this->parseDateTime($end_str);
+      if (!$end) {
+        $this->addError(
+          pht(
+            '"%s" date can not be parsed.',
+            $end_name));
+      }
+    }
+
+    if ($start && $end && ($start >= $end)) {
+      $this->addError(
+        pht(
+          '"%s" must be a date before "%s".',
+          $start_name,
+          $end_name));
+    }
+
+    $form
+      ->appendChild(
+        id(new PHUIFormFreeformDateControl())
+          ->setName($start_key)
+          ->setLabel($start_name)
+          ->setValue($start_str))
+      ->appendChild(
+        id(new AphrontFormTextControl())
+          ->setName($end_key)
+          ->setLabel($end_name)
+          ->setValue($end_str));
   }
 }

src/infrastructure/storage/patch/PhabricatorBuiltinPatchList.php

···
         'type' => 'php',
         'name' => $this->getPatchPath('20130530.sessionhash.php'),
       ),
+      '20130530.macrodatekey.sql' => array(
+        'type' => 'sql',
+        'name' => $this->getPatchPath('20130530.macrodatekey.sql'),
+      ),
     );
   }
 }

src/view/form/control/PHUIFormFreeformDateControl.php

···
+<?php
+
+final class PHUIFormFreeformDateControl extends AphrontFormControl {
+
+  protected function getCustomControlClass() {
+    return 'aphront-form-control-text';
+  }
+
+  protected function renderInput() {
+    return javelin_tag(
+      'input',
+      array(
+        'type'         => 'text',
+        'name'         => $this->getName(),
+        'value'        => $this->getValue(),
+        'disabled'     => $this->getDisabled() ? 'disabled' : null,
+        'id'           => $this->getID(),
+      ));
+  }
+
+}