Code Monkey home page Code Monkey logo

orbit-encoder's Introduction

🟢 ORBIT ENCODER ⚙️🗜️

Compatible Status Code Size Status Commit Status Issues Status npm version license

ORBIT-ENCODER is an utility library for Data Compression and Encoding. It can take whatever object you give him as argument and returns a compressed encoded string. It provides a decoding method too. It uses a modified version of LZString for UTF16 Compression.

ORBIT-ENCODER COVER

INSTALLATION



📚 Table Of Contents 📑


💨 What is this Library for? 🤔

ORBIT-ENCODER is a small library that is useful for Encoding Objects [String, Arrays, JSON, Anything...] to a Compressed UTF16 String. You can also Decode that string back using The exposed Decode method.

Note: This library can only be used with JS or TS but you already know that 🤦🏿‍♂️.

✨ Key Features 🎯

  • Use it without instantiation because all the methods are Static.
  • Fast and High Performance Compression of big Complex Data.
  • ✅ TOO EASY TO USE !! 🥳🥳

📥 HOW TO RUN IT ? 🔰

# installation with npm
npm install array-querier

# or you may prefer
npm i --save array-querier

# installation with yarn
yarn add array-querier

This SCRIPT relies on NOTHING SO YOU DON'T NEED ADDITIONNAL PACKAGES.


🤔 HOW IT WORKS ? 🤔

You only need to Import the OrbitEncoder Class from the Package and start using it !

➤ Encode & Decode Given Data 🟢

If you have a User object as follows ->

const User = {
    "name": "Orbit",
    "age": 21,
    "planet": {
        "id": 4,
        "codename" : "Shadow-Coders",
        "galaxyName" : "Turner"
    }   
}

👇🏾 Let's Encode and Decode an Objects :

  • ECMAScript Modules and Typescript
    import {OrbitEncoder} from 'orbit-encoder/lib/OrbitEncoder';

    // Then Encode whatever you want
    const encodedData = OrbitEncoder.encode(User);

    console.log(encodedData);
    /**
     * 👇🏾 Output: 👇🏾
     * 
     * ᓢ㰴䅼ী甤〦恩Ìߐዠᔣᣡ䂦TɈ〦⁐䰠ᘡ㐢〪僠㲪␠祶fĂ࢕⓸Ǹ͚ࣣគⵉM䀼䀻什䁕㒘攈ᢸ᣷吰ৣ乩厖亰æၩ䩴¸椮ࠢ昤怪挑䃒塐恬睂⑘䤣&㉀PƘ䀠
     * 
     * /
    ...
    const decodedData = OrbitEncoder.decode(encodedData);

    console.log(decodedData);
    /**
     * 👇🏾 Output: 👇🏾
     * 
     * {
        name: 'Orbit',
        age: 21,
        planet: { id: 4, codename: 'Shadow-Coders', galaxyName: 'Turner' }
      }
     * 
     * /

🛑 ANGULAR & FRONTEND USERS ☢️

Note: If you are using this in your frontend application you'll need to add the folowing line in your index.html 👇🏾:.

    <script> if (global === undefined) { var global = window; } </script>

FIX COMING: We are working on Future updates that will try to fix this error [Uncaught ReferenceError: global is not defined].

  • CommonJs and Vanilla JS
  const orbit = require("orbit-encoder").OrbitEncoder;

  const data = orbit.encode('Bodio Bodio Yei !!');

  console.log(data); // 🚀 Output :ᅢ汇njࢀ甠瀼橪梸恕<Ұᡠ⢠ୀ

  console.log(orbit.decode(data));

⚠ Note: ⚠ * You can do that : const orbit = require("orbit-encoder"); And use orbit.OrbitEncoder.encode() everywhere but for a more clean approach I did the code above.

➤ Encode & Decode Data Passed on URI 🟢

Sometimes you may want to pass some heavy and complex data or datastructure in a URL, so you can use the encodeWithURIsafe method. It produces ASCII strings representing the original string encoded in Base64 with a few tweaks to make these URI safe. Hence, you can send them to the server without thinking about URL encoding them. This saves bandwidth and CPU.

  • ECMAScript Modules and Typescript
    import {OrbitEncoder} from 'orbit-encoder/lib/OrbitEncoder';

    const data = [['2021-03-02','2021-06-02'],['2022-05-05','2021-07-01']];

    // Then Encode whatever you want
    const encodedData = OrbitEncoder.encodeWithURIsafe(data);

    console.log(dataForURI);

    /**
     * 👇🏾 Output: 👇🏾
     * 
     * OoRgzglgsgVgggTygZQAwHcoI1CBJMPGPTGAUQBcoARATSurwgA1kAPAIyJNjwYFUBEADIBhPEkZthAFTgBmWXDZ4ANiAAmQA
     * 
     * /
    ...
    const decodedData = OrbitEncoder.decodeURIsafe(encodedData);

    console.log(decodedData);
    /**
     * 👇🏾 Output: 👇🏾
     * 
     * [ [ '2021-03-02', '2021-06-02' ], [ '2022-05-05', '2021-07-01' ] ]
     * 
     * /
  • CommonJs and Vanilla JS
  const orbit = require("orbit-encoder").OrbitEncoder;


  const dataForURI = orbit.encodeWithURIsafe([['2021-03-02','2021-06-02'],['2022-05-05','2021-07-01']]);

  console.log(dataForURI) // 🚀 Output : OoRgzglgsgVgggTygZQAwHcoI1CBJMPGPTGAUQBcoARATSurwgA1kAPAIyJNjwYFUBEADIBhPEkZthAFTgBmWXDZ4ANiAAmQA
  
  console.log(orbit.decodeURIsafe(dataForURI))

Configuration Options

Coming Soon !


Contributing ❤

👋🏾 Pull requests are welcome!


Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.


GREETINGS

❤❤ ❤❤


Author

Orbit Turner


License

This project is licensed under the MIT license. See the LICENSE file for more info.


❤ MADE WITH LOVE ❤

Image of OT

orbit-encoder's People

Contributors

hakimlyon avatar orbitturner avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

orbit-encoder's Issues

Improve getBaseValue

improving the lookup performance of the getBaseValue function. Currently, it accesses properties of objects in a nested loop, which can be slow for large dictionaries. You can improve this by using a single-level object for the reverse dictionary lookup.

More details in README

Is your feature request related to a problem? Please describe.
It's not really clear what compression algo is used and what's it's performance.

Describe the solution you'd like
A clear readme with the algo used, why it was chosen and how it compares to other algorithms / libraries. After testing with my demo dataset this lib is really slow on compression and super fast on decompression. I'm searching for something that will be fast both ways and it would be nice to cross out a lib at first glance without testing :P.

Describe alternatives you've considered
ZLib, LZ77, LZW, Zip, probably others.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.