Question to seek clarification on the definition of "..." in type signatures

Aberta
#2,847 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
25/100
Tipo de issue
Documentação
Clareza
Precisa de esclarecimento
Status de atividade
Estagnada
Stack de tecnologia
ruby
Domínio
tooling

Direção de pesquisa

Comece lendo o pull request #2540 e a issue #1293; em seguida, compare a discussão deles com as assinaturas Example1 e Example2 nesta issue. Considera-se concluído quando houver uma resolução explícita sobre se ... denota assinaturas herdadas, sobrecargas ou ambos, e sobre se o comportamento ou sua documentação precisam de esclarecimento.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Hi! I have a question regarding ..., specifically relating to https://github.com/ruby/rbs/pull/2540 / https://github.com/ruby/rbs/issues/1293

Prior to seeing this, I thought that:

  • ... is used to denote overloaded method type signatures in the same class/module
  • Overriding a type signature from a class or module overwrites the parent signature, and it is no longer possible to reference it

After seeing this, I realise I possibly didn't understand ..., as it looks to me that:

  • ... is also used to denote "defer to the parent type signature", similar to the super keyword in Ruby
  • ... only denotes super if there are no real method overloads

Take the following examples:

module Foo
  def call: -> Integer
end

class Example1
  include Foo
  def call: -> Float | ...
end

class Example2
  include Foo
  def call: -> Float | ... 
end
class Example2 # Overload/re-open
  def call: -> Symbol
end

It looks to me (by RBS and Steep) that:

  • Example1 uses ... to denote "super", and has type -> Integer | -> Float
  • Example2 uses ... to denote "overload", and has type -> Float | -> Symbol

I think that it would be great to hear what the intention of ... is, but I'll also just mention a couple of my thoughts on it:

  • It feels problematic to me that a library may wish to use ... to denote super, but then the super functionality can be overridden if a user of the library adds an actual overload of the method signature.
  • Re-using ... to denote super could lead to confusion when reading type signatures - it is no longer clear whether this means the type signature is overloaded, or whether it is referring to super, especially if you have to know/understand if there are any re-openings of the class/module.
  • I think having a separate syntax for super may be better here for behaviour and readability

Thanks :)

Linguagem predominante
Ruby
Estrelas
2.2k
Forks
263
Merge médio
1d 20h
PRs com merge (30d)
64

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de ruby/rbs

Todas as issues de ruby/rbs

Issues semelhantes

Mais issues de Ruby

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.