utensilsunion/barcoded repository overview

⁠Barcoded

Barcoded intends to provide a simple API for the generation of barcodes in multiple symbologies.

⁠Getting Started

Because we know how awesome you are, we've provided you options for running Barcoded:

⁠Without Docker

1. Install the required software dependencies if you have not already:

   • Ruby 2.0+

   • ImageMagick 6.8+

2. At the command prompt, clone the project:

   git clone [email protected]/UtensilsUnion/barcoded

3. Change directory to barcoded and install our gems:

   bundle install

4. At last we are ready to get this show on the road:

   bundle exec rackup

⁠With Docker

1. Install required dependencies on your host:

   • Docker⁠ 0.9+

2. Run the following command from your host's terminal:

   docker run -p 0.0.0.0:9000:8080 utensilsunion/barcoded

3. Access the service at: http://yourhost:9000/

4. Barcode!

Configuration

The following options are available for use with the container:

• RACK_ENV (default: production)

• RACK_CORS (default: disabled)

• UNICORN_WORKERS (default: 1)

• UNICORN_TIMEOUT (default: 30)

To run the application with 4 Unicorn workers:

`docker run -P -e UNICORN_WORKERS=4 utensilsunion/barcoded`

⁠Symbologies

• Bookland⁠
• Code 128⁠
• Code 25 Interleaved 2 of 5⁠
• Code 25 Non-interleaved 2 of 5⁠
• Code 39⁠
• Code 93⁠
• EAN-13⁠
• EAN-8⁠
• IATA⁠
• QR Code⁠
• UPC-A⁠
• UPC/EAN Supplemental 2⁠
• UPC/EAN Supplemental 5⁠

⁠Formats

• PNG
• GIF
• JPG
• SVG

⁠Why?

Businesses need barcodes and adding support to legacy systems for new symbologies can be non-trival, enter Barcoded. Leveraging our simple API, businesses can generate barcodes in multiple symbologies on-demand without ever making a code change.

⁠Demo

To see Barcoded in action check out the project page⁠.

⁠Testing

1. As simple as:

   bundle exec rspec

⁠Contributing

Feedback and features welcome! Please make use of Issues⁠ and Pull Requests⁠, all code must have accompanying specs.

⁠Author/Contact

Barcoded is written and maintained by @doomspork⁠ and @jamesbrink⁠.

⁠License

The project is made available under the MIT⁠ License.