{"id":14972913,"url":"https://github.com/spring-projects/spring-data-build","last_synced_at":"2025-05-14T09:07:33.800Z","repository":{"id":6238178,"uuid":"7469974","full_name":"spring-projects/spring-data-build","owner":"spring-projects","description":"Modules to centralize common resources and configuration for Spring Data Maven builds.","archived":false,"fork":false,"pushed_at":"2025-05-12T07:32:35.000Z","size":4827,"stargazers_count":104,"open_issues_count":18,"forks_count":136,"subscribers_count":34,"default_branch":"main","last_synced_at":"2025-05-12T07:41:50.618Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/spring-projects.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":"CONTRIBUTING.adoc","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.adoc","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-01-06T16:50:46.000Z","updated_at":"2025-05-12T07:32:38.000Z","dependencies_parsed_at":"2023-11-15T09:25:43.742Z","dependency_job_id":"6912948a-3187-4082-b9e0-d7cb45ecd27c","html_url":"https://github.com/spring-projects/spring-data-build","commit_stats":{"total_commits":1893,"total_committers":42,"mean_commits":45.07142857142857,"dds":0.7348124669836239,"last_synced_commit":"9be1b13bbd7a555b948c6cfe14e6ba7ca6f4bcba"},"previous_names":["springsource/spring-data-build"],"tags_count":333,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spring-projects%2Fspring-data-build","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spring-projects%2Fspring-data-build/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spring-projects%2Fspring-data-build/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spring-projects%2Fspring-data-build/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spring-projects","download_url":"https://codeload.github.com/spring-projects/spring-data-build/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254110374,"owners_count":22016391,"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":[],"created_at":"2024-09-24T13:47:44.234Z","updated_at":"2025-05-14T09:07:33.757Z","avatar_url":"https://github.com/spring-projects.png","language":"Shell","readme":"= Spring Data Build Infrastructure image:https://jenkins.spring.io/buildStatus/icon?job=spring-data-build%2Fmain\u0026subject=Build[link=https://jenkins.spring.io/view/SpringData/job/spring-data-build/] image:https://img.shields.io/badge/Revved%20up%20by-Develocity-06A0CE?logo=Gradle\u0026labelColor=02303A[\"Revved up by Develocity\", link=\"https://ge.spring.io/scans?search.rootProjectNames=Spring Data Build\"]\n\nThis repository contains common infrastructure to be used by Spring Data modules that build with Maven. It consists of a _resources_ project that bundles up resources that are needed during the build CSS for reference documentation generation and JavaDoc. The second project is _parent_ that can be used as parent project to pre-configure core dependencies, properties, reference documentation generation and most important of all the appropriate distribution assembly.\n\nThe parent project can be eased for either a single-module Maven project or a multi-module one. Each of the setups requires a slightly different setup of the project.\n\n== Code of Conduct\n\nThis project is governed by the link:https://github.com/spring-projects/.github/blob/main/CODE_OF_CONDUCT.md[Spring Code of Conduct]. By participating, you are expected to uphold this code of conduct. Please report unacceptable behavior to spring-code-of-conduct@pivotal.io.\n\n== Project setup\n\n=== General setup\n\nThe parent project configures the following aspects of the project build:\n\nShared resources are pulled in from the `spring-data-build-resources` dependency (images, CSS, JavaScript). Renders reference documentation from Asciidoc file named `index.adoc` within `src/asciidoc`. In the `distribute` profile, two assemblies are generated: A ZIP to be uploaded to docs.spring.io (incl. javadoc (browsable), reference docs as described before) with the following content:\n\n[source]\n----\n- notice.txt\n+ reference -\u003e Asciidoc generated reference documentation\n  + html\n  + pdf\n  + epub\n+ api -\u003e JavaDoc\n----\n\nA second ZIP is generated to be uploaded to docs.spring.io to contain all Spring namespace XSDs.\n\nThe following dependencies are pre-configured.\n\n* Logging dependencies: SLF4j + Commons Logging bridge and Logback as test dependency\n* Test dependencies: JUnit / AssertJ / Hamcrest / Mockito\n* Dependency versions for commonly used dependencies\n\n=== Single project setup\n\nIf the client project is a project consisting of a single project only all that needs to be done is declaring the parent project:\n\n[source,xml]\n----\n\u003cparent\u003e\n\t\u003cgroupId\u003eorg.springframework.data.build\u003c/groupId\u003e\n\t\u003cartifactId\u003espring-data-parent\u003c/artifactId\u003e\n\t\u003cversion\u003e${most-recent-release-version}\u003c/version\u003e\n\u003c/parent\u003e\n----\n\nBe sure to adapt the version number to the latest release version. The second and already last step of the setup is to activate the assembly and asciidoctor plugin in the build section:\n\n[source,xml]\n----\n\u003cplugin\u003e\n\t\u003cgroupId\u003eorg.apache.maven.plugins\u003c/groupId\u003e\n\t\u003cartifactId\u003emaven-assembly-plugin\u003c/artifactId\u003e\n\u003c/plugin\u003e\n\u003cplugin\u003e\n\t\u003cgroupId\u003eorg.asciidoctor\u003c/groupId\u003e\n\t\u003cartifactId\u003easciidoctor-maven-plugin\u003c/artifactId\u003e\n\u003c/plugin\u003e\n----\n\nAs an example have a look at the build of https://github.com/spring-projects/spring-data-jpa[Spring Data JPA].\n\n=== Multi project setup\n\nA multi module setup requires slightly more setup and some structure being set up.\n\n* The root `pom.xml` needs to configure the `project.type` property to `multi`.\n* Asciidoc documentation sources need to be in the root project.\n* The assembly needs to be build in a dedicated sub-module (e.g. `distribution`), declare the assembly plugin (see single project setup) in that submodule and reconfigure the `project.root` property in that module to `${basedir}/..`.\n* Configure `${dist.id}` in the root project to the basic artifact id (e.g. `spring-data-mongodb`) as this will serve as file name for distribution artifacts, static resources etc. It will default to the artifact id and thus usually resolve to a `…-parent` if not configured properly.\n\nAs an example have a look at the build of https://github.com/spring-projects/spring-data-mongodb[Spring Data MongoDB].\n\n== Build configuration\n\n* Goals to execute `clean (dependency:tree) install -Pci` to run the build\n* Goals to execute `clean deploy -Pci,artifactory` to deploy artifacts to Artifactory\n* A nightly build can then use `clean (dependency:tree) deploy -Pdistribute` to publish reference documentation\n\n== Additional build profiles\n\n* `ci` - Packages the JavaDoc as JAR for distribution (needs to be active on the CI server to make sure we distribute JavaDoc as JAR).\n* `distribute` - Creates Asciidoc documentation.\n* `distribute-schema` - Creates schema file distribution.\n* `spring…-next` - Configures the Spring version to be used to be the next Spring Framework snapshot version.\n\n== License\n\nSpring Data Build is Open Source software released under the https://www.apache.org/licenses/LICENSE-2.0.html[Apache 2.0 license].\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspring-projects%2Fspring-data-build","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspring-projects%2Fspring-data-build","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspring-projects%2Fspring-data-build/lists"}