You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Open-IM-Server/test/typecheck/README.md

2.5 KiB

OpenIM Typecheck: Cross-Platform Source Code Type Checking for Go

Introduction

OpenIM Typecheck is a robust tool designed for cross-platform source code type checking across all Go build platforms. This utility leverages Gos built-in parsing and type-check libraries (go/parser and go/types) to deliver efficient and reliable code analysis.

Advantages

  • Speed: A complete compilation with OpenIM can take approximately 3 minutes. In contrast, OpenIM Typecheck achieves this in mere seconds, significantly enhancing productivity.
  • Resource Efficiency: Unlike the typical requirement of over 40GB of RAM for standard processes, Typecheck operates effectively with less than 8GB of RAM. This reduction in resource consumption makes it highly suitable for a variety of systems, reducing overheads and facilitating smoother operations.

Implementation

OpenIM Typecheck employs Go's native parsing and type-checking libraries (go/parser and go/types). However, it's important to note that these libraries aren't identical to those used by the Go compiler. While occasional mismatches may occur, these libraries generally provide close approximations to the compiler's functionality, offering a reliable basis for type checking.

Error Handling

Typecheck's approach to error handling is pragmatic, focusing on practicality and build continuity.

Errors reported by go/types but not by go build:

  • Actual Errors (as per the specification):
    • These should ideally be rectified. If rectification is not feasible, such as in cases of ongoing work or external dependencies in the code, these errors can be overlooked.
      • Example: Unused variables within a closure.
  • False Positives:
    • These errors should be ignored and, where appropriate, reported upstream for resolution.
      • Example: Type mismatches between staging and generated types.

Errors reported by go build but not by us:

  • CGo-related errors, including both syntax and linker issues, are outside our scope.

Usage

Locally

To run Typecheck locally, simply use the following command:

make verify

Continuous Integration (CI)

In CI environments, Typecheck can be integrated into the workflow as follows:

- name: Typecheck
  run: make verify

This streamlined process facilitates efficient error detection and resolution, ensuring a robust and reliable build pipeline.

More to learn about typecheck share blog