2d:null 2e:["$","title",null,{"children":"You Aren’t Gonna Need It | Nikita Sharov | Observable"}] 33:[{"id":"906ea19236c3ce4183d45ae6f9c2380d34f6c6ce9f533a26f2b9912ef8f788bce3162fcaf020f9fe924ce6a0f211b4ae8acb1b615b070ee6b0e6714829e424c8","href":"https://static.observableusercontent.com/files/906ea19236c3ce4183d45ae6f9c2380d34f6c6ce9f533a26f2b9912ef8f788bce3162fcaf020f9fe924ce6a0f211b4ae8acb1b615b070ee6b0e6714829e424c8","name":"downloads-by-package_2021-04-21.csv","type":"text/csv","lastModified":1618221786654.567,"size":6483}] 31:{"id":"57cede719da3bb0d","slug":"you-arent-gonna-need-it","title":"You Aren’t Gonna Need It","thumbnail":"cbd348054c38497dd4870d8164ef3ba50ac570902a1772ca30293ca5cfee0c38","access_level":"public","create_time":"$D2021-04-08T10:57:01.287Z","update_time":"$D2021-04-29T05:14:03.005Z","view_time":null,"first_public_time":"$D2021-04-10T12:46:38.509Z","has_unpublished_edits":null,"fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"6c49d8d38db08400","login":"nikita-sharov","name":"Nikita Sharov","avatar_url":"https://avatars-next.observableusercontent.com/544afb614871e9f3bee546cbff7e689f2a454464b16ac434007893bde877f2df","tier":"starter_2024"},"version":1336,"publish_version":1336,"role":null,"authored":false,"authors":[{"type":"individual","id":"ee7c67b988c5530c","login":"nikita-sharov","name":"Nikita Sharov","avatar_url":"https://avatars-next.observableusercontent.com/544afb614871e9f3bee546cbff7e689f2a454464b16ac434007893bde877f2df","tier":null}],"members":[{"type":"individual","id":"ee7c67b988c5530c","login":"nikita-sharov","name":"Nikita Sharov","avatar_url":"https://avatars-next.observableusercontent.com/544afb614871e9f3bee546cbff7e689f2a454464b16ac434007893bde877f2df","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":{"id":"0d8b57ba92da7b34","slug":"apis","title":"APIs","owner":{"id":"6c49d8d38db08400","login":"nikita-sharov","name":"Nikita Sharov"}},"type":"notebook","body":{"title":"You Aren’t Gonna Need It","cells":[{"id":0,"value":"md`# You Aren’t Gonna Need It\n\n> Lodash methods are available in standalone [per method packages](https://www.npmjs.com/browse/keyword/lodash-modularized) like \\`lodash.mapvalues\\`, \\`lodash.pickby\\`, etc. These packages contain only the code the method depends on.\n> \n> However, use of these packages is discouraged and they [will be removed in v5](https://github.com/lodash/lodash/issues/3838#issuecomment-398592530) [the next major release]. \n\nBefore then we can use [them](https://lodash.com/per-method-packages) to question the usefulness of the methods themselves.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1284,"value":"viewof build = Radio(_.values(Build), {value: Build.FULL})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":36,"value":"{\n const className = _.includes(settings, Setting.ADJUST_STYLING) ? \"funky\" : \"default\";\n return table(className, packageInfos);\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":138,"value":"viewof settings = Checkbox(_.values(Setting), {value: [Setting.ADJUST_STYLING]})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":317,"value":"md`The upper 10% (20% / 30% / 40%) of the packages make up ${_.nth(distribution, 0)}% (${_.nth(distribution, 1)}% / ${_.nth(distribution, 2)}% / ${_.nth(distribution, 3)}%) of all the downloads in total${_.eq(build, Build.FULL) ? \", similar to the worldwide wealth distribution\" : _.stubString()}.\n\nNota bene: Downloads are not exactly *usefulness*, just an indicator.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":263,"value":"md`---\n## Little bits of history repeating`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":259,"value":"html``","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":205,"value":"md`Lodash was initially (v0.1.0 [released](https://www.npmjs.com/package/lodash/v/0.1.0) 2012-04) [positioned as](https://github.com/lodash/lodash/tree/0.1.0) \n\n> A drop-in replacement for [being fully compatible to / based on] [Underscore.js](https://underscorejs.org/) [by sharing its API / test bench / documentation] that delivers up to 8x performance improvements, bug fixes, and additional features.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":278,"value":"md`---\n## Configuration`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":125,"value":"\nimport {Checkbox, Radio} from \"@observablehq/inputs\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":306,"value":"md`> We are grateful to Jeremy Ashkenas [the author of Underscore.js] for blazing the trail with [“The Grand Native Inputs Bazaar”](/@jashkenas/inputs). To migrate from Jeremy’s inputs to our new official inputs, consider our [legacy inputs](/@observablehq/legacy-inputs).`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1324,"value":"Build = ({\n CORE: \"Core build\",\n FULL: \"Full build\"\n})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":195,"value":"Setting = ({\n SHOW_ALL_PACKAGES: \"Show all packages\",\n ADJUST_STYLING: \"Adjust styling\"\n})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":198,"value":"md`---\n## Data\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":6,"value":"downloadsByPackage = dataSource.fetchDownloadCounts(methodNames)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":745,"value":"viewof dataSource = {\n const sources = [\n {\n name: \"gist.github.com\",\n fetchDownloadCounts: _.memoize(gist.fetchDownloadCounts)\n },\n {\n name: \"api.npmjs.org\",\n fetchDownloadCounts: _.memoize(npm.fetchDownloadCounts)\n }\n ];\n \n const options = {\n label: \"Source:\",\n format: source => source.name,\n value: _.head(sources)\n };\n \n return Radio(sources, options);\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":5,"value":"_ = require(\"lodash@4\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":827,"value":"// see: https://gist.github.com/nikita-sharov/67376c726555665fe261f066d30fa4cb\ngist = {\n const d3 = await require(\"d3-fetch@2\"); \n const fetchDownloadCounts = async (methodNames) => {\n const url = \"https://gist.githubusercontent.com/nikita-sharov/67376c726555665fe261f066d30fa4cb/raw/76197a0bc725ca1748abd958598f4fa8825b5ef8/downloads-by-package_2021-04-21.csv\"; // yes, way too long\n const converter = row => ({package: row.package, downloads: +row.downloads});\n const downloadsByPackage = await d3.csv(url, converter);\n const packageNames = _.map(methodNames, getPotentialPackageName);\n return _.filter(downloadsByPackage, d => _.includes(packageNames, d.package));\n };\n \n return {fetchDownloadCounts};\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":840,"value":"// see: https://github.com/npm/registry/blob/master/docs/download-counts.md\nnpm = { \n const getDownloadCountUrl = (packageName) => {\n // actually, the last 30 days is the maximum we can get\n return `https://api.npmjs.org/downloads/point/last-month/${packageName}`; \n };\n \n const fetchDownloads = async (methodName) => {\n const packageName = getPotentialPackageName(methodName);\n const url = getDownloadCountUrl(packageName);\n return fetch(url).then(response => response.json());\n }; \n \n const fetchDownloadCounts = async (methodNames) => {\n const requests = _.map(methodNames, fetchDownloads);\n const responses = await Promise.all(requests);\n const existingPackages = _.filter(responses, d => _.isUndefined(d.error));\n return _.map(existingPackages, d => ({package: d.package, downloads: d.downloads}));\n };\n \n return {fetchDownloadCounts};\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1181,"value":"getPotentialPackageName = (methodName) => `lodash.${_.toLower(methodName)}`;","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":863,"value":"methodNames = _.eq(build, Build.CORE) ? coreBuildMethodNames : _.map(methodInfos, \"name\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1187,"value":"// see: https://lodash.com/custom-builds\n// see also: https://github.com/lodash/lodash/wiki/Build-Differences\ncoreBuildMethodNames = [\"assignIn\", \"before\", \"bind\", \"chain\", \"clone\", \"compact\", \"concat\", \"create\", \"defaults\", \"defer\", \"delay\", \"each\", \"escape\", \"every\", \"filter\", \"find\", \"flatten\", \"flattenDeep\", \"forEach\", \"has\", \"head\", \"identity\", \"indexOf\", \"isArguments\", \"isArray\", \"isBoolean\", \"isDate\", \"isEmpty\", \"isEqual\", \"isFinite\", \"isFunction\", \"isNaN\", \"isNull\", \"isNumber\", \"isObject\", \"isRegExp\", \"isString\", \"isUndefined\", \"iteratee\", \"keys\", \"last\", \"map\", \"matches\", \"max\", \"min\", \"mixin\", \"negate\", \"noConflict\", \"noop\", \"once\", \"pick\", \"reduce\", \"result\", \"size\", \"slice\", \"some\", \"sortBy\", \"tap\", \"thru\", \"toArray\", \"uniqueId\", \"value\", \"values\"]","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":14,"value":"import {methodInfos} from \"@nikita-sharov/lodash-documentation-generator\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":590,"value":"md`---\n## Processing`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":509,"value":"ranking = {\n const ordering = _.orderBy(downloadsByPackage, \"downloads\", \"desc\");\n return _.map(ordering, (d, i) => ({rank: i + 1, name: d.package, downloads: d.downloads}));\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":480,"value":"packageInfos = { \n if (_.includes(settings, Setting.SHOW_ALL_PACKAGES)) {\n return _.map(ranking, createPackageInfo);\n }\n\n const sliceSize = 10;\n const mostPopularPackages = _.map(_.take(ranking, sliceSize), createPackageInfo);\n const leastPopularPackages = _.map(_.takeRight(ranking, sliceSize), createPackageInfo);\n return _.concat(mostPopularPackages, _.stubObject(), leastPopularPackages);\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":483,"value":"createPackageInfo = (rankedPackage) => {\n const methodName = getMethodName(rankedPackage.name);\n return {\n methodName,\n documentationUrl: getDocumentationUrl(methodName),\n downloads: rankedPackage.downloads,\n percentage: getPercentage(rankedPackage.downloads),\n rank: rankedPackage.rank\n };\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":547,"value":"getMethodName = (packageName) => \n _.find(methodNames, methodName => _.eq(packageName, getPotentialPackageName(methodName)))","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":657,"value":"getDocumentationUrl = (methodName, majorVersion = 4) => `https://lodash.com/docs/${majorVersion}#${methodName}`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":676,"value":"getPercentage = (downloads) => downloads / totalDownloads * 100","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":19,"value":"totalDownloads = _.sumBy(downloadsByPackage, \"downloads\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1132,"value":"chunks = {\n const chunkSize = _.ceil(ranking.length / 10);\n return _.chunk(ranking, chunkSize);\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1142,"value":"percentages = _.map(chunks, chunk => getPercentage(_.sumBy(chunk, d => d.downloads)))","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1162,"value":"distribution = { \n const endIndices = _.range(1, 11); \n const shares = _.map(endIndices, endIndex => getShare(percentages, endIndex));\n return _.takeWhile(shares, share => share < 100);\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":1164,"value":"getShare = (values, endIndex) => {\n const slice = _.slice(values, 0, endIndex);\n return _.round(_.sum(slice));\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":202,"value":"md`---\n## Representation`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":445,"value":"table = (className, packageInfos) => html`\n ${head()}\n ${body(packageInfos)}\n

`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":682,"value":"head = () => `\n \n Package\n Downloads\n Percentage\n`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":697,"value":"body = (packageInfos) => `${_.join(_.map(packageInfos, row), _.stubString())}`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":463,"value":"row = (packageInfo) => { \n if (_.isEmpty(packageInfo)) {\n return separator();\n }\n \n return `\n ${packageInfo.rank}\n ${formatPackage(packageInfo)}\n ${formatDownloads(packageInfo.downloads)}\n ${formatPercentage(packageInfo.percentage)}\n`; \n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":558,"value":"separator = (cellCount = 4) => `${_.repeat(\"\", cellCount)}` // an empty row","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":640,"value":"formatPackage = (info) => `${info.methodName}`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":649,"value":"formatDownloads = (value) => value.toLocaleString()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":645,"value":"formatPercentage = (value, precision = 8, digitsAfterDecimalPoint = 6) => \n _.round(value, precision).toFixed(digitsAfterDecimalPoint)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":64,"value":"// based on https://observablehq.com/@tmcw/tables\nhtml`