b4: initial patchwork integration support

b4: initial patchwork integration support

[Konstantin Ryabitsev]

Hello, all:

I know some of you use patchwork alongside b4, so if you're already a heavy
"b4 ty" user, you can also have it set patchwork state of those patches.

What you will need:

1. latest b4 master branch
2. a patchwork project (obviously)
3. a patchwork API token (obtained from your profile page)

To enable the integration, add the following config in the relevant repo:

    [b4]
      pw-key = your_api_token_here
      pw-url = https://patchwork.kernel.org
      pw-project = your-project (e.g. linux-usb)
      pw-review-state = under-review
      pw-accept-state = accepted
      pw-discard-state = deferred

Explanation of states:

pw-review-state: will be applied to patches when you retrieve them with
am/shazam/pr subcommands. E.g.:

    $ b4 am -o/tmp https://patchwork.kernel.org/project/linux-usb/patch/20220613095957.1669829-1-xji@analogixsemi.com/
    Grabbing thread from lore.kernel.org/all/20220613095957.1669829-1-xji%40analogixsemi.com/t.mbox.gz
    Analyzing 5 messages in the thread
    Checking attestation on all messages, may take a moment...
    ---
      ✓ [PATCH v10 1/3] usb: typec: tcpci: move tcpci.h to include/linux/usb/
        + Reviewed-by: Guenter Roeck <linux@roeck-us.net> (✓ DKIM/gmail.com)
      ✓ [PATCH v10 2/3] dt-bindings: usb: Add analogix anx7411 PD binding
      ✓ [PATCH v10 3/3] usb: typec: anx7411: Add Analogix PD ANX7411 support
      ---
      ✓ Signed: DKIM/analogixsemi.onmicrosoft.com (From: xji@analogixsemi.com)
    ---
    Total patches: 3
    ---
     Link: https://lore.kernel.org/r/20220613095957.1669829-1-xji@analogixsemi.com
     Base: applies clean to current tree
           git checkout -b v10_20220613_xji_analogixsemi_com HEAD
           git am /tmp/v10_20220613_xji_usb_typec_tcpci_move_tcpci_h_to_include_linux_usb.mbx
    ---
    Patchwork: setting state on patchwork.kernel.org/linux-usb
     -> under-review : [v10,1/3] usb: typec: tcpci: move tcpci.h to include/linux/usb/
     -> under-review : [v10,2/3] dt-bindings: usb: Add analogix anx7411 PD binding
     -> under-review : [v10,3/3] usb: typec: anx7411: Add Analogix PD ANX7411 support

pw-accept-state: will be applied when you run "b4 ty" (with -t or -a). E.g.:

    $ b4 ty -a
    Auto-thankanating commits in usb-next
    Found 3 of your commits since 1.week
    Calculating patch hashes, may take a moment...
      Located: [PATCH v10 1/3] usb: typec: tcpci: move tcpci.h to include/linux/usb/
    ---
    Generating 1 thank-you letters
      Writing: ./xji_analogixsemi_com_patch_v10_1_3_usb_typec_tcpci_move_tcpci_h_to_include_linux_usb_.thanks
    ---
    Patchwork: setting state on patchwork.kernel.org/linux-usb
     -> accepted : [v10,1/3] usb: typec: tcpci: move tcpci.h to include/linux/usb/
     -> accepted : [v10,2/3] dt-bindings: usb: Add analogix anx7411 PD binding
     -> accepted : [v10,3/3] usb: typec: anx7411: Add Analogix PD ANX7411 support
    ---
    You can now run:
      git send-email ./*.thanks

Note: it also works with "b4 ty -S" and won't do anything in --dry-run mode.

pw-discard-state: will be applied if you run "b4 ty -d". E.g.:

    $ b4 ty -d 24
    Discarding 1 messages
      Discarded: [PATCH] USB: serial: option: add Quectel EM05-G modem
    ---
    Patchwork: setting state on patchwork.kernel.org/linux-usb
     -> deferred : USB: serial: option: add Quectel EM05-G modem

You can also override the configured default state with the --pw-set-state
switch to "b4 ty", e.g.:

    $ b4 ty -d 24 --pw-set-state rejected
    Discarding 1 messages
      Discarded: [PATCH] USB: serial: option: add Quectel EM05-G modem
    ---
    Patchwork: setting state on patchwork.kernel.org/linux-usb
     -> rejected : USB: serial: option: add Quectel EM05-G modem


Please give it a whirl and report any explosions or wrongness.

-K