Add FAQ section on StreamListener for v4
authorHarmon <Harmon758@gmail.com>
Sat, 23 Oct 2021 16:49:05 +0000 (11:49 -0500)
committerHarmon <Harmon758@gmail.com>
Sat, 23 Oct 2021 16:49:05 +0000 (11:49 -0500)
docs/faq.rst

index dd904c38ae87db2456ee8b57160c636c58eeab6a..9f5378fa0a1c572770f96744d2506394f65de6e5 100644 (file)
@@ -73,6 +73,18 @@ These parameters can be passed as keyword arguments instead.
 
 Refer to the documentation for the :class:`API` method being used.
 
+Where did ``StreamListener`` go?
+--------------------------------
+
+If you're attempting to import ``StreamListener`` with Tweepy v4, you'll get an
+:class:`AttributeError` about ``tweepy`` not having a ``StreamListener``
+attribute.
+
+This is because Tweepy v4.0.0 merged ``StreamListener`` into :class:`Stream`.
+
+To use Tweepy v4, you'll need to update your code to subclass :class:`Stream`
+instead.
+
 Twitter API v2
 ==============