Skip to main content

Tools

Tools for converting to, validating, and working with Wrekenfiles

A growing collection of open-source tools for working with Wrekenfiles across different languages and platforms.

terminal
# Install the converter globally
npm install -g wrekenfile-converter
# Convert OpenAPI
wrekenfile-converter convert openapi.yaml
# Convert Postman
wrekenfile-converter convert collection.json
# Validate a Wrekenfile
wrekenfile-validator wrekenfile.yaml
Prefer a quick try? Use the web-based Converter

SDK to Wrekenfile converters

Native SDK-to-Wrekenfile converters are available as part of the sdk-wrekenfile-converter project. These tools extract semantic intent from SDK source code and generate Wrekenfiles directly.

Supported languages

Currently supported languages:
C#, Go, PHP, Python, TypeScript, Swift, Kotlin, Java, and Rust.

Usage note

Each converter is available as a native library for its language. Dockerfiles are also provided if you prefer not to install dependencies locally.

Usage instructions are language-specific and documented in the corresponding GitLab repositories.

Wrekenfile CLI tools

The wrekenfile-converter project provides a CLI and a JavaScript library for working directly with Wrekenfiles. It can be installed globally via npm or imported into an existing JavaScript project.

Supported operations

  • Convert OpenAPI and Postman specs to Wrekenfile
  • Convert Wrekenfile to Mini-Wrekenfile
  • Validate Wrekenfile syntax and completeness

Resources

ResourceLinkDescription
GitLab RepositoryRepositorySource code and issue tracking
npm Packagenpm packageInstall via npm for CLI or library use
CLI DocumentationREADMECommands, usage examples, and API reference

Current and planned support

Source FormatLanguagesStatus
SDK (AST-based)C#, Go, Java, Kotlin, PHP, Python, Rust, Swift, TypeScriptAvailable
OpenAPIREST specifications (JSON/YAML)Available
PostmanCollection format (JSON)Available