# ExGtin
[![Build Status](https://semaphoreci.com/api/v1/kickinespresso/ex_gtin/branches/master/badge.svg)](https://semaphoreci.com/kickinespresso/ex_gtin)
[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/dwyl/esta/issues)
[![Hex.pm](https://img.shields.io/hexpm/v/plug.svg)](https://www.hex.pm/packages/ex_gtin)
[![Packagist](https://img.shields.io/packagist/l/doctrine/orm.svg)](LICENSE.md)
[![Maintainability](https://api.codeclimate.com/v1/badges/bbd541fdc7375d4e3e0a/maintainability)](https://codeclimate.com/github/kickinespresso/ex_gtin/maintainability)
A [GTIN](https://www.gtin.info/) (Global Trade Item Number) & UPC (Universal Price Code) Generation and Validation Library in Elixir under the GS1 specification.
- GTIN-12 (UPC-A): this is a 12-digit number used primarily in North America
- GTIN-8 (EAN/UCC-8): this is an 8-digit number used predominately outside of North America
- GTIN-13 (EAN/UCC-13): this is a 13-digit number used predominately outside of North America
- GTIN-14 (EAN/UCC-14 or ITF-14): this is a 14-digit number used to identify trade items at various packaging levels
## Features
- Supports GTIN-8, GTIN-12 (UPC-12), GTIN-13 (GLN), GTIN-14, GSIN, SSCC codes
- Generate GTIN
- Check GTIN validity
- Lookup GS1 country prefix
## Installation
*WARNING `1.0.0` contains breaking changes from `0.4.0`*
```elixir
def deps do
[{:ex_gtin, "~> 1.0.0"}]
end
```
## Usage
- Check GTIN codes
```elixir
iex> ExGtin.validate("6291041500213")
{:ok, "GTIN-13"}
iex> ExGtin.validate("6291041500214")
{:error, "Invalid Code"}
ex> ExGtin.validate!("6291041500213")
"GTIN-13"
```
Pass GTIN numbers in as a String, Number or an Array
```elixir
iex> number = [6, 2, 9, 1, 0, 4, 1, 5, 0, 0, 2, 1,3]
iex> ExGtin.validate(number)
{:ok, "GTIN-13"}
iex> number = 6_291_041_500_213
iex> ExGtin.validate(number)
{:ok, "GTIN-13"}
```
- Generate GTIN codes
```elixir
iex> ExGtin.generate("629104150021")
{:ok, "6291041500213"}
iex> ExGtin.generate!("629104150021")
"6291041500213"
```
- Lookup GS1 Prefix
```elixir
iex> ExGtin.Validation.find_gs1_prefix_country("53523235")
{:ok, "GS1 Malta"}
```
### Using Strings, Arrays or Numbers
- String
```elixir
iex> ExGtin.validate("6291041500213")
{:ok, "GTIN-13"}
```
- Array of Integers
```elixir
iex> ExGtin.validate([6, 2, 9, 1, 0, 4, 1, 5, 0, 0, 2, 1, 3])
{:ok, "GTIN-13"}
```
- Integer
```elixir
iex> ExGtin.validate(6291041500213)
{:ok, "GTIN-13"}
```
Integers with leading zeros may not process properly
## Reference
- [GTIN](https://www.gs1.org)
- [How to calculate GTIN](https://www.gs1.org/how-calculate-check-digit-manually)
Documentation can be found at [https://hexdocs.pm/ex_gtin](https://hexdocs.pm/ex_gtin) on [HexDocs](https://hexdocs.pm).
## Tests
Run tests with
```elixir
mix test
```
Run test coverage
```elixir
MIX_ENV=test mix coveralls
```
## Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
When making pull requests, please be sure to update the [CHANGELOG.md](CHANGELOG.md) with the corresponding changes. Please make sure that all tests pass and that the static analysis checker `credo` is run.
Run static code analysis
```elixir
mix credo
```
Generate Docs
```elixir
mix docs
```
## Sponsors
This project is sponsored by [KickinEspresso](https://kickinespresso.com/?utm_source=github&utm_medium=sponsor&utm_campaign=opensource)
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/kickinespresso/ex_gtin/tags).
## Code of Conduct
Please refer to the [Code of Conduct](CODE_OF_CONDUCT.md) for details
## Security
Please refer to the [Security](SECURITY.md) for details
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
## Publish
```elixir
mix hex.publish
```