Skip to content

Commit

Permalink
Add Release Checklist
Browse files Browse the repository at this point in the history
  • Loading branch information
Thijsiez committed Oct 24, 2024
1 parent 97b1e8f commit a25efe1
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 4 deletions.
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Changelog

## 0.0.2
- Add the `ColumnType` annotation to specify the `Column<T>`'s type
- Add the `@ColumnType` annotation to override the generated `Column<T>`'s type parameter

## 0.0.1
- Initial release
6 changes: 6 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Release Checklist
- Update the `version` in gradle.properties
- Make sure the versions in the README's Requirements section match the dependency versions specified in gradle.properties
- Add a new section to the CHANGELOG describing what has changed
- Update the versions in the README's Getting Started section
- Add a tag with the new version to the commit which will be built and released
15 changes: 12 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,21 @@
# panache-kotlin-dsl
A dynamic, type-safe way to write your queries

[Changelog](CHANGELOG.md) | [Contributing](CONTRIBUTING.md)

## Getting Started
TODO

## Requirements
- Quarkus version `3.9.2` or newer
- Dependency `io.quarkus:quarkus-hibernate-orm-panache-kotlin` is required
- Kotlin version `1.9.23` or newer
- KSP version `1.9.23-1.0.20` or newer
- Your KSP version needs to match your Kotlin version. This is a strict requirement!
- For example, when your Kotlin version is `2.0.21`, your KSP version needs to be built for and start with the same version, such as `2.0.21-1.0.25`
- Your KSP version needs to match your Kotlin version. This is a strict requirement!
For example, when your Kotlin version is `2.0.21`, your KSP version needs to be built for and start with the same version, such as `2.0.21-1.0.25`

## Examples
TODO

## Features
### Queries
Expand All @@ -30,7 +39,7 @@ Allows you to handle no/multiple results with a `when (result) { ... }` block in
- Generate query entry point extension functions for classes with companion objects extending `PanacheCompanion`/`PanacheCompanionBase`
- `where`/`whereGroup`, `count`, `delete`, `find`, `stream`, `single`, `singleSafe`, and `multiple`
- Allows for overriding the generated `Column<T>`'s type parameter using `@ColumnType`
- Especially useful when using JPA `@Converter` when the field's type is different to the column's type
- Especially useful when using a JPA `@Converter` when the field's type is different to the column's type
- Optionally annotate generated code with `@Generated` so it can more easily be excluded from test coverage reporting

## Known Issues
Expand Down

0 comments on commit a25efe1

Please sign in to comment.