attyc

ATTyC

Currently in Alpha

AngularTemplateTypeChecker is a command line tool that uses typescript to verify angularjs templates. You supply the names and types of the variables that the template uses, and attyc will find any bugs in your template.

Note: Attyc isn't intended to conclusively prove that a template is correct, AFAIK this is impossible in angularjs. Its goal is to give you a bit more confidence that the template is correct. If you want absolute confidence that your templates don't contain errors, upgrade to angular 2 and use the AOT compiler.

Getting Started

To install run npm install -g attyc. For help, run attyc --help.

Attyc needs some metadata about your template to work out the types of template variables. It expects there to be a comment at the very top of the template, containing an edn vector of maps containing the keys :name (variable name), :type (variable type) and optionally :import (path to import the type from). For example:

<!-- [{:name "ctrl" :type "Controller" :import "./controller"}] -->

Once you've added this metadata, run attyc [glob matching template files]

Known Issues

• Attyc works best when you use the "controller as" syntax. If you don't, you'll have to specify every single scope variable you use in the template metadata (ain't nobody got time for that).
• Other than in the ng-init, ng-repeat and ng-options attributes, variable declaration is not allowed. For example, {{ x = 10 }} will cause an error.
• Attyc assumes that if an attribute contains a variable name, then it is an angular expression. This may not always be true.
• Filters are not type checked (although arguments to filters are). This could potentially lead to attyc missing errors. This may change in future.

Building it yourself

• Clone the repo
• Run npm install
• Make sure you have leiningen installed
• Run lein figwheel
• In another terminal, run node dist/main.js
• Figwheel will rebuild the code whenever it changes

For a production build, run lein cljsbuild once prod.