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

wut's tis

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/



maintaining euddraft and eudplib.
Armo#6637 at Discord :teehee:

Options
  Back to forum
Please log in to reply to this topic or to report it.
Members in this topic: None.
[11:13 pm]
Suicidal Insanity -- There was a blue post to that effect, why would it be silly?
[08:37 pm]
NudeRaider -- Suicidal Insanity
Suicidal Insanity shouted: to do with the fact that macos is phasing out 32bit support
that would be silly but might still be true
[08:33 pm]
jjf28 -- there was a neat trick in 1.16.1 with the sprite structure... though it's not in SC:R
[07:43 pm]
Zoan -- I'll try it when I get home
[07:30 pm]
Zoan -- anyone know how to make selection persist through walking in fog of war with eud's? http://www.staredit.net/topic/7729/unread/#special
[02:17 pm]
Suicidal Insanity -- to do with the fact that macos is phasing out 32bit support
[02:17 pm]
Suicidal Insanity -- NudeRaider
NudeRaider shouted: The changes are all "under the hood" main reason for 64 bit is access to more than ~3.5GB RAM. Probably not relevant to Starcraft though.
it may, just maybe, just a littgle, havet
[2019-10-22. : 5:07 am]
NudeRaider -- Ultraviolet
Ultraviolet shouted: NudeRaider <3
even though I clearly put no effort into those arrows? :P
[2019-10-22. : 5:06 am]
NudeRaider -- http://i.snipboard.io/k3C9O2.jpg ... because all the main characters suffocated during this scene
Please log in to shout.


Members Online: Roy, GGmano, karmania392314