{"id":20504522,"url":"https://github.com/yupiik/maven-shade-transformers","last_synced_at":"2025-04-13T20:50:21.799Z","repository":{"id":43189353,"uuid":"258251522","full_name":"yupiik/maven-shade-transformers","owner":"yupiik","description":"Extensions to use with Apache Maven Shade.","archived":false,"fork":false,"pushed_at":"2024-03-10T11:41:40.000Z","size":48,"stargazers_count":9,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-27T11:11:59.128Z","etag":null,"topics":["java","maven","shade"],"latest_commit_sha":null,"homepage":"https://www.yupiik.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yupiik.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["yupiik"]}},"created_at":"2020-04-23T15:38:59.000Z","updated_at":"2024-03-20T23:36:14.000Z","dependencies_parsed_at":"2024-03-10T12:53:16.632Z","dependency_job_id":null,"html_url":"https://github.com/yupiik/maven-shade-transformers","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yupiik%2Fmaven-shade-transformers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yupiik%2Fmaven-shade-transformers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yupiik%2Fmaven-shade-transformers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yupiik%2Fmaven-shade-transformers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yupiik","download_url":"https://codeload.github.com/yupiik/maven-shade-transformers/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248782279,"owners_count":21160716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","maven","shade"],"created_at":"2024-11-15T19:38:32.877Z","updated_at":"2025-04-13T20:50:21.778Z","avatar_url":"https://github.com/yupiik.png","language":"Java","funding_links":["https://github.com/sponsors/yupiik"],"categories":[],"sub_categories":[],"readme":"//\n// Copyright (c) 2020-2023 - Yupiik SAS - https://www.yupiik.com\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance\n// with the License.  You may obtain a copy of the License at\n//\n//  http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing,\n// software distributed under the License is distributed on an\n// \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n// KIND, either express or implied.  See the License for the\n// specific language governing permissions and limitations\n// under the License.\n//\n\n= Yupiik Maven Shade Transformers\n\nExtensions to use with Apache Maven Shade.\n\n== Yupiik Fusion\n\nFusion provides some metadata files which need to be merged when used at runtime.\nThis is typically the case for configuration metadata, OpenRPC metadata and JSON schema metadata.\n\nFor the first one just register the transformer `FusionDocumentationTransformer`, `FusionOpenRPCTransformer` for the second and for last one use `FusionJsonSchemaTransformer`.\nBoth are in `io.yupiik.maven.shade.transformer` package:\n\n[source,xml]\n----\n\u003ctransformers\u003e\n  \u003ctransformer implementation=\"io.yupiik.maven.shade.transformer.FusionDocumentationTransformer\" /\u003e\n  \u003ctransformer implementation=\"io.yupiik.maven.shade.transformer.FusionJsonSchemaTransformer\" /\u003e\n  \u003ctransformer implementation=\"io.yupiik.maven.shade.transformer.FusionOpenRPCTransformer\" /\u003e\n\u003c/transformers\u003e\n----\n\n== Relocating Wrapper\n\nThis transformer aims at wrapping another transformer adding relocation capabilities to it (using relocations of the plugin).\nIt supports a list of delegate transformers if needed.\n\n=== Usage\n\nThis provides two transformer implementations which use slightly different replacement algorithms.\n* `io.yupiik.maven.shade.transformer.RelocationTransformer`: relocates class names\n* `io.yupiik.maven.shade.transformer.SourceRelocationTransformer`: relocates class names in source-like files\n* `io.yupiik.maven.shade.transformer.PathRelocationTransformer`: relocates paths (enabling to use `rawString` relocation configuration and use a plain `replaceAll`)\n* `io.yupiik.maven.shade.transformer.ClassRelocationTransformer`: similar to default one but filter replacements to classes only (safer).\n\n[source,xml]\n----\n\u003cproject\u003e\n  ...\n  \u003cbuild\u003e\n    \u003cplugins\u003e\n      \u003cplugin\u003e\n        \u003cgroupId\u003eorg.apache.maven.plugins\u003c/groupId\u003e\n        \u003cartifactId\u003emaven-shade-plugin\u003c/artifactId\u003e\n        \u003cversion\u003e${project.version}\u003c/version\u003e\n        \u003cexecutions\u003e\n          \u003cexecution\u003e\n            \u003cgoals\u003e\n              \u003cgoal\u003eshade\u003c/goal\u003e\n            \u003c/goals\u003e\n            \u003cconfiguration\u003e\n              \u003ctransformers\u003e\n                \u003ctransformer implementation=\"io.yupiik.maven.shade.transformer.RelocationTransformer\"\u003e\n                  \u003cdelegates\u003e\n                    \u003ctransformer implementation=\"org.apache.maven.plugins.shade.resource.properties.PropertiesTransformer\"\u003e\n                      \u003cresource\u003econfiguration/application.properties\u003c/resource\u003e\n                      \u003cordinalKey\u003eordinal\u003c/ordinalKey\u003e\n                    \u003c/transformer\u003e\n                  \u003c/delegates\u003e\n                \u003c/transformer\u003e\n              \u003c/transformers\u003e\n            \u003c/configuration\u003e\n          \u003c/execution\u003e\n        \u003c/executions\u003e\n        \u003cdependencies\u003e\n          \u003cdependency\u003e\n            \u003cgroupId\u003eio.yupiik.maven\u003c/groupId\u003e\n            \u003cartifactId\u003emaven-shade-transformers\u003c/artifactId\u003e\n            \u003cversion\u003e0.0.1\u003c/version\u003e\n          \u003c/dependency\u003e\n        \u003c/dependencies\u003e\n      \u003c/plugin\u003e\n    \u003c/plugins\u003e\n  \u003c/build\u003e\n  ...\n\u003c/project\u003e\n----\n\n== Build\n\nTo build the project use:\n\n[source,bash]\n----\nmvn clean verify -Prun-its\n----\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyupiik%2Fmaven-shade-transformers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyupiik%2Fmaven-shade-transformers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyupiik%2Fmaven-shade-transformers/lists"}