Generate truffle library webpack bundle for package main

[cgewecke]

#2222

Makes the following possible (in a plugin context, for example).

const truffle = require("truffle");
await truffle.contracts.compile(config);

Implementation Details

• In Plugin improvement: expose truffle-core's index.js in webpack bundle  #2222 I proposed using webpack expose-loader for this because I was concerned about the bundle size growing a lot. The unpacked version is bigger here (25-30%), but the packed version sent over the wire from npm is still quite small and it doesn't affect installation speeds. I published my own version to test that issue & validate the POC in the code snippet above - everything worked. Also expose-loader is a nightmare.

• Added ganache-core to the truffle-core exports so consumer can spin up an in-process provider.

• Added top layer API correctness tests - you'll get a scenario test failure if you delete/rename one of those methods.

cf: solidity-coverage 0.7.0

[coveralls]

Coverage remained the same at 70.595% when pulling ccdf497 on cgewecke:truffle-library into 7fcc3fe on trufflesuite:develop.

[cgewecke]

Also had a thought about the API reliability question Nick raises in #2222 - perhaps the simplest thing is to document this feature in the plugin docs, declare the API all-caps unstable (except for truffle.version) and advise people to use individual semvered truffle- modules when possible. Happy to open a PR for that as well.

I my case I really need to be able to invoke the test.run logic after manipulating the config. The absence require("truffle") would mean I'd have to include truffle-core as a dependency (which is a heavy payload for a plugin).

[eggplantzzz]

Thanks for the PR @cgewecke, I'll try and look over this soon!

[cgewecke]

@eggplantzzz Thanks! Just lmk if/when you want a rebase.

[gnidan]

@cgewecke Finally got time to sit down and think about this one. Your point about notifying instability has sold me. If you wouldn't mind opening the PR for that docs change, I'd be grateful for one less thing to do 🙇

For now though, approving and merging! Thanks!

[cgewecke]

@gnidan Awesome, thanks so much! Will open the docs PR tomorrow.