@salesforce/apex-tmlanguage

    1.6.0 • Public • Published

    Salesforce Apex Language Grammar

    CircleCI Commitizen friendly

    Introduction

    This repository contains the source code for generating the language grammar files for Salesforce's Apex.

    Disclaimer

    Development and setup of this project has not been tested for Windows OS. You may see a node-gyp error - follow the instrutions here to resolve it.

    Development

    To build and test install Node.js do the following:

    • Run npm install to install any dependencies.
    • Run gulp to build.
    • Run npm run test to run tests.

    Output grammars are output in the grammars/ directory.

    To see the token changes from within the Salesforce VS Code Extensions:

    1. Copy the apex.tmLanguage results into ../salesforcedx-vscode/packages/salesforcedx-vscode-apex/node_modules/@salesforce/apex-tmlanguage/grammars/apex.tmLanguage.
    2. From the Command Palette select Developer: Inspect Editor Tokens and Scopes.

    Adding grammar rules

    Token structure is based off of Textmate's Language Grammar guidelines

    Tests for SOQL grammar

    For the standalone SOQL grammar, tests are executed with vscode-tmgrammar-tests.

    test/soql/
    |-- simple_account.soql "Manually" created test cases
    |-- ...
    `-- snapshots/          "Snapshot-based" test cases
        |-- example-*.soql
        |-- example-*.soql.snap
        `-- ...
    

    The difference between manual vs. snapshot tests is that the latter are auto-generated and can be updated with command vscode-tmgrammar-snap -u. They are useful to quickly see the output of applying the grammar and catch regressions.

    The example-* queries were taken from Example SELECT clauses.

    Supported outputs

    • grammars/apex.tmLanguage.cson - for Atom
    • grammars/apex.tmLanguage - TextMate grammar (XML plist)
    • grammars/soql.tmLanguage - TextMate grammar (XML plist) for standalone SOQL files

    Releasing

    Tags on this repo get automatically published as a GitHub release and an NPM package through Travis CI.

    Attribution

    This repository was copied from https://github.com/dotnet/csharp-tmLanguage

    Install

    npm i @salesforce/apex-tmlanguage

    DownloadsWeekly Downloads

    214

    Version

    1.6.0

    License

    MIT

    Unpacked Size

    366 kB

    Total Files

    6

    Last publish

    Collaborators

    • joshwlewis
    • brandon-svec
    • rmohan20.sfdc
    • demianbrecht
    • jgraff
    • cdias
    • conal
    • jgrantham
    • vazexqi
    • mpsenn
    • sfdc_iamigo
    • diervo
    • rsalvador
    • kevinv11n
    • tbliss
    • davidturissini
    • byao
    • pmdartus
    • futuremint_sf
    • interactivellama
    • maratto
    • pallavi.singh
    • smugakamil
    • tausifm
    • kriscfoster
    • brandonm
    • vineet-sinha
    • salesforce-bot
    • harshkothari410
    • ekashida
    • gr8gatsby
    • ravi.jayaramappa
    • apapko
    • krisgraysfdc
    • jleen-sfdc
    • jqian
    • cwallsf
    • dhagberg-sf
    • rasphilco
    • jbfeingold
    • michaelhoefer
    • tlohr
    • dpessoa
    • khawkins
    • jgellin
    • maxreality
    • amphro
    • davidrouten
    • tconn
    • salesforce-releases
    • dehru
    • nazligungor
    • abdulsattar
    • jodarove
    • rxu-sfdc
    • amcconnell-sf
    • nolanlawson
    • sfdctaka
    • fernomac
    • maliroteh-sf
    • justinharringa
    • ahakro
    • rjanamanchi
    • vttikoo
    • dlouvton
    • cafreeman
    • mallik.webaroo
    • jimjag
    • alyssaa14
    • ivarley
    • svanteddu
    • neeraj_g
    • jbartolotta-sfdc