Proposal to deprecate prototype features

Aperta
#2,841 3 commenti 3 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Refactoring
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
ruby
Ambito
tooling

Direzione di ricerca

Inizia esaminando le implementazioni e l’utilizzo dei prototipi rb, rbi e runtime, insieme alle issue e alla pull request indicate. Verifica in che modo Ripper, RubyVM::AbstractSyntaxTree e rbs-inline sono correlati a queste funzionalità. Il lavoro si considera completato quando sarà stato concordato un piano per gli avvisi di deprecazione in rbs v4 e un piano di rimozione per v5, decidendo inoltre se runtime resterà in uso internamente per core e stdlib.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
Ruby
Stelle
2.2k
Fork
263
Merge medio
1g 20h
PR unite (30g)
64

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di ruby/rbs

Tutte le issue di ruby/rbs

Issue simili

Altre issue su Ruby

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.