https://github.com/ubuntu/gowsl

GoWSL is a package that wraps around the wslApi.dll for safe and idiomatic use within Go projects.
https://github.com/ubuntu/gowsl

Last synced: about 1 year ago
JSON representation

GoWSL is a package that wraps around the wslApi.dll for safe and idiomatic use within Go projects.

• Host: GitHub
• URL: https://github.com/ubuntu/gowsl
• Owner: ubuntu
• License: mit
• Created: 2022-11-07T09:43:30.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-03-25T11:15:28.000Z (about 1 year ago)
• Last Synced: 2025-04-20T15:44:27.349Z (about 1 year ago)
• Language: Go
• Homepage:
• Size: 516 KB
• Stars: 17
• Watchers: 4
• Forks: 3
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# GoWSL

This module offers an idiomatic interface between your Go code and the Windows Subsystem for Linux (WSL) API (`wslApi.dll`  and occasionally `wsl.exe`). It offers wrappers around common actions to manage WSL distros.

[![Code quality](https://github.com/ubuntu/GoWSL/actions/workflows/qa-azure.yaml/badge.svg)](https://github.com/ubuntu/GoWSL/actions/workflows/qa-azure.yaml)

[![Go Reference](https://pkg.go.dev/badge/github.com/ubuntu/gowsl.svg)](https://pkg.go.dev/github.com/ubuntu/gowsl)

[![Go Report Card](https://goreportcard.com/badge/ubuntu/gowsl)](https://goreportcard.com/report/ubuntu/gowsl)

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/ubuntu/gowsl/blob/main/LICENSE)

## Aim

We aim not to extend the aforementioned API, but rather to provide a safe, idiomatic, and easy-to-use wrapper around it. The goal is to enable the development of applications that build on top of it.

## Requirements

- Windows Subsystem for Linux must be installed ([documentation](https://learn.microsoft.com/en-us/windows/wsl/install)) and enabled.

- Go version must be equal to or above 1.20.

## Development

Your help would be very much appreciated! Check out the [CONTRIBUTING](./CONTRIBUTING.md) document to see how you could collaborate.

## Contact

You are welcome to create a new issue on this repository if you find bugs or wish to make any feature request.