mirror of
https://github.com/rwinkhart/go-winio.git
synced 2026-08-28 04:46:50 -04:00
Hamza El-Saawy
e268c11e27
* Add lint and go generate stages to CI
Add CI step to verify `go generate` was run on repo.
Add linter stage to CI along with linter config file,
`.golangci.yml`.
Will likely prefer revive over static-check.
Updated README Contributing section on linting requirements.
Added sequence ordering to make sure lint and go generate stages run
before tests and build.
This way, build and tests are not run on code that could potentially:
1. not build due to `gofmt` issues;
2. contain bugs;
3. have to be re-submitted after issues are fixed; or
4. contain outdated Win32 syscall or other auto-generated files.
Signed-off-by: Hamza El-Saawy <hamzaelsaawy@microsoft.com>
* Fixed linter issues
Code changes to satisfy linters:
- Ran `gofmt -s -w` on repo.
- Broke up long lines.
- When possible, changed names with incorrect initialism formatting
- Added exceptions for exported variables.
- Added exceptions for ALL_CAPS_WITH_UNDERSCORES code.
- Switched to using `windows` or `syscall` definitions if possible;
especially if some constants were unused.
- Added `_ =` to satisfy error linter, and acknowledge that errors are
being ignored.
- Switched to using `errors.Is` and `As` in places, elsewhere added
exceptions if error value was known to be `syscall.Errno`.
- Removed bare returns.
- Prevented variables from being overshadowed in certain places
(ignoring cases of overshadowing `err`).
- Renamed variables and functions (eg, `len`, `eventMetadata.bytes`) to
prevent shadowing pre-built functions and imported pacakges.
- Removed unused method receivers.
- Added exceptions to certain unused (unexported) constants and
functions.
- Deleted unused `once` from `pkg/etw.providerMap`.
- Renamed `noop.go` files to `main_other.go` or `doc.go`, to better fit
style recommendations.
- Added exceptions for non-secure use of SHA1 and weak crypto
libraries.
- Replaced `ioutil` with `io` and `os` (and `t.TempDir` in tests).
- Added fully exhaustive checks for `switch` statements in `pkg/etw`.
- Defined constant strings for `tools/mkwinsyscall`.
- Removed unnecessary conversions.
- Made sure `context.Cancel` was called.
Additionally, added `//go:build windows" constraints on files with
unexported code, since linter will complain about unused code on
non-Windows platforms.
Added a stub `main() {}` for `mkwinsyscall` for non-Windows builds, just in
case `//go:generate` directives are added to OS-agnostic files.
Signed-off-by: Hamza El-Saawy <hamzaelsaawy@microsoft.com>
* PR: spelling, constants, fuzzing
Moved HVSocket fuzzing tests to separate file with go 1.18 build
constraint.
Signed-off-by: Hamza El-Saawy <hamzaelsaawy@microsoft.com>
Signed-off-by: Hamza El-Saawy <hamzaelsaawy@microsoft.com>
90 lines
3.7 KiB
Markdown
90 lines
3.7 KiB
Markdown
# go-winio [](https://github.com/microsoft/go-winio/actions/workflows/ci.yml)
|
|
|
|
This repository contains utilities for efficiently performing Win32 IO operations in
|
|
Go. Currently, this is focused on accessing named pipes and other file handles, and
|
|
for using named pipes as a net transport.
|
|
|
|
This code relies on IO completion ports to avoid blocking IO on system threads, allowing Go
|
|
to reuse the thread to schedule another goroutine. This limits support to Windows Vista and
|
|
newer operating systems. This is similar to the implementation of network sockets in Go's net
|
|
package.
|
|
|
|
Please see the LICENSE file for licensing information.
|
|
|
|
## Contributing
|
|
|
|
This project welcomes contributions and suggestions.
|
|
Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that
|
|
you have the right to, and actually do, grant us the rights to use your contribution.
|
|
For details, visit [Microsoft CLA](https://cla.microsoft.com).
|
|
|
|
When you submit a pull request, a CLA-bot will automatically determine whether you need to
|
|
provide a CLA and decorate the PR appropriately (e.g., label, comment).
|
|
Simply follow the instructions provided by the bot.
|
|
You will only need to do this once across all repos using our CLA.
|
|
|
|
Additionally, the pull request pipeline requires the following steps to be performed before
|
|
mergining.
|
|
|
|
### Code Sign-Off
|
|
|
|
We require that contributors sign their commits using [`git commit --signoff`][git-commit-s]
|
|
to certify they either authored the work themselves or otherwise have permission to use it in this project.
|
|
|
|
A range of commits can be signed off using [`git rebase --signoff`][git-rebase-s].
|
|
|
|
Please see [the developer certificate](https://developercertificate.org) for more info,
|
|
as well as to make sure that you can attest to the rules listed.
|
|
Our CI uses the DCO Github app to ensure that all commits in a given PR are signed-off.
|
|
|
|
### Linting
|
|
|
|
Code must pass a linting stage, which uses [`golangci-lint`][lint].
|
|
The linting settings are stored in [`.golangci.yaml`](./.golangci.yaml), and can be run
|
|
automatically with VSCode by adding the following to your workspace or folder settings:
|
|
|
|
```json
|
|
"go.lintTool": "golangci-lint",
|
|
"go.lintOnSave": "package",
|
|
```
|
|
|
|
Additional editor [integrations options are also available][lint-ide].
|
|
|
|
Alternatively, `golangci-lint` can be [installed locally][lint-install] and run from the repo root:
|
|
|
|
```shell
|
|
# use . or specify a path to only lint a package
|
|
# to show all lint errors, use flags "--max-issues-per-linter=0 --max-same-issues=0"
|
|
> golangci-lint run ./...
|
|
```
|
|
|
|
### Go Generate
|
|
|
|
The pipeline checks that auto-generated code, via `go generate`, are up to date.
|
|
|
|
This can be done for the entire repo:
|
|
|
|
```shell
|
|
> go generate ./...
|
|
```
|
|
|
|
## Code of Conduct
|
|
|
|
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
|
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
|
|
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
|
|
|
## Special Thanks
|
|
|
|
Thanks to [natefinch][natefinch] for the inspiration for this library.
|
|
See [npipe](https://github.com/natefinch/npipe) for another named pipe implementation.
|
|
|
|
[lint]: https://golangci-lint.run/
|
|
[lint-ide]: https://golangci-lint.run/usage/integrations/#editor-integration
|
|
[lint-install]: https://golangci-lint.run/usage/install/#local-installation
|
|
|
|
[git-commit-s]: https://git-scm.com/docs/git-commit#Documentation/git-commit.txt--s
|
|
[git-rebase-s]: https://git-scm.com/docs/git-rebase#Documentation/git-rebase.txt---signoff
|
|
|
|
[natefinch]: https://github.com/natefinch
|