Parsley Bundler

0.0.2 verified Thu Apr 23 auth: no javascript abandoned

Parsley Bundler is an open-source project forked from Parcel, designed as a zero-configuration web application bundler emphasizing speed and developer experience. It provides out-of-the-box support for JavaScript, CSS, HTML, and various file assets, automatically applying necessary transformations via tools like Babel, PostCSS, and PostHTML. Key features include multicore compilation, a filesystem cache for fast rebuilds, zero-configuration code splitting with dynamic `import()`, and built-in hot module replacement. Benchmarks from its README claimed significantly faster build times compared to Browserify and Webpack. The package's current and only released version is 0.0.2. Given its very low version number and the lack of updates since its initial release around 2017, the project appears to be abandoned, meaning there is no active release cadence or ongoing maintenance. Its main differentiator was its 'zero config' approach and performance at the time of its inception, mirroring Parcel's philosophy.

Common errors

error Command not found: parsley ↓

cause The `parsley` CLI executable is not installed globally or is not in your system's PATH.

fix

Install Parsley Bundler globally using npm install -g parsley-bundler or yarn global add parsley-bundler.

error Error: EISDIR: illegal operation on a directory, read ↓

cause Attempting to bundle a directory directly without specifying a particular entry file.

fix

Always specify a valid entry file, such as an HTML or JavaScript file (e.g., parsley index.html or parsley src/main.js).

Warnings

breaking The `parsley-bundler` project appears to be abandoned, with no updates since its initial 0.0.2 release around 2017. It is not recommended for new projects and existing users should migrate. ↓

fix Do not use `parsley-bundler` for new projects. Migrate existing projects to the actively maintained `parcel-bundler` (https://parceljs.org/) or other modern bundlers like Webpack, Rollup, or Vite.

gotcha The README contains misleading badges for npm version and downloads that link to `parcel-bundler` (the original project) instead of `parsley-bundler`. ↓

fix Refer to the official npm registry for `parsley-bundler` specifically for accurate package information, rather than relying on potentially outdated or incorrect README badges.

Install

npm install parsley-bundler

yarn add parsley-bundler

pnpm add parsley-bundler

Imports

CLI
```
parsley index.html
```
Parsley Bundler is primarily a command-line interface tool. Its programmatic API, if any existed, was not documented or commonly used at its 0.0.2 version. Most interaction is via direct CLI commands.

Quickstart

Demonstrates how to install Parsley Bundler globally and use it to bundle a simple HTML file that references an external JavaScript file, launching a development server.

<html>
<body>
  <script src="./index.js"></script>
</body>
</html>

// index.js
console.log('Hello from Parsley!');
document.body.innerHTML += '<h1>Hello from Parsley!</h1>';

# Terminal commands
npm install -g parsley-bundler
parsley index.html