Skip to content

shyamal31/units_converter_extension

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Smart Units Converter - Browser Extension

An extension that converts your selected values into popular units. Saves time, Makes life easier:dancer:

MIT license GitHub issues GitHub pull requests GitHub contributors Build Status Coveralls github Maintainability DOI

Click on the image below to view the video

Alt text

Use Cases

  • Convert $ to ยฅ when you are shopping abroad

  • Convert kilometers to miles when you are planning routes before driving

  • Convert kilograms to pounds when you are buying food

  • Convert celcius to fahrenheit when you are talking about weather

  • Convert hours to seconds when you are calculating time

  • Convert celcius to Fahrenheit when you are calculating temperature

  • Convert Mb/s to b/s when you are calculating internet speed

  • Convert square meter to square feet when you are calculating the measure of area

  • Convert litres to gallons when you are calculating the volume for liquid items online

  • Convert TB to GB when you are buying data storage devices

  • Convert Time from a given time zone to another (PST to EST)

    Technologies we used:

  • Javascript

  • HTML

  • NodeJS

  • CSS

Installation Guide

Step 1: Clone this Repository

git clone [repository_url]

Step 2: Go to chrome extensions

  • In the chrome browser open

    chrome://extensions/
    

Step 3: Enable developer settings

  • Enable developer settings if it is not enabled

    image

Step 4: Unpack the cloned repository

  • Choose Load Unpacked

  • Select the repository folder that was cloned in the first step

    image

Step 5: Check the extension added

  • The extension will now be added to the Chrome

image

Step 6: Test the extension

  • Displays the most relevant converted unit first

image

  • Click on view all button to view all of the converted units for that metric

image

Popup Features for the user

To access the popup feature the user has to click on the extension icon in the top right corner where the user further finds and selects the extension "Unit Convert Selection"

1. Direct conversions

  • This feature allows the user to directly convert units without the need to select any particular text on the browser. This helps save trouble and effort for the user
  • The user selects the conversion he requires from the given standard conversions

image

  • The user can select and convert any unit to the required unit without any restrictions. This direct method allows the user to be quick

image

2. Customized Conversions

  • This feature allows the user to create his own customized unit conversion for his personal use and purposes. This includes all the conversion that are not standard but used as a jargon by people.
  • This is the example taken where 1 meter is taken as 3 subs

image

  • Testing whether the customized conversion works or not

image

  • Since the customized version of conversion keeps changing it is important to allow the user to alter the units. So a feature is added that allows user to delete his customized conversion.

image

3. Favorites

  • This feature allows users to select a particular conversion unit and place it in favorites as the units in favorites are shown at the top. This feature is useful when the user wastes time in finding his desired converted unit from a pool of large units.
  • Here we select pint and gallon as favorites in volume converions.

image

  • So now all the volume conversions will have pint and gallon at the top of the display

image

Style Checker and Analyzer

Standard Js

Installation npm install standard --global in comand line interface to install globally npm install standard --save-dev in command line interface to install locally

Running Standard Js go to root of project and type standard if StandardJs is installed globally go to root of project and type npx standard if StandardJs is installed locally Instead of installing it using npm, you can also use the extension available on VS Code

IDE and Code Fomatter

  • IDE and Style Checker: VSCode

  • Code Style Formatter: Beautify

  • Code Syntax Checker : Eslint for Vscode plugin.

VS Code uses js-beautify internally, but it lacks the ability to modify the style you wish to use. This extension enables running js-beautify in VS Code, AND honouring any .jsbeautifyrc file in the open file's path tree to load your code styling. Run with F1 Beautify (to beautify a selection) or F1 Beautify file.

Run Test cases and coverage

Unit Test

  • Test cases have been tested using Mocha and Chai.

Setup

From the repository root, run:

  npm install --save-dev mocha chai

Then run:

  npm test [filename]
  

npm will then attempt to run all test files that end with *.test.js if you do not specify the filename.

Code Coverage

Funding

The project is not currently funded

๐ŸŒ  Future

See RoadMap here

Documentation (Wiki)

"What" and "How" Docs

"Why" and "Why not" Docs

Think about the case when you shopping on Amazon. When you want to purchase Dumbbells on the website, the weight unit is somewhat you are not familiar with. You will google search the conversion of two units. But now, we have units converter, helping you to covert the unit by a single select with the mouse.

Feature Model

<!--  This model was created online using SPLOT's Feature Model Editor (http://www.splot-research.org) -->
<feature_model name="Unit Converter Extension">
    <feature_tree> 
        :r Unit Converter Extension(_r) 
            :m Length(_r_1) 
            :m Mass(_r_3) 
            :m Temperature(_r_4) 
            :m Time(_r_5) 
            :m Currency(_r_6) 
            :m Area(_r_7) 
            :m Datarate(_r_8) 
            :m Speed(_r_10) 
    </feature_tree>
    <constraints> 
        constraint_1:_r_1 or _r_7 
        constraint_2:_r_1 or _r_5 or _r_10 
    </constraints>
</feature_model>

feature_model

Troubleshooting

If you encounter any issues during any stage of extension use or you encounter any development-related issues, feel free to reach out to our contact our support team at [email protected].

Contributors


Devansh Shah

Shyamal Gandhi


Jay Patel


Shail Shah

About

An extension that converts units for selected text

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 91.2%
  • CSS 5.1%
  • HTML 3.7%