Add newmode v2

[sharinetmc]

Creates a separate class for NewMode's v2 API since the existing v1 (and the python wrapper the existing NewMode sync is based on will be sunset nest February)

@shaunagm, definitely hoping to discuss Parsons deprecation process with you! Also, wondering if you think v2 should just go in its own folder?
Discussed with @willyraedy some options to go about this. This PR currently follows the 2nd option

1. so one way to do this is with versions so we publish a new version and people have to upgrade to the version of the package to get the new and only the new NewMode connector
2. the other way to do it is have latest have both and then do a deprecation process where like:
   NewMode and NewModeV2 are both available and people can update their code
   All users swap to NewModeV2
   Then you switch NewMode to be V2 as well so both NewMode and NewModeV2 are the v2 version
   All users swap back to NewMode
   Delete NewModeV2

[shaunagm]

Will the NewMode v1 API stop working in February?

[shaunagm]

Rather than creating a new connector with a different name that would have to be edited in lots of different scripts, can we set some kind of variable, either on the connector or at the global config level, that directs which connector to use under the hood?

I'm imagining something like:

class OldNewMode:
   ...

class NewNewMode:
  ...

if os.environ("UPDATE_NEWMODE_VERSION", "False"):
  class NewMode = NewNewMode
else:
  class NewMode = OldNewMode

So then people wouldn't need to change their scripts at all, just use an environmental variable, and then come Feb we just get rid of the OldNewMode entirely. Unless the old version will still be workable for a while...

I'm not 100% sure the above approach will work but it seems like it should?

[shaunagm]

Not sure if you wanted me to review the whole thing but I took a quick look, obviously the main thing is the deprecation process - happy to talk about this on a call if you'd prefer

[sharinetmc]

That sounds like an excellent idea, Shauna! Will make those changes! Also, yes, newmode v1 api will stop working in feburary.

[sharinetmc]

Marked this as ready for review @shaunagm, since I was able to get that last endpoint working! Happy to discuss versioning stuff further, though (specifically for how you think the best way to share with parsons community will be)!

[willyraedy]

Great start! Love all the doc strings and there is clearly a lot of detail you've worked through on formatting the requests correctly.

Big things to fix are (1) changing the state in the "get_campaign_ids" method and (2) a consistent return signature from the "converted_request" method. I'm gonna go look at the canales PR now to see how you may be handling the different return values in that script

[mirabuck]

Will the NewMode v1 API stop working in February?

We expect to shut it down completely on February 28th, 2025.

[willyraedy]

Some last thoughts on how to handle the wonkiness in the Campaigns endpoint but overall this looks good!

[jburchard]

I by red d

[sharinetmc]

@shaunagm, i think i'm still waiting on your approval for this!

[IanRFerguson]

minimal feedback from me! I think once @shaunagm signs off on this we can ship it

[shaunagm]

Looks good to me, sorry for the delay!

[IanRFerguson]

Nice work!