Globus SDK version 3 now in beta!

[Stephen Rosen]

Hi everyone,

We've just released a new version of the Globus SDK, 3.0.0b1 ("beta one")

Please be aware that python packaging conventions will prevent this version from being installed unless you request it explicitly. That means that

    pip install globus-sdk

or

    pip install 'globus-sdk<4'

will still install globus-sdk version 2. To install the beta, use

    pip install 'globus-sdk==3.0.0b1'

= Should I upgrade now?

You don't need to upgrade right away, but you may want to.

Version 3 makes several incompatible changes, but also brings significant new features.

Not only is the beta period a great time for you to try out new functionality, but it's also an opportunity for us to adjust before we finalize version 3.0 .

Per our versioning policy, the SDK uses semantic versioning.

That means that once version 3.0 is finalized, we will not make backwards incompatible changes -- even if they would make the library better!

During the beta, we have more flexibility to consider backwards incompatible improvements.

= Upgrading

If you want to try v3, there are several known-incompatible changes.

These are documented with appropriate changes in our upgrading guide.

= What's new in version 3?

There are many changes in v3, so you'll have to read the changelog to see everything.

However, we'll highlight a few notable ones:

- New, built-in token storage to help manage logins

- SDK client objects now automatically retry failing requests (this behavior is customizable)

- The SDK now publishes type annotations (PEP 561), meaning your code can be type-checked using mypy

= How long will the beta last? Will there be multiple betas?

We do not have a timeline for the final version 3.0 yet, and will be evaluating this over the next few weeks.

One of the factors we'll be considering is the feedback we receive about the beta and whether or not any incompatible changes are needed.

We intend to release at least one more beta version with new features in the coming weeks. Our exact time to v3.0 will depend on when this happens and the kind of responses we receive.

= Where should I report feedback?

You can report any issues or ideas for the globus SDK in our public issue tracker:

https://github.com/globus/globus-sdk-python/issues

Or, email us at sup...@globus.org with any feedback about the beta!

Thanks,

-Stephen, and the rest of the Globus Team