Helper to make batching easier

[naxoc]

Inspired by frustration with internet connection cutting out and trying to navigate running scripts with start and end. It's super hard to keep track of what ran and what didn't in that case.

This thingy doesn't run anything, but outputs a bunch of commands that can be pasted in a file and then run one by one or in multiple terminals.

How to test

• With some command that supports from and to run like this:

  wp newspack-content-migrator migration-helper-output-batched \
  "wp newspack-content-migrator some-command --some-arg=horse --other-arg=goat" \
  --total-items=122 --batch-size=60

• You need to know how many items you are running (or choose a random number high enough).

• If your command doesn't use the BatchLogic class, you can pass the name of the from and to like this: --start-arg-name=index-from --end-arg-name=index-to

• If you need to start a ways in you can pass --begin-at=<some-number>.

You will get an output like this that you can copy paste from:

# MigrationHelper: Batch 1 of 3
wp newspack-content-migrator some-command \
--some-arg=horse \
--other-arg=goat \
 --end=60

# MigrationHelper: Batch 2 of 3
wp newspack-content-migrator some-command \
--some-arg=horse \
--other-arg=goat \
 --start=60 --end=120

# MigrationHelper: Batch 3 of 3
wp newspack-content-migrator some-command \
--some-arg=horse \
--other-arg=goat \
 --start=120

Todo

• [x] Better documentation
• [x] Better processing of the passed command. It works, but might botch stuff with whitespace in unexpected places

---

• [x] confirmed that PHPCS has been run

[naxoc]

Thanks @eddiesshop ! I cleaned it up a tiny bit more and I'm merging it now. I can come back to the whitespace issue. It will only ever be an issue if we pass args that have a quoted string with whitespace. Something like --site-title="My Site" or similar would trigger it. I'm not pressed since this is not an actual command.