RoutineX is a compilation tool designed to enhance the goroutine capabilities of the Golang standard library runtime package.
As a compilation tool for the routine static mode, it supports advanced features such as native goroutine-local storage (TLS).
This enables routine in static mode to achieve higher performance and a safer memory access mechanism.
In the normal mode, routine stores the map and goroutine context data in the g.labels field based on the structure layout.
This requires additional validation and judgment during reading and inheritance, which impacts performance and may not be compatible with future go versions.
To further improve performance and compatibility, the RoutineX compiler uses source code enhancement techniques to export some functions at the lower level,
allowing routine to efficiently and safely access the data of the goroutine structure g.
go install -a github.com/timandy/routinex@latestBefore calling, you need to set the environment variable to append $(go env GOPATH)/bin to PATH, so that routinex can be run directly in the console.
- windows
$env:Path="$env:Path;$(go env GOPATH)\bin"- linux
export PATH="$PATH:$(go env GOPATH)/bin"Using debugging parameters can output logs from routinex.
-
--debugor-doutputs detailed logs. -
--verboseor-voutputs brief logs. -
windows
#!/bin/pwsh
# Set environment variable
$env:Path="$env:Path;$(go env GOPATH)\bin"
# Add parameters
go build -a -toolexec 'routinex -v' -o main.exe .- linux
#!/bin/bash
# Set environment variable
export PATH="$PATH:$(go env GOPATH)/bin"
# Add parameters
go build -a -toolexec 'routinex -v' -o main.exe .If you have already used another toolchain before using routinex, take abc as an example.
Since it cannot be guaranteed that abc has chain transfer functionality, routinex should be placed before the abc toolchain.
After routinex is executed, it will automatically call the abc tool.
- windows
#!/bin/pwsh
# Set environment variable
$env:Path="$env:Path;$(go env GOPATH)\bin"
# Add parameters
go build -a -toolexec 'routinex -v abc' -o main.exe .- linux
#!/bin/bash
# Set environment variable
export PATH="$PATH:$(go env GOPATH)/bin"
# Add parameters
go build -a -toolexec 'routinex -v abc' -o main.exe .RoutineXis released under the Apache License 2.0.
Copyright 2021-2025 TimAndy
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.