npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

sol-merger

v4.4.1

Published

Merges all import files into single file.

Downloads

3,037

Readme

Build status

Build status

Quick Usage

const { merge } = require('sol-merger');

// Get the merged code as a string
const mergedCode = await merge('./contracts/MyContract.sol');
// Print it out or write it to a file etc.
console.log(mergedCode);

CLI Usage

Right now it only works with solidity files that are in node_modules or relative to your solidity file.

Simple usage:

npm i --save-dev sol-merger

Then add following line to your package.json.

{
  "scripts": {
    "build-contracts": "sol-merger \"./contracts/*.sol\" ./build"
  }
}

This will allow you to use npm run build-contracts in your project directory.

Note that contracts glob should be surrounded with "

If no output file specified then output file will be created at the same directory and appended with _merged (by default), i.e. MyContract_merged.sol. You can also change this behaviour by specifying --append option:

sol-merger --append _me "./contracts/*.sol"
sol-merger -a _me "./contracts/*.sol"

You may need to use npm run to invoke the program standalone, as in npm run sol-merger.

You can also get help via --help command

sol-merger -h
sol-merger --help

More info about glob available at node-glob repository

See tests for more examples.

Post processing support

It is possible right now to write your own plugins to process exports. Currently state is not used in plugins. To see available plugins take a look plugins page.

All default plugins are available via shortcut syntax using filename:

sol-merger --export-plugin SPDXLicenseRemovePlugin "test/contracts/*.sol" compiled

It is also possible to use external plugins via relative path to plugin or path relative to node_modules:

sol-merger --export-plugin ./dist/lib/plugins/SPDXLicenseRemovePlugin.js "test/contracts/*.sol" compiled

sol-merger --export-plugin sol-merger/lib/plugins/SPDXLicenseRemovePlugin.js "test/contracts/*.sol" compiled

Note that file extension is required for plugin to be loaded.

Additional root folders for searching contracts

By default, sol-merger only searches for contracts in the node_modules folder. However, you can include additional root folders to search for contracts. This can be done by passing a CLI argument or a parameter through the code.

If additional root folders are specified, sol-merger will first search for the contract in the node_modules folder and then in the additional root folders. Multiple folders can be included by passing a CLI argument multiple times.

Example of usage in CLI:

sol-merger --additional-root "./test/contracts/imports" "test/contracts/ImportWithAdditionalRoot.sol" compiled

Example of usage in code:

const merger = new Merger({
  delimeter: '\n\n',
  additionalRoots: ['./test/contracts/imports'],
});

Debuging

It is possible to setup environment variable to see what is happening under the hood when contracts are being compiled:

export DEBUG="sol-merger*"

Plugin for VSCode

I created a plugin for VSCode so you can use it instead of sol-merger: Solidity Contracts Merger.

Hope you will like it.