scripts

Scripts for umm modules.

Script list

• init
• generate_assembly_definition
• module/install
• module/uninstall
• project/deploy
• project/remove

Library list

• info
• synchronize

Usage

package.json

Normal

{

  "scripts": {
    "umm:init": "umm-init",
    "umm:generate_assembly_definition": "umm-generate_assembly_definition",
    "umm:module:install": "umm-module-install",
    "umm:module:uninstall": "umm-module-uninstall",
    "postinstall": "npm run --silent umm:module:install",
    "postuninstall": "npm run --silent umm:module:uninstall"
  },

}

• Automatic deployment by umm:module:install.
• Copy assets to Assets/Modules/<module_name>/ from Assets/ in modules excepts listed in .npmignore.

Copy assets from outside of Assets/

{

  "scripts": {
    "umm:init": "umm-init",
    "umm:generate_assembly_definition": "umm-generate_assembly_definition",
    "umm:module:install": "umm-module-install",
    "umm:module:uninstall": "umm-module-uninstall",
    "postinstall": "npm run --silent umm:module:install Foo Bar",
    "postuninstall": "npm run --silent umm:module:uninstall"
  },

}

• Specify command line arguments to umm:module:install.
• Copy assets to Assets/Modules/<module_name>/Foo/ and Assets/Modules/<module_name>/Bar/ from Foo/ and Bar/ in modules excepts listed in .npmignore.
• You can specify one or more argument.

Customized

{

  "scripts": {
    "umm:init": "umm-init",
    "umm:generate_assembly_definition": "umm-generate_assembly_definition",
    "umm:module:install": "umm-module-install",
    "umm:module:uninstall": "umm-module-uninstall",
    "postinstall": "npm run --silent umm:module:install && node ./scripts/postinstall.js",
    "postuninstall": "npm run --silent umm:module:uninstall"
  },

}

• Append calling script into postinstall section if you need to customized deploy.

Deploy as sub project

{

  "scripts": {
    "umm:init": "umm-init",
    "umm:generate_assembly_definition": "umm-generate_assembly_definition",
    "umm:project:deploy": "umm-project-deploy",
    "umm:project:remove": "umm-project-remove",
    "postinstall": "npm run --silent umm:project:deploy",
    "postuninstall": "npm run --silent umm:project:remove"
  },

}

• Automatic deployment by umm:project:deploy
• Copy assets to Assets/Projects/<module_name>/ from Assets/ in modules excepts listed in .npmignore.

Sample for postinstall.js

const umm = require('@umm/scripts');

umm.libraries.synchronize("path/to/source", "path/to/destination");

generate_assembly_definition

• You can generate .asmdef file for module.
  • See also: Unity Manual
• Simply run npm run umm:generate_assembly_definition.
• Append references node automatic from dependencies of package.json.

Signature

libraries.synchronize(source_path, destination_path, [patterns], [overwrite_options], [callback])

• Synchronize assets flexiblly.

Arguments of libraries.synchronize

Argument	Type	Description
source_path	{String}	Copy source path
destination_path	{String}	Copy destination path
patterns	`{Array<String	Object>}`
overwrite_options	{Object}	Overwrite default options
callback	{Function}	Callback function

Details of patterns

Key	Type	Description	Default
pattern	{String}	Designation patterns as glob.	-
overwrite	{Boolean}	Overwrite files if already exists.	true
remove_source	{Boolean}	Remove source files when finish copy.	false
remove_empty_source_directory	{Boolean}	Remove empty directory in source path after finish processing remove_source.	false
remove_deleted_files	{Boolean}	Remove files that do not exist on the source path.	false

Details of overwrite_options

• Parameters are ignored if specified by patterns.

Key	Type	Description	Default
overwrite	{Boolean}	Overwrite files if already exists.	true
remove_source	{Boolean}	Remove source files when finish copy.	false
remove_empty_source_directory	{Boolean}	Remove empty directory in source path after finish processing remove_source.	false
remove_deleted_files	{Boolean}	Remove files that do not exist on the source path.	false

libraries.info

• Information of module as JavaScript Object.

Details of libraries.info

Key	Type	Description
npm_package_name	{String}	Name of npm package.
has_scope	{Boolean}	Package name has scope? (Package name has @ character if scoped.)
development_install	{Boolean}	Set true if installation process is development.
module_name	{String}	Module name.
scope	{String}	Scope of module.
name	{String}	Name of module.
package_path	{String}	Path to package install.
base_path	{String}	Path of project.

Example

{
  npm_package_name: "@umm/sample_module",
  has_scope: true,
  development_install: false,
  module_name: "umm@sample_module",
  scope: "umm",
  name: "sample_module",
  package_path: "/Users/monry/Development/git/monry/some_project/node_modules/@umm/sample_module",
  base_path: "/Users/monry/Development/git/monry/some_project",
}

License

Copyright (c) 2018 Tetsuya Mori

Released under the MIT license, see LICENSE.txt