https://github.com/x2loreeh/convertions-helper
A blazing fast utility for converting data
https://github.com/x2loreeh/convertions-helper
conversion javascript js json nodejs txt yml
Last synced: about 1 year ago
JSON representation
A blazing fast utility for converting data
- Host: GitHub
- URL: https://github.com/x2loreeh/convertions-helper
- Owner: x2loreeh
- License: gpl-3.0
- Created: 2025-02-17T22:05:54.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-12T09:28:25.000Z (about 1 year ago)
- Last Synced: 2025-04-12T10:31:10.910Z (about 1 year ago)
- Topics: conversion, javascript, js, json, nodejs, txt, yml
- Language: JavaScript
- Homepage:
- Size: 74.2 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Convertions Helper
A blazing fast utility for converting data
## Why should you switch to Convertions Helper?
You should switch to Convertions Helper because it is simple and fast! Instead of using ```console.log(num + num)``` you can simply use a function like ```celsiusToFahrenheit(num)``` and it will automatically convert this into your selected measure. Also it is a little bit faster tha the normal console.log()
Proofs:
 Using Convertions Helper
 Using ```console.log()```
**All these test were made on the same file, on the same machine, and runned at the same time**
## Requirements
For using Convertions Helper you will need the following requirements:
- NodeJS (Minimum v22)
- An IDE, or a program that lets you create and modify javascript files
- A terminal and the "jest" package if you want to have also the timings
## Usage
For now Convertions Helper is not avaiable/working on npmjs, so the only method to make it running is downloading this repository and importing in in your project, like i wrote in [Example](#Example)
## Avaviable Convertions
- ✔️ Celsius to Fahrenheit (and viceversa)
- ✔️ Celsius to Kelvin (and viceversa)
- ✔️ Kelvin to Fahrenheit (and viceversa)
- ✔️ Hour to Minute (and viceversa)
- ✔️ Minute to Second (and viceversa)
- ✔️ Hour to Second (and viceversa)
- ✔️ Second to Hour (and viceversa)
- ✔️ Day to Hour (and viceversa)
- ✔️ Day to Minute (and viceversa)
- ✔️ Minute to Day (and viceversa)
- ✔️ Day to Seconds (and viceversa)
- ✔️ Byte to Bit (and viceversa)
- ✔️ Kilobyte to Bit (and viceversa)
- ✔️ KiloByte to Byte (and viceversa)
- ✔️ MegaByte to Bit (and viceversa)
- ✔️ MegaByte to Byte (and viceversa)
- ✔️ MegaByte to Kilobyte (and viceversa)
- ✔️ Kilobyte to Megabyte (and viceversa)
- ✔️ Bit to Kilobyte (and viceversa)
- ✔️ Bit to Megabyte (and viceversa)
- ✔️ String to Base64 (and viceversa)
- ✔️ String to Hex (and viceversa)
- ✔️ String to Byte (and viceversa)
- ✔️ Kilograms to Ounces (and viceversa)
- ✔️ Kilograms to Pounds (and viceversa)
### Other Features
- You can also add an emoji to your convertions to make them cooler using the function ```.addEmoji(emoji)```
- You can save your convertions in a txt (or text) file using ```.saveConvertions()```
- #### Avaiable formats
- Text File (.txt)
- JSON File (.json)
- YAML File (.yml)
- You can compare now two convertions using ```compareConvertions(conv1, conv2)``` and see which is the bigger one
- You can transform big numbers into scientific notation using ```toScientificNotation(num)```, like the example below
```
console.log(convertions.toScientificNotation(1000000000))
( Result: 1.00e+9 )
```
- You can convert the items in a array using ```convertMultiples(convertion, values)```, following the example below
```
const results = convertMultiple(hourToMinute, [1, 2, 3, 4]);
console.log(results.map(r => r.value));
```
### Example
Before trying to convert data using the example below, your project structure would look like this:
```
my-project/
│
├── src/
│ └── main.js // Main.js need to be here
│
├── testing/
│ └── test.js // Test files needs to be in a different folder
│
├── package.json
└── node_modules/
```
```
const convertions = require('../src/main');
test('test1', () => {
convertions.celsiusToFahrenheit(20)
.addEmoji('🔥')
.saveConversions('json');
convertions.kilobyteToBit(1)
.addEmoji('💻')
.saveConversions('txt');
convertions.megabyteToKilobyte(5)
.addEmoji('📦')
.saveConversions('yml');
});
```
## CONTRIBUTING
Feel Free to clone the repository via Git or GitHub Desktop. If you want to contribute, just open a pull request with your code in a different branch, I would really appreciate that!