Skip to content

Artifact org.itsallcode.openfasttrace:openfasttrace causes duplicates #428

Open
Bug
Open
Artifact org.itsallcode.openfasttrace:openfasttrace causes duplicates#428
Bug
Labels
bug

Description

@kaklakariada
kaklakariada
opened on Aug 11, 2024

Running the duplicate finder plugin causes errors when including OFT as a dependency:

        <dependency>
            <groupId>org.itsallcode.openfasttrace</groupId>
            <artifactId>openfasttrace</artifactId>
            <version>${oft.version}</version>
            <scope>runtime</scope>
        </dependency>
[INFO] --- duplicate-finder-maven-plugin:2.0.1:check (default-cli) @ openfasttrace-maven-plugin ---
[INFO] Checking compile classpath
[INFO] Checking runtime classpath
...
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-api:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.api.ColorScheme
[WARNING]   org.itsallcode.openfasttrace.api.DetailsSectionDisplay
[WARNING]   org.itsallcode.openfasttrace.api.FilterSettings
[WARNING]   org.itsallcode.openfasttrace.api.ReportSettings
[WARNING]   org.itsallcode.openfasttrace.api.cli.DirectoryService
[WARNING]   org.itsallcode.openfasttrace.api.core.DeepCoverageStatus
[WARNING]   org.itsallcode.openfasttrace.api.core.ItemStatus
[WARNING]   org.itsallcode.openfasttrace.api.core.LinkStatus
[WARNING]   org.itsallcode.openfasttrace.api.core.LinkedSpecificationItem
[WARNING]   org.itsallcode.openfasttrace.api.core.Location
[WARNING]   org.itsallcode.openfasttrace.api.core.Newline
[WARNING]   org.itsallcode.openfasttrace.api.core.SpecificationItem
[WARNING]   org.itsallcode.openfasttrace.api.core.SpecificationItemId
[WARNING]   org.itsallcode.openfasttrace.api.core.Trace
[WARNING]   org.itsallcode.openfasttrace.api.core.TracedLink
[WARNING]   org.itsallcode.openfasttrace.api.core.serviceloader.Initializable
[WARNING]   org.itsallcode.openfasttrace.api.exporter.Exporter
[WARNING]   org.itsallcode.openfasttrace.api.exporter.ExporterContext
[WARNING]   org.itsallcode.openfasttrace.api.exporter.ExporterException
[WARNING]   org.itsallcode.openfasttrace.api.exporter.ExporterFactory
[WARNING]   org.itsallcode.openfasttrace.api.importer.ImportEventListener
[WARNING]   org.itsallcode.openfasttrace.api.importer.ImportSettings
[WARNING]   org.itsallcode.openfasttrace.api.importer.Importer
[WARNING]   org.itsallcode.openfasttrace.api.importer.ImporterContext
[WARNING]   org.itsallcode.openfasttrace.api.importer.ImporterException
[WARNING]   org.itsallcode.openfasttrace.api.importer.ImporterFactory
[WARNING]   org.itsallcode.openfasttrace.api.importer.ImporterService
[WARNING]   org.itsallcode.openfasttrace.api.importer.MultiFileImporter
[WARNING]   org.itsallcode.openfasttrace.api.importer.RegexMatchingImporterFactory
[WARNING]   org.itsallcode.openfasttrace.api.importer.SpecificationListBuilder
[WARNING]   org.itsallcode.openfasttrace.api.importer.input.InputFile
[WARNING]   org.itsallcode.openfasttrace.api.importer.input.RealFileInput
[WARNING]   org.itsallcode.openfasttrace.api.importer.tag.config.DescribedPathMatcher
[WARNING]   org.itsallcode.openfasttrace.api.importer.tag.config.PathConfig
[WARNING]   org.itsallcode.openfasttrace.api.report.ReportConstants
[WARNING]   org.itsallcode.openfasttrace.api.report.ReportException
[WARNING]   org.itsallcode.openfasttrace.api.report.ReportVerbosity
[WARNING]   org.itsallcode.openfasttrace.api.report.Reportable
[WARNING]   org.itsallcode.openfasttrace.api.report.ReporterContext
[WARNING]   org.itsallcode.openfasttrace.api.report.ReporterFactory
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-core:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.core.ExportSettings
[WARNING]   org.itsallcode.openfasttrace.core.LinkedItemIndex
[WARNING]   org.itsallcode.openfasttrace.core.Linker
[WARNING]   org.itsallcode.openfasttrace.core.Oft
[WARNING]   org.itsallcode.openfasttrace.core.OftRunner
[WARNING]   org.itsallcode.openfasttrace.core.ServiceFactory
[WARNING]   org.itsallcode.openfasttrace.core.Tracer
[WARNING]   org.itsallcode.openfasttrace.core.cli.ArgumentValidator
[WARNING]   org.itsallcode.openfasttrace.core.cli.CliArguments
[WARNING]   org.itsallcode.openfasttrace.core.cli.CliException
[WARNING]   org.itsallcode.openfasttrace.core.cli.CliStarter
[WARNING]   org.itsallcode.openfasttrace.core.cli.CommandLineInterpreter
[WARNING]   org.itsallcode.openfasttrace.core.cli.ExitStatus
[WARNING]   org.itsallcode.openfasttrace.core.cli.MissingArgumentException
[WARNING]   org.itsallcode.openfasttrace.core.cli.StandardDirectoryService
[WARNING]   org.itsallcode.openfasttrace.core.cli.commands.AbstractCommand
[WARNING]   org.itsallcode.openfasttrace.core.cli.commands.ConvertCommand
[WARNING]   org.itsallcode.openfasttrace.core.cli.commands.HelpCommand
[WARNING]   org.itsallcode.openfasttrace.core.cli.commands.Performable
[WARNING]   org.itsallcode.openfasttrace.core.cli.commands.TraceCommand
[WARNING]   org.itsallcode.openfasttrace.core.cli.logging.LogLevel
[WARNING]   org.itsallcode.openfasttrace.core.cli.logging.LoggingConfigurator
[WARNING]   org.itsallcode.openfasttrace.core.exporter.ExporterConstants
[WARNING]   org.itsallcode.openfasttrace.core.exporter.ExporterFactoryLoader
[WARNING]   org.itsallcode.openfasttrace.core.exporter.ExporterService
[WARNING]   org.itsallcode.openfasttrace.core.importer.ImporterFactoryLoader
[WARNING]   org.itsallcode.openfasttrace.core.importer.ImporterServiceImpl
[WARNING]   org.itsallcode.openfasttrace.core.importer.MultiFileImporterImpl
[WARNING]   org.itsallcode.openfasttrace.core.report.ReportService
[WARNING]   org.itsallcode.openfasttrace.core.report.ReporterFactoryLoader
[WARNING]   org.itsallcode.openfasttrace.core.serviceloader.ChildFirstClassLoader
[WARNING]   org.itsallcode.openfasttrace.core.serviceloader.ClassPathServiceLoader
[WARNING]   org.itsallcode.openfasttrace.core.serviceloader.DelegatingLoader
[WARNING]   org.itsallcode.openfasttrace.core.serviceloader.InitializingServiceLoader
[WARNING]   org.itsallcode.openfasttrace.core.serviceloader.Loader
[WARNING]   org.itsallcode.openfasttrace.core.serviceloader.ServiceLoaderFactory
[WARNING]   org.itsallcode.openfasttrace.core.serviceloader.ServiceOrigin
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-exporter-common:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.exporter.common.DelegatingXMLStreamWriter
[WARNING]   org.itsallcode.openfasttrace.exporter.common.IndentingXMLStreamWriter
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-exporter-specobject:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.exporter.specobject.SpecobjectExporter
[WARNING]   org.itsallcode.openfasttrace.exporter.specobject.SpecobjectExporterFactory
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-importer-lightweightmarkup:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.ForwardingSpecificationItem
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.LightWeightMarkupImporter
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.linereader.LineContext
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.linereader.LineReader
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.linereader.LineReaderCallback
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.statemachine.LineParserState
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.statemachine.LineParserStateMachine
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.statemachine.LinePattern
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.statemachine.SimpleLinePattern
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.statemachine.Transition
[WARNING]   org.itsallcode.openfasttrace.importer.lightweightmarkup.statemachine.TransitionAction
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-importer-markdown:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.importer.markdown.MarkdownImporter
[WARNING]   org.itsallcode.openfasttrace.importer.markdown.MarkdownImporterFactory
[WARNING]   org.itsallcode.openfasttrace.importer.markdown.MdPattern
[WARNING]   org.itsallcode.openfasttrace.importer.markdown.MdSectionTitlePattern
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-importer-restructuredtext:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.importer.restructuredtext.RestructuredTextImporter
[WARNING]   org.itsallcode.openfasttrace.importer.restructuredtext.RestructuredTextImporterFactory
[WARNING]   org.itsallcode.openfasttrace.importer.restructuredtext.RstPattern
[WARNING]   org.itsallcode.openfasttrace.importer.restructuredtext.RstSectionTitlePattern
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-importer-specobject:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.SpecobjectImporter
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.SpecobjectImporterFactory
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.DependenciesHandlerBuilder
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.FulfilledByHandlerBuilder
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.NeedsCoverageHandlerBuilder
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.ProvidesCoverageHandlerBuilder
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.SingleSpecObjectsHandlerBuilder
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.SpecDocumentHandlerBuilder
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.SpecObjectsHandlerBuilder
[WARNING]   org.itsallcode.openfasttrace.importer.specobject.handler.TagsHandlerBuilder
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-importer-tag:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.importer.tag.ChecksumCalculator
[WARNING]   org.itsallcode.openfasttrace.importer.tag.DelegatingLineConsumer
[WARNING]   org.itsallcode.openfasttrace.importer.tag.LineReader
[WARNING]   org.itsallcode.openfasttrace.importer.tag.LongTagImportingLineConsumer
[WARNING]   org.itsallcode.openfasttrace.importer.tag.RegexLineConsumer
[WARNING]   org.itsallcode.openfasttrace.importer.tag.ShortTagImportingLineConsumer
[WARNING]   org.itsallcode.openfasttrace.importer.tag.TagImporter
[WARNING]   org.itsallcode.openfasttrace.importer.tag.TagImporterFactory
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-importer-xmlparser:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.ContentHandlerAdapter
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.ContentHandlerAdapterController
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.EventContentHandler
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.IgnoringEntityResolver
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.XmlParser
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.XmlParserException
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.XmlParserFactory
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.event.Attribute
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.event.EndElementEvent
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.event.QNameFactory
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.event.StartElementEvent
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.tree.CallbackContentHandler
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.tree.TreeBuildingContentHandler
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.tree.TreeContentHandler
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.tree.TreeElement
[WARNING]   org.itsallcode.openfasttrace.importer.xmlparser.tree.TreeParsingController
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-importer-zip:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.importer.zip.ZipFileImporter
[WARNING]   org.itsallcode.openfasttrace.importer.zip.ZipFileImporterFactory
[WARNING]   org.itsallcode.openfasttrace.importer.zip.input.ZipEntryInput
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-reporter-aspec:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.report.aspec.ASpecReport
[WARNING]   org.itsallcode.openfasttrace.report.aspec.ASpecReporterFactory
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-reporter-html:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.report.html.HtmlReport
[WARNING]   org.itsallcode.openfasttrace.report.html.HtmlReporterFactory
[WARNING]   org.itsallcode.openfasttrace.report.html.view.AbstractStreamableViewContainer
[WARNING]   org.itsallcode.openfasttrace.report.html.view.AbstractViewContainer
[WARNING]   org.itsallcode.openfasttrace.report.html.view.AbstractViewFactory
[WARNING]   org.itsallcode.openfasttrace.report.html.view.IndentationHelper
[WARNING]   org.itsallcode.openfasttrace.report.html.view.ViewFactory
[WARNING]   org.itsallcode.openfasttrace.report.html.view.Viewable
[WARNING]   org.itsallcode.openfasttrace.report.html.view.ViewableContainer
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.CharacterConstants
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlReportDetails
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlReportSummary
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlSection
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlSpecificationItem
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlTableOfContents
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlTraceSummary
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlView
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.HtmlViewFactory
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.MarkdownConverter
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.MarkdownLineState
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.MarkdownLineStateMachine
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.MarkdownLineTransition
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.MarkdownSpanConverter
[WARNING]   org.itsallcode.openfasttrace.report.html.view.html.OriginLinkFormatter
[WARNING] Found duplicate (but equal) classes in [org.itsallcode.openfasttrace:openfasttrace-reporter-plaintext:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.AnsiSequence
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.ConsoleColorFormatter
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.MonochromeTextFormatter
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.NullTextFormatter
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.PlainTextReport
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.PlaintextReporterFactory
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.TextFormatter
[WARNING]   org.itsallcode.openfasttrace.report.plaintext.TextFormatterFactory
[WARNING] Found duplicate (but equal) resources in [org.itsallcode.openfasttrace:openfasttrace-core:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   openfasttrace_logo.png
[WARNING]   openfasttrace_logo.svg
[WARNING]   openfasttrace_logo.txt
[WARNING]   usage.txt
[WARNING] Found duplicate (but equal) resources in [org.itsallcode.openfasttrace:openfasttrace-reporter-html:4.1.0, org.itsallcode.openfasttrace:openfasttrace:4.1.0]:
[WARNING]   css/report.css
[WARNING] Found duplicate classes/resources in runtime classpath.

Root cause

Artifact org.itsallcode.openfasttrace:openfasttrace is a fat jar produced with maven-shade-plugin but still declares it's dependencies in pom.xml, because of setting <createDependencyReducedPom>false</createDependencyReducedPom>:

+- org.itsallcode.openfasttrace:openfasttrace:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-core:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-exporter-specobject:jar:4.1.0:runtime
|  |  \- org.itsallcode.openfasttrace:openfasttrace-exporter-common:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-importer-markdown:jar:4.1.0:runtime
|  |  \- org.itsallcode.openfasttrace:openfasttrace-importer-lightweightmarkup:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-importer-restructuredtext:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-importer-specobject:jar:4.1.0:runtime
|  |  \- org.itsallcode.openfasttrace:openfasttrace-importer-xmlparser:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-importer-tag:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-importer-zip:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-reporter-plaintext:jar:4.1.0:runtime
|  +- org.itsallcode.openfasttrace:openfasttrace-reporter-html:jar:4.1.0:runtime
|  \- org.itsallcode.openfasttrace:openfasttrace-reporter-aspec:jar:4.1.0:runtime

Proposed solution

  • Change configuration of maven-shade-plugin:
    • Set createDependencyReducedPom to true to create a pom without dependencies

Activity

  1. kaklakariada
    added
    bug
    on Aug 11, 2024
  2. kaklakariada
    added this to OpenFastTraceon Aug 11, 2024
  3. github-project-automation
    moved this to 📫 Backlog in OpenFastTraceon Aug 11, 2024
  4. kaklakariada
    added a commit that references this issue on Aug 11, 2024

    Add workaround for itsallcode/openfasttrace#428

    ac08d51
  5. redcatbear
    added the
    Bug
    issue type on Jun 2, 2026

  6. redcatbear commented on Jun 2, 2026

    @redcatbear
    redcatbear
    on Jun 2, 2026
    Collaborator

    🤖 Suggestion by Junie:

    To avoid duplicates in the OpenFastTrace (OFT) fat JAR without sacrificing its delivery format, you should use a combination of the duplicate-finder-maven-plugin for validation and refined maven-shade-plugin configurations to handle overlapping resources.
    Based on the analysis of the OFT project structure, here are the steps to achieve this:

    Use duplicate-finder-maven-plugin for Validation

    The project already includes the duplicate-finder-maven-plugin in the parent pom.xml. This plugin is essential for detecting actual class name collisions on the classpath before the fat JAR is even built.
    To ensure it properly protects the product module, verify that it is configured to check both compile and runtime classpaths:

    <plugin>
    <groupId>org.basepom.maven</groupId>
    <artifactId>duplicate-finder-maven-plugin</artifactId>
    <version>2.0.1</version>
    <executions>
        <execution>
            <id>default</id>
            <phase>verify</phase>
            <goals>
                <goal>check</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <failBuildInCaseOfDifferentContentConflict>true</failBuildInCaseOfDifferentContentConflict>
        <failBuildInCaseOfEqualContentConflict>true</failBuildInCaseOfEqualContentConflict>
        <failBuildInCaseOfConflict>true</failBuildInCaseOfConflict>
        <checkCompileClasspath>true</checkCompileClasspath>
        <checkRuntimeClasspath>true</checkRuntimeClasspath>
        <ignoredResourcePatterns>
            <ignoredResourcePattern>META-INF/.*</ignoredResourcePattern>
        </ignoredResourcePatterns>
    </configuration>
</plugin>

    Note: The current configuration in OFT is already quite strict, which is good.

    Refine maven-shade-plugin Filters

    The "duplicates" reported by the maven-shade-plugin during the packaging of the product module are often not actual bugs but rather overlaps of resources like META-INF/MANIFEST.MF, module-info.class, or Maven descriptors.
    Inproduct/pom.xml, the maven-shade-plugin is already configured to exclude some of these. You can further suppress these warnings and keep the JAR clean by ensuring all common overlapping metadata is excluded:

    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <configuration>
        <filters>
            <filter>
                <artifact>*:*</artifact>
                <excludes>
                    <exclude>module-info.class</exclude>
                    <exclude>module-info.java</exclude>
                    <exclude>META-INF/MANIFEST.MF</exclude>
                    <exclude>META-INF/maven/**</exclude>
                    <exclude>META-INF/DEPENDENCIES</exclude>
                    <exclude>META-INF/LICENSE*</exclude>
                    <exclude>META-INF/NOTICE*</exclude>
                </excludes>
            </filter>
        </filters>
        <transformers>
            <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer" />
            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                <mainClass>org.itsallcode.openfasttrace.core.cli.CliStarter</mainClass>
            </transformer>
        </transformers>
    </configuration>
</plugin>

    Why This Works

    1. duplicate-finder-maven-plugin: Acts as a safety net during the verify phase. It ensures that no two dependencies contain the same class, which would cause unpredictable behavior at runtime.
    2. Shade Filters: By excluding META-INF/maven/** and other metadata, you stop the shade plugin from complaining about overlapping pom files and properties from the various OFT sub-modules that are being merged into the fat JAR.
    3. No Loss of Fat JAR: These changes only affect how the JAR is assembled and validated; the final result remains a single, executable Uber-JAR containing all necessary components.

    Summary of the Problem in OFT

    The warnings currently seen (e.g., openfasttrace-api-4.5.0.jar define 52 overlapping classes) are often a side-effect of how the shade plugin reports overlaps between the input jars and the output jar if not perfectly configured. By using the filters above and relying on the duplicate-finder for actual safety, you can maintain a clean, warning-free build.

  7. redcatbear commented on Sep 19, 2026

    @redcatbear
    redcatbear
    on Sep 19, 2026
    Collaborator

    @kaklakariada if you have a quiet must moment and some time to kill, could you please take a look at this one?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bug

    Type

    Bug

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions