microsoft / microsoft/kiota-java

Build tool's plugin options

Open
#120 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement java
Dominant language
Java
Stars
38
Forks
34
Avg merge
15h 9m
Merged PRs (30d)
20

Description

There are several reasoning to be done around "how we expect" users to use Kiota in their projects, among others:
- generate sources and commit the generated result
- have some sort of script to automate the code generation

Personally, I do like the approach that considers a codegen tool 100% idempotent and the generated code should be reproducible and not committed in the versioning system (i.e. regenerated all the time, build tools are good at caching the results on dev machines).

Following this(opinionated) philosophy I started automating the code generation wrapping the `kiota` CLI in a Maven plugin:
https://github.com/andreaTP/kiota-utils/blob/main/plugin/src/main/java/io/apicurio/kiota/KiotaMojo.java

Here I'm asking if you have already considered this aspect and what your take on the subject is.
More specifically, would you accept Maven/Gradle plugins in this repo or you prefer them to be third-party?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the issue and reviewing the linked KiotaMojo.java Maven plugin implementation. Compare the proposed Maven and Gradle plugin approaches with the repository's current code-generation workflow. The work is not yet defined beyond deciding whether such plugins belong in this repository or should remain third-party.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
build-system
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.