Proposal to deprecate prototype features

Ouverte
#2,841 3 commentaires 3 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
25/100
Type d'issue
Refactorisation
Clarté
Plutôt claire
Activité
À l'abandon
Stack technique
ruby
Domaine
tooling

Piste de recherche

Commencez par examiner les implémentations et l’utilisation des prototypes rb, rbi et runtime, ainsi que les issues et la pull request référencées. Vérifiez comment Ripper, RubyVM::AbstractSyntaxTree et rbs-inline sont liés à ces fonctionnalités. Le travail est considéré comme terminé lorsqu’un plan convenu pour les avertissements de dépréciation dans rbs v4 et un plan de suppression pour v5 auront été définis, et qu’il aura été décidé si runtime reste utilisé en interne par core et stdlib.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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

Langage dominant
Ruby
Étoiles
2.2k
Forks
263
Merge moyen
1 j 20 h
PR mergées (30 j)
64

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de ruby/rbs

Toutes les issues de ruby/rbs

Issues similaires

Plus d'issues Ruby

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.