spmjs / cmd-util

Utilities for common module definition.

cmd-util

Utilities for common module definition.

---

This package is designed for developers, if you are a user, don't read this.

Implements

• ast: parse cmd javascript code, do whatever you want.
• css: css parser
• iduri: solutions for id and uri.

Install

$ npm install cmd-util

Contribute

Yes, please do contribute. But before this, you should read our Contributing Guide.

Changelog

August 12th, 2013 0.3.13

1. @import without quote

August 5th, 2013 0.3.12

1. Can modify require.async

July 23rd, 2013 0.3.11

1. Parsing dependencies for define(id, factory)

June 18th, 2013 0.3.10

1. Passing parent node to filter for css.stringify

Jun 9th, 2013 0.3.9

1. Update uglify js dependency.

May 22nd, 2013 0.3.8

1. Little fix #4

May 21st, 2013 0.3.7

1. Family can has - in its name.

April 19th, 2013 0.3.6

1. Support parse dependency of define('id', null, factory) #2

April 8th, 2013 0.3.5

1. Fix parse dependency of require('foo')('bar')

Mar 29, 2013 0.3.4

1. Only parse require, don't parse require.async

Mar 19, 2013 0.3.3

1. Enhancement of ast. Delete a dependency by return null

Mar 16, 2013 0.3.2

1. add iduri.validateFormat

Mar 14, 2013 0.3.1

1. make css.walk the right way
2. add css.strigify

Mar 14, 2013 0.3.0

1. add css parser

Mar 2, 2013 0.2.0

1. ast.modify return ast instead of string
2. iduri.resolve only resolve cmd uri
3. rewrite ast parser

Feb 1, 2013 0.1.0

This first version.

cmd-util's Issues

ast.js中，获取函数名的方式有错

ast.js代码中多处出现以下类似代码，用于判断代码结点是否为对函数名为require的调用，然后再获取其参数，比如模块 id

if(node instanceof UglifyJS.AST_Call && node.start.value === 'require')

此种方式对如下代码也能判断通过

require('module-a')('abc')

但是，此时 node.args[0] 其实是 'abc'，而不是 'module-a'，也就是说通过上述方式解析require 对应的模块 id 参数值，很有可能是错的

正确的方式应该是

if(node instanceof UglifyJS.AST_Call && node.expression.name === 'require') {
  var id = node.args[0].value
}

css parser

Add a css parser

spmjs/spm2#4

Invalid Version: 0.1.1a1

npm i cmd-util
npm ERR! Invalid Version: 0.1.1a1

npm ERR! A complete log of this run can be found in:
npm ERR! C:\Users\Administrator\AppData\Local\npm-cache_logs\2022-10-08T03_30_45_407Z-debug-0.log

require.async('jquery')能否转换到parsed.async属性中呢！

如题吧，能否把async依赖放到async属性中呢，这样便于用工具替换

require.async('jquery');

到完整路径

require.async('base/jquery/1.10.2/jquery');

把配置简化，现在sea.config必须保留async的别名配置！

这个库处理的是AMD而不是CMD？

parseFirst 不支持带变量的 require

调用 ast.parseFirst , 无法识别字符串拼接的路径, 如:

require("./mycss" + myVar+ ".css");

import css 支持绝对路径

这样可以 import 外部的样式

publish 0.3.13

@lepture 这个库只有你有权限

重写了css模块，速度提升一倍，支持压缩过的样式，误伤几乎为零

直接上 性能测试 😄 有时间更新到版本库~

样式转换前：

/*! define a */
@charset "utf-8";
@import url('nav.css');
@import "foot.css";

/* import common.css *//**/

body { color: red; font-size: 12px; }

/* hello world */

/*! block e */
.a { color: black }
/*! endblock */

/*! block f */
.b { color: white }
/*! block g */
.c { color: yellow }
/*! endblock */
.d { color: green }
/*! endblock */

新版转换后：

/*! block a */
@charset "utf-8";
/*! import nav.css */
/*! import foot.css */

/* import common.css *//**/

body { color: red; font-size: 12px; }

/* hello world */

/*! block e */
.a { color: black }
/*! endblock e */

/*! block f */
.b { color: white }
/*! block g */
.c { color: yellow }
/*! endblock g */
.d { color: green }
/*! endblock f */
/*! endblock a */

上面样式转换10000次新旧效率对比：

css 支持压缩文件

好像压缩后的不行，给你加个用例

@lepture

测试用例文本中有<CR>，导致字符串比对无法通过。

直接上图，求解：

这是怎么回事啊？

parse dependencies

support for

define('id', null, factory)

spmjs/grunt-cmd-concat#12

关于css转换的ast，下面的情况怎么归类？

/*! define a */
/*! block e */
/*! import d */
a {color: ablack}
/*! endblock */

这里转换后import d应该归于谁呢？
第一种归于所属模块

[
  {
    "id": "a",
    "type": "block",
    "code": [
      {
        "id": "e",
        "type": "block",
        "code": [
          {
            "id": "d",
            "type": "import"
          },
          {
            "type": "string",
            "code": "a {color:black;}"
          }
        ]
      }
    ]
  }
]

第二种归于全局

[
  {
    "id": "a",
    "type": "block",
    "code": [
      {
        "id": "e",
        "type": "block",
        "code": [
          {
            "type": "string",
            "code": "a {color:black;}"
          }
        ]
      },
      {
        "id": "d",
        "type": "import"
      }
    ]
  }
]

个人觉得注释写的归于相应模块，@import写的归于全局 😄 求讨论 @popomore @army8735