git-gerrit 2.1.0__tar.gz → 3.0.0__tar.gz

{git_gerrit-2.1.0/git_gerrit.egg-info → git_gerrit-3.0.0}/PKG-INFO

@@ -1,22 +1,29 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: git_gerrit
-Version: 2.1.0
+Version: 3.0.0
 Summary: Gerrit review system command line tools.
 Home-page: https://github.com/meffie/git-gerrit
 Author: Michael Meffie
 Author-email: mmeffie@sinenomine.net
-License: BSD
+License: BSD-2-Clause
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: POSIX
-Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development
 License-File: LICENSE.txt
 Requires-Dist: sh
 Requires-Dist: pygerrit2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
 
 git-gerrit
 ==========
@@ -27,7 +34,7 @@ with the **pygerrit2** package to access the Gerrit REST API.
 
 .. _Gerrit code review system: https://www.gerritcodereview.com/
 
-**git-gerrit** is compatible with Python 2 and Python 3.
+**git-gerrit** is requires Python 3.9 or later.
 
 Commands
 ========
@@ -40,9 +47,10 @@ Commands
     git gerrit-help              List commands.
     git gerrit-install-hooks     Install git hooks to create gerrit change-ids.
     git gerrit-log               Show oneline log with gerrit numbers.
+    git gerrit-number            Show info for a gerrit change number.
     git gerrit-query             Search gerrit.
+    git gerrit-sync              Fetch all changes and update the local database.
     git gerrit-update            Update gerrits matching search terms.
-    git gerrit-unpicked          Find gerrit numbers on upstream branch not cherry picked.
     git gerrit-version           Print version and exit.
 
 Installation
@@ -124,7 +132,7 @@ Find gerrits with subjects containing the term 'debuginfo'::
 
 Find the branch names of gerrits with the subject containing the term 'debuginfo'::
 
-    $ git gerrit-query --format='{branch:>20s} {_number} {subject}' debuginfo
+    $ git gerrit-query --format='{branch:>20s} {number} {subject}' debuginfo
                   master 13030 redhat: Make separate debuginfo for kmods work with recent rpm
     openafs-stable-1_6_x 13029 redhat: Create unique debuginfo packages for kmods
     openafs-stable-1_6_x 12818 redhat: separate debuginfo package for kmod rpm
@@ -151,7 +159,7 @@ Checkout a gerrit by number::
 
 Cherry-pick a gerrit onto the current branch::
 
-    $ git gerrit-fetch --no-branch 13001 && git cherry-pick FETCH_HEAD
+    $ git gerrit-fetch 13001 && git cherry-pick FETCH_HEAD
 
 Show gerrit numbers in the checked out branch in the local git repo::
 
@@ -181,15 +189,6 @@ Show just the gerrit numbers and subjects in the local git repo::
     12957: afs: squash empty declaration warning
     12955: libafs: git ignore build artifacts on Solaris
 
-Show the commits on the master branch which have not been cherry-picked on to
-the stable branch. (Gerrits may already exists for them.)::
-
-    $ git gerrit-unpicked -u origin/master origin/openafs-stable-1_8_x
-    13656 4eeed830fa31b7b8b5487ba619acbc8d30642aaa afscp: Link against opr/roken/hcrypto
-    13659 f5f59cd8d336b153e2b762bb7afd16e6ab1b1ee2 util: serverLog using memory after free
-    13665 1210a8d6d96db2d84595d35ef81ec5d176de05e8 LINUX: Run the 'sparse' checker if available
-    ...
-
 Add reviewers to the **foobar** topic::
 
     $ git gerrit-update --add-reviewer="ty@example.com" branch:master is:open topic:foobar

{git_gerrit-2.1.0 → git_gerrit-3.0.0}/README.rst

@@ -7,7 +7,7 @@ with the **pygerrit2** package to access the Gerrit REST API.
 
 .. _Gerrit code review system: https://www.gerritcodereview.com/
 
-**git-gerrit** is compatible with Python 2 and Python 3.
+**git-gerrit** is requires Python 3.9 or later.
 
 Commands
 ========
@@ -20,9 +20,10 @@ Commands
     git gerrit-help              List commands.
     git gerrit-install-hooks     Install git hooks to create gerrit change-ids.
     git gerrit-log               Show oneline log with gerrit numbers.
+    git gerrit-number            Show info for a gerrit change number.
     git gerrit-query             Search gerrit.
+    git gerrit-sync              Fetch all changes and update the local database.
     git gerrit-update            Update gerrits matching search terms.
-    git gerrit-unpicked          Find gerrit numbers on upstream branch not cherry picked.
     git gerrit-version           Print version and exit.
 
 Installation
@@ -104,7 +105,7 @@ Find gerrits with subjects containing the term 'debuginfo'::
 
 Find the branch names of gerrits with the subject containing the term 'debuginfo'::
 
-    $ git gerrit-query --format='{branch:>20s} {_number} {subject}' debuginfo
+    $ git gerrit-query --format='{branch:>20s} {number} {subject}' debuginfo
                   master 13030 redhat: Make separate debuginfo for kmods work with recent rpm
     openafs-stable-1_6_x 13029 redhat: Create unique debuginfo packages for kmods
     openafs-stable-1_6_x 12818 redhat: separate debuginfo package for kmod rpm
@@ -131,7 +132,7 @@ Checkout a gerrit by number::
 
 Cherry-pick a gerrit onto the current branch::
 
-    $ git gerrit-fetch --no-branch 13001 && git cherry-pick FETCH_HEAD
+    $ git gerrit-fetch 13001 && git cherry-pick FETCH_HEAD
 
 Show gerrit numbers in the checked out branch in the local git repo::
 
@@ -161,15 +162,6 @@ Show just the gerrit numbers and subjects in the local git repo::
     12957: afs: squash empty declaration warning
     12955: libafs: git ignore build artifacts on Solaris
 
-Show the commits on the master branch which have not been cherry-picked on to
-the stable branch. (Gerrits may already exists for them.)::
-
-    $ git gerrit-unpicked -u origin/master origin/openafs-stable-1_8_x
-    13656 4eeed830fa31b7b8b5487ba619acbc8d30642aaa afscp: Link against opr/roken/hcrypto
-    13659 f5f59cd8d336b153e2b762bb7afd16e6ab1b1ee2 util: serverLog using memory after free
-    13665 1210a8d6d96db2d84595d35ef81ec5d176de05e8 LINUX: Run the 'sparse' checker if available
-    ...
-
 Add reviewers to the **foobar** topic::
 
     $ git gerrit-update --add-reviewer="ty@example.com" branch:master is:open topic:foobar

git_gerrit-3.0.0/git_gerrit/__init__.py

@@ -0,0 +1,62 @@
+# Copyright (c) 2018-2024 Sine Nomine Associates
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice, this
+#    list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS' AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+"""
+Git helpers for the Gerrit code review system, with an emphasis on the Gerrit
+old-style numeric identifiers.
+"""
+
+from git_gerrit.__version__ import VERSION
+from git_gerrit.git import Git
+from git_gerrit.error import (
+    GitGerritError,
+    GitGerritConfigError,
+    GitGerritFormatError,
+    GitGerritNotFoundError,
+)
+from git_gerrit.core import (
+    CHANGE_FIELDS,
+    LOG_FIELDS,
+    cherry_pick,
+    fetch,
+    get_current_change,
+    log,
+    query,
+    sync,
+    update,
+)
+
+_hush_linter = [
+    VERSION,
+    CHANGE_FIELDS,
+    LOG_FIELDS,
+    Git,
+    GitGerritError,
+    GitGerritConfigError,
+    GitGerritFormatError,
+    GitGerritNotFoundError,
+    cherry_pick,
+    fetch,
+    get_current_change,
+    log,
+    query,
+    sync,
+    update,
+]

git_gerrit-3.0.0/git_gerrit/__version__.py

@@ -0,0 +1 @@
+VERSION = "3.0.0"