MRP OptionParser - (development library) Get out of Regular Expression Hell and parse note tags with

HelloAnnyong

Software Wizard
Member
Joined
Oct 26, 2015
Messages
17
Reaction score
27
First Language
English
MRP OptionParser - version 0.0.14
Mark Przepiora (HelloAnnyong)
 
Usage Terms: Licensed under the Creative Commons Attribution-NonCommercial 4.0. tl;dr: If you use this for your plugin or game, you must credit me (Mark Przepiora / HelloAnnyong) inside your forum post and readme . I would also appreciate you sending me a message letting me know you did so. :) If you plan to use this during the development of your commercial game, please contact me first.

Description:

Never again write brittle regular expressions for parsing your plugins' configuration settings. MRP.OptionParser allows your plugin to accept configuration settings written in a familiar, human-readable "note tag" syntax you are probably already trying to use!
 
Download and installation:
 
Version 0.0.14: Click here to download the ZIP file from GitHub.
 
Extract

dist/rmmv-mrp-core--option-parser.jsand add it to your

js/pluginsfolder and activate it. Easy peasy.
 

Usage:

Please see the full documentation on GitHub for many examples of what you can parse and how!!

However, here are a few quick usage examples.

MRP.OptionParser.parse(str)

Parse a single object from a string. Returns null in case of a syntax error. You might want to use this to parse a plugin parameter.



MRP.OptionParser.extractAll(str)

Parse all objects contained in a string and return an array of them, even if they are surrounded by unrelated text. You might want to use this to extract configuration settings your plugin user defines in, say, an item note.



MRP.OptionParser.extractAllOfType(str, type)

Like above, but extracts only objects of the specified type. Use this to find tags you care about in something like an item note, ignoring tags and other garbage defined for other plugins!

 



 

 

MRP.OptionParser.extractFirst(str)

Like extractAll above, but returns the first match or null if none exists.

MRP.OptionParser.extractFirstOfType(str)

Like extractAllOfType above, but returns the first match or null if none exists.

Changelog:

  • 0.0.14 — Initial release on the forums
FAQ:
 
Do I care about this if I'm just making a game?
 
Probably not! This plugin is designed to be used as a dependency in other plugins.
 

- Can you parse <some crazy syntax not described>?

It doesn't hurt to ask. But probably not. :) What I've defined here is already a very flexible syntax, with support for named tags, positional arguments, named arguments, bare strings, text blocks, etc.

- How do I package this with my plugin?

The simplest way is probably to concatenate the option-parser JS file either to the beginning or end of your plugin file. (Depending on whether you need to use the parser when your script is first parsed.) Alternatively you can require this to be a dependency, but ain't nobody got time for that.

If you happen to be developing your plugin using NPM and Browserify, then rmmv-mrp-core is on npm! Simply add "rmmv-mrp-core" to your package.json as a dependency, run npm install, and then do,

    var OptionParser = require('rmmv-mrp-core/option-parser');
 

Users Who Are Viewing This Thread (Users: 0, Guests: 1)

Latest Threads

Latest Posts

Latest Profile Posts

buinguyenhoangtho wrote on fizzly's profile.
Hello @fizzly, i would like to use your asset/ resource for my project ( is maybe commercial ). May i have your permission? Thanks you !
Working on breaking the limits of RPGMaker! :cool:
I have 470+ hours on RMMV but have only made a demo game, is this normal? :kaoswt: (I lose motivation a lot plus I use a 32gb laptop, so..)
I like Iron Maiden.
Benku wrote on Magnus0808's profile.
Hey man you helped me out a long time ago with a plugin i was wondering if you can help me out one more time since its literally the last thing i need help with if not is cool but id figured id ask you one more soild.

Forum statistics

Threads
95,427
Messages
929,082
Members
125,659
Latest member
AphoticAmaranth
Top