Skip to content
Java Python Dockerfile Roff JavaScript HTML Other
Branch: master
Clone or download

Latest commit

Robin Westberg
Robin Westberg Use @mentions to improve email threading
Reviewed-by: ehelin
Latest commit 7d37ea9 Feb 28, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows Run Windows CI using cmd Oct 24, 2019
.jcheck 234: Allow more granular jcheck reviewer configuration Jan 20, 2020
args git-pr: set should allow no assignees Feb 21, 2020
bot Add support for configuring Jira credentials Nov 27, 2019
bots Use @mentions to improve email threading Feb 28, 2020
buildSrc 241: Gradle version plugin should allow a version.txt file Jan 23, 2020
census Allow reverse mapping of census namespace users Sep 3, 2019
ci
cli git-pr: add the sponsor subcommand Feb 27, 2020
email
encoding Rename encoding/src/main/java/org/openjdk/skara/base85/Base85.java Nov 19, 2019
forge cli: rename git-status to git-info Feb 27, 2020
gradle/wrapper Add gradle wrapper properties file to help IDEs Feb 28, 2020
host Add HostUserDetails::email Feb 14, 2020
ini Initial commit Jun 24, 2019
issuetracker Implement shared caching for rest requests Feb 25, 2020
jcheck vcs: add Hash::zero Feb 24, 2020
json Use very defensive programming in CSRCommand Feb 5, 2020
mailinglist 149: Improve formatting of bridged emails Nov 6, 2019
network 291: Intermittent test failure in RestRequestTests.cachedSeparateAuth Feb 27, 2020
process Fix some issues building on Windows Aug 22, 2019
proxy 245: Fix proxy protocol setting, add logging Jan 24, 2020
ssh Parse .ssh/config in git-pr if needed Aug 27, 2019
storage Save references to materialized branches locally Nov 27, 2019
test git-pr: support git pr create --draft Feb 21, 2020
vcs vcs: add Hash::zero Feb 24, 2020
version 220: webrev version unknown message Jan 21, 2020
webrev webrev: check that issue linker is not null Feb 18, 2020
.dockerignore Initial commit Jun 24, 2019
.gitattributes Initial commit Jun 24, 2019
.gitignore Initial commit Jun 24, 2019
CONTRIBUTING.md Initial commit Jun 24, 2019
LICENSE Initial commit Jun 24, 2019
Makefile 243: Merge bot should support merging with certain frequency Jan 27, 2020
README.md 290: Goodies to help keeping the fork up2date Feb 27, 2020
Unzip.java 9: JDK dependencies should only be in one file Sep 18, 2019
bots.dockerfile Allow unsafe features when importing Jan 13, 2020
build.gradle Add support for offline and local builds Nov 11, 2019
deps.env Update to JDK 13.0.1 Nov 12, 2019
gradlew Add support for offline and local builds Nov 11, 2019
gradlew.bat Add support for offline and local builds Nov 11, 2019
settings.gradle 218: Enforce check on approval of CSRs Jan 29, 2020
skara.gitconfig Add git-sync command Sep 24, 2019
skara.py Add Mercurial mapping for skara command Sep 11, 2019
skara.sh Initial commit Jun 24, 2019
test.dockerfile Allow unsafe features when importing Jan 13, 2020

README.md

OpenJDK Project Skara

The goal of Project Skara is to investigate alternative SCM and code review options for the OpenJDK source code, including options based upon Git rather than Mercurial, and including options hosted by third parties.

This repository contains tooling for working with OpenJDK projects and their repositories. The following CLI tools are available as part of this repository:

  • git-jcheck - a backwards compatible Git port of jcheck
  • git-webrev - a backwards compatible Git port of webrev
  • git-defpath - a backwards compatible Git port of defpath
  • git-fork - fork a project on an external Git source code hosting provider to your personal space and optionally clone it
  • git-sync - sync the personal fork of the project with the current state of the upstream repository
  • git-pr - interact with pull requests for a project on an external Git source code hosting provider
  • git-info - show OpenJDK information about commits, e.g. issue links, authors, contributors, etc.
  • git-token - interact with a Git credential manager for handling personal access tokens
  • git-translate - translate between Mercurial and Git hashes
  • git-skara - learn about and update the Skara CLI tools
  • git-publish - publishes a local branch to a remote repository

There are also CLI tools available for importing OpenJDK Mercurial repositories into Git repositories and vice versa:

  • git-openjdk-import
  • git-verify-import
  • hg-openjdk-import

The following server-side tools (so called "bots") for interacting with external Git source code hosting providers are available:

  • hgbridge - continuously convert Mercurial repositories to git
  • mlbridge - bridge messages between mailing lists and pull requests
  • notify - send email notifications when repositories are updated
  • pr - add OpenJDK workflow support for pull requests
  • submit - example pull request test runner

Building

JDK 12 or later and Gradle 5.6.2 or later is required for building. To build the project on macOS or GNU/Linux x64, just run the following command from the source tree root:

$ sh gradlew

To build the project on Windows x64, run the following command from the source tree root:

> gradlew

The extracted jlinked image will end up in the build directory in the source tree root.

Other operating systems and CPU architectures

If you want to build on an operating system other than GNU/Linux, macOS or Windows or if you want to build on a CPU architecture other than x64, then ensure that you have JDK 12 or later installed locally. You can then run the following command from the source tree root:

$ sh gradlew

The extracted jlinked image will end up in the build directory in the source tree root.

Offline builds

If you don't want the build to automatically download any dependencies, then you must ensure that you have installed the following software locally:

  • JDK 12 or later
  • Gradle 5.6.2 or later

To create a build then run the command:

$ gradle offline

Please note that the above command does not make use of gradlew to avoid downloading Gradle.

The extracted jlinked image will end up in the build directory in the source tree root.

Cross-linking

It is also supported to cross-jlink jimages to GNU/Linux, macOS and/or Windows from any of the aforementioned operating systems. To build all applicable jimages (including the server-side tooling), run the following command from the source tree root:

sh gradlew images

Installing

To install the Skara tools, include the skara.gitconfig Git configuration file in your user-level Git configuration file. On macOS or GNU/Linux:

$ git config --global include.path "$PWD/skara.gitconfig"

On Windows:

> git config --global include.path "%CD%/skara.gitconfig"

To check that everything works as expected, run the command git skara help.

Testing

JUnit 5.5.1 or later is required to run the unit tests. To run the tests, execute following command from the source tree root:

$ sh gradlew test

The tests expect Git version 2.19.1 or later and Mercurial 4.7.1 or later to be installed on your system.

This repository also contains a Dockerfile, test.dockerfile, that allows for running the tests in a reproducible way with the proper dependencies configured. To run the tests in this way, run the following command from the source tree root:

$ sh gradlew reproduce

Wiki

Project Skara's wiki is available at https://wiki.openjdk.java.net/display/skara.

Issues

Issues are tracked in the JDK Bug System under project Skara at https://bugs.openjdk.java.net/projects/SKARA/.

Contributing

We are more than happy to accept contributions to the Skara tooling, both via patches sent to the Skara mailing list and in the form of pull requests on GitHub.

Members

See http://openjdk.java.net/census#skara for the current Skara Reviewers, Committers and Authors. See https://openjdk.java.net/projects/ for how to become an author, committer or reviewer in an OpenJDK project.

Discuss

Development discussions take place on the project Skara mailing list skara-dev@openjdk.java.net, see https://mail.openjdk.java.net/mailman/listinfo/skara-dev for instructions on how to subscribe of if you want to read the archives. You can also reach many project Skara developers in the #openjdk IRC channel on OFTC, see https://openjdk.java.net/irc/ for details.

License

See the file LICENSE for details.

You can’t perform that action at this time.