Welcome to Insize! 🎉
insize is a library designed to estimate the memory space occupied by runtime variables. It's like having a tape measure for your code!
Ever wondered how much memory your variables are hogging? Insize helps you:
- Estimate memory usage of variables.
- Optimize your code by identifying memory-heavy variables.
- Debug memory leaks by keeping an eye on variable sizes.
- Test and profile your applications more effectively.
You can install Insize via npm:
npm install insizeHere's a quick example to get you started:
const insize = require('insize');
let myVariable = { name: "John", age: 30 };
console.log(`Memory size: ${insize(myVariable)} bytes`);Insize exports data in different bytes' multiples. The default value is b, measuring in bytes.
insize(myVariable, 'kb'); // 204
insize(myVariable, 'Mb'); // 0.204
insize(myVariable, 'Gb'); // 0.000204This library can be easily imported and used in typescript too.
import insize from insize;
let myVariable = { name: "John", age: 30 };
console.log(`Memory size: ${insize(myVariable)} bytes`);- Easy to use: Simple API to get memory sizes.
- Lightweight: Minimal overhead to your application.
- Versatile: Works with various data types.
If you are wondering when and where it could be useful, these are real cases we used Insize for.
- Testing: Ensure your tests don't consume excessive memory.
- Optimization: Identify and optimize memory-heavy variables.
- Debugging: Track down memory leaks by monitoring variable sizes.
- Profiling: Profile your application's memory usage in different scenarios.
To run tests, you can use the following command:
npm testMake sure you have all the necessary dependencies installed by running:
npm installTest cases are generated using Insightest and exploit Jest. You can find the test files in the tests directory. To add new tests, create a new file with the .test.js extension in the tests directory.
We welcome contributions! Feel free to open issues or submit pull requests.
Please, follow the Code of Conduct attached.
This project is licensed under the MIT License.
Happy measuring! 📏