Precompile Sakefile #5
Open
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Precompiling is useful for writing Sakefile in various compile-to-JS
languages.
Precompiling is performed by JavaScript function from region embedded
in Sakefile and bounded by required marker lines. Marker line format
is inspilred by Vim modeline (but it's different).
Function region (along with marker lines) is suited to be located in
comments of host language:
* marker lines are independent of its prefixes,
* prefix of start marker line is stripped from every following
function source line.
Function must take one argument (string with Sakefile source) and
return string with compiled source.
This commit contains further restrictions to general idea:
* only files without extension are searched for function region,
* start marker must be located in first 5 lines of Sakefile,
* function length is limited to 100 lines.
* format of marker lines:
- start marker line: <prefix><white>sakefile:<white*>{
- end marker line: <prefix><white>sakefile:<white*>}
where <prefix> -- any characters
<white> -- one space or tab character
<white*> -- zero or more spaces or tab characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Precompiling is useful for writing Sakefile in various compile-to-JS languages.
Precompiling is performed by JavaScript function from region embedded in Sakefile and bounded by required marker lines. Marker line format is inspilred by Vim modeline (but it's different).
Function region (along with marker lines) is suited to be located in comments of host language:
Function must take one argument (string with Sakefile source) and return string with compiled source.
PR contains further restrictions to general idea:
<prefix><white>sakefile:<white*>{<prefix><white>sakefile:<white*>}<prefix>-- any characters,<white>-- one space or tab character,<white*>-- zero or more spaces or tab characters