#include "rbs_extension.h" #define INTERN_TOKEN(parserstate, tok) \ rb_intern3(\ peek_token(parserstate->lexstate, tok),\ token_bytes(tok),\ rb_enc_get(parserstate->lexstate->string)\ ) #define KEYWORD_CASES \ case kBOOL:\ case kBOT: \ case kCLASS: \ case kFALSE: \ case kINSTANCE: \ case kINTERFACE: \ case kNIL: \ case kSELF: \ case kSINGLETON: \ case kTOP: \ case kTRUE: \ case kVOID: \ case kTYPE: \ case kUNCHECKED: \ case kIN: \ case kOUT: \ case kEND: \ case kDEF: \ case kINCLUDE: \ case kEXTEND: \ case kPREPEND: \ case kALIAS: \ case kMODULE: \ case kATTRREADER: \ case kATTRWRITER: \ case kATTRACCESSOR: \ case kPUBLIC: \ case kPRIVATE: \ case kUNTYPED: \ /* nop */ typedef struct { VALUE required_positionals; VALUE optional_positionals; VALUE rest_positionals; VALUE trailing_positionals; VALUE required_keywords; VALUE optional_keywords; VALUE rest_keywords; } method_params; // /** // * Returns RBS::Location object of `current_token` of a parser state. // * // * @param state // * @return New RBS::Location object. // * */ static VALUE rbs_location_current_token(parserstate *state) { return rbs_location_pp( state->buffer, &state->current_token.range.start, &state->current_token.range.end ); } static VALUE parse_optional(parserstate *state); static VALUE parse_simple(parserstate *state); static VALUE string_of_loc(parserstate *state, position start, position end) { return rb_enc_str_new( RSTRING_PTR(state->lexstate->string) + start.byte_pos, end.byte_pos - start.byte_pos, rb_enc_get(state->lexstate->string) ); } /** * Raises RuntimeError with "Unexpected error " messsage. * */ static NORETURN(void) rbs_abort(void) { rb_raise( rb_eRuntimeError, "Unexpected error" ); } NORETURN(void) raise_syntax_error(parserstate *state, token tok, const char *fmt, ...) { va_list args; va_start(args, fmt); VALUE message = rb_vsprintf(fmt, args); va_end(args); VALUE location = rbs_new_location(state->buffer, tok.range); VALUE type = rb_str_new_cstr(token_type_str(tok.type)); VALUE error = rb_funcall( RBS_ParsingError, rb_intern("new"), 3, location, message, type ); rb_exc_raise(error); } typedef enum { CLASS_NAME = 1, INTERFACE_NAME = 2, ALIAS_NAME = 4 } TypeNameKind; void parser_advance_no_gap(parserstate *state) { if (state->current_token.range.end.byte_pos == state->next_token.range.start.byte_pos) { parser_advance(state); } else { raise_syntax_error( state, state->next_token, "unexpected token" ); } } /* type_name ::= {`::`} (tUIDENT `::`)* | {(tUIDENT `::`)*} | {} */ VALUE parse_type_name(parserstate *state, TypeNameKind kind, range *rg) { VALUE absolute = Qfalse; VALUE path = rb_ary_new(); VALUE namespace; if (rg) { rg->start = state->current_token.range.start; } if (state->current_token.type == pCOLON2) { absolute = Qtrue; parser_advance_no_gap(state); } while ( state->current_token.type == tUIDENT && state->next_token.type == pCOLON2 && state->current_token.range.end.byte_pos == state->next_token.range.start.byte_pos && state->next_token.range.end.byte_pos == state->next_token2.range.start.byte_pos ) { rb_ary_push(path, ID2SYM(INTERN_TOKEN(state, state->current_token))); parser_advance(state); parser_advance(state); } namespace = rbs_namespace(path, absolute); switch (state->current_token.type) { case tLIDENT: if (kind & ALIAS_NAME) goto success; goto error; case tULIDENT: if (kind & INTERFACE_NAME) goto success; goto error; case tUIDENT: if (kind & CLASS_NAME) goto success; goto error; default: goto error; } success: { if (rg) { rg->end = state->current_token.range.end; } return rbs_type_name(namespace, ID2SYM(INTERN_TOKEN(state, state->current_token))); } error: { VALUE ids = rb_ary_new(); if (kind & ALIAS_NAME) { rb_ary_push(ids, rb_str_new_literal("alias name")); } if (kind & INTERFACE_NAME) { rb_ary_push(ids, rb_str_new_literal("interface name")); } if (kind & CLASS_NAME) { rb_ary_push(ids, rb_str_new_literal("class/module/constant name")); } VALUE string = rb_funcall(ids, rb_intern("join"), 1, rb_str_new_cstr(", ")); raise_syntax_error( state, state->current_token, "expected one of %"PRIsVALUE, string ); } } /* type_list ::= {} type `,` ... <`,`> eol | {} type `,` ... `,` eol */ static VALUE parse_type_list(parserstate *state, enum TokenType eol, VALUE types) { while (true) { rb_ary_push(types, parse_type(state)); if (state->next_token.type == pCOMMA) { parser_advance(state); if (state->next_token.type == eol) { break; } } else { if (state->next_token.type == eol) { break; } else { raise_syntax_error( state, state->next_token, "comma delimited type list is expected" ); } } } return types; } static bool is_keyword_token(enum TokenType type) { switch (type) { case tLIDENT: case tUIDENT: case tULIDENT: case tULLIDENT: case tQIDENT: case tBANGIDENT: KEYWORD_CASES return true; default: return false; } } /* function_param ::= {} | {} type */ static VALUE parse_function_param(parserstate *state) { range type_range; type_range.start = state->next_token.range.start; VALUE type = parse_type(state); type_range.end = state->current_token.range.end; if (state->next_token.type == pCOMMA || state->next_token.type == pRPAREN) { range param_range = type_range; VALUE location = rbs_new_location(state->buffer, param_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_optional_child(loc, rb_intern("name"), NULL_RANGE); return rbs_function_param(type, Qnil, location); } else { range name_range = state->next_token.range; range param_range; parser_advance(state); param_range.start = type_range.start; param_range.end = name_range.end; VALUE name = rb_to_symbol(rbs_unquote_string(state, state->current_token.range, 0)); VALUE location = rbs_new_location(state->buffer, param_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_optional_child(loc, rb_intern("name"), name_range); return rbs_function_param(type, name, location); } } static ID intern_token_start_end(parserstate *state, token start_token, token end_token) { return rb_intern3( peek_token(state->lexstate, start_token), end_token.range.end.byte_pos - start_token.range.start.byte_pos, rb_enc_get(state->lexstate->string) ); } /* keyword_key ::= {} `:` | {} keyword <`?`> `:` */ static VALUE parse_keyword_key(parserstate *state) { VALUE key; parser_advance(state); if (state->next_token.type == pQUESTION) { key = ID2SYM(intern_token_start_end(state, state->current_token, state->next_token)); parser_advance(state); } else { key = ID2SYM(INTERN_TOKEN(state, state->current_token)); } return key; } /* keyword ::= {} keyword `:` */ static void parse_keyword(parserstate *state, VALUE keywords) { VALUE key; VALUE param; key = parse_keyword_key(state); parser_advance_assert(state, pCOLON); param = parse_function_param(state); rb_hash_aset(keywords, key, param); return; } /* Returns true if keyword is given. is_keyword === {} KEYWORD `:` */ static bool is_keyword(parserstate *state) { if (is_keyword_token(state->next_token.type)) { if (state->next_token2.type == pCOLON && state->next_token.range.end.byte_pos == state->next_token2.range.start.byte_pos) { return true; } if (state->next_token2.type == pQUESTION && state->next_token3.type == pCOLON && state->next_token.range.end.byte_pos == state->next_token2.range.start.byte_pos && state->next_token2.range.end.byte_pos == state->next_token3.range.start.byte_pos) { return true; } } return false; } /* params ::= {} `)` | `)` | `,` `)` required_params ::= {} function_param `,` | {} | {} optional_params ::= {} `?` function_param `,` | {} `?` | {} rest_params ::= {} `*` function_param `,` | {} `*` | {} trailing_params ::= {} function_param `,` | {} | {} keywords ::= {} required_keyword `,` | {} `?` optional_keyword `,` | {} `**` function_param `,` | {} | {} `?` | {} `**` */ static void parse_params(parserstate *state, method_params *params) { if (state->next_token.type == pRPAREN) { return; } while (true) { VALUE param; switch (state->next_token.type) { case pQUESTION: goto PARSE_OPTIONAL_PARAMS; case pSTAR: goto PARSE_REST_PARAM; case pSTAR2: goto PARSE_KEYWORDS; case pRPAREN: goto EOP; default: if (is_keyword(state)) { goto PARSE_KEYWORDS; } param = parse_function_param(state); rb_ary_push(params->required_positionals, param); break; } if (!parser_advance_if(state, pCOMMA)) { goto EOP; } } PARSE_OPTIONAL_PARAMS: while (true) { VALUE param; switch (state->next_token.type) { case pQUESTION: parser_advance(state); if (is_keyword(state)) { parse_keyword(state, params->optional_keywords); parser_advance_if(state, pCOMMA); goto PARSE_KEYWORDS; } param = parse_function_param(state); rb_ary_push(params->optional_positionals, param); break; default: goto PARSE_REST_PARAM; } if (!parser_advance_if(state, pCOMMA)) { goto EOP; } } PARSE_REST_PARAM: if (state->next_token.type == pSTAR) { parser_advance(state); params->rest_positionals = parse_function_param(state); if (!parser_advance_if(state, pCOMMA)) { goto EOP; } } goto PARSE_TRAILING_PARAMS; PARSE_TRAILING_PARAMS: while (true) { VALUE param; switch (state->next_token.type) { case pQUESTION: goto PARSE_KEYWORDS; case pSTAR: goto EOP; case pSTAR2: goto PARSE_KEYWORDS; case pRPAREN: goto EOP; default: if (is_keyword(state)) { goto PARSE_KEYWORDS; } param = parse_function_param(state); rb_ary_push(params->trailing_positionals, param); break; } if (!parser_advance_if(state, pCOMMA)) { goto EOP; } } PARSE_KEYWORDS: while (true) { switch (state->next_token.type) { case pQUESTION: parser_advance(state); if (is_keyword(state)) { parse_keyword(state, params->optional_keywords); } else { raise_syntax_error( state, state->next_token, "optional keyword argument type is expected" ); } break; case pSTAR2: parser_advance(state); params->rest_keywords = parse_function_param(state); break; case tUIDENT: case tLIDENT: case tULIDENT: case tULLIDENT: case tBANGIDENT: KEYWORD_CASES if (is_keyword(state)) { parse_keyword(state, params->required_keywords); } else { raise_syntax_error( state, state->next_token, "required keyword argument type is expected" ); } break; default: goto EOP; } if (!parser_advance_if(state, pCOMMA)) { goto EOP; } } EOP: if (state->next_token.type != pRPAREN) { raise_syntax_error( state, state->next_token, "unexpected token for method type parameters" ); } return; } /* optional ::= {} | {} simple_type <`?`> */ static VALUE parse_optional(parserstate *state) { range rg; rg.start = state->next_token.range.start; VALUE type = parse_simple(state); if (state->next_token.type == pQUESTION) { parser_advance(state); rg.end = state->current_token.range.end; VALUE location = rbs_new_location(state->buffer, rg); return rbs_optional(type, location); } else { return type; } } static void initialize_method_params(method_params *params){ params->required_positionals = rb_ary_new(); params->optional_positionals = rb_ary_new(); params->rest_positionals = Qnil; params->trailing_positionals = rb_ary_new(); params->required_keywords = rb_hash_new(); params->optional_keywords = rb_hash_new(); params->rest_keywords = Qnil; } /* self_type_binding ::= {} <> | {} `[` `self` `:` type <`]`> */ static VALUE parse_self_type_binding(parserstate *state) { if (state->next_token.type == pLBRACKET) { parser_advance(state); parser_advance_assert(state, kSELF); parser_advance_assert(state, pCOLON); VALUE type = parse_type(state); parser_advance_assert(state, pRBRACKET); return type; } else { return Qnil; } } /* function ::= {} `(` params `)` self_type_binding? `{` `(` params `)` self_type_binding? `->` optional `}` `->` | {} `(` params `)` self_type_binding? `->` | {} self_type_binding? `{` `(` params `)` self_type_binding? `->` optional `}` `->` | {} self_type_binding? `{` self_type_binding `->` optional `}` `->` | {} self_type_binding? `->` */ static void parse_function(parserstate *state, VALUE *function, VALUE *block, VALUE *function_self_type) { method_params params; initialize_method_params(¶ms); if (state->next_token.type == pLPAREN) { parser_advance(state); parse_params(state, ¶ms); parser_advance_assert(state, pRPAREN); } // Passing NULL to function_self_type means the function itself doesn't accept self type binding. (== method type) if (function_self_type) { *function_self_type = parse_self_type_binding(state); } VALUE required = Qtrue; if (state->next_token.type == pQUESTION && state->next_token2.type == pLBRACE) { // Optional block required = Qfalse; parser_advance(state); } if (state->next_token.type == pLBRACE) { parser_advance(state); method_params block_params; initialize_method_params(&block_params); if (state->next_token.type == pLPAREN) { parser_advance(state); parse_params(state, &block_params); parser_advance_assert(state, pRPAREN); } VALUE block_self_type = parse_self_type_binding(state); parser_advance_assert(state, pARROW); VALUE block_return_type = parse_optional(state); *block = rbs_block( rbs_function( block_params.required_positionals, block_params.optional_positionals, block_params.rest_positionals, block_params.trailing_positionals, block_params.required_keywords, block_params.optional_keywords, block_params.rest_keywords, block_return_type ), required, block_self_type ); parser_advance_assert(state, pRBRACE); } parser_advance_assert(state, pARROW); VALUE type = parse_optional(state); *function = rbs_function( params.required_positionals, params.optional_positionals, params.rest_positionals, params.trailing_positionals, params.required_keywords, params.optional_keywords, params.rest_keywords, type ); } /* proc_type ::= {`^`} */ static VALUE parse_proc_type(parserstate *state) { position start = state->current_token.range.start; VALUE function = Qnil; VALUE block = Qnil; VALUE proc_self = Qnil; parse_function(state, &function, &block, &proc_self); position end = state->current_token.range.end; VALUE loc = rbs_location_pp(state->buffer, &start, &end); return rbs_proc(function, block, loc, proc_self); } /** * ... `{` ... `}` ... * > > * */ /* record_attributes ::= {`{`} record_attribute... `}` record_attribute ::= {} keyword_token `:` | {} literal_type `=>` */ VALUE parse_record_attributes(parserstate *state) { VALUE hash = rb_hash_new(); if (state->next_token.type == pRBRACE) { return hash; } while (true) { VALUE key; VALUE type; if (is_keyword(state)) { // { foo: type } syntax key = parse_keyword_key(state); parser_advance_assert(state, pCOLON); } else { // { key => type } syntax switch (state->next_token.type) { case tSYMBOL: case tSQSYMBOL: case tDQSYMBOL: case tSQSTRING: case tDQSTRING: case tINTEGER: case kTRUE: case kFALSE: key = rb_funcall(parse_type(state), rb_intern("literal"), 0); break; default: raise_syntax_error( state, state->next_token, "unexpected record key token" ); } parser_advance_assert(state, pFATARROW); } type = parse_type(state); rb_hash_aset(hash, key, type); if (parser_advance_if(state, pCOMMA)) { if (state->next_token.type == pRBRACE) { break; } } else { break; } } return hash; } /* symbol ::= {} */ static VALUE parse_symbol(parserstate *state) { VALUE string = state->lexstate->string; rb_encoding *enc = rb_enc_get(string); int offset_bytes = rb_enc_codelen(':', enc); int bytes = token_bytes(state->current_token) - offset_bytes; VALUE literal; switch (state->current_token.type) { case tSYMBOL: { char *buffer = peek_token(state->lexstate, state->current_token); literal = ID2SYM(rb_intern3(buffer+offset_bytes, bytes, enc)); break; } case tDQSYMBOL: case tSQSYMBOL: { literal = rb_funcall( rbs_unquote_string(state, state->current_token.range, offset_bytes), rb_intern("to_sym"), 0 ); break; } default: rbs_abort(); } return rbs_literal( literal, rbs_location_current_token(state) ); } /* instance_type ::= {type_name} type_args ::= {} <> /empty/ | {} `[` type_list <`]`> */ static VALUE parse_instance_type(parserstate *state, bool parse_alias) { range name_range; range args_range; range type_range; TypeNameKind expected_kind = INTERFACE_NAME | CLASS_NAME; if (parse_alias) { expected_kind |= ALIAS_NAME; } VALUE typename = parse_type_name(state, expected_kind, &name_range); VALUE types = rb_ary_new(); TypeNameKind kind; if (state->current_token.type == tUIDENT) { kind = CLASS_NAME; } else if (state->current_token.type == tULIDENT) { kind = INTERFACE_NAME; } else if (state->current_token.type == tLIDENT) { kind = ALIAS_NAME; } else { rbs_abort(); } if (state->next_token.type == pLBRACKET) { parser_advance(state); args_range.start = state->current_token.range.start; parse_type_list(state, pRBRACKET, types); parser_advance_assert(state, pRBRACKET); args_range.end = state->current_token.range.end; } else { args_range = NULL_RANGE; } type_range.start = name_range.start; type_range.end = nonnull_pos_or(args_range.end, name_range.end); VALUE location = rbs_new_location(state->buffer, type_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_optional_child(loc, rb_intern("args"), args_range); if (kind == CLASS_NAME) { return rbs_class_instance(typename, types, location); } else if (kind == INTERFACE_NAME) { return rbs_interface(typename, types, location); } else if (kind == ALIAS_NAME) { return rbs_alias(typename, types, location); } else { return Qnil; } } /* singleton_type ::= {`singleton`} `(` type_name <`)`> */ static VALUE parse_singleton_type(parserstate *state) { range name_range; range type_range; parser_assert(state, kSINGLETON); type_range.start = state->current_token.range.start; parser_advance_assert(state, pLPAREN); parser_advance(state); VALUE typename = parse_type_name(state, CLASS_NAME, &name_range); parser_advance_assert(state, pRPAREN); type_range.end = state->current_token.range.end; VALUE location = rbs_new_location(state->buffer, type_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); return rbs_class_singleton(typename, location); } /* simple ::= {} `(` type <`)`> | {} | {} | {} class_instance `[` type_list <`]`> | {} `singleton` `(` type_name <`)`> | {} `[` type_list <`]`> | {} `{` record_attributes <`}`> | {} `^` */ static VALUE parse_simple(parserstate *state) { parser_advance(state); switch (state->current_token.type) { case pLPAREN: { VALUE type = parse_type(state); parser_advance_assert(state, pRPAREN); return type; } case kBOOL: return rbs_base_type(RBS_Types_Bases_Bool, rbs_location_current_token(state)); case kBOT: return rbs_base_type(RBS_Types_Bases_Bottom, rbs_location_current_token(state)); case kCLASS: return rbs_base_type(RBS_Types_Bases_Class, rbs_location_current_token(state)); case kINSTANCE: return rbs_base_type(RBS_Types_Bases_Instance, rbs_location_current_token(state)); case kNIL: return rbs_base_type(RBS_Types_Bases_Nil, rbs_location_current_token(state)); case kSELF: return rbs_base_type(RBS_Types_Bases_Self, rbs_location_current_token(state)); case kTOP: return rbs_base_type(RBS_Types_Bases_Top, rbs_location_current_token(state)); case kVOID: return rbs_base_type(RBS_Types_Bases_Void, rbs_location_current_token(state)); case kUNTYPED: return rbs_base_type(RBS_Types_Bases_Any, rbs_location_current_token(state)); case tINTEGER: { VALUE literal = rb_funcall( string_of_loc(state, state->current_token.range.start, state->current_token.range.end), rb_intern("to_i"), 0 ); return rbs_literal( literal, rbs_location_current_token(state) ); } case kTRUE: return rbs_literal(Qtrue, rbs_location_current_token(state)); case kFALSE: return rbs_literal(Qfalse, rbs_location_current_token(state)); case tSQSTRING: case tDQSTRING: { VALUE literal = rbs_unquote_string(state, state->current_token.range, 0); return rbs_literal( literal, rbs_location_current_token(state) ); } case tSYMBOL: case tSQSYMBOL: case tDQSYMBOL: { return parse_symbol(state); } case tUIDENT: { ID name = INTERN_TOKEN(state, state->current_token); if (parser_typevar_member(state, name)) { return rbs_variable(ID2SYM(name), rbs_location_current_token(state)); } // fallthrough for type name } case tULIDENT: // fallthrough case tLIDENT: // fallthrough case pCOLON2: return parse_instance_type(state, true); case kSINGLETON: return parse_singleton_type(state); case pLBRACKET: { range rg; rg.start = state->current_token.range.start; VALUE types = rb_ary_new(); if (state->next_token.type != pRBRACKET) { parse_type_list(state, pRBRACKET, types); } parser_advance_assert(state, pRBRACKET); rg.end = state->current_token.range.end; return rbs_tuple(types, rbs_new_location(state->buffer, rg)); } case pAREF_OPR: { return rbs_tuple(rb_ary_new(), rbs_new_location(state->buffer, state->current_token.range)); } case pLBRACE: { position start = state->current_token.range.start; VALUE fields = parse_record_attributes(state); parser_advance_assert(state, pRBRACE); position end = state->current_token.range.end; VALUE location = rbs_location_pp(state->buffer, &start, &end); return rbs_record(fields, location); } case pHAT: { return parse_proc_type(state); } default: raise_syntax_error( state, state->current_token, "unexpected token for simple type" ); } } /* intersection ::= {} optional `&` ... '&' | {} */ static VALUE parse_intersection(parserstate *state) { range rg; rg.start = state->next_token.range.start; VALUE type = parse_optional(state); VALUE intersection_types = rb_ary_new(); rb_ary_push(intersection_types, type); while (state->next_token.type == pAMP) { parser_advance(state); rb_ary_push(intersection_types, parse_optional(state)); } rg.end = state->current_token.range.end; if (rb_array_len(intersection_types) > 1) { VALUE location = rbs_new_location(state->buffer, rg); type = rbs_intersection(intersection_types, location); } return type; } /* union ::= {} intersection '|' ... '|' | {} */ VALUE parse_type(parserstate *state) { range rg; rg.start = state->next_token.range.start; VALUE type = parse_intersection(state); VALUE union_types = rb_ary_new(); rb_ary_push(union_types, type); while (state->next_token.type == pBAR) { parser_advance(state); rb_ary_push(union_types, parse_intersection(state)); } rg.end = state->current_token.range.end; if (rb_array_len(union_types) > 1) { VALUE location = rbs_new_location(state->buffer, rg); type = rbs_union(union_types, location); } return type; } /* type_params ::= {} `[` type_param `,` ... <`]`> | {<>} type_param ::= kUNCHECKED? (kIN|kOUT|) tUIDENT (module_type_params == true) type_param ::= tUIDENT (module_type_params == false) */ VALUE parse_type_params(parserstate *state, range *rg, bool module_type_params) { VALUE params = rb_ary_new(); if (state->next_token.type == pLBRACKET) { parser_advance(state); rg->start = state->current_token.range.start; while (true) { VALUE name; bool unchecked = false; VALUE variance = ID2SYM(rb_intern("invariant")); VALUE upper_bound = Qnil; range param_range = NULL_RANGE; range name_range; range variance_range = NULL_RANGE; range unchecked_range = NULL_RANGE; range upper_bound_range = NULL_RANGE; param_range.start = state->next_token.range.start; if (module_type_params) { if (state->next_token.type == kUNCHECKED) { unchecked = true; parser_advance(state); unchecked_range = state->current_token.range; } if (state->next_token.type == kIN || state->next_token.type == kOUT) { switch (state->next_token.type) { case kIN: variance = ID2SYM(rb_intern("contravariant")); break; case kOUT: variance = ID2SYM(rb_intern("covariant")); break; default: rbs_abort(); } parser_advance(state); variance_range = state->current_token.range; } } parser_advance_assert(state, tUIDENT); name_range = state->current_token.range; ID id = INTERN_TOKEN(state, state->current_token); name = ID2SYM(id); parser_insert_typevar(state, id); if (state->next_token.type == pLT) { parser_advance(state); if (state->next_token.type == kSINGLETON) { parser_advance(state); upper_bound = parse_singleton_type(state); } else { parser_advance(state); upper_bound = parse_instance_type(state, false); } } param_range.end = state->current_token.range.end; VALUE location = rbs_new_location(state->buffer, param_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_optional_child(loc, rb_intern("variance"), variance_range); rbs_loc_add_optional_child(loc, rb_intern("unchecked"), unchecked_range); rbs_loc_add_optional_child(loc, rb_intern("upper_bound"), upper_bound_range); VALUE param = rbs_ast_type_param(name, variance, unchecked, upper_bound, location); rb_ary_push(params, param); if (state->next_token.type == pCOMMA) { parser_advance(state); } if (state->next_token.type == pRBRACKET) { break; } } parser_advance_assert(state, pRBRACKET); rg->end = state->current_token.range.end; } else { *rg = NULL_RANGE; } rb_funcall( RBS_AST_TypeParam, rb_intern("resolve_variables"), 1, params ); return params; } /* method_type ::= {} type_params */ VALUE parse_method_type(parserstate *state) { range rg; range params_range = NULL_RANGE; range type_range; VALUE function = Qnil; VALUE block = Qnil; parser_push_typevar_table(state, false); rg.start = state->next_token.range.start; VALUE type_params = parse_type_params(state, ¶ms_range, false); type_range.start = state->next_token.range.start; parse_function(state, &function, &block, NULL); rg.end = state->current_token.range.end; type_range.end = rg.end; parser_pop_typevar_table(state); VALUE location = rbs_new_location(state->buffer, rg); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("type"), type_range); rbs_loc_add_optional_child(loc, rb_intern("type_params"), params_range); return rbs_method_type( type_params, function, block, location ); } /* global_decl ::= {tGIDENT} `:` */ VALUE parse_global_decl(parserstate *state) { range decl_range; range name_range, colon_range; VALUE typename; VALUE type; VALUE location; VALUE comment; rbs_loc *loc; decl_range.start = state->current_token.range.start; comment = get_comment(state, decl_range.start.line); name_range = state->current_token.range; typename = ID2SYM(INTERN_TOKEN(state, state->current_token)); parser_advance_assert(state, pCOLON); colon_range = state->current_token.range; type = parse_type(state); decl_range.end = state->current_token.range.end; location = rbs_new_location(state->buffer, decl_range); loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range); return rbs_ast_decl_global(typename, type, location, comment); } /* const_decl ::= {const_name} `:` */ VALUE parse_const_decl(parserstate *state) { range decl_range; range name_range, colon_range; VALUE typename; VALUE type; VALUE location; VALUE comment; rbs_loc *loc; decl_range.start = state->current_token.range.start; comment = get_comment(state, decl_range.start.line); typename = parse_type_name(state, CLASS_NAME, &name_range); parser_advance_assert(state, pCOLON); colon_range = state->current_token.range; type = parse_type(state); decl_range.end = state->current_token.range.end; location = rbs_new_location(state->buffer, decl_range); loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range); return rbs_ast_decl_constant(typename, type, location, comment); } /* type_decl ::= {kTYPE} alias_name `=` */ VALUE parse_type_decl(parserstate *state, position comment_pos, VALUE annotations) { range decl_range; range keyword_range, name_range, params_range, eq_range; parser_push_typevar_table(state, true); decl_range.start = state->current_token.range.start; comment_pos = nonnull_pos_or(comment_pos, decl_range.start); keyword_range = state->current_token.range; parser_advance(state); VALUE typename = parse_type_name(state, ALIAS_NAME, &name_range); VALUE type_params = parse_type_params(state, ¶ms_range, true); parser_advance_assert(state, pEQ); eq_range = state->current_token.range; VALUE type = parse_type(state); decl_range.end = state->current_token.range.end; VALUE location = rbs_new_location(state->buffer, decl_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_optional_child(loc, rb_intern("type_params"), params_range); rbs_loc_add_required_child(loc, rb_intern("eq"), eq_range); parser_pop_typevar_table(state); return rbs_ast_decl_alias( typename, type_params, type, annotations, location, get_comment(state, comment_pos.line) ); } /* annotation ::= {} */ VALUE parse_annotation(parserstate *state) { VALUE content = rb_funcall(state->buffer, rb_intern("content"), 0); rb_encoding *enc = rb_enc_get(content); range rg = state->current_token.range; int offset_bytes = rb_enc_codelen('%', enc) + rb_enc_codelen('a', enc); unsigned int open_char = rb_enc_mbc_to_codepoint( RSTRING_PTR(state->lexstate->string) + rg.start.byte_pos + offset_bytes, RSTRING_END(state->lexstate->string), enc ); unsigned int close_char; switch (open_char) { case '{': close_char = '}'; break; case '(': close_char = ')'; break; case '[': close_char = ']'; break; case '<': close_char = '>'; break; case '|': close_char = '|'; break; default: rbs_abort(); } int open_bytes = rb_enc_codelen(open_char, enc); int close_bytes = rb_enc_codelen(close_char, enc); char *buffer = RSTRING_PTR(state->lexstate->string) + rg.start.byte_pos + offset_bytes + open_bytes; VALUE string = rb_enc_str_new( buffer, rg.end.byte_pos - rg.start.byte_pos - offset_bytes - open_bytes - close_bytes, enc ); rb_funcall(string, rb_intern("strip!"), 0); VALUE location = rbs_location_current_token(state); return rbs_ast_annotation(string, location); } /* annotations ::= {} annotation ... | {<>} */ void parse_annotations(parserstate *state, VALUE annotations, position *annot_pos) { *annot_pos = NullPosition; while (true) { if (state->next_token.type == tANNOTATION) { parser_advance(state); if (null_position_p((*annot_pos))) { *annot_pos = state->current_token.range.start; } rb_ary_push(annotations, parse_annotation(state)); } else { break; } } } /* method_name ::= {} | {} (IDENT | keyword)~<`?`> */ VALUE parse_method_name(parserstate *state, range *range) { parser_advance(state); switch (state->current_token.type) { case tUIDENT: case tLIDENT: case tULIDENT: case tULLIDENT: KEYWORD_CASES if (state->next_token.type == pQUESTION && state->current_token.range.end.byte_pos == state->next_token.range.start.byte_pos) { range->start = state->current_token.range.start; range->end = state->next_token.range.end; parser_advance(state); ID id = rb_intern3( RSTRING_PTR(state->lexstate->string) + range->start.byte_pos, range->end.byte_pos - range->start.byte_pos, rb_enc_get(state->lexstate->string) ); return ID2SYM(id); } else { *range = state->current_token.range; return ID2SYM(INTERN_TOKEN(state, state->current_token)); } case tBANGIDENT: case tEQIDENT: *range = state->current_token.range; return ID2SYM(INTERN_TOKEN(state, state->current_token)); case tQIDENT: return rb_to_symbol(rbs_unquote_string(state, state->current_token.range, 0)); case pBAR: case pHAT: case pAMP: case pSTAR: case pSTAR2: case pLT: case pAREF_OPR: case tOPERATOR: *range = state->current_token.range; return ID2SYM(INTERN_TOKEN(state, state->current_token)); default: raise_syntax_error( state, state->current_token, "unexpected token for method name" ); } } typedef enum { INSTANCE_KIND, SINGLETON_KIND, INSTANCE_SINGLETON_KIND } InstanceSingletonKind; /* instance_singleton_kind ::= {<>} | {} kSELF <`.`> | {} kSELF~`?` <`.`> @param allow_selfq `true` to accept `self?` kind. */ InstanceSingletonKind parse_instance_singleton_kind(parserstate *state, bool allow_selfq, range *rg) { InstanceSingletonKind kind = INSTANCE_KIND; if (state->next_token.type == kSELF) { range self_range = state->next_token.range; if (state->next_token2.type == pDOT) { parser_advance(state); parser_advance(state); kind = SINGLETON_KIND; rg->start = self_range.start; rg->end = state->current_token.range.end; } else if ( state->next_token2.type == pQUESTION && state->next_token.range.end.char_pos == state->next_token2.range.start.char_pos && state->next_token3.type == pDOT && allow_selfq) { parser_advance(state); parser_advance(state); parser_advance(state); kind = INSTANCE_SINGLETON_KIND; rg->start = self_range.start; rg->end = state->current_token.range.end; } } else { *rg = NULL_RANGE; } return kind; } /** * def_member ::= {kDEF} method_name `:` * | {kPRIVATE2} kDEF method_name `:` * | {kPUBLIC2} kDEF method_name `:` * * method_types ::= {} * | {} <`...`> * | {} method_type `|` * * @param instance_only `true` to reject singleton method definition. * @param accept_overload `true` to accept overloading (...) definition. * */ VALUE parse_member_def(parserstate *state, bool instance_only, bool accept_overload, position comment_pos, VALUE annotations) { range member_range; range visibility_range; range keyword_range; range name_range; range kind_range; range overload_range = NULL_RANGE; VALUE visibility; member_range.start = state->current_token.range.start; comment_pos = nonnull_pos_or(comment_pos, member_range.start); VALUE comment = get_comment(state, comment_pos.line); switch (state->current_token.type) { case kPRIVATE: visibility_range = state->current_token.range; visibility = ID2SYM(rb_intern("private")); member_range.start = visibility_range.start; parser_advance(state); break; case kPUBLIC: visibility_range = state->current_token.range; visibility = ID2SYM(rb_intern("public")); member_range.start = visibility_range.start; parser_advance(state); break; default: visibility_range = NULL_RANGE; visibility = Qnil; break; } keyword_range = state->current_token.range; InstanceSingletonKind kind; if (instance_only) { kind_range = NULL_RANGE; kind = INSTANCE_KIND; } else { kind = parse_instance_singleton_kind(state, NIL_P(visibility), &kind_range); } VALUE name = parse_method_name(state, &name_range); VALUE method_types = rb_ary_new(); VALUE overload = Qfalse; if (state->next_token.type == pDOT && RB_SYM2ID(name) == rb_intern("self?")) { raise_syntax_error( state, state->next_token, "`self?` method cannot have visibility" ); } else { parser_advance_assert(state, pCOLON); } parser_push_typevar_table(state, kind != INSTANCE_KIND); bool loop = true; while (loop) { switch (state->next_token.type) { case pLPAREN: case pARROW: case pLBRACE: case pLBRACKET: case pQUESTION: rb_ary_push(method_types, parse_method_type(state)); member_range.end = state->current_token.range.end; break; case pDOT3: if (accept_overload) { overload = Qtrue; parser_advance(state); loop = false; overload_range = state->current_token.range; member_range.end = overload_range.end; break; } else { raise_syntax_error( state, state->next_token, "unexpected overloading method definition" ); } default: raise_syntax_error( state, state->next_token, "unexpected token for method type" ); } if (state->next_token.type == pBAR) { parser_advance(state); } else { loop = false; } } parser_pop_typevar_table(state); VALUE k; switch (kind) { case INSTANCE_KIND: k = ID2SYM(rb_intern("instance")); break; case SINGLETON_KIND: k = ID2SYM(rb_intern("singleton")); break; case INSTANCE_SINGLETON_KIND: k = ID2SYM(rb_intern("singleton_instance")); break; default: rbs_abort(); } VALUE location = rbs_new_location(state->buffer, member_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_optional_child(loc, rb_intern("kind"), kind_range); rbs_loc_add_optional_child(loc, rb_intern("overload"), overload_range); rbs_loc_add_optional_child(loc, rb_intern("visibility"), visibility_range); return rbs_ast_members_method_definition( name, k, method_types, annotations, location, comment, overload, visibility ); } /** * class_instance_name ::= {} * | {} class_name `[` type args <`]`> * * @param kind * */ void class_instance_name(parserstate *state, TypeNameKind kind, VALUE *name, VALUE args, range *name_range, range *args_range) { parser_advance(state); *name = parse_type_name(state, kind, name_range); if (state->next_token.type == pLBRACKET) { parser_advance(state); args_range->start = state->current_token.range.start; parse_type_list(state, pRBRACKET, args); parser_advance_assert(state, pRBRACKET); args_range->end = state->current_token.range.end; } else { *args_range = NULL_RANGE; } } /** * mixin_member ::= {kINCLUDE} * | {kPREPEND} * | {kEXTEND} * * @param from_interface `true` when the member is in an interface. * */ VALUE parse_mixin_member(parserstate *state, bool from_interface, position comment_pos, VALUE annotations) { range member_range; range name_range; range keyword_range; range args_range = NULL_RANGE; bool reset_typevar_scope; member_range.start = state->current_token.range.start; comment_pos = nonnull_pos_or(comment_pos, member_range.start); keyword_range = state->current_token.range; VALUE klass = Qnil; switch (state->current_token.type) { case kINCLUDE: klass = RBS_AST_Members_Include; reset_typevar_scope = false; break; case kEXTEND: klass = RBS_AST_Members_Extend; reset_typevar_scope = true; break; case kPREPEND: klass = RBS_AST_Members_Prepend; reset_typevar_scope = false; break; default: rbs_abort(); } if (from_interface) { if (state->current_token.type != kINCLUDE) { raise_syntax_error( state, state->current_token, "unexpected mixin in interface declaration" ); } } parser_push_typevar_table(state, reset_typevar_scope); VALUE name; VALUE args = rb_ary_new(); class_instance_name( state, from_interface ? INTERFACE_NAME : (INTERFACE_NAME | CLASS_NAME), &name, args, &name_range, &args_range ); parser_pop_typevar_table(state); member_range.end = state->current_token.range.end; VALUE location = rbs_new_location(state->buffer, member_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_optional_child(loc, rb_intern("args"), args_range); return rbs_ast_members_mixin( klass, name, args, annotations, location, get_comment(state, comment_pos.line) ); } /** * @code * alias_member ::= {kALIAS} method_name * | {kALIAS} kSELF `.` method_name kSELF `.` * @endcode * * @param[in] instance_only `true` to reject `self.` alias. * */ VALUE parse_alias_member(parserstate *state, bool instance_only, position comment_pos, VALUE annotations) { range member_range; range keyword_range, new_name_range, old_name_range; range new_kind_range, old_kind_range; member_range.start = state->current_token.range.start; keyword_range = state->current_token.range; comment_pos = nonnull_pos_or(comment_pos, member_range.start); VALUE comment = get_comment(state, comment_pos.line); VALUE new_name; VALUE old_name; VALUE kind; if (!instance_only && state->next_token.type == kSELF) { kind = ID2SYM(rb_intern("singleton")); new_kind_range.start = state->next_token.range.start; new_kind_range.end = state->next_token2.range.end; parser_advance_assert(state, kSELF); parser_advance_assert(state, pDOT); new_name = parse_method_name(state, &new_name_range); old_kind_range.start = state->next_token.range.start; old_kind_range.end = state->next_token2.range.end; parser_advance_assert(state, kSELF); parser_advance_assert(state, pDOT); old_name = parse_method_name(state, &old_name_range); } else { kind = ID2SYM(rb_intern("instance")); new_name = parse_method_name(state, &new_name_range); old_name = parse_method_name(state, &old_name_range); new_kind_range = NULL_RANGE; old_kind_range = NULL_RANGE; } member_range.end = state->current_token.range.end; VALUE location = rbs_new_location(state->buffer, member_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_required_child(loc, rb_intern("new_name"), new_name_range); rbs_loc_add_required_child(loc, rb_intern("old_name"), old_name_range); rbs_loc_add_optional_child(loc, rb_intern("new_kind"), new_kind_range); rbs_loc_add_optional_child(loc, rb_intern("old_kind"), old_kind_range); return rbs_ast_members_alias( new_name, old_name, kind, annotations, location, comment ); } /* variable_member ::= {tAIDENT} `:` | {kSELF} `.` tAIDENT `:` | {tA2IDENT} `:` */ VALUE parse_variable_member(parserstate *state, position comment_pos, VALUE annotations) { range member_range; range name_range, colon_range; range kind_range = NULL_RANGE; if (rb_array_len(annotations) > 0) { raise_syntax_error( state, state->current_token, "annotation cannot be given to variable members" ); } member_range.start = state->current_token.range.start; comment_pos = nonnull_pos_or(comment_pos, member_range.start); VALUE comment = get_comment(state, comment_pos.line); VALUE klass; VALUE location; VALUE name; VALUE type; switch (state->current_token.type) { case tAIDENT: klass = RBS_AST_Members_InstanceVariable; name_range = state->current_token.range; name = ID2SYM(INTERN_TOKEN(state, state->current_token)); parser_advance_assert(state, pCOLON); colon_range = state->current_token.range; type = parse_type(state); member_range.end = state->current_token.range.end; break; case tA2IDENT: klass = RBS_AST_Members_ClassVariable; name_range = state->current_token.range; name = ID2SYM(INTERN_TOKEN(state, state->current_token)); parser_advance_assert(state, pCOLON); colon_range = state->current_token.range; parser_push_typevar_table(state, true); type = parse_type(state); parser_pop_typevar_table(state); member_range.end = state->current_token.range.end; break; case kSELF: klass = RBS_AST_Members_ClassInstanceVariable; kind_range.start = state->current_token.range.start; kind_range.end = state->next_token.range.end; parser_advance_assert(state, pDOT); parser_advance_assert(state, tAIDENT); name_range = state->current_token.range; name = ID2SYM(INTERN_TOKEN(state, state->current_token)); parser_advance_assert(state, pCOLON); colon_range = state->current_token.range; parser_push_typevar_table(state, true); type = parse_type(state); parser_pop_typevar_table(state); member_range.end = state->current_token.range.end; break; default: rbs_abort(); } location = rbs_new_location(state->buffer, member_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range); rbs_loc_add_optional_child(loc, rb_intern("kind"), kind_range); return rbs_ast_members_variable(klass, name, type, location, comment); } /* visibility_member ::= {<`public`>} | {<`private`>} */ VALUE parse_visibility_member(parserstate *state, VALUE annotations) { if (rb_array_len(annotations) > 0) { raise_syntax_error( state, state->current_token, "annotation cannot be given to visibility members" ); } VALUE klass; switch (state->current_token.type) { case kPUBLIC: klass = RBS_AST_Members_Public; break; case kPRIVATE: klass = RBS_AST_Members_Private; break; default: rbs_abort(); } return rbs_ast_members_visibility( klass, rbs_new_location(state->buffer, state->current_token.range) ); } /* attribute_member ::= {attr_keyword} attr_name attr_var `:` | {visibility} attr_keyword attr_name attr_var `:` | {attr_keyword} `self` `.` attr_name attr_var `:` | {visibility} attr_keyword `self` `.` attr_name attr_var `:` attr_keyword ::= `attr_reader` | `attr_writer` | `attr_accessor` visibility ::= `public` | `private` attr_var ::= # empty | `(` tAIDENT `)` # Ivar name | `(` `)` # No variable */ VALUE parse_attribute_member(parserstate *state, position comment_pos, VALUE annotations) { range member_range; range keyword_range, name_range, colon_range; range kind_range = NULL_RANGE, ivar_range = NULL_RANGE, ivar_name_range = NULL_RANGE, visibility_range = NULL_RANGE; InstanceSingletonKind is_kind; VALUE klass; VALUE kind; VALUE attr_name; VALUE ivar_name; VALUE type; VALUE comment; VALUE location; VALUE visibility; rbs_loc *loc; member_range.start = state->current_token.range.start; comment_pos = nonnull_pos_or(comment_pos, member_range.start); comment = get_comment(state, comment_pos.line); switch (state->current_token.type) { case kPRIVATE: visibility = ID2SYM(rb_intern("private")); visibility_range = state->current_token.range; parser_advance(state); break; case kPUBLIC: visibility = ID2SYM(rb_intern("public")); visibility_range = state->current_token.range; parser_advance(state); break; default: visibility = Qnil; visibility_range = NULL_RANGE; break; } keyword_range = state->current_token.range; switch (state->current_token.type) { case kATTRREADER: klass = RBS_AST_Members_AttrReader; break; case kATTRWRITER: klass = RBS_AST_Members_AttrWriter; break; case kATTRACCESSOR: klass = RBS_AST_Members_AttrAccessor; break; default: rbs_abort(); } is_kind = parse_instance_singleton_kind(state, false, &kind_range); if (is_kind == INSTANCE_KIND) { kind = ID2SYM(rb_intern("instance")); } else { kind = ID2SYM(rb_intern("singleton")); } attr_name = parse_method_name(state, &name_range); if (state->next_token.type == pLPAREN) { parser_advance_assert(state, pLPAREN); ivar_range.start = state->current_token.range.start; if (parser_advance_if(state, tAIDENT)) { ivar_name = ID2SYM(INTERN_TOKEN(state, state->current_token)); ivar_name_range = state->current_token.range; } else { ivar_name = Qfalse; } parser_advance_assert(state, pRPAREN); ivar_range.end = state->current_token.range.end; } else { ivar_name = Qnil; } parser_advance_assert(state, pCOLON); colon_range = state->current_token.range; parser_push_typevar_table(state, is_kind == SINGLETON_KIND); type = parse_type(state); parser_pop_typevar_table(state); member_range.end = state->current_token.range.end; location = rbs_new_location(state->buffer, member_range); loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("colon"), colon_range); rbs_loc_add_optional_child(loc, rb_intern("kind"), kind_range); rbs_loc_add_optional_child(loc, rb_intern("ivar"), ivar_range); rbs_loc_add_optional_child(loc, rb_intern("ivar_name"), ivar_name_range); rbs_loc_add_optional_child(loc, rb_intern("visibility"), visibility_range); return rbs_ast_members_attribute( klass, attr_name, type, ivar_name, kind, annotations, location, comment, visibility ); } /* interface_members ::= {} ... kEND interface_member ::= def_member (instance method only && no overloading) | mixin_member (interface only) | alias_member (instance only) */ VALUE parse_interface_members(parserstate *state) { VALUE members = rb_ary_new(); while (state->next_token.type != kEND) { VALUE annotations = rb_ary_new(); position annot_pos = NullPosition; parse_annotations(state, annotations, &annot_pos); parser_advance(state); VALUE member; switch (state->current_token.type) { case kDEF: member = parse_member_def(state, true, true, annot_pos, annotations); break; case kINCLUDE: case kEXTEND: case kPREPEND: member = parse_mixin_member(state, true, annot_pos, annotations); break; case kALIAS: member = parse_alias_member(state, true, annot_pos, annotations); break; default: raise_syntax_error( state, state->current_token, "unexpected token for interface declaration member" ); } rb_ary_push(members, member); } return members; } /* interface_decl ::= {`interface`} interface_name module_type_params interface_members */ VALUE parse_interface_decl(parserstate *state, position comment_pos, VALUE annotations) { range member_range; range name_range, keyword_range, end_range; range type_params_range = NULL_RANGE; member_range.start = state->current_token.range.start; comment_pos = nonnull_pos_or(comment_pos, member_range.start); parser_push_typevar_table(state, true); keyword_range = state->current_token.range; parser_advance(state); VALUE name = parse_type_name(state, INTERFACE_NAME, &name_range); VALUE params = parse_type_params(state, &type_params_range, true); VALUE members = parse_interface_members(state); parser_advance_assert(state, kEND); end_range = state->current_token.range; member_range.end = end_range.end; parser_pop_typevar_table(state); VALUE location = rbs_new_location(state->buffer, member_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("end"), end_range); rbs_loc_add_optional_child(loc, rb_intern("type_params"), type_params_range); return rbs_ast_decl_interface( name, params, members, annotations, location, get_comment(state, comment_pos.line) ); } /* module_self_types ::= {`:`} module_self_type `,` ... `,` module_self_type ::= | module_name `[` type_list <`]`> */ void parse_module_self_types(parserstate *state, VALUE array) { while (true) { range self_range; range name_range; range args_range = NULL_RANGE; parser_advance(state); self_range.start = state->current_token.range.start; VALUE module_name = parse_type_name(state, CLASS_NAME | INTERFACE_NAME, &name_range); self_range.end = name_range.end; VALUE args = rb_ary_new(); if (state->next_token.type == pLBRACKET) { parser_advance(state); args_range.start = state->current_token.range.start; parse_type_list(state, pRBRACKET, args); parser_advance(state); self_range.end = args_range.end = state->current_token.range.end; } VALUE location = rbs_new_location(state->buffer, self_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_optional_child(loc, rb_intern("args"), args_range); VALUE self_type = rbs_ast_decl_module_self(module_name, args, location); rb_ary_push(array, self_type); if (state->next_token.type == pCOMMA) { parser_advance(state); } else { break; } } } VALUE parse_nested_decl(parserstate *state, const char *nested_in, position annot_pos, VALUE annotations); /* module_members ::= {} ... kEND module_member ::= def_member | variable_member | mixin_member | alias_member | attribute_member | `public` | `private` */ VALUE parse_module_members(parserstate *state) { VALUE members = rb_ary_new(); while (state->next_token.type != kEND) { VALUE member; VALUE annotations = rb_ary_new(); position annot_pos = NullPosition; parse_annotations(state, annotations, &annot_pos); parser_advance(state); switch (state->current_token.type) { case kDEF: member = parse_member_def(state, false, true, annot_pos, annotations); break; case kINCLUDE: case kEXTEND: case kPREPEND: member = parse_mixin_member(state, false, annot_pos, annotations); break; case kALIAS: member = parse_alias_member(state, false, annot_pos, annotations); break; case tAIDENT: case tA2IDENT: case kSELF: member = parse_variable_member(state, annot_pos, annotations); break; case kATTRREADER: case kATTRWRITER: case kATTRACCESSOR: member = parse_attribute_member(state, annot_pos, annotations); break; case kPUBLIC: case kPRIVATE: if (state->next_token.range.start.line == state->current_token.range.start.line) { switch (state->next_token.type) { case kDEF: member = parse_member_def(state, false, true, annot_pos, annotations); break; case kATTRREADER: case kATTRWRITER: case kATTRACCESSOR: member = parse_attribute_member(state, annot_pos, annotations); break; default: raise_syntax_error(state, state->next_token, "method or attribute definition is expected after visibility modifier"); } } else { member = parse_visibility_member(state, annotations); } break; default: member = parse_nested_decl(state, "module", annot_pos, annotations); break; } rb_ary_push(members, member); } return members; } /* module_decl ::= {`module`} module_name module_type_params module_members | {`module`} module_name module_type_params `:` module_self_types module_members */ VALUE parse_module_decl(parserstate *state, position comment_pos, VALUE annotations) { range decl_range; range keyword_range; range name_range; range end_range; range type_params_range; range colon_range; range self_types_range; parser_push_typevar_table(state, true); position start = state->current_token.range.start; comment_pos = nonnull_pos_or(comment_pos, start); VALUE comment = get_comment(state, comment_pos.line); keyword_range = state->current_token.range; decl_range.start = state->current_token.range.start; parser_advance(state); VALUE module_name = parse_type_name(state, CLASS_NAME, &name_range); VALUE type_params = parse_type_params(state, &type_params_range, true); VALUE self_types = rb_ary_new(); if (state->next_token.type == pCOLON) { parser_advance(state); colon_range = state->current_token.range; self_types_range.start = state->next_token.range.start; parse_module_self_types(state, self_types); self_types_range.end = state->current_token.range.end; } else { colon_range = NULL_RANGE; self_types_range = NULL_RANGE; } VALUE members = parse_module_members(state); parser_advance_assert(state, kEND); end_range = state->current_token.range; decl_range.end = state->current_token.range.end; VALUE location = rbs_new_location(state->buffer, decl_range); rbs_loc *loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("end"), end_range); rbs_loc_add_optional_child(loc, rb_intern("type_params"), type_params_range); rbs_loc_add_optional_child(loc, rb_intern("colon"), colon_range); rbs_loc_add_optional_child(loc, rb_intern("self_types"), self_types_range); parser_pop_typevar_table(state); return rbs_ast_decl_module( module_name, type_params, self_types, members, annotations, location, comment ); } /* class_decl_super ::= {} `<` | {<>} */ VALUE parse_class_decl_super(parserstate *state, range *lt_range) { if (parser_advance_if(state, pLT)) { range super_range; range name_range; range args_range = NULL_RANGE; VALUE name; VALUE args; VALUE location; rbs_loc *loc; *lt_range = state->current_token.range; super_range.start = state->next_token.range.start; args = rb_ary_new(); class_instance_name(state, CLASS_NAME, &name, args, &name_range, &args_range); super_range.end = args_range.end; location = rbs_new_location(state->buffer, super_range); loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_optional_child(loc, rb_intern("args"), args_range); return rbs_ast_decl_class_super(name, args, location); } else { *lt_range = NULL_RANGE; return Qnil; } } /* class_decl ::= {`class`} class_name type_params class_decl_super class_members <`end`> */ VALUE parse_class_decl(parserstate *state, position comment_pos, VALUE annotations) { range decl_range; range keyword_range; range name_range; range end_range; range type_params_range; range lt_range; VALUE name; VALUE type_params; VALUE super; VALUE members; VALUE comment; VALUE location; rbs_loc *loc; parser_push_typevar_table(state, true); decl_range.start = state->current_token.range.start; keyword_range = state->current_token.range; comment_pos = nonnull_pos_or(comment_pos, decl_range.start); comment = get_comment(state, comment_pos.line); parser_advance(state); name = parse_type_name(state, CLASS_NAME, &name_range); type_params = parse_type_params(state, &type_params_range, true); super = parse_class_decl_super(state, <_range); members = parse_module_members(state); parser_advance_assert(state, kEND); end_range = state->current_token.range; decl_range.end = end_range.end; parser_pop_typevar_table(state); location = rbs_new_location(state->buffer, decl_range); loc = rbs_check_location(location); rbs_loc_add_required_child(loc, rb_intern("keyword"), keyword_range); rbs_loc_add_required_child(loc, rb_intern("name"), name_range); rbs_loc_add_required_child(loc, rb_intern("end"), end_range); rbs_loc_add_optional_child(loc, rb_intern("type_params"), type_params_range); rbs_loc_add_optional_child(loc, rb_intern("lt"), lt_range); return rbs_ast_decl_class( name, type_params, super, members, annotations, location, comment ); } /* nested_decl ::= {} | {} | {} | {} | {} */ VALUE parse_nested_decl(parserstate *state, const char *nested_in, position annot_pos, VALUE annotations) { VALUE decl; parser_push_typevar_table(state, true); switch (state->current_token.type) { case tUIDENT: case pCOLON2: decl = parse_const_decl(state); break; case tGIDENT: decl = parse_global_decl(state); break; case kTYPE: decl = parse_type_decl(state, annot_pos, annotations); break; case kINTERFACE: decl = parse_interface_decl(state, annot_pos, annotations); break; case kMODULE: decl = parse_module_decl(state, annot_pos, annotations); break; case kCLASS: decl = parse_class_decl(state, annot_pos, annotations); break; default: raise_syntax_error( state, state->current_token, "unexpected token for class/module declaration member" ); } parser_pop_typevar_table(state); return decl; } VALUE parse_decl(parserstate *state) { VALUE annotations = rb_ary_new(); position annot_pos = NullPosition; parse_annotations(state, annotations, &annot_pos); parser_advance(state); switch (state->current_token.type) { case tUIDENT: case pCOLON2: return parse_const_decl(state); case tGIDENT: return parse_global_decl(state); case kTYPE: return parse_type_decl(state, annot_pos, annotations); case kINTERFACE: return parse_interface_decl(state, annot_pos, annotations); case kMODULE: return parse_module_decl(state, annot_pos, annotations); case kCLASS: return parse_class_decl(state, annot_pos, annotations); default: raise_syntax_error( state, state->current_token, "cannot start a declaration" ); } } VALUE parse_signature(parserstate *state) { VALUE decls = rb_ary_new(); while (state->next_token.type != pEOF) { rb_ary_push(decls, parse_decl(state)); } return decls; } static VALUE rbsparser_parse_type(VALUE self, VALUE buffer, VALUE start_pos, VALUE end_pos, VALUE variables, VALUE requires_eof) { parserstate *parser = alloc_parser(buffer, FIX2INT(start_pos), FIX2INT(end_pos), variables); if (parser->next_token.type == pEOF) { return Qnil; } VALUE type = parse_type(parser); if (RTEST(requires_eof)) { parser_advance_assert(parser, pEOF); } free_parser(parser); return type; } static VALUE rbsparser_parse_method_type(VALUE self, VALUE buffer, VALUE start_pos, VALUE end_pos, VALUE variables, VALUE requires_eof) { parserstate *parser = alloc_parser(buffer, FIX2INT(start_pos), FIX2INT(end_pos), variables); if (parser->next_token.type == pEOF) { return Qnil; } VALUE method_type = parse_method_type(parser); if (RTEST(requires_eof)) { parser_advance_assert(parser, pEOF); } free_parser(parser); return method_type; } static VALUE rbsparser_parse_signature(VALUE self, VALUE buffer, VALUE end_pos) { parserstate *parser = alloc_parser(buffer, 0, FIX2INT(end_pos), Qnil); VALUE signature = parse_signature(parser); free_parser(parser); return signature; } void rbs__init_parser(void) { RBS_Parser = rb_define_class_under(RBS, "Parser", rb_cObject); rb_define_singleton_method(RBS_Parser, "_parse_type", rbsparser_parse_type, 5); rb_define_singleton_method(RBS_Parser, "_parse_method_type", rbsparser_parse_method_type, 5); rb_define_singleton_method(RBS_Parser, "_parse_signature", rbsparser_parse_signature, 2); }