Wrap bare URLs in doc comments in angle brackets.

Author: wfraser

.github/workflows/cargo-test.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5.3.0
         with:
-          python-version: "3.10"
+          python-version: "3.11"
 
       - name: Install Python dependencies
         run: |

generator/rust.stoneg.py

@@ -1,5 +1,6 @@
 import contextlib
 from contextlib import contextmanager
+import re
 from typing import Iterator, Optional, Sequence
 
 from rust import RustHelperBackend, EXTRA_DISPLAY_TYPES, REQUIRED_NAMESPACES
@@ -824,8 +825,13 @@ def _emit_doc(self, doc_string: Optional[str], prefix: str = '///') -> None:
                 if idx != 0:
                     self.emit(prefix)
                 docf = lambda tag, val: self._docf(tag, val)
+                text = self.process_doc(chunk, docf)
+                # Find bare URLs and wrap them in `<>`. This intentionlly only matches lowercase
+                # letters so it doesn't match a problematic API example with a token which is part
+                # of a curl command in files/get_temporary_upload_link :(
+                text = re.sub(r"(?<!\()https://(?>[a-z0-9./-]+)(?=\.?(\)|\n|$))", r"<\g<0>>", text)
                 self.emit_wrapped_text(
-                        self.process_doc(chunk, docf),
+                        text,
                         prefix=prefix + ' ', width=100)
 
     def _docf(self, tag: str, val: str) -> str:

src/generated/async_routes/files.rs

@@ -880,10 +880,10 @@ pub fn paper_update<'a>(
         Some(crate::client_helpers::Body::from(body)))
 }
 
-/// Permanently delete the file or folder at a given path (see https://www.dropbox.com/en/help/40).
-/// If the given file or folder is not yet deleted, this route will first delete it. It is possible
-/// for this route to successfully delete, then fail to permanently delete. Note: This endpoint is
-/// only available for Dropbox Business apps.
+/// Permanently delete the file or folder at a given path (see
+/// <https://www.dropbox.com/en/help/40>). If the given file or folder is not yet deleted, this
+/// route will first delete it. It is possible for this route to successfully delete, then fail to
+/// permanently delete. Note: This endpoint is only available for Dropbox Business apps.
 pub fn permanently_delete<'a>(
     client: &'a impl crate::async_client_trait::UserAuthClient,
     arg: &'a DeleteArg,

src/generated/async_routes/team.rs

@@ -535,7 +535,8 @@ pub fn member_space_limits_excluded_users_remove<'a>(
 
 /// Get users custom quota. A maximum of 1000 members can be specified in a single call. Note: to
 /// apply a custom space limit, a team admin needs to set a member space limit for the team first.
-/// (the team admin can check the settings here: https://www.dropbox.com/team/admin/settings/space).
+/// (the team admin can check the settings here:
+/// <https://www.dropbox.com/team/admin/settings/space>).
 pub fn member_space_limits_get_custom_quota<'a>(
     client: &'a impl crate::async_client_trait::TeamAuthClient,
     arg: &'a CustomQuotaUsersArg,
@@ -551,7 +552,8 @@ pub fn member_space_limits_get_custom_quota<'a>(
 
 /// Remove users custom quota. A maximum of 1000 members can be specified in a single call. Note: to
 /// apply a custom space limit, a team admin needs to set a member space limit for the team first.
-/// (the team admin can check the settings here: https://www.dropbox.com/team/admin/settings/space).
+/// (the team admin can check the settings here:
+/// <https://www.dropbox.com/team/admin/settings/space>).
 pub fn member_space_limits_remove_custom_quota<'a>(
     client: &'a impl crate::async_client_trait::TeamAuthClient,
     arg: &'a CustomQuotaUsersArg,
@@ -568,7 +570,7 @@ pub fn member_space_limits_remove_custom_quota<'a>(
 /// Set users custom quota. Custom quota has to be at least 15GB. A maximum of 1000 members can be
 /// specified in a single call. Note: to apply a custom space limit, a team admin needs to set a
 /// member space limit for the team first. (the team admin can check the settings here:
-/// https://www.dropbox.com/team/admin/settings/space).
+/// <https://www.dropbox.com/team/admin/settings/space>).
 pub fn member_space_limits_set_custom_quota<'a>(
     client: &'a impl crate::async_client_trait::TeamAuthClient,
     arg: &'a SetCustomQuotaArg,

src/generated/sync_routes/files.rs

@@ -979,10 +979,10 @@ pub fn paper_update(
     )
 }
 
-/// Permanently delete the file or folder at a given path (see https://www.dropbox.com/en/help/40).
-/// If the given file or folder is not yet deleted, this route will first delete it. It is possible
-/// for this route to successfully delete, then fail to permanently delete. Note: This endpoint is
-/// only available for Dropbox Business apps.
+/// Permanently delete the file or folder at a given path (see
+/// <https://www.dropbox.com/en/help/40>). If the given file or folder is not yet deleted, this
+/// route will first delete it. It is possible for this route to successfully delete, then fail to
+/// permanently delete. Note: This endpoint is only available for Dropbox Business apps.
 pub fn permanently_delete(
     client: &impl crate::client_trait::UserAuthClient,
     arg: &DeleteArg,

src/generated/sync_routes/team.rs

@@ -605,7 +605,8 @@ pub fn member_space_limits_excluded_users_remove(
 
 /// Get users custom quota. A maximum of 1000 members can be specified in a single call. Note: to
 /// apply a custom space limit, a team admin needs to set a member space limit for the team first.
-/// (the team admin can check the settings here: https://www.dropbox.com/team/admin/settings/space).
+/// (the team admin can check the settings here:
+/// <https://www.dropbox.com/team/admin/settings/space>).
 pub fn member_space_limits_get_custom_quota(
     client: &impl crate::client_trait::TeamAuthClient,
     arg: &CustomQuotaUsersArg,
@@ -623,7 +624,8 @@ pub fn member_space_limits_get_custom_quota(
 
 /// Remove users custom quota. A maximum of 1000 members can be specified in a single call. Note: to
 /// apply a custom space limit, a team admin needs to set a member space limit for the team first.
-/// (the team admin can check the settings here: https://www.dropbox.com/team/admin/settings/space).
+/// (the team admin can check the settings here:
+/// <https://www.dropbox.com/team/admin/settings/space>).
 pub fn member_space_limits_remove_custom_quota(
     client: &impl crate::client_trait::TeamAuthClient,
     arg: &CustomQuotaUsersArg,
@@ -642,7 +644,7 @@ pub fn member_space_limits_remove_custom_quota(
 /// Set users custom quota. Custom quota has to be at least 15GB. A maximum of 1000 members can be
 /// specified in a single call. Note: to apply a custom space limit, a team admin needs to set a
 /// member space limit for the team first. (the team admin can check the settings here:
-/// https://www.dropbox.com/team/admin/settings/space).
+/// <https://www.dropbox.com/team/admin/settings/space>).
 pub fn member_space_limits_set_custom_quota(
     client: &impl crate::client_trait::TeamAuthClient,
     arg: &SetCustomQuotaArg,