Hi all,
One of the sites using/maintaining API compatibility tools actually
already compares adjacent versions of Accumulo.
https://abi-laboratory.pro/index.php?view=timeline&lang=java&l=accumulo
That page shows some of the high-level aggregate info and shows that
many Accumulo minor releases and bug fixes are quite likely
binary/source compatible.
For the 1.10-2.0 jump, there's a page laying out all the changes:
https://abi-laboratory.pro/index.php?view=compat_report&lang=java&l=accumulo&v1=1.10.1&v2=2.0.0&obj=c059d&kind=bin
Since the tool is open source, one can run it manually to evaluate /
compare two jars. I've used it here and there when releasing other open
sources projects to get a sense of any delta in the API.
Cheers,
Jim
On 10/25/21 2:09 PM, Christopher wrote:
Thanks Dave. It'd be really great if that plugin allowed us to filter
out removals of things previously deprecated. Its options seem limited
in that way.
On Fri, Oct 22, 2021 at 8:03 AM Dave Marion <dmario...@gmail.com> wrote:
I created a simple maven pom file that when run with *mvn clean package* will
generate a report that shows the differences in the public API between
2.0.0 and 1.10.0.
https://gist.github.com/dlmarion/b1063c334d519f637cc78d81ba9e15ef
On Wed, Oct 20, 2021 at 6:20 PM Jeremy Kepner <kep...@ll.mit.edu> wrote:
Seeme like there should be document that is kept whereby everytime a
breaking change is made it gets documented at the time it is committed.
On Wed, Oct 20, 2021 at 04:55:42PM -0400, Christopher wrote:
If somebody were to volunteer to create such a document, they could do so
from some of the many 3rd party java API comparison tools. I'm not sure
which tool would work best for this purpose, though.
If anybody does this, let us know which one worked best for you. We could
also amend the release notes with whatever you find. That could be
useful.
On Wed, Oct 20, 2021, 15:14 Jeremy Kepner <kep...@ll.mit.edu> wrote:
There should be a document that clearly states 1.10 functions will not
work in 2.0
so folks can grep their code to check. Otherwise you have to install
2.0
and then just
work through the errors one-by-one.
On Tue, Oct 19, 2021 at 11:17:09AM -0400, Christopher wrote:
The best reference is the release notes:
https://accumulo.apache.org/release/accumulo-2.0.0/
On Tue, Oct 19, 2021, 09:15 Jeremy Kepner <kep...@ll.mit.edu> wrote:
Is there a list of things in 1.10 that will no longer work in 2.0.
On Tue, Oct 19, 2021 at 08:59:58AM -0400, Christopher wrote:
Hi Vincent,
To supplement what Mike said, it's possible some stuff that was
deprecated in 1.10 was dropped in 2.0. I don't have a
comprehensive
list of what that might include, but anything marked as
deprecated in
1.10 is subject to removal in 2.0. If I recall, we did try to
limit
it
somewhat. It wouldn't really make sense to create a shim to
restore
those APIs, though, because that would just reintroduce code we
explicitly dropped, which defeats the purpose of a major version
bump.
In semantic versioning, the entire point of a major version bump
is
to
declare a break in the backwards compatibility of the public API.
If you need the code that was dropped, you probably aren't ready
to
move to 2.x. 1.10 is an LTM release, so that means we intend to
keep
patching important bugs until a year after our next LTM (which
hasn't
yet been released). So, if you need to stay on 1.10, you have
plenty
of time to update your code to stop using deprecated APIs and
avoid
non-public APIs.
On Tue, Oct 19, 2021 at 8:10 AM Mike Miller <mmil...@apache.org>
wrote:
If the library was written using only the public API then it
shouldn't
be a
problem. See https://accumulo.apache.org/api/
Accumulo follows SemVer to maintain compatibility of the
public API
between
versions. There are a lot of changes between 1.10 and 2.0 but
anything
in
the public API in 1.10 should still exist in 2.0, even if
deprecated.
If the library is calling internal methods or extending
internal
classes,
then that is a different story. If it uses internals then I
recommend
refactoring to use the public API if possible.
On Mon, Oct 18, 2021 at 3:38 PM Vincent Russell <
vincent.russ...@gmail.com>
wrote:
Hello,
I am interested in using an accumulo query and storage
library
that
was
written against accumulo version 1.10 and I am interested in
using
it with
accumulo 2.0.
Is there a shim that exists that would allow the library to
be
used
for
both versions that could be activated at compile time via a
maven
profile
or something?
Thanks,
Vincent
