extjs-dependencies
Resolves and sorts all dependencies of an Ext JS project.
Features:
- Build your Ext JS project without having to use the sencha tools.
- No dependency to any particular build system. So it's a ideal base to add Ext JS dependency detection to any build system.
- Only includes the source files you really need.
- Sorts your source files in the right order.
You are using gulp?
Check out gulp-extjs - the gulp plugin based on extjs-dependencies
.
Basic usage
Install extjs-dependencies
in your project:
npm install --save-dev extjs-dependencies
Then add it to your build:
var extdeps = ; var extFiles = extdeps; // extFiles = [// 'ext/ext-dev.js',// 'ext/src/button/Button.js',// ...// 'app/view/Main.js',// 'app.js'// ]
Using a separate Ext JS script
If you prefer to load the Ext JS core using an extra script tag, you can exclude it from your build:
var extdeps = ; var extFiles = extdeps;
All options
var extdeps = ;var espree = ; var extFiles = extdeps;
API
resolveFiles(options)
Resolves and sorts all dependencies of an Ext JS project.
Parameter: See "All options".
Returns: A sorted array of paths to the source files (relative to options.root
).
resolve(options)
Does the same as resolveFiles
, but returns an array of objects with information for each source file.
Tip: If you set optimizeSource
to true
, you can use the src
attribute of the ExtFile
object to create a better optimized build. However this will break source maps.
Parameter: See "All options".
Returns: A sorted array of objects with information for each source file.
Attributes of the returned objects:
fileInfopath; // The path to the source file (relative to `options.root`)fileInfocontent; // The raw content of the source file (the optimized source is in extFile)fileInfoextFile; // The parser result. See `parse`.
parse(src, filePath, options)
Parses a single source file.
Parameters:
src
the source code as string. If you don't have the source loaded, usedparseFile
instead (see below).filePath
the path to the source file. Should be relative tooptions.root
.options
See "All options", only the following attributes are used:optimizeSource
,excludeClasses
,skipParse
andextraDependencies
.
Returns: A ExtFile
object.
Attributes of ExtFile
objects:
extFilenames; // The class names defined in the source fileextFileparentName; // The name of the parent class. May be `null`extFilealiasNames; // Alias names of other classes (not necessarily defined in this source file)extFilerequires; // Strong dependencies (which must be loaded before this source file)extFileuses; // Weak dependencies (which can be loaded after this source file)extFilesrc; // The source code (is optimized if `optimizeSource` is `true`)extFilepath; // The path to the source file (relative to `options.root`)
parseFile(filePath, options)
Loads and parses a single source file.
Parameters:
filePath
the path to the source file. Should be relative tooptions.root
.options
See "All options".
Returns: A ExtFile
object. See parse
.
createDummyExtFile(filePath)
Creates a dummy ExtFile
object without any dependencies. Can be used to include other scripts.
Parameter: the path to the source file. Should be relative to options.root
.
Returns: A dummy ExtFile
object.
Attributes of the dummy ExtFile
object:
extFilenames; // An array holding the `filePath`extFilepath; // The `filePath`
History
This project is based on the parser used in grunt-extjs-dependencies
written by Rowan Crawford and Christofer Pak.
You can find the original code in the grunt-extjs-dependencies project.
The original parser has strong dependencies to grunt and others. Since I needed to determine Ext JS dependencies in a non-grunt environment, I decided to extract the parser and to remove those dependencies.