{"id":25501540,"url":"https://github.com/abdullah-v/hmsc","last_synced_at":"2025-04-10T09:36:00.020Z","repository":{"id":57264737,"uuid":"358973795","full_name":"Abdullah-V/HMSC","owner":"Abdullah-V","description":"📂 HMSC (How Much Stuff CLI) analyst for your files and folders","archived":false,"fork":false,"pushed_at":"2021-06-10T12:28:56.000Z","size":114,"stargazers_count":28,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-02T14:49:26.116Z","etag":null,"topics":["analytics","cli","files","folders","javascript","nodejs","npm"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/hmsc","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Abdullah-V.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-17T20:16:51.000Z","updated_at":"2025-03-15T19:33:24.000Z","dependencies_parsed_at":"2022-08-25T02:52:16.080Z","dependency_job_id":null,"html_url":"https://github.com/Abdullah-V/HMSC","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdullah-V%2FHMSC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdullah-V%2FHMSC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdullah-V%2FHMSC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdullah-V%2FHMSC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Abdullah-V","download_url":"https://codeload.github.com/Abdullah-V/HMSC/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248192287,"owners_count":21062663,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","cli","files","folders","javascript","nodejs","npm"],"created_at":"2025-02-19T04:43:24.449Z","updated_at":"2025-04-10T09:35:59.998Z","avatar_url":"https://github.com/Abdullah-V.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HMSC\n\n[![node](https://badges.aleen42.com/src/node.svg)](https://badges.aleen42.com/src/javascript.svg\n)\n[![javascript](https://badges.aleen42.com/src/javascript.svg\n)](https://badges.aleen42.com/src/javascript.svg\n)\n[![npm](https://badges.aleen42.com/src/npm.svg\n)](https://badges.aleen42.com/src/npm.svg)\n[![version](https://img.shields.io/npm/v/hmsc)](https://img.shields.io/npm/v/hmsc)\n[![license](https://img.shields.io/npm/l/hmsc)](https://img.shields.io/npm/l/hmsc)\n\n## 🔰 About\n\nHMSC (How Much Stuffs CLI) analyst for your files and folders. With HMSC you can see count of folders, count of files, file extensions, size of the files, etc. inside a folder.\n\n## 📸 Screenshot\n\n[![screenshot](https://raw.githubusercontent.com/Abdullah-V/media/master/HMSC.png)](https://raw.githubusercontent.com/Abdullah-V/media/master/HMSC.png)\n\n\n## 📓 Requirements\n- [Node.js](https://nodejs.org/en/download/)\n- [NPM](https://www.npmjs.com/get-npm)\n\n\n## 🔌 Installation\n\n`$ npm i -g hmsc`\n\n## ⚡ Usage\n\n### 📂 Example directory structure\n\n```\nC:.\n|   sampleFile1.js\n|   sampleFile2.js\n|   sampleFile3.py\n|\n+---onlyFiles\n|       file1.js\n|       file2.js\n|       file3.py\n|\n+---onlyFolder\n|   +---subFolder1\n|   |   \\---subSubFolder11\n|   \\---subFolder2\n|       \\---subSubFolder21\n\\---sampleFolder\n    |   subFile1.js\n    |   subFile2.py\n    |\n    +---subFolder1\n    |       subFile1.js\n    |\n    \\---subFolder2\n            subFile1.js\n```\n\n### `--path`\n\nGive an absolute or relative path. If path is folder path, the number of folders, lines and files is shown. if file path, shows number of lines. You can multiple this.\n\n#### Examples:\n\n```cmd\n$ hmsc --path \"C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\\"\n\n📂 9 folder;\n\n📄 33 line in 10 file;\n\nTotal size of files: 0.00033760 MB\n\n2 file extensions: .js .py;\n\n30 line (90.91% of total lines) on 7 .js file (70.00% of all files), Size: 0.00033760 MB (100.00% of total size)\n\n3 line (9.09% of total lines) on 3 .py file (30.00% of all files), Size: 0.00000000 MB (0.00% of total size)\n\n⭐ inside C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\\n\n\n\n\n$ hmsc --path \"C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\sampleFile1.js\"\n\n📄 17 line in C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\sampleFile1.js file; Size: 0.00020695 MB\n\n\n\n\n$ hmsc --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\adasdsasd\"\n\n❌  No such file or directory: C:\\Users\\Abdullah\\Desktop\\testForHMS\\adasdsasd\n\n\n\n\n$ hmsc --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\\" --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\sampleFile1.js\"\n\n📂 4 folder;\n\n📄 17 line in 1 file;\n\nTotal size of files: 0.00020695 MB\n\n1 file extensions: .js;\n\n17 line (100.00% of total lines) on 1 .js file (100.00% of all files), Size: 0.00020695 MB (100.00% of total size)\n\n⭐ inside C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\,C:\\Users\\Abdullah\\Desktop\\testForHMS\\sampleFile1.js\n```\n\n### `--exclude`\n\nFolders or files you wanted to be excluded, give the relative or absolute path. You can multiple this.\n\n#### Examples: \n\n```cmd\n\n$ hmsc --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\\" --exclude \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\\"\n\n📂 4 folder;\n\n📄 33 line in 10 file;\n\nTotal size of files: 0.00033760 MB\n\n2 file extensions: .js .py;\n\n30 line (90.91% of total lines) on 7 .js file (70.00% of all files), Size: 0.00033760 MB (100.00% of total size)\n\n3 line (9.09% of total lines) on 3 .py file (30.00% of all files), Size: 0.00000000 MB (0.00% of total size)\n\n⭐ inside C:\\Users\\Abdullah\\Desktop\\testForHMS\\\n\n\n\n\n$ hmsc --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\\" --exclude \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\\" --exclude \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFiles\\\"\n\n📂 3 folder;\n\n📄 30 line in 7 file;\n\nTotal size of files: 0.00033760 MB\n\n2 file extensions: .js .py;\n\n28 line (93.33% of total lines) on 5 .js file (71.43% of all files), Size: 0.00033760 MB (100.00% of total size)\n\n2 line (6.67% of total lines) on 2 .py file (28.57% of all files), Size: 0.00000000 MB (0.00% of total size)\n\n⭐ inside C:\\Users\\Abdullah\\Desktop\\testForHMS\\\n\n\n\n\n$ hmsc --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFiles\\\" --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\\" --exclude \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\subFolder1\\\" --exclude \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFiles\\file1.js\"\n\n📂 3 folder;\n\n📄 2 line in 2 file;\n\nTotal size of files: 0.00000000 MB\n\n2 file extensions: .js .py;\n\n1 line (50.00% of total lines) on 1 .js file (50.00% of all files), Size: 0.00000000 MB (NaN% of total size)\n\n1 line (50.00% of total lines) on 1 .py file (50.00% of all files), Size: 0.00000000 MB (NaN% of total size)\n\n⭐ inside C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFiles\\,C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\\n```\n\n### `--table`\n\nIf given, output shown as table\n\n#### Examples:\n\n```cmd\n$ hmsc --path \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\\" --exclude \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFolder\\\" --exclude \"C:\\Users\\Abdullah\\Desktop\\testForHMS\\onlyFiles\\\" --table\n\n📂 3 folder;\n\n📄 30 line in 7 file;\n\nTotal size of files: 0.00033760 MB\n\n2 file extensions: .js .py;\n\n┌────────────────┬─────────────────────────┬──────────────────────────┬──────────────────────────────────────┐\n│ File extension │          Count of files │               Line Count │                                 Size │\n├────────────────┼─────────────────────────┼──────────────────────────┼──────────────────────────────────────┤\n│            .js │ 5 (71.43% of all files) │ 28 (93.33% of all lines) │ 0.00033760MB (100.00% of total size) │\n│            .py │ 2 (28.57% of all files) │   2 (6.67% of all lines) │   0.00000000MB (0.00% of total size) │\n└────────────────┴─────────────────────────┴──────────────────────────┴──────────────────────────────────────┘\n\n⭐ inside C:\\Users\\Abdullah\\Desktop\\testForHMS\\\n```\n\n\n### `--exclude-hidden-files`\n\nExclude hidden files\n\n#### Example:\n\n```cmd\n$ hmsc --path \"C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\\" --exclude-hidden-files\n```\n\n\n### `--exclude-hidden-folders`\n\nExclude hidden folders\n\n#### Example:\n\n```cmd\n$ hmsc --path \"C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\\" --exclude-hidden-folders\n```\n\n\n\n### `--exclude-all-hiddens`\n\nExclude hidden files and folders\n\n#### Example:\n\n```cmd\n$ hmsc --path \"C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\\" --exclude-all-hiddens\n```\n\n\n### `--sort-by \u003ckey\u003e`\n\nSort output by `\u003ckey\u003e`\n\navailable keys: `count`, `lineCount`, `size`\n\nNOTE: Sorting is ascending by default. For descending sorting use `--desc` option\n\n#### Example: \n\n```cmd\n$ hmsc --path \"C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\\" --table --sort-by \"count\"\n\n$ hmsc --path \"C:\\\\Users\\\\Abdullah\\\\Desktop\\\\testForHMS\\\\\" --table --sort-by \"size\" --desc\n```\n\n\n## ⚖️ License\n[MIT LICENSE](https://github.com/Abdullah-V/HMSC/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdullah-v%2Fhmsc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdullah-v%2Fhmsc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdullah-v%2Fhmsc/lists"}