gerrit_client: changes: support raw search queries

The --param option does not support extended bool logic.  It forces
every search query to be AND-ed together.  There is no way to do more
OR joins or subclauses like "( X OR Y ) AND Z".

Let's add a new --query option to let people type out the full string
themselves rather than try and support this bool logic directly.

Bug: b/282975918
Test: ./gerrit_client.py changes --host https://chromium-review.googlesource.com --query '( owner:vapier OR owner:briannorris ) is:open project:chromiumos/chromite'
Change-Id: I792e4deec34797295824ec13da41f45eb85e65ae
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/tools/depot_tools/+/4638081
Reviewed-by: Greg Edelston <gredelston@google.com>
Commit-Queue: Gavin Mak <gavinmak@google.com>
Reviewed-by: Gavin Mak <gavinmak@google.com>
Auto-Submit: Mike Frysinger <vapier@chromium.org>

gerrit_client.py

@@ -203,8 +203,13 @@ def CMDheadinfo(parser, args):
 @subcommand.usage('[args ...]')
 def CMDchanges(parser, args):
   """Queries gerrit for matching changes."""
-  parser.add_option('-p', '--param', dest='params', action='append',
+  parser.add_option('-p',
+                    '--param',
+                    dest='params',
+                    action='append',
+                    default=[],
                     help='repeatable query parameter, format: -p key=value')
+  parser.add_option('--query', help='raw gerrit search query string')
   parser.add_option('-o', '--o-param', dest='o_params', action='append',
                     help='gerrit output parameters, e.g. ALL_REVISIONS')
   parser.add_option('--limit', dest='limit', type=int,
@@ -214,12 +219,14 @@ def CMDchanges(parser, args):
                          '(starting with the most recent)')
 
   (opt, args) = parser.parse_args(args)
+  assert opt.params or opt.query, '--param or --query required'
   for p in opt.params:
     assert '=' in p, '--param is key=value, not "%s"' % p
 
   result = gerrit_util.QueryChanges(
       urlparse.urlparse(opt.host).netloc,
       list(tuple(p.split('=', 1)) for p in opt.params),
+      first_param=opt.query,
       start=opt.start,  # Default: None
       limit=opt.limit,  # Default: None
       o_params=opt.o_params,  # Default: None

tests/gerrit_client_test.py

@@ -50,12 +50,53 @@ class TestGerritClient(unittest.TestCase):
         'changes', '--host', 'https://example.org/foo', '-p', 'foo=bar', '-p',
         'baz=qux', '--limit', '10', '--start', '20', '-o', 'op1', '-o', 'op2'
     ])
-    util_mock.assert_called_once_with(
-        'example.org', [('foo', 'bar'), ('baz', 'qux')],
+    util_mock.assert_called_once_with('example.org', [('foo', 'bar'),
+                                                      ('baz', 'qux')],
+                                      first_param=None,
                                       limit=10,
                                       start=20,
                                       o_params=['op1', 'op2'])
 
+  @mock.patch('gerrit_util.QueryChanges', return_value='')
+  def test_changes_query(self, util_mock):
+    gerrit_client.main([
+        'changes',
+        '--host',
+        'https://example.org/foo',
+        '--query',
+        'is:owner is:open',
+        '--limit',
+        '10',
+        '--start',
+        '20',
+    ])
+    util_mock.assert_called_once_with('example.org', [],
+                                      first_param='is:owner is:open',
+                                      limit=10,
+                                      start=20,
+                                      o_params=None)
+
+  @mock.patch('gerrit_util.QueryChanges', return_value='')
+  def test_changes_params_query(self, util_mock):
+    gerrit_client.main([
+        'changes',
+        '--host',
+        'https://example.org/foo',
+        '--query',
+        'is:owner is:open',
+        '-p',
+        'foo=bar',
+        '--limit',
+        '10',
+        '--start',
+        '20',
+    ])
+    util_mock.assert_called_once_with('example.org', [('foo', 'bar')],
+                                      first_param='is:owner is:open',
+                                      limit=10,
+                                      start=20,
+                                      o_params=None)
+
   @mock.patch('gerrit_util.GetRelatedChanges', return_value='')
   def test_relatedchanges(self, util_mock):
     gerrit_client.main([