generated from ConduitIO/conduit-processor-template
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Guillem
committed
Feb 13, 2025
1 parent
8d5b4b5
commit 23495c8
Showing
12 changed files
with
29 additions
and
140 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,3 @@ | ||
# Define code owners (individuals or teams that are responsible for code in this repository) | ||
# More about code owners at https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners | ||
* @ConduitIO/conduit-core | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,71 +1,32 @@ | ||
# Conduit Processor Template | ||
# Conduit Processor for <resource> | ||
|
||
This is a template project for building [Conduit](https://conduit.io) processors in Go. It makes it possible to | ||
start working on a Conduit processor in a matter of seconds. | ||
[Conduit](https://conduit.io) processor for <resource>. | ||
|
||
> [!TIP] | ||
> Are you looking to write a simple processor for your specific use case? In that case you could take the simpler | ||
> approach - check out the | ||
> [documentation](https://conduit.io/docs/developing/processors/building#using-sdknewprocesorfunc) how you | ||
> can write a processor in a single function! | ||
## How to build? | ||
|
||
## Quick start | ||
Run `make build` to build the processor. | ||
|
||
1. Click [_Use this template_](https://github.com/new?template_name=conduit-processor-template&template_owner=ConduitIO) and clone your new repository. | ||
2. Initialize the repository using [`setup.sh`](https://github.com/ConduitIO/conduit-processor-template/blob/main/setup.sh) and commit your changes. | ||
```sh | ||
./setup.sh github.com/myusername/conduit-processor-myprocessor | ||
git add -A | ||
git commit -m "initialize repository" | ||
``` | ||
3. Set up [automatic Dependabot PR merges](#automatically-merging-dependabot-prs). | ||
## Testing | ||
|
||
With that, you're all set up and ready to start working on your processor! As a next step, we recommend that you | ||
check out the [Conduit Processor SDK](https://github.com/ConduitIO/conduit-processor-sdk). | ||
Run `make test` to run all the unit tests. | ||
|
||
## What's included? | ||
## Functionality | ||
|
||
* Skeleton code for the processor and its configuration. | ||
* Example unit tests. | ||
* A [Makefile](/Makefile) with commonly used targets. | ||
* A [GitHub workflow](/.github/workflows/test.yml) to build the code and run the tests. | ||
* A [GitHub workflow](/.github/workflows/lint.yml) to run a pre-configured set of linters. | ||
* A [GitHub workflow](/.github/workflows/release.yml) which automatically creates a release when a tag is pushed. | ||
* A [Dependabot setup](/.github/dependabot.yml) which checks your dependencies for available updates and | ||
[merges minor version upgrades](/.github/workflows/dependabot-auto-merge-go.yml) automatically. | ||
* [Issue](/.github/ISSUE_TEMPLATE) and [PR templates](/.github/pull_request_template.md). | ||
* A [README template](/README_TEMPLATE.md). | ||
A description of what the processor achieves. | ||
|
||
## Automatically merging Dependabot PRs | ||
### Processor Configuration | ||
|
||
> [!NOTE] | ||
> This applies only to public processor repositories, as branch protection rules are not enforced in private repositories. | ||
| name | description | required | default value | | ||
|--------------------------|------------------------------------------|----------|---------------| | ||
| `processor_config_param` | Description of `processor_config_param`. | true | "" | | ||
|
||
The template makes it simple to keep your processor up-to-date using automatic merging of | ||
[Dependabot](https://github.com/dependabot) PRs. To make use of this setup, you need to adjust | ||
some repository settings. | ||
|
||
1. Navigate to Settings -> General and allow auto-merge of PRs. | ||
## Known Issues & Limitations | ||
|
||
 | ||
- Known issue A | ||
- Limitation A | ||
|
||
2. Navigate to Settings -> Branches and add a branch protection rule. | ||
## Planned work | ||
|
||
 | ||
|
||
3. Create a rule for branch `main` that requires status checks `build` and `golangci-lint`. | ||
|
||
 | ||
|
||
## Recommended repository settings | ||
|
||
- Allow squash merging only. | ||
- Always suggest updating pull request branches. | ||
- Automatically delete head branches. | ||
- Branch protection rules on branch `main` (only in public repositories): | ||
- Require a pull request before merging. | ||
- Require approvals. | ||
- Require status checks `build` and `golangci-lint`. | ||
- Require branches to be up to date before merging. | ||
- Require conversation resolution before merging. | ||
- Do not allow bypassing the above settings. | ||
- [ ] Item A | ||
- [ ] Item B |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1 @@ | ||
package processorname | ||
package textgen |