@aebzx/slang-tool 1.0.0

package/entry.ts

@@ -0,0 +1,90 @@
+import command from './command.ts'
+import {Command} from 'commander'
+import {fileURLToPath, pathToFileURL} from 'node:url'
+
+export function build_command(){
+    let c=new Command()
+    c.version('1.0.0')
+    c.name('slang')
+    c.description('slang工具链')
+    c.command('init')
+        .description('初始化slang项目')
+        .action(command.init)
+    c.command('compiler')
+        .description('编译slang项目')
+        .action(command.compiler)
+    c.command('run')
+        .description('运行slang项目')
+        .action(command.run)
+    c.command('go')
+        .description('编译并运行slang项目')
+        .action(command.go)
+    c.command('install')
+        .option('--name <name>', '库名')
+        .option('--version <version>', '版本号')
+        .description('安装库')
+        .action(async (options:{name:string,version:string})=>{
+            await command.install(options.name, options.version)
+        })
+    c.command('uninstall')
+        .argument('<name>','库名')
+        .description('卸载库')
+        .action(async (name:string)=>{
+            await command.uninstall(name)
+        })
+    //publish 子命令组
+    let publish=c.command('publish').description('发布')
+    publish.command('module')
+        .description('发布模块')
+        .action(command.publish_module)
+    publish.command('vm')
+        .description('发布vm')
+        .option('--path <path>', 'vm文件路径')
+        .option('--license <license>', '许可证')
+        .option('--isa <isa>','指令集')
+        .option('--version <version>','版本')
+        .action(async (options:{path:string,license:string,isa:string,version:string})=>{
+            await command.publish_vm(options.path, options.license, options.isa, options.version)
+        })
+    publish.command('compiler')
+        .description('发布编译器')
+        .option('--path <path>','compiler文件路径')
+        .option('--large <large>', '所属编译器大版本')
+        .option('--small <small>','编译器版本')
+        .action(async (options:{path:string,large:string,small:string})=>{
+            await command.publish_compiler(options.path, options.large, options.small)
+        })
+    //create 子命令组
+    let create=c.command('create').description('创建')
+    create.command('compiler')
+        .description('创建编译器大版本')
+        .option('--license <license>', '许可证')
+        .option('--version <version>', '版本号')
+        .action(async (options:{license:string,version:string})=>{
+            await command.create_compiler(options.license, options.version)
+        })
+    //config 子命令组
+    let config=c.command('config').description('配置')
+    config.command('set')
+        .description('设置配置')
+        .argument('<key>', '配置键')
+        .argument('<value>', '配置值')
+        .action(async (key:string,value:string)=>{
+            await command.config_set(key,value)
+        })
+    config.command('verify')
+        .description('校验配置')
+        .action(command.config_verify)
+    c.command('register')
+        .description('注册账号')
+        .option('--username <username>', '用户名')
+        .option('--email <email>', '邮箱')
+        .action(async (options:{username:string,email:string})=>{
+            await command.register(options.username, options.email)
+        })
+    return c
+}
+
+//直接运行时才解析参数;被 import(如测试)时不执行
+if(import.meta.url===pathToFileURL(process.argv[1]).href)
+    build_command().parse()

package/model.ts

@@ -0,0 +1,90 @@
+export type GlobalConfig={
+    server:string,
+    username:string,
+    password:string,
+    token:string
+}
+export const DefaultGlobalConfig={
+    server:'',
+    username:'',
+    password:'',
+    token:''
+} as GlobalConfig
+export type ProjectConfig={
+    name:string
+    version:string
+    author:string
+    license:string
+    ignore:string[]
+    optimize:number
+    output:string
+    venv:{
+        dir:string,
+        compiler:string,
+        vm:string,
+        compiler_version:string,
+        vm_version:string
+    }
+    dependency:{name:string,version:string}[]
+    lib:{local:string,data:{name:string,version:string}[]}
+    lock?:{name:string,dependencies:{name:string,version:string}[]}[]
+}
+export type ModuleVersion={
+    version:string,
+    dependencies:{
+        name:string,
+        version:string
+    }[],
+    source:string,
+    hex:string
+}
+export type Module={
+    name:string,
+    author:string,
+    keywords:string[],
+    description: string,
+    license:string,
+    version:ModuleVersion[]
+}
+export type User={
+    email:string,
+    token:string,
+    username:string
+}
+export type VM={
+    version:string,
+    isa:string,
+    author:string,
+    license:string,
+    source:string,
+    hex:string
+}
+export type Config={
+    host:string,
+    port:number,
+    username:string,
+    password:string,
+    email:string,
+    token:string,
+    smtp:string
+}
+export type CompilerChild={
+    version:string,
+    hex:string,
+    source:string
+}
+export type Compiler={
+    author:string,
+    version:string,
+    license:string,
+    child:CompilerChild[]
+}
+export type CompilerConfig=Compiler[]
+export type ModuleConfig=Module[]
+export type VMConfig=VM[]
+export type UserConfig=User[]
+export type Result<T>={
+    message:string
+    data:T,
+    code:number
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@aebzx/slang-tool",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "publish": "npm publish"
+  },
+  "bin": {
+    "slang": "dist/cli.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "devDependencies": {
+    "@types/lzma-native": "^4.0.4",
+    "@types/node": "^26.3.0",
+    "vitest": "^4.1.11"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.6.0",
+    "axios": "^1.19.0",
+    "axios-retry": "^4.5.0",
+    "commander": "^15.0.0",
+    "lzma-native": "^8.0.6",
+    "rolldown": "^1.2.5",
+    "tar": "^7.5.22"
+  }
+}

package/test/entry.test.ts

@@ -0,0 +1,102 @@
+//cli 命令注册测试:验证每个子命令、选项、位置参数都已正确配置
+//commander 15 不支持空格命令名,多词命令拆为父命令+子命令(如 publish module)
+import { describe, expect, it } from 'vitest'
+import type { Command } from 'commander'
+import { build_command } from '../entry.ts'
+
+const c = build_command()
+
+//按路径递归查找命令:find('publish vm') 匹配 publish 下的 vm
+function find(name: string): Command {
+    const parts = name.split(' ')
+    let cur: Command = c
+    for (const p of parts) {
+        const next = cur.commands.find(i => i.name() == p)
+        expect(next, `命令 ${name} 应已注册`).toBeTruthy()
+        cur = next!
+    }
+    return cur
+}
+
+describe('命令注册', () => {
+    it('注册了所有顶层命令', () => {
+        const names = c.commands.map(i => i.name())
+        for (const n of ['init', 'compiler', 'run', 'go', 'install', 'uninstall',
+            'publish', 'create', 'config', 'register'])
+            expect(names).toContain(n)
+    })
+    it('publish 下有 module/vm/compiler 子命令', () => {
+        const names = find('publish').commands.map(i => i.name())
+        expect(names).toEqual(expect.arrayContaining(['module', 'vm', 'compiler']))
+    })
+    it('create 下有 compiler 子命令', () => {
+        expect(find('create').commands.map(i => i.name())).toContain('compiler')
+    })
+    it('config 下有 set/verify 子命令', () => {
+        expect(find('config').commands.map(i => i.name())).toEqual(expect.arrayContaining(['set', 'verify']))
+    })
+})
+
+describe('install 命令', () => {
+    it('有 --name 和 --version 选项', () => {
+        const opts = find('install').options.map(o => o.attributeName())
+        expect(opts).toContain('name')
+        expect(opts).toContain('version')
+    })
+})
+
+describe('uninstall 命令', () => {
+    it('有位置参数 <name>', () => {
+        const args = find('uninstall').registeredArguments.map(a => a.name())
+        expect(args).toContain('name')
+    })
+})
+
+describe('publish vm 命令', () => {
+    it('有 path/license/isa/version 四个选项', () => {
+        const opts = find('publish vm').options.map(o => o.attributeName())
+        for (const o of ['path', 'license', 'isa', 'version'])
+            expect(opts).toContain(o)
+    })
+})
+
+describe('create compiler 命令', () => {
+    it('有 license 和 version 选项', () => {
+        const opts = find('create compiler').options.map(o => o.attributeName())
+        expect(opts).toContain('license')
+        expect(opts).toContain('version')
+    })
+})
+
+describe('publish compiler 命令', () => {
+    it('有 path/large/small 三个选项', () => {
+        const opts = find('publish compiler').options.map(o => o.attributeName())
+        for (const o of ['path', 'large', 'small'])
+            expect(opts).toContain(o)
+    })
+})
+
+describe('config set 命令', () => {
+    it('有 key 和 value 位置参数', () => {
+        const args = find('config set').registeredArguments.map(a => a.name())
+        expect(args).toContain('key')
+        expect(args).toContain('value')
+    })
+})
+
+describe('register 命令', () => {
+    it('有 username 和 email 选项(不再有 password)', () => {
+        const opts = find('register').options.map(o => o.attributeName())
+        expect(opts).toContain('username')
+        expect(opts).toContain('email')
+        expect(opts).not.toContain('password')
+    })
+})
+
+describe('无参命令', () => {
+    it('init/compiler/run/go/config verify/publish module 无位置参数', () => {
+        for (const n of ['init', 'compiler', 'run', 'go', 'config verify', 'publish module']) {
+            expect(find(n).registeredArguments.length, `${n} 不应有位置参数`).toBe(0)
+        }
+    })
+})

package/test/utils.test.ts

@@ -0,0 +1,72 @@
+//cli utils 单元测试:压缩/解压/哈希/项目配置
+//注意:global_config 会读写真实 ~/.slang/config.json,此处不测,避免污染用户环境
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { mkdirSync, mkdtempSync, existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import * as path from 'node:path'
+import {createHash} from 'node:crypto'
+import {compress, decompress, hash_verify, project_config} from '../utils/utils.ts'
+
+let dir = ''
+beforeAll(() => {
+    dir = mkdtempSync(path.join(tmpdir(), 'cli-utils-'))
+})
+afterAll(() => {
+    rmSync(dir, { recursive: true, force: true })
+})
+
+describe('hash_verify', () => {
+    it('正确哈希通过', () => {
+        const data = Buffer.from('hello slang')
+        const hex = createHash('sha256').update(data).digest('hex')
+        expect(hash_verify(data, hex)).toBe(true)
+    })
+    it('错误哈希不通过', () => {
+        expect(hash_verify(Buffer.from('hello'), 'deadbeef')).toBe(false)
+    })
+    it('字符串数据也能校验', () => {
+        const hex = createHash('sha256').update('abc').digest('hex')
+        expect(hash_verify('abc', hex)).toBe(true)
+    })
+})
+
+describe('compress/decompress 往返', () => {
+    it('压缩排除 ignore 目录后可还原', async () => {
+        //项目结构:main.sl 与 lib/ 目录,ignore 排除 lib
+        mkdirSync(path.join(dir, 'lib'), { recursive: true })
+        writeFileSync(path.join(dir, 'main.sl'), 'print("hi")\n')
+        writeFileSync(path.join(dir, 'lib', 'foo.sl'), 'should be ignored')
+        const buf = await compress(['lib'], dir)
+        expect(Buffer.isBuffer(buf)).toBe(true)
+        expect(buf.length).toBeGreaterThan(0)
+
+        //解压到 output,校验哈希,再解出文件
+        const hex = createHash('sha256').update(buf).digest('hex')
+        await decompress('mypkg', buf, path.join(dir, 'out'), hex)
+        expect(readFileSync(path.join(dir, 'out', 'mypkg', 'main.sl'), 'utf-8')).toBe('print("hi")\n')
+        //ignore 的目录不应被打包
+        expect(readdirSync(path.join(dir, 'out', 'mypkg'))).not.toContain('lib')
+    })
+
+    it('哈希不匹配时抛文件校验失败', async () => {
+        writeFileSync(path.join(dir, 'a.sl'), 'a')
+        const buf = await compress([], dir)
+        await expect(decompress('bad', buf, path.join(dir, 'out2'), 'deadbeef'))
+            .rejects.toThrow('文件校验失败')
+        //不应留下任何解压产物
+        expect(existsSync(path.join(dir, 'out2', 'bad'))).toBe(false)
+    })
+})
+
+describe('project_config', () => {
+    it('读取 slang.json', () => {
+        const cfg = {
+            name: 'demo', version: '1.0.0', author: 'tester', license: 'MIT',
+            ignore: ['lib'], optimize: 0, output: 'a.sbin',
+            venv: { dir: 'venv', compiler: '1.0', vm: '2.0', compiler_version: '1.0.0', vm_version: '2.0' },
+            dependency: [], lib: { local: 'lib', data: [] }
+        }
+        writeFileSync(path.join(dir, 'slang.json'), JSON.stringify(cfg))
+        expect(project_config(dir)).toEqual(cfg)
+    })
+})

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "es2017",
+    "module": "esnext",
+    "lib": ["ES2016","DOM","ES2019"],
+    "types": ["node"],
+    "moduleResolution": "bundler",
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": false,
+    "skipLibCheck": true
+  }
+}

package/utils/ajax.ts

@@ -0,0 +1,15 @@
+import axios from 'axios'
+import axiosRetry from 'axios-retry'
+import {global_config} from './utils.ts'
+const ajax=axios.create({
+    baseURL:global_config().server,
+    timeout:5000
+})
+axiosRetry(ajax,{
+    retryDelay:(retryCount) => {
+        return retryCount * 1000
+    },
+    retryCondition:axiosRetry.isNetworkOrIdempotentRequestError,
+    retries:3
+})
+export default ajax

package/utils/index.ts

@@ -0,0 +1,4 @@
+import net from './net.ts'
+export {net}
+export * from './ajax.ts'
+export * from './utils.ts'

package/utils/net.ts

@@ -0,0 +1,75 @@
+import {
+    Compiler,
+    CompilerConfig,
+    ModuleConfig,
+    Result,
+    VM,
+    VMConfig,
+    Module,
+    ModuleVersion,
+    CompilerChild
+} from '../model.ts'
+import ajax from './ajax.ts'
+function check<T>(res:Result<T>){
+    if(res.code!=200)throw new Error(res.message)
+    return res.data
+}
+async function download_vm(version:string){
+    return Buffer.from(check((await ajax.post('/api/download/vm',{version})).data) as string,'base64')
+}
+async function download_module(name:string,version:string){
+    return Buffer.from(check((await ajax.post('/api/download/module',{name,version})).data) as string,'base64')
+}
+async function download_compiler(large_version:string,small_version:string){
+    return check<string>(await ajax.post('/api/download/compiler',{large_version,small_version}))
+}
+async function list_vm(){
+    return check<VMConfig>(await ajax.get('/api/list/vm'))
+}
+async function list_module(){
+    return check<ModuleConfig>(await ajax.get('/api/list/module'))
+}
+async function list_compiler(){
+    return check<CompilerConfig>(await ajax.get('/api/list/compiler'))
+}
+async function publish_vm(author:string,token:string,module:VM,data:Buffer){
+    return check<void>(await ajax.post('/api/publish/vm',{author,token,module,data}))
+}
+async function publish_module(author:string,token:string,module:ModuleVersion,data:Buffer){
+    return check<void>(await ajax.post('/api/publish/module',{author,token,module,data}))
+}
+async function publish_compiler(author:string,token:string,version:string,type:CompilerChild,data:string){
+    return check<void>(await ajax.post('/api/publish/compiler/add',{author,token,version,type,data}))
+}
+async function create_compiler(author:string,token:string,license:string,version:string){
+    return check<void>(await ajax.post('/api/publish/compiler/create',{author,token,license,version}))
+}
+async function register(username:string,email:string){
+    return check<void>(await ajax.post('/api/register',{username,email}))
+}
+async function verify(username:string,token:string){
+    if(((await ajax.get('/api/health')).data as Result<void>).message!='is SPM Server')return '不是SPM服务器'
+    return check<boolean>(await ajax.post('/api/verify',{username,token}))?'':'用户不存在或者token配置不正确'
+}
+export default {
+    download:{
+        vm:download_vm,
+        module:download_module,
+        compiler:download_compiler
+    },
+    list:{
+        vm:list_vm,
+        module:list_module,
+        compiler:list_compiler
+    },
+    publish:{
+        vm:publish_vm,
+        module:publish_module,
+        compiler:publish_compiler,
+        compiler_create:create_compiler
+    },
+    user:{
+        register:register,
+        verify:verify
+    }
+}

package/utils/utils.ts

@@ -0,0 +1,58 @@
+import lzma from 'lzma-native'
+import {c as _compress,x as _decompress} from 'tar'
+import {existsSync, mkdirSync, readFileSync, rmSync, writeFileSync} from 'node:fs'
+import path from 'node:path'
+import {createHash} from 'node:crypto'
+import {DefaultGlobalConfig, GlobalConfig, ProjectConfig} from '../model.ts'
+import os from 'node:os'
+export function lzma_compress(buf:Buffer):Promise<Buffer>{
+    return new Promise((resolve)=>{
+        lzma.compress(buf,{preset:9,synchronous:true},(res)=>{resolve(res)})
+    })
+}
+export function lzma_decompress(str:Buffer):Promise<Buffer>{
+    return new Promise((resolve)=>{
+        lzma.decompress(str,{synchronous:true},(res)=>{resolve(res)})
+    })
+}
+export async function compress(ignore:string[], dir:string=process.cwd()):Promise<Buffer>{
+    const tar_file=path.join(dir,'ls.tar')
+    _compress({gzip:false,cwd:dir,file:tar_file,filter:(p:string)=>{
+            return !ignore.map(i=>p.includes(i)).includes(true)&&!p.includes('ls.tar')
+        },sync:true},['.'])
+    let ret=await lzma_compress(readFileSync(tar_file))
+    rmSync(tar_file)
+    return ret
+}
+export async function decompress(name:string,str:Buffer,output:string,verify:string){
+    //hex 是压缩数据的 sha256(发布时 createHash('sha256').update(data) 对压缩后数据取哈希),
+    //必须先对 str(压缩数据)校验,再解压
+    if(!hash_verify(str,verify))throw new Error('文件校验失败')
+    mkdirSync(output,{recursive:true})
+    mkdirSync(path.join(output,name),{recursive:true})
+    const plain=await lzma_decompress(str)
+    writeFileSync(path.join(output,'ls.tar'),plain)
+    _decompress({file:path.join(output,'ls.tar'),cwd:path.join(output,name),sync:true})
+    rmSync(path.join(output,'ls.tar'))
+}
+export function hash_verify(data:Buffer|string,hex:string){
+    return createHash('sha256').update(data).digest('hex')==hex
+}
+export function global_config():GlobalConfig{
+    if(!existsSync(path.join(os.homedir(),'.slang','config.json')))
+        writeFileSync(path.join(os.homedir(),'.slang','config.json'),JSON.stringify(DefaultGlobalConfig))
+    return JSON.parse(readFileSync(path.join(os.homedir(),'.slang','config.json'),'utf-8')) as GlobalConfig
+}
+export function project_config(dir:string):ProjectConfig{
+    return JSON.parse(readFileSync(path.join(dir,'slang.json'),'utf-8')) as ProjectConfig
+}
+export function verify(dir:string){
+    if(!existsSync(path.join(dir,'slang.json')))
+        throw new Error('不是Slang项目')
+}
+export function write_global_config(config:GlobalConfig){
+    writeFileSync(path.join(os.homedir(),'.slang','config.json'),JSON.stringify(config,null,4))
+}
+export function write_project_config(dir:string,config:ProjectConfig){
+    writeFileSync(path.join(dir,'slang.json'),JSON.stringify(config,null,4))
+}