[Pulp-dev] Breaking change (for plugin writers) announcement

[Daniel Alley]

We determined that there is a path for moving forwards which would be a
little more work (in the short term), but would preserve the deprecation
policy - so we are changing the plan described above and will instead be
maintaining the deprecation policy. It’s written into the epic (
https://pulp.plan.io/issues/8383 ) with most of the work happening in 3.12.
The timeline is being driven by auto-distribute being needed also in 3.12
and this work blocking that.

With the deprecation policy remaining intact, it is recommended for your
plugin releases compatible with 3.11 to also declare compatibility with
3.12.

On Thu, Mar 4, 2021 at 3:49 PM Daniel Alley <dalley at redhat.com> wrote:

> *tl;dr*
>
> 1. Plugins compatible with 3.11 should *not* declare compatibility with
> 3.12
> 2. Review the PR for your plugin below [0] and include it in your 3.12
> plugin compatibility release
>
> (PR review doesn't need to happen now, just in the next few weeks)
>
> *3.12 Plugin API Breaking Changes*
>
> In Pulpcore 3.12, which the release *after* the upcoming 3.11 release, we
> will be making a breaking change to Pulpcore which will require some
> intervention by plugin writers. This does not follow the deprecation
> policy; we tried very hard to look at other options, but after a lot of
> discussion this is the least disruptive approach.
>
> All plugins currently released should set their compatibility ceiling at
> <3.12, and all plugin releases after the change will need to set their
> compatibility floor to >= 3.12.
>
> *What you need to do:*
>
> Ensure your 3.11 compatibility releases don't declare compatibility with
> 3.12. Many plugins, including File, Container, Certguard, and Ansible
> already have a support ceiling set for 3.12 (or before). Other plugins such
> as RPM, Debian, Maven, don't have a support ceiling set. These should be
> added to pre-3.12-compatible releases.
>
> Then, for your 3.12 plugin compatibility releases, review the PR for your
> plugin below [0].
>
> Please feel free to reach out to me over email or IRC if you would like
> assistance with anything I've just discussed.
>
> [0] PRs:
>
> Pulpcore
> https://github.com/pulp/pulpcore/pull/1084
>
> Pulp File
> https://github.com/pulp/pulp_file/pull/467
>
> Pulp RPM
> https://github.com/pulp/pulp_rpm/pull/1938
>
> Pulp NPM
> https://github.com/pulp/pulp_npm/pull/71
>
> Pulp Container
> https://github.com/pulp/pulp_container/pull/249
>
> Pulp Ansible
> https://github.com/pulp/pulp_ansible/pull/527
>
> Pulp Python
> https://github.com/pulp/pulp_python/pull/329
>
> Pulp Debian
> https://github.com/pulp/pulp_deb/pull/248
>
> Pulp Maven and the 2to3 migration plugin
>
>    - No patches necessary
>
> Pulp Gem and Pulp Cookbook, and any other plugins not listed:
>
>    - I didn't make PRs, but I'd be happy to help anyone who does so
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/pulp-dev/attachments/20210315/59533ea8/attachment.htm>