ya_tagscript - Yet Another TagScript fork
Current stable version: v2.0.1
Information
This is a fork of PhenoM4n4n's TagScript, which itself is a fork of JonSnowbd's TagScript, a string templating language.
The main purpose of this fork is to align the Discord-specific blocks with the most recent Discord and discord.py changes (new username system, etc.).
What?
TagScript is a drop-in, easy-to-use string interpreter that lets you provide users with ways of customizing their profiles or chat rooms with interactive text.
For example TagScript comes out of the box with a random block that would let users provide a template that produces a new result each time its ran, or assign math and variables for later use.
Changes in v1
The newly released v1 includes a complete rewrite of the entire parsing and interpretation performed by the TagScriptInterpreter class. This comes with some subtle behavioural changes but great care was taken to keep v1 behaviourally similar to v0 and PhenoM4n4n's fork. Most simple uses should behave the same but especially deeply nested scripts or dynamically assembled ones will most likely require adjustments. Some documentation examples were also outright wrong, so those were also adjusted to reflect the actual behaviour of the pre-existing interpreter.
Oh, no! Behaviour changes?!
To remove the need for dynamically assembled blocks (e.g. command blocks that only happen under some circumstances), v1 only performs interpretation of branches that were actually hit (to the best of its ability).
Take this (very bad) password check script:
{if({args}==123):{command:echo password accepted!}|something else}
If {args} is not in fact equal to 123, the interpreter WILL NOT interpret the
command block AT ALL. It jumps straight to the else section after the | and only
interprets that. This means that for any incorrect values of {args}, the echo
command is NOT included in the list of commands in response.actions.get("commands").
Other blocks with some conditional executions (like all or any) do the same.
Installation
Download the latest version through pip:
pip install ya_tagscript
or
pip install git+https://github.com/MajorTanya/ya_tagscript.git@v2.0.1
Download from a commit:
pip install git+https://github.com/MajorTanya/ya_tagscript.git@<COMMIT_HASH>
Install for editing/development:
git clone https://github.com/MajorTanya/ya_tagscript.git
pip install -e ./ya_tagscript
Dependencies
Python>=3.11- before v1.4.0, this was effectively
>=3.12due to an oversight in testing - after v1.4.0, Python 3.11 is actually supported
- before v1.4.0, this was effectively
discord.py>=2.5.0pyparsing>=3.2.0python-dateutil>=2.9.0
Metadata
Release files for ya-tagscript 2.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ya_tagscript-2.0.1.tar.gz | 113.0 kB | With provenance | Details for ya_tagscript-2.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ya_tagscript-2.0.1-py3-none-any.whl | Python 3 | none | any | Details for ya_tagscript-2.0.1-py3-none-any.whl |
Total release size: 200.2 kB
Security for ya-tagscript 2.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.