A CLI tool for converting and serving Woodpecker CI configuration files, supporting conversion from Starlark and serving configurations via a web service for CI runs.
  • Go 91.1%
  • Shell 4.4%
  • Dockerfile 2.6%
  • Makefile 1.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-06-09 09:52:06 +02:00
.woodpecker fix: fix vendor folder 2026-05-13 16:43:28 +02:00
assets Commit Title (50 char max) 2025-03-14 12:49:38 +01:00
cmd/wccs enhancement(cli): add convert cmd 2025-03-13 18:31:28 +01:00
internal/cmd enhancement: print to stdout if out is not set 2025-03-14 10:46:11 +01:00
testdata enhancement(cli): add convert cmd 2025-03-13 18:31:28 +01:00
testenv enhancement(wp): 3.8.0 compatibility 2025-07-10 19:50:43 +02:00
vendor fix: fix vendor folder 2026-05-13 16:43:28 +02:00
.dockerignore enhancement: rename to wccs 2025-03-12 17:20:47 +01:00
.editorconfig enhancement: rename to wccs 2025-03-12 17:20:47 +01:00
.gitattributes enhancement: rename to wccs 2025-03-12 17:20:47 +01:00
.gitignore fix: expose cron in build 2026-06-09 09:29:34 +02:00
.golangci.yaml enhancement(cli): add convert cmd 2025-03-13 18:31:28 +01:00
config.example.toml enhancement(cli): add convert cmd 2025-03-13 18:31:28 +01:00
convert.go fix: expose cron in build 2026-06-09 09:29:34 +02:00
convert_test.go enhancement(cli): add convert cmd 2025-03-13 18:31:28 +01:00
Dockerfile chore: update woodpecker to 3.14 2026-05-09 18:35:24 +02:00
go.mod chore: update woodpecker to 3.14 2026-05-09 18:35:24 +02:00
go.sum chore: update woodpecker to 3.14 2026-05-09 18:35:24 +02:00
http.go enhancement(cli): add convert cmd 2025-03-13 18:31:28 +01:00
LICENSE enhancement: rename to wccs 2025-03-12 17:20:47 +01:00
Makefile chore: update woodpecker to 3.14 2026-05-09 18:35:24 +02:00
provider.go chore: update woodpecker to 3.14 2026-05-09 18:35:24 +02:00
provider_test.go enhancement(cli): add convert cmd 2025-03-13 18:31:28 +01:00
README.md chore: add readme 2025-03-14 12:43:22 +01:00
wccs.go enhancement(convert): provide additional environment data for the starlark converter 2025-07-09 14:11:04 +02:00
wccs_test.go enhancement(convert): provide additional environment data for the starlark converter 2025-07-09 14:11:04 +02:00

Woodpecker CI Config Service

Pipeline Status Matrix space Go Report Card go reference GitHub release License: Apache-2.0

woodpecker-ci-config-service is a command-line interface (CLI) tool designed to work with Woodpecker CI configurations. It provides functionalities to convert and serve configuration files for Woodpecker CI, a powerful and flexible continuous integration system.

Features

  • Convert Command – Convert configuration files from a source format to Woodpecker CI format.
  • Server Command – Serve configuration files through a web service for CI runs.

Why Use Woodpecker CI Config Service?

When integrating Woodpecker CI into your development workflow, woodpecker-ci-config-service helps streamline the process of managing and serving configuration files. It provides:

  • Easy conversion from supported formats (currently Starlark) to Woodpecker CI configuration.
  • Flexible output options, either to stdout or to disk.
  • A web server to serve configurations to CI runs directly.

Commands

Convert Command

The convert command converts configuration files from a source format to Woodpecker CI format. Currently, it supports conversion from Starlark.

Usage

# using the forge environment
ENV_SECRET_GITHUB_TOKEN=XXX wccs convert testdata/convert.forge.json [--out <output-file>]
# using the fs environment
WCCS_CONVERT_PROVIDERS=fs WCCS_CONVERT_PROVIDER_FS_SOURCE=testdata/*.star wccs convert testdata/convert.fs.json [--out <output-file>]

Server Command

The server command starts a web server that serves configuration files for CI runs.

Usage

wccs server

Installation

To install woodpecker-ci-config-service, clone the repository and build the tool:

git clone https://github.com/opencloud-eu/woodpecker-ci-config-service.git
cd woodpecker-ci-config-service
go build -o bin/wccs cmd/wccs/*.go

Future Improvements

  • Support for additional source formats for conversion.
  • Support for additional forges and private repositories.
  • Improved error handling and logging.

License

This project is licensed under the Apache License 2.0.

Contributions

Contributions are welcome! Feel free to submit issues or pull requests to improve woodpecker-ci-config-service.

Acknowledgements

Special thanks to the Woodpecker CI team for their amazing work on the Woodpecker CI project.

The logo was generated using DALL-E. Thanks to the DALL-E team for providing such a fantastic tool.

Contact

For more information, reach out via the GitHub Issues.