1
0
mirror of https://github.com/mikf/gallery-dl.git synced 2024-11-25 04:02:32 +01:00

[docs] add note about 'path-restrict' implementation

https://github.com/mikf/gallery-dl/issues/146#issuecomment-1671892152
This commit is contained in:
Mike Fährmann 2023-08-11 17:35:32 +02:00
parent d319777a24
commit 84089c7368
No known key found for this signature in database
GPG Key ID: 5680CA389D365A88

View File

@ -222,8 +222,15 @@ Description
* ``"ascii"``: ``"^0-9A-Za-z_."`` (only ASCII digits, letters, underscores, and dots)
* ``"ascii+"``: ``"^0-9@-[\\]-{ #-)+-.;=!}~"`` (all ASCII characters except the ones not allowed by Windows)
Note: In a string with 2 or more characters, ``[]^-\`` need to be
escaped with backslashes, e.g. ``"\\[\\]"``
Implementation Detail: For ``strings`` with length >= 2, this option uses a
`Regular Expression Character Set <https://www.regular-expressions.info/charclass.html>`__,
meaning that:
* using a caret ``^`` as first character inverts the set
* character ranges are supported (``0-9a-z``)
* ``]``, ``-``, and ``\`` need to be escaped as
``\\]``, ``\\-``, and ``\\\\`` respectively
to use them as literal characters
extractor.*.path-replace