Proposal to deprecate prototype features

Aberta
#2,841 3 comentários 3 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
Refatoração
Clareza
Razoavelmente clara
Status de atividade
Estagnada
Stack de tecnologia
ruby
Domínio
tooling

Direção de pesquisa

Comece revisando as implementações e o uso dos protótipos rb, rbi e runtime, juntamente com as issues e o pull request referenciados. Verifique como Ripper, RubyVM::AbstractSyntaxTree e rbs-inline se relacionam com esses recursos. O trabalho estará concluído quando houver um plano acordado para os avisos de depreciação no rbs v4 e um plano de remoção para a v5, além da decisão sobre manter ou não runtime para uso interno de core e stdlib.

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

Descrição

RBS has 3 prototype features. I propose to stop maintaining all of them and eventually deprecate them.

Issues

Implementation as Experimental Features

All three prototypes (rb, rbi, runtime) use Ripper or RubyVM::AbstractSyntaxTree.

Both Ripper and RubyVM::AbstractSyntaxTree are experimental features, and their deprecation has also been proposed.

Decreasing Use Cases

rb

The rbs-inline gem almost entirely covers the prototype rb functionality and is planned to be integrated into the rbs repo in rbs v4. It is expected that prototype rb will no longer be used.

rbi

The rbi feature has served its purpose and is likely no longer in use.

runtime

The runtime feature lacks sufficient functionality for use in large-scale codebases like applications, and for simple use cases, rbs-inline is often sufficient.

Deprecation Method

I propose to issue a warning for prototype features starting with rbs v4, indicating they are slated for deprecation, and to completely remove them in v5.

The runtime feature may still have uses for expanding type definitions in core and stdlib, so it is highly likely to remain for internal use within the rbs repository.

Refs

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.