Staredit Network > Forums > SC1 Mapping Tools > Topic: YATAPI - Python friendly API for trigger generation
YATAPI - Python friendly API for trigger generation
Feb 28 2019, 12:45 am
By: sethmachine  

Feb 28 2019, 12:45 am sethmachine Post #1



Hi everyone,

I have created a Python API to generate TrigEdit style triggers that can be copy and pasted into SCMDraft called YATAPI (Yet Another Trigger API).

Please see the GitHub repo for full information: https://github.com/sethmachine/yatapi

Yet Another Trigger API (YATAPI) is a Python based generator of SCMDraft TrigEdit triggers featuring type annotations, autocompletion (with a Python IDE) one-to-one correspondence with TrigEdit triggers, and object oriented programming design. YATAPI is designed to work with PyCharm, a modern Python IDE, and requires only basic Python scripting knowledge and how Starcraft Triggers work. YATAPI is minimalist and extensible, and can be used as the base for more advanced triggering. Since YATAPI is a whitebox--it has a one-to-one correspondence with Starcraft Triggers, there is no need to learn a new specialized triggering language or framework.

I am aware there are numerous other tools and frameworks that accomplish this and more. However, none of them were able to meet my development needs. In particular being easily usable in a modern IDE like PyCharm and easy to understand. It also appears many of the macro triggers projects aren't active anymore. I have a table in the GitHub repo README.md comparing YATAPI to other tools according to the dimensions I needed for my projects.

Note YATAPI does not add new triggers or features, just an OOP interface to easily and verifiably generate triggers in large numbers. YATAPI does not add new syntactic sugar or useful features like death counter management. I believe these could be developed in another Python based project that builds upon YATAPI (as a dependency).

YATAPI is not complete and most obviously is missing some Actions and Conditions. I encourage anyone to contribute to this open source project who is interested!



None.

Apr 13 2019, 5:12 am Tassaar930 Post #2



This looks pretty great but I noticed that in your documentation in comparing the various trigger preprocessors out there that you didn't seem to have included TrigEdit++. Ironically, I also only stumbled across your project because I was looking for the open source listing for TrigEdit++, which also happens to be sourced on GitHub.

Given that TrigEdit++ is a full-native solution (you can just open up the editor in SCMDraft, CTRL+A, CTRL+V, CTRL+S, and then close the window and your triggers are automatically saved), it already has strong advantages that YATAPI cannot have (unless you include an option to compile directly to map or something like that). Still, this looks like it is probably a very good solution for those who like Python (over Lua, which is what TrigEdit++'s parser is written for).



None.

May 11 2019, 4:51 pm sethmachine Post #3



Quote from Tassaar930
This looks pretty great but I noticed that in your documentation in comparing the various trigger preprocessors out there that you didn't seem to have included TrigEdit++. Ironically, I also only stumbled across your project because I was looking for the open source listing for TrigEdit++, which also happens to be sourced on GitHub.

Given that TrigEdit++ is a full-native solution (you can just open up the editor in SCMDraft, CTRL+A, CTRL+V, CTRL+S, and then close the window and your triggers are automatically saved), it already has strong advantages that YATAPI cannot have (unless you include an option to compile directly to map or something like that). Still, this looks like it is probably a very good solution for those who like Python (over Lua, which is what TrigEdit++'s parser is written for).

I can't seem to find TrigEdit++ on GitHub, would you mind sharing a link? :D

YATAPI targets a workflow that excludes using the GUI editor, i.e. all triggers/logic are maintained and written separate of the actual map. I agree that it's a disadvantage that you still have to copy+paste the output of YATAPI into SCMDraft. I am working on a separate project called chkjson to address this, which will create a Python API to directly compile triggers into a map without ever having to open it in a GUI like SCMDraft (no more copy+paste!).

It is a distinct advantage that YATAPI is in Python, as this allows for using any modern IDE like PyCharm, Notepad++, etc. with all features like autocompletion, syntax highlighting, etc. for free. It sounds like TrigEdit++ is restricted to the SCMDraft GUI, and can't be used in a typical programming IDE? I think it's a disadvantage to have to open up an editor with SCMDraft and YATAPI shares this because it still relies on SCMDraft TrigEdit format (which will be removed once I have a true trigger parser and compiler in the chkjson project).



None.

May 20 2019, 8:16 am Arta(M) Post #4

Armoha

WOW 57.6MB gif in GitHub repo...

Quote from sethmachine
I can't seem to find TrigEdit++ on GitHub, would you mind sharing a link? :D

TrigEditPlus GitHub repo: https://github.com/phu54321/TrigEditPlus
Post in StarEdit.net : http://www.staredit.net/topic/17036/



maintainer of euddraft and eudplib.
Armo#6637 at Discord :teehee:

Jul 17 2020, 9:31 am Saox Post #5



Trigedit saves do not work for me in SCMDraft. I am unable to save and have them reflected. Any ideas ?



None.

Options
  Back to forum
Please log in to reply to this topic or to report it.
Members in this topic: None.
[06:51 pm]
Vrael -- It is, and I could definitely use a company with a commitment to flexibility, quality, and customer satisfaction to provide effective solutions to dampness and humidity in my urban environment.
[06:50 pm]
NudeRaider -- Vrael
Vrael shouted: Idk, I was looking more for a dehumidifer company which maybe stands out as a beacon of relief amidst damp and unpredictable climates of bustling metropolises. Not sure Amazon qualifies
sounds like moisture control is often a pressing concern in your city
[06:50 pm]
Vrael -- Maybe here on the StarEdit Network I could look through the Forums for some Introductions to people who care about the Topics of Dehumidifiers and Carpet Cleaning?
[06:49 pm]
Vrael -- Perhaps even here I on the StarEdit Network I could look for some Introductions.
[06:48 pm]
Vrael -- On this Topic, I could definitely use some Introductions.
[06:48 pm]
Vrael -- Perhaps that utilizes cutting-edge technology and eco-friendly cleaning products?
[06:47 pm]
Vrael -- Do you know anyone with a deep understanding of the unique characteristics of your carpets, ensuring they receive the specialized care they deserve?
[06:45 pm]
NudeRaider -- Vrael
Vrael shouted: I've also recently becoming interested in Carpet Cleaning, but I'd like to find someone with a reputation for unparalleled quality and attention to detail.
beats me, but I'd make sure to pick the epitome of excellence and nothing less.
[06:41 pm]
Vrael -- It seems like I may need Introductions to multiple companies for the Topics that I care deeply about, even as early as Today, 6:03 am.
[06:38 pm]
Vrael -- I need a go-to solution and someone who understands that Carpets are more than just decorative elements in my home.
Please log in to shout.


Members Online: Roy