Code Monkey home page Code Monkey logo

bled's Introduction

Bled - Base Library for Easy Decompression

What's this then?

This is Bled, the Base Library for Easy Decompression. It is based almost entirely on the native decompression code found in BusyBox.

What's it for?

It's a library, that can be used in applications to handle the decompression of .Z, .gz, .bz2, .lzma, .xz, .zip and (planned) .7z compressed files and/or archives.

Why are you doing that?

Because I need this stuff for Rufus, mostly to handle compressed disk images, and nobody outside of BusyBox seems to have put much effort providing a compact, one-size-fits-all Open Source library, for decompressing the most common formats.

As I am very conscious of size in Rufus, and Busybox is targeted at embedded systems, its decompression library seemed like a natural choice. Sure, the 7-Zip LZMA SDK is nice, and compiles nicely on Windows, but it only supports lzma/lzma2/xz (+.7z archives), so you'll need to add stuff like miniz, and then some more, and soon enough you're dealing with multiple APIs and a lot of duplicated code. Plus these libraries also provide compression support, which we don't need, so the whole thing becomes quite large.

What's the license?

GPLv2 or later.

While the BusyBox project as a whole is GPLv2 only, this library is GPLv2 or later, which means it can be used indiscriminately in GPLv2 or GPLv3 projects. This is possible because the BusyBox sources we used were all explictly tagged GPLv2 or later and any source that wasn't (libbb.h, crc32.c, decompress_unxz.c) has been recreated/replaced with versions that are. Also, since we're not using any part of bzlib there's no additional license notice required. So this really is a pure GPLv2 or later decompression library, for the most common compression formats.

What about compressed tar archives?

I'm not planning to handle these, because I have no need for tar extraction in Rufus. However, since tar archive handling is present in the BusyBox sources, I may accept a patch if you feel like adding support for it.

What about .rar?

Not planning to add support for RAR, unless a truly Free Source (GPL) RAR decompression comes along.

Are there any limitations?

  • Only Windows is supported for now (MinGW/gcc and MSVC). That's because:
    • Windows is the only platform I need for Rufus
    • The original libbb.h was GPLv2 only, so I had to recreate my own from scratch that is GPLv2 or later. This was a bit of a pain, so I'm don't want to bother recreating a GPLv2+ libbb.h for Linux or other platforms.
  • Can't query the uncompressed file size. This is mostly due to the limitation of the compression formats being used, as most of them are stream formats and do not store that information anywhere.
  • .7z archive extraction is not currently supported. But I may add this feature if needed.
  • No multithreading and not optimized for speed at all!
  • There probably exist limitations with regards to advanced compression and/or newer compression formats.

Alright I'm sold. What do I need?

Either:

  • Visual Studio 2019
  • MinGW

Then use the .sln file or run configure + make.

Is the name a reference to Bled, Slovenia?

It is. You should visit Slovenia too, if you ever have a chance.

bled's People

Contributors

pbatard avatar ventoy avatar

Stargazers

 avatar

Watchers

James Cloos avatar  avatar

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.