github2gerrit 0.1.9__py3-none-any.whl → 0.1.11__py3-none-any.whl

{github2gerrit-0.1.9.dist-info → github2gerrit-0.1.11.dist-info}/METADATA

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: github2gerrit
-Version: 0.1.9
+Version: 0.1.11
 Summary: Submit a GitHub pull request to a Gerrit repository.
-Author-email: Matthew Watkins <mwatkins@linuxfoundation.org>
-License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/lfreleng-actions/github2gerrit
 Project-URL: Repository, https://github.com/lfreleng-actions/github2gerrit
 Project-URL: Issues, https://github.com/lfreleng-actions/github2gerrit/issues
-Keywords: github,gerrit,ci,actions,typer,cli
+Author-email: Matthew Watkins <mwatkins@linuxfoundation.org>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: actions,ci,cli,gerrit,github,typer
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -20,23 +21,23 @@ Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Version Control
 Classifier: Typing :: Typed
 Requires-Python: <3.14,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typer>=0.12.5
-Requires-Dist: PyGithub>=2.3.0
-Requires-Dist: pygerrit2>=2.0.0
 Requires-Dist: git-review>=2.3.1
-Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: pygerrit2>=2.0.0
+Requires-Dist: pygithub>=2.3.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.5
 Provides-Extra: dev
-Requires-Dist: pytest>=8.3.2; extra == "dev"
-Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
-Requires-Dist: coverage[toml]>=7.6.1; extra == "dev"
-Requires-Dist: ruff>=0.6.3; extra == "dev"
-Requires-Dist: mypy>=1.11.2; extra == "dev"
-Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
-Requires-Dist: types-requests>=2.31.0; extra == "dev"
-Requires-Dist: types-click>=7.1.8; extra == "dev"
-Dynamic: license-file
+Requires-Dist: coverage[toml]>=7.6.1; extra == 'dev'
+Requires-Dist: mypy>=1.11.2; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.2; extra == 'dev'
+Requires-Dist: responses>=0.25.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.3; extra == 'dev'
+Requires-Dist: types-click>=7.1.8; extra == 'dev'
+Requires-Dist: types-requests>=2.31.0; extra == 'dev'
+Description-Content-Type: text/markdown
 
 <!--
 SPDX-License-Identifier: Apache-2.0
@@ -140,6 +141,27 @@ with:
 When allowed, duplicates generate warnings but processing continues.
 The tool exits with code 3 when it detects duplicates and they are not allowed.
 
+### Configuring duplicate detection scope
+
+By default, the duplicate detector considers changes with status `open` when searching for potential duplicates.
+You can customize which Gerrit change states to check using `--duplicate-types` or setting `DUPLICATE_TYPES`:
+
+```bash
+# CLI usage - check against open and merged changes
+github2gerrit --duplicate-types=open,merged https://github.com/org/repo
+
+# Environment variable
+DUPLICATE_TYPES=open,merged,abandoned github2gerrit https://github.com/org/repo
+
+# GitHub Actions
+uses: onap/github2gerrit@main
+with:
+  DUPLICATE_TYPES: 'open,merged'
+```
+
+Valid change states include `open`, `merged`, and `abandoned`. This setting determines which existing changes
+to check when evaluating whether a new change would be a duplicate.
+
 ## Commit Message Normalization
 
 The tool includes intelligent commit message normalization that automatically
@@ -309,6 +331,8 @@ jobs:
           ORGANIZATION: ${{ github.repository_owner }}
           REVIEWERS_EMAIL: ""
           ISSUE_ID: ""  # Optional: adds 'Issue-ID: ...' trailer to the commit message
+          # ISSUE_ID_LOOKUP: ${{ vars.ISSUE_ID_LOOKUP }}  # Optional: enable JSON lookup
+          # ISSUE_ID_LOOKUP_JSON: ${{ vars.ISSUE_ID_LOOKUP_JSON }}  # Optional: JSON lookup table
 ```
 
 The action reads `.gitreview`. If `.gitreview` is absent, you must
@@ -368,6 +392,7 @@ Key options include:
 - `--use-pr-as-commit`: Use PR title/body as commit message (`USE_PR_AS_COMMIT`)
 - `--issue-id`: Add an Issue-ID trailer (e.g., "Issue-ID: ABC-123") to the commit message (`ISSUE_ID`)
 - `--preserve-github-prs`: Don't close GitHub PRs after submission (`PRESERVE_GITHUB_PRS`)
+- `--duplicate-types`: Configure which Gerrit change states to check for duplicates (`DUPLICATE_TYPES`)
 
 For a complete list of all available options, see the [Inputs](#inputs) section.
 
@@ -403,13 +428,15 @@ Common issues and solutions:
 
 2. **SSH Permission Denied**:
    - Ensure `GERRIT_SSH_PRIVKEY_G2G` and `GERRIT_KNOWN_HOSTS` are properly set
-   - If you see "Permissions 0644 for 'gerrit_key' are too open", the action will automatically try SSH agent
-     authentication
+   - If you see "Permissions 0644 for 'gerrit_key' are too open", the action will automatically
+     try SSH agent authentication
    - For persistent file permission issues, ensure `G2G_USE_SSH_AGENT=true` (default)
 
 3. **Branch Not Found**: Check that the target branch exists in both GitHub and Gerrit
 4. **Change-Id Issues**: Enable debug logging to see Change-Id generation and validation
-5. **Gerrit API Errors**: Verify Gerrit server connectivity and project permissions
+5. **Account Not Found Errors**: If you see "Account '<Email@Domain.com>' not found",
+   ensure your Gerrit account email matches your git config email (case-sensitive).
+6. **Gerrit API Errors**: Verify Gerrit server connectivity and project permissions
 
 > **Note**: The tool displays configuration errors cleanly without Python tracebacks.
 > If you see a traceback in the output, please report it as a bug.
@@ -592,8 +619,10 @@ alignment between action inputs, environment variables, and CLI flags:
 | `ALLOW_DUPLICATES` | `ALLOW_DUPLICATES` | `--allow-duplicates` | No | `"false"` | Allow submitting duplicate changes without error |
 | `CI_TESTING` | `CI_TESTING` | `--ci-testing` | No | `"false"` | Enable CI testing mode (overrides .gitreview) |
 | `ISSUE_ID` | `ISSUE_ID` | `--issue-id` | No | `""` | Issue ID to include (e.g., ABC-123) |
+| `ISSUE_ID_LOOKUP` | N/A | N/A | No | `"false"` | Enable Issue ID lookup via JSON table |
+| `ISSUE_ID_LOOKUP_JSON` | N/A | N/A | No | `"{}"` | JSON mapping of GitHub actors to Issue IDs |
 | `G2G_USE_SSH_AGENT` | `G2G_USE_SSH_AGENT` | N/A | No | `"true"` | Use SSH agent for authentication |
-| `DUPLICATES` | `DUPLICATES` | `--duplicates` | No | `"open"` | Comma-separated Gerrit statuses for duplicate detection |
+| `DUPLICATE_TYPES` | `DUPLICATE_TYPES` | `--duplicate-types` | No | `"open"` | Comma-separated Gerrit change states to check for duplicate detection |
 | `GERRIT_SERVER` | `GERRIT_SERVER` | `--gerrit-server` | No² | `""` | Gerrit server hostname (auto-derived if enabled) |
 | `GERRIT_SERVER_PORT` | `GERRIT_SERVER_PORT` | `--gerrit-server-port` | No | `"29418"` | Gerrit SSH port |
 | `GERRIT_PROJECT` | `GERRIT_PROJECT` | `--gerrit-project` | No² | `""` | Gerrit project name |
@@ -604,7 +633,7 @@ alignment between action inputs, environment variables, and CLI flags:
 
 **Notes:**
 
-1. Auto-derived when `G2G_ENABLE_DERIVATION=true` (default: false in GitHub Actions, true in CLI)
+1. Auto-derived when `G2G_ENABLE_DERIVATION=true` (default: true in all contexts)
 2. Optional if `.gitreview` file exists in repository
 
 ### Internal Environment Variables
@@ -614,7 +643,7 @@ The following environment variables control internal behavior but are not action
 | Environment Variable | Description | Default |
 |---------------------|-------------|---------|
 | `G2G_LOG_LEVEL` | Logging level (DEBUG, INFO, WARNING, ERROR) | `"INFO"` |
-| `G2G_ENABLE_DERIVATION` | Enable auto-derivation of Gerrit parameters | `"false"` (GitHub Actions), `"true"` (CLI) |
+| `G2G_ENABLE_DERIVATION` | Enable auto-derivation of Gerrit parameters | `"true"` |
 | `G2G_CONFIG_PATH` | Path to organization configuration file | `~/.config/github2gerrit/config.ini` |
 | `G2G_AUTO_SAVE_CONFIG` | Auto-save derived parameters to config | `"false"` (GitHub Actions), `"true"` (CLI) |
 | `G2G_TARGET_URL` | Internal flag for direct URL mode | Set automatically |
@@ -680,6 +709,51 @@ variable.
 **Note**: Unknown configuration keys will generate warnings to help catch typos
 and missing functionality.
 
+### Issue ID Lookup
+
+> **Migration Note**: If you were using repository variables `ISSUE_ID_LOOKUP`
+> and `ISSUE_ID_LOOKUP_JSON` directly, you now need to pass them as inputs to
+> the action. See the example below.
+
+The action supports automatic Issue ID resolution via JSON lookup when no
+explicit `ISSUE_ID` exists:
+
+```yaml
+- uses: lfreleng-actions/github2gerrit-action@v1
+  with:
+    GERRIT_SSH_PRIVKEY_G2G: ${{ secrets.GERRIT_SSH_PRIVKEY_G2G }}
+    # Enable Issue ID lookup (pass repository variables as inputs)
+    ISSUE_ID_LOOKUP: ${{ vars.ISSUE_ID_LOOKUP }}
+    ISSUE_ID_LOOKUP_JSON: ${{ vars.ISSUE_ID_LOOKUP_JSON }}
+    # ... other inputs
+```
+
+**Setup Requirements:**
+
+1. Set repository variables:
+   - `ISSUE_ID_LOOKUP`: `"true"` (enables lookup feature)
+   - `ISSUE_ID_LOOKUP_JSON`: JSON mapping of GitHub usernames to Issue IDs
+
+2. **Example JSON format:**
+
+   ```json
+   {
+     "dependabot[bot]": "AUTO-123",
+     "renovate[bot]": "AUTO-456",
+     "alice": "PROJ-789",
+     "bob": "PROJ-101"
+   }
+   ```
+
+**Lookup Logic:**
+
+1. If `ISSUE_ID` input exists → use it directly
+2. If `ISSUE_ID` is empty AND `ISSUE_ID_LOOKUP=true` → lookup using `github.actor`
+3. If lookup fails → no Issue ID gets added (silent fallback)
+
+This feature helps organizations automatically tag commits with
+project-specific Issue IDs based on who creates the pull request.
+
 ## Behavior details
 
 - Branch resolution

github2gerrit-0.1.11.dist-info/RECORD

@@ -0,0 +1,31 @@
+github2gerrit/__init__.py,sha256=N1Vj1HJ28LKCJLAynQdm5jFGQQAz9YSMzZhEfvbBgow,886
+github2gerrit/cli.py,sha256=iI-e229TOuDKEA9NJ7mDTLr96aJDuRnEnCOXJ4l645k,65285
+github2gerrit/commit_normalization.py,sha256=5HqUJ7p3WQzUYNTkganIsu82aW1wZrh7J7ivQvdCYXw,17033
+github2gerrit/config.py,sha256=khuXAfmOc2wqO4r1Cpp8PYk04AO-JpmnJvSWQZ3fdL8,22315
+github2gerrit/core.py,sha256=bu65-_fJ53Nd2P9FeYt0iIeAEI8t3Yd6db8J1ZAQCLk,147167
+github2gerrit/duplicate_detection.py,sha256=FaYtftmABdNofdZIi-kfgI4DlWvfvDS87gLj7hx0Jvo,29152
+github2gerrit/external_api.py,sha256=9483kkgIs1ECOl_f0lcGb8GrJQF9IfYmWfBQwUJT9hk,18480
+github2gerrit/gerrit_query.py,sha256=7AR9UEwZxtTb9V-l17UDdtWvlvROlnIeJVMa57ilf6s,8343
+github2gerrit/gerrit_rest.py,sha256=Yv1a0vqEuP1dvx16AB6BKSOb01o3FfOxEVzRzTND6gE,11009
+github2gerrit/gerrit_urls.py,sha256=aoPuUOCysHffVr9qkBRIPCZEUoSBMHmfviydy1U1uSQ,13843
+github2gerrit/github_api.py,sha256=3aexJhZy-YlodwX7YuLubaZAa2qR8OOcgRwrZHK_a_g,8565
+github2gerrit/gitutils.py,sha256=yNV1Nxa5VVYItc9DuNf5xLmwu-OBzwMANxYV151fpqk,26456
+github2gerrit/mapping_comment.py,sha256=5d37Xtqa7yU9PqIpjMrvPpNfHqdomtJJhs2exqRM8e0,9597
+github2gerrit/models.py,sha256=oOznuagfEXxvkiXRyLSB9h3CsWqmCjkPHPrat7AiMcs,2446
+github2gerrit/pr_content_filter.py,sha256=Brgf1HoGzdvQR5OrikuNCrbNout8kxwmds2AiHzEF6U,17990
+github2gerrit/reconcile_matcher.py,sha256=UpFAGqOD0NSKJKqKN_ErpNtqG0MEXxVEMywnKWcNnnI,20185
+github2gerrit/rich_display.py,sha256=hA2lXdbG3FOPozI_JTyU52o67oCS9LMUyc2odEpaAjo,15466
+github2gerrit/rich_logging.py,sha256=AEcPksmg2kj3eFOZHuU-_kWzGCKh-m__ZgDzwECBtaY,10281
+github2gerrit/similarity.py,sha256=-YHnscTrVh1jdfA3JRLPkbVjaZ5FpFdmXe8UPlTG1ss,15888
+github2gerrit/ssh_agent_setup.py,sha256=Wni94Zs86AVYalmVKfZ8lRzBnWybtJUwDltdpMC4Qnw,12864
+github2gerrit/ssh_common.py,sha256=ClABtIqXiYIfUn58Shw7uHZ6Ham1ysHn0EpcUHjQ8D8,8261
+github2gerrit/ssh_discovery.py,sha256=jz5sn8Eiehr1QtR8zDTyQ7dZ_w54WC8km8y0cDbHaDg,13496
+github2gerrit/trailers.py,sha256=9w0vIxPNBNQp56sIy-MF62d22Rm6vY-msh9ao1lX0rQ,8384
+github2gerrit/utils.py,sha256=1CKTsQo_FO3eyVjzNUT3XyFnyObIxyEFLeSmVKzavVo,3397
+github2gerrit/orchestrator/__init__.py,sha256=HAEcdCAHOFr8LsdIwAdcIcFZn_ayMbX9rdVUULp8410,864
+github2gerrit/orchestrator/reconciliation.py,sha256=qLhmjnIblSa_PVmBblWJ1gSvJ6Gto2AIVOVdYvT6zbk,18364
+github2gerrit-0.1.11.dist-info/METADATA,sha256=7sk9TSOqHuH00NaJQl3Sv6zUv66ZAr17BZZFb9Rn3iw,33833
+github2gerrit-0.1.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+github2gerrit-0.1.11.dist-info/entry_points.txt,sha256=MxN2_liIKo3-xJwtAulAeS5GcOS6JS96nvwOQIkP3W8,56
+github2gerrit-0.1.11.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+github2gerrit-0.1.11.dist-info/RECORD,,

{github2gerrit-0.1.9.dist-info → github2gerrit-0.1.11.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

github2gerrit-0.1.9.dist-info/RECORD

@@ -1,24 +0,0 @@
-github2gerrit/__init__.py,sha256=N1Vj1HJ28LKCJLAynQdm5jFGQQAz9YSMzZhEfvbBgow,886
-github2gerrit/cli.py,sha256=ClwCOtMl9eecobeN6Bb1GFQ_E-kbILdxKFE89Vtvai4,45865
-github2gerrit/commit_normalization.py,sha256=u4AZigz3qOpz5XYpUOq3WUqsY-o08YrkgaT160eyIIs,16594
-github2gerrit/config.py,sha256=uRVVcofzojTayA8AyM_3rgSFsV0fWGjixWmK48aZsRA,21471
-github2gerrit/core.py,sha256=Mjo_TNocFE5HDmRTxh54LEHAEw5y1u6lc1qItEZ76GA,105180
-github2gerrit/duplicate_detection.py,sha256=5j6EDz2P3GnnT2JkR1tGbzWCjA6TV0l5VjsEMs-tfCM,26544
-github2gerrit/external_api.py,sha256=EVHh__v6lRq_ojpBI_nkGZ31AQSZ9NG8tDqVUid23XY,17638
-github2gerrit/gerrit_rest.py,sha256=NmC95hb2hLpnko8Uu3OwPEKktNv-k3qrmuA7A2q-H0Y,10562
-github2gerrit/gerrit_urls.py,sha256=pw4rjIQeQ-i-vbPqsOZjZpdz7FO03pnMUMWc8L9Mcic,12893
-github2gerrit/github_api.py,sha256=6S9DRt-Dza78cgxQwZ3_ujI0yPPozDGBIKnYgHan760,8388
-github2gerrit/gitutils.py,sha256=3ob1K7dlKeWYYYOPXIIJ56p2N49lm1yj8XHHg2zSlhw,25929
-github2gerrit/models.py,sha256=sRS4rPMF_wjV19HMFTzhHXFMfsLFzm9TFb1JydJsSyQ,1875
-github2gerrit/pr_content_filter.py,sha256=w4MqSZ4uLX-3Da1DL_A56zVQa7xJ4h5jHMNteOOG2AE,16896
-github2gerrit/similarity.py,sha256=xPqdypI-Fmpeb74K4lcqZBxj17i8avS_x73dXckeicA,15268
-github2gerrit/ssh_agent_setup.py,sha256=fvKuMdF9Hv5ioaSu_alzLcjeoQLGGFRLS2wb46KdNzE,11889
-github2gerrit/ssh_common.py,sha256=f0QQmnj6yIW74N3ZjGkYmJryEstjEOmq41EIXOZdGTM,8102
-github2gerrit/ssh_discovery.py,sha256=zH0tX9VN1pn8DLM1J9QQquoKBhA9gk5drXHvMSHNNLg,13021
-github2gerrit/utils.py,sha256=ADE5YZe1h3PB3cgfxbsCuYU-Xs-1CMHrDHxfIdariFE,3369
-github2gerrit-0.1.9.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-github2gerrit-0.1.9.dist-info/METADATA,sha256=QlTEhsWuTU9Yxim1Z__-aMr6GcGWmBzpcczbqzEyBNU,31006
-github2gerrit-0.1.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-github2gerrit-0.1.9.dist-info/entry_points.txt,sha256=MxN2_liIKo3-xJwtAulAeS5GcOS6JS96nvwOQIkP3W8,56
-github2gerrit-0.1.9.dist-info/top_level.txt,sha256=bWTYXjvuu4sSU90KLT1JlnjD7xV_iXZ-vKoulpjLTy8,14
-github2gerrit-0.1.9.dist-info/RECORD,,

github2gerrit-0.1.9.dist-info/top_level.txt

@@ -1 +0,0 @@
-github2gerrit