Starting to work on Jackson 3.0 artifact/package renaming (com.fasterxml -> tools.jackson)

39 views
Skip to first unread message

Tatu Saloranta

unread,
Jul 10, 2022, 11:17:03 PM7/10/22
to jacks...@googlegroups.com
So, a quick update on my earlier email about the "Big Rename" for Jackson 3.0.
Details are found from:

https://github.com/FasterXML/jackson-future-ideas/wiki/JSTEP-1

(NOT JSTEP-6 as I earlier linked)

but basically the idea is that wherever "com.fasterxml." prefix is
used -- for Maven Group Id, Java package name -- Jackson 3.0 will
instead have "tools.jackson.
(the sole exception being `jackson-annotations` which will, for
backwards compatibility reasons, NOT be repackaged or migrated).

So what I will do next is to start actual renaming.

The very first step will be to try renaming/-basing `jackson-core` and
see how things go, including publishing of Maven snapshots, for which
I most likely will need to get help from Sonatype folks.

Once I managed to do this, the next, much bigger step, is to change
all the other packages that depend on `jackson-core` -- before
renaming/repackaging those modules.

And then I will keep on repeating these steps, recursively.

This means that if anyone is actually testing or developing current
3.0.0-SNAPSHOTs -- unlikely, I would think -- things may be in flux
for a while. I will try to send update notes to this list as things
progress and/or I make changes to plans based on learnings.

One other thing to note is that I have not yet decided on possible
renaming of artifact ids -- that is, should we have

tools.jackson.core:jackson-core

or

tools.jackson.core:jackson3-core

For now I assume the former so there is less to change. But I have not
yet decided that this is the final decision on artifact naming.

-+ Tatu +-

Tatu Saloranta

unread,
Jul 27, 2022, 6:23:29 PM7/27/22
to jacks...@googlegroups.com
Quick update: so far following Github repos have been updated:

* jackson-core (streaming): moved to "tools.jackson.core"
* jackson-databind: moved to "tools.jackson.core"
* jackson-jr: moved (tools.jackson.jr)
* jackson-dataformats-binary: moved (tools.jackson.dataformat)
* jackson-dataformats-text: moved (tools.jackson.dataformat)
* jackson-dataformat-xml: moved (tools.jackson.dataformat)
* jackson-datatype-joda (tools.jackson.datatype)
* jackson-modules-base (tools.jackson.module)
* jackson-modules-java8 (tools.jackson.module)

No changes:

* jackson-annotations: will remain as the only
"com.fasterxml.jackson.core" package for 2.x/3.x compatibility

To be changed:

* jackson-datatypes-collections
* jackson-datatypes-misc
* jackson-jaxrs-providers
* jackson-jakarta-rs-providers
* jackson-module-kotlin
* jackson-module-scala

No plans for 3.0 currently

* jackson-datatype-hibernate
* jackson-module-jsonSchema

This only covers FasterXML github repos; I may reach out to other
repos in future
(for BSON and MessagePack format modules for example)

-+ Tatu +-
> --
> You received this message because you are subscribed to the Google Groups "jackson-dev" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to jackson-dev...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/jackson-dev/CAL4a10hb0%2BXz0-UEuEF0s3aXSHtudWigqdT0DhuA0tp0c6woUA%40mail.gmail.com.

Tatu Saloranta

unread,
Aug 15, 2022, 2:42:04 PM8/15/22
to jacks...@googlegroups.com
Some more progress:

On Wed, Jul 27, 2022 at 3:23 PM Tatu Saloranta <tsalo...@gmail.com> wrote:
>
> Quick update: so far following Github repos have been updated:
>
> * jackson-core (streaming): moved to "tools.jackson.core"
> * jackson-databind: moved to "tools.jackson.core"
> * jackson-jr: moved (tools.jackson.jr)
> * jackson-dataformats-binary: moved (tools.jackson.dataformat)
> * jackson-dataformats-text: moved (tools.jackson.dataformat)
> * jackson-dataformat-xml: moved (tools.jackson.dataformat)
> * jackson-datatype-joda (tools.jackson.datatype)
> * jackson-modules-base (tools.jackson.module)
> * jackson-modules-java8 (tools.jackson.module)
>
> No changes:
>
> * jackson-annotations: will remain as the only
> "com.fasterxml.jackson.core" package for 2.x/3.x compatibility
>
> To be changed:
>
> * jackson-datatypes-collections
> * jackson-datatypes-misc
> * jackson-jaxrs-providers
> * jackson-jakarta-rs-providers

^^^^ all of these converted

> * jackson-module-kotlin

Not converted, will need help.

> * jackson-module-scala

Converted (by PJ) I think.
Reply all
Reply to author
Forward
0 new messages