muddler

library1.5.13jsnpmunverified

A CLI tool to transpile, unit test, and minify hackmud scripts (TypeScript or JavaScript). Version 1.5.13 is the latest stable release; the project appears to be in maintenance mode with no recent updates since 2017. It uses Google's Closure Compiler for minification and Mocha for testing. Key differentiators: built specifically for hackmud, supports TypeScript, automatic file watching, and integration with hackmud's script directory.

testing devops

npm install muddler

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MUDDLER

muddler

testingjavascriptv1.5.13

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CLI tool

✓ npx muddler src.ts

✗ require('muddler')

Muddler is a CLI tool, not a library. Use npx or install globally.

Config file

✓ muddle.json

✗ muddler.json

Default config file is 'muddle.json' not 'muddler.json'.

TypeScript support

✓ Use .ts extension for scripts and .test.ts for tests.

✗ Using .js files only and expecting full TypeScript support

TypeScript is transpiled by Muddler, but requires setup.

Shows installation, watching directory, single file processing, and config file usage.

# Install muddler globally npm install -g muddler # Watch current directory and output minified files to hackmud scripts folder muddle -W ./src -d ~/AppData/Roaming/hackmud/1337H4x0r/scripts # Single file transpile, test, and minify muddle myScript.ts -o myScript_mud.js # Config file example (muddle.json): { "srcDir": "./src", "outDir": "./out", "watch": true, "testDir": "./tests" }

Debug

Known issues

breakingRequires Java 7+ and Google Closure Compiler on PATH

fix

Install Java 7+ and download Closure Compiler .jar; add to PATH or place in project directory.

affects: >=0.0.0

deprecatedPackage has not been updated since 2017

fix

Consider migrating to modern alternatives if needed; check issue tracker for unresolved bugs.

affects: >=1.5.0

gotchaConfig file defaults to 'muddle.json' (not 'muddler.json')

fix

Create a file named 'muddle.json' or use -c flag.

affects: >=1.0.0

gotchaTemp files are created in same directory as source script

fix

Ensure write permissions for the source directory.

affects: >=1.5.0

breakingMocha caching false positives before v1.5.0

fix

Upgrade to v1.5.0 or later.

affects: <1.5.0

Errors

Common errors & fixes

java is not recognized

Java not installed or not on PATH

fix

Install Java 7+ and add to PATH environment variable.

Error: The closure compiler .jar file was not found

Closure Compiler not downloaded or not in PATH

fix

Download compiler-latest.zip from Google and extract; ensure 'compiler.jar' is in PATH or current directory.

Error: No tests were found matching pattern

Test files don't follow naming convention or are in wrong directory

fix

Name test files as `<filename>.test.(t|j)s` and place in default or specified test directory.

Upgrade

Version history

1.5.13latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/jcjolley/muddler ↗

packagemuddler ↗

homepagehttps://github.com/jcjolley/muddler#readme ↗