GithubHelp home page GithubHelp logo

utensils / barcoded Goto Github PK

View Code? Open in Web Editor NEW
49.0 11.0 5.0 138 KB

A barcode generation web service.

Home Page: utensils.io/barcoded

License: MIT License

Ruby 97.27% Shell 2.73%
barcode upc multiple-symbologies symbologies webservice docker

barcoded's People

Contributors

doomspork avatar jamesbrink avatar sobering avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

barcoded's Issues

Document API usage

Documentation:

  • JSON requests
  • XML requests
  • Healthcheck endpoint
  • Supported encodings/symbologies
  • Supported image formats

Configure CNAME for api.utensils.io

@jamesbrink is there any additional configuration necessary for us to host the container at the aforementioned domain? I imagine this will only be an issue when we begin to host multiple containers representing different APIs on the same box.

Product demo

In addition to a product page explaining what it was we built and why, it would be fantastic to have a demo people could interact with.

  • The user shall be able to select a subset of the available encoding/symbologies.
  • The user shall be able to input a phrase to encode.
  • The system shall display an error if the input phrase is not valid.
  • The system shall display an SVG of the successful barcode.

Product page

It'd be great to build a simple product page that explain what Barcoded was and how it can be used.

In addition, we might want to put a blurb about this being a product of the Utensils Union.

Add a documentation page to GH pages

We need an area to document not only the API endpoints but instructions for running the Docker container.

  • API POST request (JSON/XML support)
  • Availability/healthcheck endpoint
  • Supported symbologies
    • Formal name — Code 128A (Code Set A)
    • Barcoded value — code128a
    • Example valid data
    • Sample barcode optional
  • Supported image formats
  • Document Docker usage

Release version 1.1.0

It's almost time to ship 1.1.0 — Hooray!

  • QR code support
  • Code 128 Auto-detection and multi-subset support
  • Support for image height/width
  • Demo updates for QR codes
  • Demo updates for Code 128 changes
  • Documentation updates
  • Tag Master @ v1.1.0
  • Tag Docker container @ v1.1.0
  • Publish release announcements

Add support for GS1-128

Barby supports GS1-128 but it's usage is different than the other barcodes, we should evaluate how we want to handle this and other special cases.

Add support for height/width

It'd be great if we could allow people to support the height/width for their barcodes. Perhaps we could setup something like this as the request:

{
    "encoding": "...",
    "format": "...",
    "data": "...",
    "options": {
        "width": 500,
        "height": 500
    }
}

This might lend itself to accepting options for individual barcode types too.

Discuss API self documentation

@jamesbrink let's pull together a few examples of APIs that provide a description endpoint, look over them, and make a decision about whether or not this project warrants one.

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.