From 737f5bdaa708be4cbaec58eb4b1b939d8d897a6a Mon Sep 17 00:00:00 2001
From: Matus Valo <matusvalo@users.noreply.github.com>
Date: Mon, 9 May 2022 19:22:27 +0200
Subject: [PATCH] Added while-used message example (#6562)

---
 doc/data/messages/w/while-used/bad.py      | 12 ++++++++++++
 doc/data/messages/w/while-used/good.py     | 10 ++++++++++
 doc/data/messages/w/while-used/pylintrc    |  2 ++
 doc/data/messages/w/while-used/related.rst |  1 +
 4 files changed, 25 insertions(+)
 create mode 100644 doc/data/messages/w/while-used/bad.py
 create mode 100644 doc/data/messages/w/while-used/good.py
 create mode 100644 doc/data/messages/w/while-used/pylintrc
 create mode 100644 doc/data/messages/w/while-used/related.rst

diff --git a/doc/data/messages/w/while-used/bad.py b/doc/data/messages/w/while-used/bad.py
new file mode 100644
index 0000000000..8839b1a830
--- /dev/null
+++ b/doc/data/messages/w/while-used/bad.py
@@ -0,0 +1,12 @@
+import requests
+
+
+def fetch_data():
+    i = 1
+    while i < 6:  # [while-used]
+        print(f'Attempt {i}...')
+        try:
+            return requests.get('https://example.com/data')
+        except requests.exceptions.RequestException:
+            pass
+        i += 1
diff --git a/doc/data/messages/w/while-used/good.py b/doc/data/messages/w/while-used/good.py
new file mode 100644
index 0000000000..3f2be4860a
--- /dev/null
+++ b/doc/data/messages/w/while-used/good.py
@@ -0,0 +1,10 @@
+import requests
+
+
+def fetch_data():
+    for i in range(1, 6):
+        print(f'Attempt {i}...')
+        try:
+            return requests.get('https://example.com/data')
+        except requests.exceptions.RequestException:
+            pass
diff --git a/doc/data/messages/w/while-used/pylintrc b/doc/data/messages/w/while-used/pylintrc
new file mode 100644
index 0000000000..90fe02d2d7
--- /dev/null
+++ b/doc/data/messages/w/while-used/pylintrc
@@ -0,0 +1,2 @@
+[master]
+load-plugins=pylint.extensions.while_used
diff --git a/doc/data/messages/w/while-used/related.rst b/doc/data/messages/w/while-used/related.rst
new file mode 100644
index 0000000000..9763d05747
--- /dev/null
+++ b/doc/data/messages/w/while-used/related.rst
@@ -0,0 +1 @@
+- `Stackoverflow discussion <https://stackoverflow.com/questions/920645/when-to-use-while-or-for-in-python>`_