zulip/api_docs
Zixuan James Li 268f858f39 linkifier: Support URL templates for linkifiers.
This swaps out url_format_string from all of our APIs and replaces it
with url_template. Note that the documentation changes in the following
commits  will be squashed with this commit.

We change the "url_format" key to "url_template" for the
realm_linkifiers events in event_schema, along with updating
LinkifierDict. "url_template" is the name chosen to normalize
mixed usages of "url_format_string" and "url_format" throughout
the backend.

The markdown processor is updated to stop handling the format string
interpolation and delegate the task template expansion to the uri_template
library instead.

This change affects many test cases. We mostly just replace "%(name)s"
with "{name}", "url_format_string" with "url_template" to make sure that
they still pass. There are some test cases dedicated for testing "%"
escaping, which aren't relevant anymore and are subject to removal.
But for now we keep most of them as-is, and make sure that "%" is always
escaped since we do not use it for variable substitution any more.

Since url_format_string is not populated anymore, a migration is created
to remove this field entirely, and make url_template non-nullable since
we will always populate it. Note that it is possible to have
url_template being null after migration 0422 and before 0424, but
in practice, url_template will not be None after backfilling and the
backend now is always setting url_template.

With the removal of url_format_string, RealmFilter model will now be cleaned
with URL template checks, and the old checks for escapes are removed.

We also modified RealmFilter.clean to skip the validation when the
url_template is invalid. This avoids raising mulitple ValidationError's
when calling full_clean on a linkifier. But we might eventually want to
have a more centric approach to data validation instead of having
the same validation in both the clean method and the validator.

Fixes #23124.

Signed-off-by: Zixuan James Li <p359101898@gmail.com>
2023-04-19 12:20:49 -07:00
..
include user_topics: Add a new endpoint to update visibility_policy. 2023-04-03 22:31:49 -07:00
api-doc-template.md
api-keys.md settings: Improve wording of "Show API key" modal. 2023-03-08 18:48:37 -08:00
changelog.md linkifier: Support URL templates for linkifiers. 2023-04-19 12:20:49 -07:00
client-libraries.md
configuring-python-bindings.md
construct-narrow.md
create-stream.md
deploying-bots.md
http-headers.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
incoming-webhooks-overview.md web: Save a needless 301 redirect from /integrations to /integrations/. 2023-03-24 14:51:01 -07:00
incoming-webhooks-walkthrough.md api_docs: Fix outdated python code snippet for webhook integrations. 2023-03-20 11:30:38 -07:00
index.md web: Save a needless 301 redirect from /integrations to /integrations/. 2023-03-24 14:51:01 -07:00
installation-instructions.md
integrations-overview.md web: Save a needless 301 redirect from /integrations to /integrations/. 2023-03-24 14:51:01 -07:00
mark-all-as-read.md
missing.md
non-webhook-integrations.md
outgoing-webhooks.md
real-time-events.md
rest-error-handling.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
rest.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
roles-and-permissions.md help: Update URLs to match "Restrict message editing and deletion" title. 2023-02-10 15:56:16 -08:00
running-bots.md
send-message.md message-type: Add support for "direct" as value for type parameter. 2023-04-18 12:29:33 -07:00
sidebar_index.md api_docs: Add page documenting HTTP headers in the api docs. 2023-03-07 12:51:17 -08:00
writing-bots.md