rspec/rules/S1724/rule.adoc

== Why is this an issue?

Deprecated classes and interfaces should be avoided, rather than used, inherited or extended. Deprecation is a warning that the class or interface has been superseded, and will eventually be removed. The deprecation period allows you to make a smooth transition away from the aging, soon-to-be-retired technology.


=== Noncompliant code example

[source,text]
----
/**
 * @deprecated  As of release 1.3, replaced by {@link #Fee}
 */@Deprecated
class Foo { ... }

class Bar extends Foo { ... }
----


=== Compliant solution

[source,text]
----
class Bar extends Fee { ... }
----


=== Exceptions

When the class that extends a deprecated class is itself deprecated, the extending class will be ignored.

[source,text]
----
@Deprecated
class Bar extends Foo { ... } // compliant Bar is deprecated.
----


== Resources

* CWE - https://cwe.mitre.org/data/definitions/477[CWE-477 - Use of Obsolete Functions]

ifdef::env-github,rspecator-view[]

'''
== Implementation Specification
(visible only on this page)

=== Message

"XXX" is deprecated, [extend|implement] the suggested replacement instead.


'''
== Comments And Links
(visible only on this page)

=== is related to: S2214


endif::env-github,rspecator-view[]