openapi: Automatically add python tab whenever required.

As a part of goal of moving towards a common template,
the hardcoded python tabs need to be removed to ensure
that endpoints which don't have python examples can be
covered by the common template as well.

This commit also modifies the markdown extension for python
examples to render empty string in case the examples don't
exist, which would allow it to be called whether the endpoint
has python examples or not.

templates/zerver/api/add-code-playground.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/playgrounds:post|example}
 

templates/zerver/api/add-linkifier.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/filters:post|example}
 

templates/zerver/api/add-reaction.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/{message_id}/reactions:post|example}
 

templates/zerver/api/archive-stream.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/streams/{stream_id}:delete|example}
 

templates/zerver/api/check-messages-match-narrow.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/matches_narrow:get|example}
 

templates/zerver/api/create-custom-profile-field.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/profile_fields:post|example}
 

templates/zerver/api/create-user-group.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/user_groups/create:post|example}
 

templates/zerver/api/create-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users:post|example}
 

templates/zerver/api/deactivate-own-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me:delete|example}
 

templates/zerver/api/deactivate-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/{user_id}:delete|example}
 

templates/zerver/api/delete-message.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/{message_id}:delete|example}
 

templates/zerver/api/delete-queue.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/events:delete|example}
 

templates/zerver/api/get-attachments.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/attachments:get|example}
 

templates/zerver/api/get-custom-emoji.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/emoji:get|example}
 

templates/zerver/api/get-custom-profile-fields.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/profile_fields:get|example}
 

templates/zerver/api/get-linkifiers.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/linkifiers:get|example}
 

templates/zerver/api/get-message-history.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/{message_id}/history:get|example}
 

templates/zerver/api/get-messages.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages:get|example}
 

templates/zerver/api/get-own-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me:get|example}
 

templates/zerver/api/get-raw-message.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/{message_id}:get|example}
 

templates/zerver/api/get-server-settings.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/server_settings:get|example}
 

templates/zerver/api/get-stream-id.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/get_stream_id:get|example}
 

templates/zerver/api/get-stream-topics.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/{stream_id}/topics:get|example}
 

templates/zerver/api/get-streams.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/streams:get|example}
 

templates/zerver/api/get-subscription-status.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/{user_id}/subscriptions/{stream_id}:get|example}
 

templates/zerver/api/get-subscriptions.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/subscriptions:get|example}
 

templates/zerver/api/get-user-by-email.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/{email}:get|example}
 

templates/zerver/api/get-user-groups.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/user_groups:get|example}
 

templates/zerver/api/get-user-presence.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/{user_id_or_email}/presence:get|example}
 

templates/zerver/api/get-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/{user_id}:get|example}
 

templates/zerver/api/get-users.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users:get|example}
 

templates/zerver/api/mark-all-as-read.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/mark_all_as_read:post|example}
 
@@ -42,7 +41,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/mark_stream_as_read:post|example}
 
@@ -80,7 +78,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/mark_topic_as_read:post|example}
 

templates/zerver/api/mute-topic.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/subscriptions/muted_topics:patch|example}
 

templates/zerver/api/mute-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/muted_users/{muted_user_id}:post|example}
 

templates/zerver/api/reactivate-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/{user_id}/reactivate:post|example}
 

templates/zerver/api/register-queue.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/register:post|example}
 

templates/zerver/api/remove-code-playground.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/playgrounds/{playground_id}:delete|example}
 

templates/zerver/api/remove-linkifier.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/filters/{filter_id}:delete|example}
 

templates/zerver/api/remove-reaction.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/{message_id}/reactions:delete|example}
 

templates/zerver/api/remove-user-group.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/user_groups/{user_group_id}:delete|example}
 

templates/zerver/api/render-message.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/render:post|example}
 

templates/zerver/api/reorder-custom-profile-fields.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/profile_fields:patch|example}
 

templates/zerver/api/send-message.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages:post|example}
 

templates/zerver/api/set-typing-status.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/typing:post|example}
 

templates/zerver/api/subscribe.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/subscriptions:post|example}
 

templates/zerver/api/unmute-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/muted_users/{muted_user_id}:delete|example}
 

templates/zerver/api/unsubscribe.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/subscriptions:delete|example}
 

templates/zerver/api/update-display-settings.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/settings/display:patch|example}
 

templates/zerver/api/update-linkifier.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/realm/filters/{filter_id}:patch|example}
 

templates/zerver/api/update-message-flags.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/flags:post|example}
 

templates/zerver/api/update-message.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/messages/{message_id}:patch|example}
 

templates/zerver/api/update-notification-settings.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/settings/notifications:patch|example}
 

templates/zerver/api/update-stream.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/streams/{stream_id}:patch|example}
 

templates/zerver/api/update-subscription-settings.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/me/subscriptions/properties:post|example}
 

templates/zerver/api/update-user-group-members.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/user_groups/{user_group_id}/members:post|example}
 

templates/zerver/api/update-user-group.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/user_groups/{user_group_id}:patch|example}
 

templates/zerver/api/update-user.md

@@ -5,7 +5,6 @@
 ## Usage examples
 
 {start_tabs}
-{tab|python}
 
 {generate_code_example(python)|/users/{user_id}:patch|example}
 

templates/zerver/api/upload-custom-emoji.md

@@ -6,7 +6,6 @@
 
 {start_tabs}
 
-{tab|python}
 
 {generate_code_example(python)|/realm/emoji/{emoji_name}:post|example}
 

templates/zerver/api/upload-file.md

@@ -6,7 +6,6 @@
 
 {start_tabs}
 
-{tab|python}
 
 {generate_code_example(python)|/user_uploads:post|example}
 

zerver/openapi/markdown_extension.py

@@ -129,6 +129,8 @@ def extract_code_example(
 def render_python_code_example(
     function: str, admin_config: bool = False, **kwargs: Any
 ) -> List[str]:
+    if function not in zerver.openapi.python_examples.TEST_FUNCTIONS:
+        return []
     method = zerver.openapi.python_examples.TEST_FUNCTIONS[function]
     function_source_lines = inspect.getsourcelines(method)[0]
 
@@ -139,7 +141,7 @@ def render_python_code_example(
 
     snippets = extract_code_example(function_source_lines, [], PYTHON_EXAMPLE_REGEX)
 
-    code_example = []
+    code_example = ["{tab|python}\n"]
     code_example.append("```python")
     code_example.extend(config)