Comment signaler “pas encore implémenté”?

Dans la rédaction initiale d’un nouveau joyau, je dois laisser certaines implémentations de méthodes vides (à mettre en œuvre dans la suivante)

Par conséquent, je voudrais signaler une exception “pas encore implémentée”

Je me demande s’il existe une bonne pratique ou des conventions standard spécifiques au langage Ruby pour coder ce type d’espace réservé / exception.

ie: quelque chose comme:

  • UnsupportedOperationException en Java
  • NotImplementedException dans .Net Framework (C #)

    Vous devriez relancer NotImplementedError

     raise NotImplementedError 

    ruby-doc

    Vous pouvez utiliser le todonotes-gem

    Il y a une documentation avec quelques exemples.

    Il n’implémente pas une exception, mais un mécanisme de journalisation et une possibilité de solutions temporaires.

    On dirait que la réponse originale, qui a suggéré de relever NotImplementedError , a été supprimée. Je vais prendre une fissure: écrivez la documentation.

    N’ajoutez pas de code qui n’est qu’un espace réservé. Vous ne voudriez pas que les gens codent contre cette API, alors ne leur donne même pas une chance (y compris vous-même). Au lieu de cela, documentez la feuille de route que vous planifiez actuellement dans la classe et / ou le fichier README. Alors soyez ouvert à ce changement. Au moment de résoudre le problème, vous avez de nouvelles idées sur la solution appropriée. Je pense que c’est la bonne ligne de conduite dans tout langage / cadre, mais je pense que Ruby en particulier nous encourage à ne pas écrire de code que vous ne prévoyez pas avoir exécuté.

    Ne mentionnez pas les méthodes non implémentées dans les documents, ou mentionnez qu’elles ne sont pas encore implémentées. C’est tout.

    Ruby NoMethodError une NoMethodError pour vous quand vous appelez une méthode non existante. Cela devrait être suffisant pour la plupart des cas.