class Analyzer::Go::ConnectRpc

Overview

Connect (https://connectrpc.com/) is Buf's gRPC-compatible RPC framework. Generated handlers expose each service method as POST /<package>.<Service>/<Method> over plain HTTP, with JSON and proto content-types negotiated through Content-Type. The service surface is identical to gRPC's, so we reuse the proto files already registered by the gRPC detector.

The analyzer is proto-driven by default — every rpc method on every service in a .proto file becomes one Connect endpoint — and uses a NewXxxServiceHandler( scan over Go sources to attach the wired-up service's mount path when available. A code-driven mount discovery is run alongside so endpoints reference the Go file that registers the handler instead of (or in addition to) the proto file.

Defined in:

analyzer/analyzers/go/connect_rpc.cr

Constant Summary

CONNECT_CONTENT_TYPES = "application/proto, application/json, application/connect+proto, application/connect+json"
HANDLER_KIND_REGEX = /connect\.New(Unary|ClientStream|ServerStream|BidiStream)Handler\s*\(\s*(\w+Procedure)/m

Maps the generated handler-constructor to a streaming descriptor.

HANDLER_NAME_REGEX = /New(\w+ServiceHandler)\s*\(/
IMPORT_MARKER = "connectrpc.com/connect"
PROCEDURE_REGEX = /\b(\w+Procedure)\s*=\s*"(\/[\w.]+\/\w+)"/

Instance Method Summary

Instance methods inherited from class Analyzer::Go::GoEngine

add_param_to_endpoint(param : Param, endpoint : Endpoint) add_param_to_endpoint, add_static_path_if_valid(static_path : Hash(String, String), public_dirs : Array(Hash(String, String))) add_static_path_if_valid, collect_import_path_function_bodies(package_function_bodies : Hash(String, Hash(String, Noir::GoCalleeExtractor::FunctionBody))) : Hash(String, Hash(String, Noir::GoCalleeExtractor::FunctionBody)) collect_import_path_function_bodies, collect_import_path_method_bodies(package_method_bodies : Hash(String, Hash(String, Array(Noir::GoCalleeExtractor::FunctionBody)))) : Hash(String, Hash(String, Array(Noir::GoCalleeExtractor::FunctionBody))) collect_import_path_method_bodies, collect_package_controller_method_bodies(file_contents : Hash(String, String)) : Hash(String, Hash(String, Array(Noir::GoCalleeExtractor::FunctionBody))) collect_package_controller_method_bodies, collect_package_controller_methods(file_contents : Hash(String, String)) : Hash(String, Hash(String, Array(String))) collect_package_controller_methods, collect_package_function_bodies(file_contents : Hash(String, String)) : Hash(String, Hash(String, Noir::GoCalleeExtractor::FunctionBody)) collect_package_function_bodies, collect_package_groups_ts(group_method : String = "Group", import_marker : String | Nil = nil) : Tuple(Hash(String, Hash(String, String)), Hash(String, String)) collect_package_groups_ts, framework_package_dirs(file_contents : Hash(String, String), import_marker : String) : Set(String) framework_package_dirs, framework_route_source_candidate?(content : String, dir : String, framework_dirs : Set(String), import_marker : String, extra_methods : Array(String)) : Bool framework_route_source_candidate?, go_route_source_candidate?(content : String, extra_methods : Array(String)) : Bool go_route_source_candidate?, read_package_file_contents : Hash(String, String) read_package_file_contents, resolve_public_dirs(public_dirs : Array(Hash(String, String))) resolve_public_dirs, resolve_public_dirs_with_glob(public_dirs : Array(Hash(String, String))) resolve_public_dirs_with_glob, static_dir_entry(source_path : String, static_path : String, file_path : String) : Hash(String, String) static_dir_entry, ts_controller_method_bodies_for_directory(package_controller_method_bodies : Hash(String, Hash(String, Array(Noir::GoCalleeExtractor::FunctionBody))), dir : String) : Hash(String, Array(Noir::GoCalleeExtractor::FunctionBody)) ts_controller_method_bodies_for_directory, ts_controller_methods_for_directory(package_controller_methods : Hash(String, Hash(String, Array(String))), dir : String) : Hash(String, Array(String)) ts_controller_methods_for_directory, ts_function_bodies_for_directory(package_function_bodies : Hash(String, Hash(String, Noir::GoCalleeExtractor::FunctionBody)), dir : String) : Hash(String, Noir::GoCalleeExtractor::FunctionBody) ts_function_bodies_for_directory, ts_groups_for_directory(package_groups : Hash(String, Hash(String, String)), dir : String) : Hash(String, String) ts_groups_for_directory

Class methods inherited from class Analyzer::Go::GoEngine

go_test_file?(path : String) : Bool go_test_file?

Instance methods inherited from class Analyzer

analyze analyze, base_path : String base_path, base_paths : Array(String) base_paths, callees_needed? : Bool callees_needed?, logger : NoirLogger logger, parallel_analyze(files : Array(String), &block : String -> Nil) parallel_analyze, read_file_content(path : String) : String read_file_content, result : Array(Endpoint) result, url : String url

Constructor methods inherited from class Analyzer

new(options : Hash(String, YAML::Any)) new

Macros inherited from class Analyzer

define_getter_methods(names) define_getter_methods

Instance methods inherited from module FileHelper

all_files : Array(String) all_files, get_files_by_extension(extension : String) : Array(String) get_files_by_extension, get_files_by_prefix(prefix : String) : Array(String) get_files_by_prefix, get_files_by_prefix_and_extension(prefix : String, extension : String) : Array(String) get_files_by_prefix_and_extension, get_public_dir_files(base_path : String, folder : String) : Array(String) get_public_dir_files, get_public_files(base_path : String, anchors : Array(String) = ["shard.yml", "Gemfile"]) : Array(String) get_public_files

Instance Method Detail

def analyze #

[View source]