Repository files navigation

• Project information:README.md
  • Help us! How to contribute:CONTRIBUTING.md
  • Work with us! How we work:docs/how-we-work.md
  • Shipkit release notes:docs/release-notes.md
• User guides
  • Getting started:docs/getting-started.md
  • How Shipkit works:docs/how-shipkit-works.md
  • FAQ:docs/faq.md

You will be more productive if your releases are fully automated and happen on every change.You will build great product if you can focus on code & features, but not on the release overhead.Shipkit will make it happen.Shipkit is a toolkit for shipping it.

Every team should be empowered to develop with rapid velocity, frictionless releases and semantic versioning just likewe do it in Mockito.Shipkit enables Mockito to automatically publish new versions to2M Mockito users!

Using Shipkit? Submit a pull request and add your project to the list!

• Mockito:https://github.com/mockito/mockito
• Powermock:https://github.com/powermock/powermock
• Shipkit:https://github.com/mockito/shipkit
• rx-tasks:https://github.com/ashdavies/rx-tasks/
• Shipkit example:https://github.com/mockito/shipkit-example

If the vision of the project connects with you help us!!!

• Open anew GitHub ticket to start the conversation. We love feedback, brainstorming and discussions.
• Drop a comment to one of the existing "help wanted" tickets, and tell us that you are interesting in implementing it.
• Try out Shipkit in your project and give feedback
• If you like emails, join themailing list, but be warned that we rarely use emails, and prefer GitHub tickets.
• Spread the word about Shipkit, let us know about other projects with similar goals.

Currently, Shipkit offers Gradle plugins for automating releases of Java libraries and Gradle plugins.Basic use case is simple:You have code that wants to be delivered to your customers, Shipkit has tools to help you out:

• automatic version bumps in "version.properties" file - don’t waste time managing your version manually
• automatically generated release notes in markdown - offer your customer clean information what changed and why
• automatic including contributors in pom.xml - appreciate the community
• release notes that highlight each individual contributor by name - build engaged community
• avoiding publishing binaries if nothing changed - respect your customers’ time
• automatic shipping to Bintray and Maven Central - use every opportunity to give your product to the hands of customers
• keeping secure tokens safe - masks sensitive values from logging and error messages from underlying tools like git
• and all that in a sweet little package, fully integrated, neatly automated, easy to roll out

For details see "How Shipkit Works?"

Add Gradle plugin:

plugins {// TODO: Use latest version from https://plugins.gradle.org/plugin/org.shipkit.java  id"org.shipkit.java" version"2.0.0"// use 1.0.12 if you still need Java 6/7 and/or Gradle 2/3 support}

Initialize:

./gradlew initShipkit

Perform release:

./gradlew performRelease

For more and detailed information seedocs/getting-started.md

• 2014, August - we set up automatedcontinuous delivery for Mockito project, every merged pull requested produced release notes and new version in Maven Central.Westill do it today in Mockito!
• 2016, November - we pushed out the release automation toolkit to a separate project in GitHub, called "mockito-release-tools".We really needed to do that!As much as useful the toolkit was to drive Mockito releases, we needed to make it reusable, well documented, and packaged as a separate binary.
• 2017, February -Marcin Stachniuk joins the team, implements automatic fetching of contributors from GitHub and starts working on automatice2e testing of library clients.
• 2017, March - Shipkit mentioned in DevoxxUS'17 conference in San Jose, "Great tools for engineers: even cleaner tests with Mockito 2" talk (video)
• 2017, March -Wojtek Wilk joins the team, implements release avoidance when binaries aren't changed in comparison to previous release, starts drivingAPI compatibility validation and Shipkit dogfooding.
• 2017, April - we found a neat name for our project: "Shipkit", a toolkit for shipping it! We registered the domain:http://shipkit.org
• 2017, May - there are 5 contributors in total, we expanded the vision of the project, and currently working on killer features like: automated e2e testing with library consumers + automated pushes of version upgrades#85,A/B testing of build results when upgrading dependencies.
• 2017, June - "Ship every change to production!" presentation at Software Architecture conference in Santa Clara, CA (abstract).
• 2017, June - Szczepan includes information about Shipkit in his presentation at Gradle Summit conference in Palo Alto, CA. (abstract,slides,video)
• 2017, July - Shipkit presented at Confitura '17 conference in Warsaw (abstract,slides,video)
• 2017, July/August - Shipkit presentations at JUG meetups in Poland:all abstracts, Krakow (slides), Wroclaw (slides), and Bielsko-Biala (slides).
• 2017, October - Shipkit mentioned at JavaOne '17 conference in San Francisco in 2 talks:
  • "You Deserve Great Tools: Commit-to-Production Automation at LinkedIn" (summary,video,slides)
  • "You Deserve Great Tools: Mockito 2 for Cleaner Tests and Enhanced Productivity" (summary,slides). There was no video taken at JavaOne but this talk was recorded at DevoxxUS'17 conference (video).
• 2017, November - Shipkit mentioned at QCon '17 conference in San Francisco:
  • "CI/CD at scale: lessons from LinkedIn and Mockito" talk (slide clip,video)
• 2017, December - 1.0 release! See therelease notes.
• 2018, February - Shipkit 2.0, upgrade to Java8 and Gradle4. 2.0.0 is 100% compatible with 1.0.12 feature-wise, the only change is minimum Java+Gradle version requirement (#624)
• 2018, March - we started working on ourQ2 milestone, a set of improvements that make Shipkit more compelling for new projects.

Want to include your event? Submit a pull request!

• 2018, Q3 - Make Shipkit the standard tool for Gradle plugin CI/CD (#255)
• 2018, Q1-Q4 - work on getting the community adopt Shipkit while adding CI/CD features
• 2019, support OSS and enterprise in transition into CI/CD model