Skip to content

Latest commit

 

History

History
165 lines (112 loc) · 4.06 KB

CONTRIBUTING.md

File metadata and controls

165 lines (112 loc) · 4.06 KB

Contributing Guide

Welcome! There are many ways to contribute, including submitting bug reports, improving documentation, submitting feature requests, reviewing new submissions, or contributing code that can be incorporated into the project.

Review process

For any significant changes please create a new GitHub issue and enhancements that you wish to make. Describe the feature you would like to see, why you need it, and how it will work. Discuss your ideas transparently and get community feedback before proceeding.

Small changes can directly be crafted and submitted to the GitHub Repository as a Pull Request. This requires creating a repo fork using instruction.

Initial setup for local development

Install Git

Please follow instruction.

Clone the repo

Open terminal and run these commands:

git clone git@github.com:myuser/spark-dialect-extension.git

cd spark-dialect-extension

Setup environment

Before you start, ensure you have the following installed:

How to

Compile the Project

To compile the project and generate a JAR file, run the following command in the project's root directory:

./gradlew crossBuildV212Jar crossBuildV213Jar

This command compiles the source code and packages it into a .jar files located in the build/libs directory.

Run Scala Tests

This section describes how to run Scala tests for the Spark Dialect Extension.

Start Required Services

Before running the tests, you need to start the necessary database services using Docker Compose:

docker-compose -f docker-compose.test.yml up -d

Execute Tests

To run the Scala tests, execute:

./gradlew test

After the tests, you can view the coverage report by opening the build/reports/tests/test/index.html file in your web browser.

Stopping Docker Containers

After completing the tests, you can stop the Docker containers with:

docker-compose -f docker-compose.test.yml down

Format and lint the code

Using Scalafmt to Format Code

To format all Scala source files in the project, execute the following command from the project's root directory:

./gradlew scalafmtAll

Using Scalafix for Linting and Refactoring

To lint and refactor the code, run Scalafix using the following command:

./gradlew scalafix

This command checks the code against various rules specified in the .scalafix.conf file and applies fixes where possible.

Create a pull request

Commit your changes:

git commit -m "Commit message"
git push

Then open Github interface and create pull request. Please follow guide from PR body template.

After pull request is created, it get a corresponding number, e.g. 123 (pr_number).

Release a new package version

Note: this is only for repo maintainers

  1. Checkout to develop branch and update it to the actual state
git checkout develop
git pull -p
  1. Copy version (it must start with v, e.g. v1.0.0)
VERSION=$(./gradlew -q printVersion)
  1. Commit and push changes to develop branch
git add .
git commit -m "Prepare for release ${VERSION}"
git push
  1. Merge develop branch to master, WITHOUT squashing
git checkout master
git pull
git merge develop
git push
  1. Add git tag to the latest commit in master branch
git tag "$VERSION"
git push origin "$VERSION"
  1. Update version in develop branch after release:
git checkout develop
NEXT_VERSION=$(echo "$VERSION" | awk -F. '/[0-9]+\./{$NF++;print}' OFS=.)
sed -i "s/version = \".*\"/version = \"$NEXT_VERSION\"/" build.gradle
git add .
git commit -m "Bump version"
git push