Enforcement Rules in Gradle

I previously noted that Gradle has no built in enforcement rules, there is a blog here detailing how you can add your own, but that's not satisfactory for a number of reasons which I won't go in to. What is one to do? Well this one took that as a challenge so the gauntlet has been thrown down and accepted!

Sweeney

Well the first rule of any development is to come up with a suitably obscure and memorable name. So my thinking went: enforces rules -> like the police -> what do we call the police? Well a number of things but in the UK 'The Sweeney' was a memorable Police drama (at least for me) hence sweeney!

Sweeney Gradle Plugin

The sweeney gradle plugin supports a few basic rules out of the box with a couple of specifics for the Java and Gradle versions, it also supports enforcing rules and emitting warnings from rules. 

Built in Rules

Out of the box it has an equality, pattern and version range rules that can be configured, using syntax very similar to how dependencies are defined (indeed I used that as inspiration). In addition (at least at time of writing) it has support for validating the Java version number and Gradle version number.

Extensible

Since I know that I won't be able to cover every rule out there and that people/companies will have their own requirements to enforce build practices then the plugin is designed for users to add in there own rules (and definition parsers) so that it has flexibility which hopefully will ease adoption.

How does this help?

This plugin provides the community with a foundation to build extensible validation rules for Gradle build processes, comes with some useful built in rules and gives a consistent mechanism to define them that is easy to understand.

Comments

Post a Comment

Popular posts from this blog

Gradle and the parent pom

We've all got used to various maven features that we have come to rely on, and in my effort to migrate to Gradle I have endeavoured to find alternative replacments, one of which is the parent POM functionality. Gradle does not natively have this feature that as Maven users we rely on. Workarounds There are a number of workarounds documented, firstly the most common is to use the apply from to load a file from a URI (you can use a URL) but this is not ideal for many reasons. The alternative is to write your own plugin that alters your build.gradle file. Anorakgirl has a great write-up on how to do this here  Gradle and the parent POM  and is the inspiration for my plugin. Gradle pater-build plugin I love Anorakgirls write up but I was thinking that it really is a workaround and devs would need to start to understand the internal Gradle API, so if the apply from syntax has its short comings as Anorakgirl pointed out then how about subverting or working around them. I cr...
Read more

Pushing changes from Shippable to Github

If you use Shippable as your Continuous Integration server on an open source project hosted on Github you will find that by default you cannot push any changes back to Github such as when you increment a version number and wish to push the changes back. This is because Shippable uses HTTPS for public Github repositories so trying to push changes back to it will require a username and password. Solution The solution is actually simple and requires two steps, firstly installing the the deployment key in your user or repository and then switching git over to ssh rather than https. Deployment key You can find your shippable deployment key on the right hand side of your account, this is a standard SSH public key, copy this key. You can either add this key to your repository or to your user (or another user if you so choose) that has access to your repositories. Be aware though that Github restricts the re-use of keys so if you add it to your repository then you can only have it...
Read more

Maven Repository on Cloudflare R2 with Gradle

Image
 Here's a challenge with the public availability of the R2 Cloudflare blob storage is it possible to use it as a Maven repository with Gradle as the build system? The short answer is yes! The longer answer is that it is, but it is a bit disappointing with Gradle, I'll explain why it's disappointing later, but first (and probably the only bit you will read) is how. Step 1: R2 storage I'm assuming you have a Cloudflare account and have signed up for the R2 storage option. Navigate to the R2 Storage option on the R2 page Click 'Create bucket' Give the bucket a name, for the purpose of this tutorial I'm calling the bucket ' tutorial-r2-maven-bucket ' Click create and you should have your new bucket all ready for use Make note of the URL for the bucket, you'll need this later Step 2: S3 Auth token The secret sauce with using R2 as a maven repository is to treat it as an S3 bucket and use it's S3 compatible API. To do this you next need an S3 Auth...
Read more