maguire 0.1.0

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Paddle8
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,59 @@
+# Maguire [![Build Status](https://next.travis-ci.org/paddle8/maguire.svg)](https://next.travis-ci.org/paddle8/maguire) [![Code Climate](https://codeclimate.com/github/paddle8/maguire.png)](https://codeclimate.com/github/paddle8/maguire) [![Code Climate](https://codeclimate.com/github/paddle8/maguire/coverage.png)](https://codeclimate.com/github/paddle8/maguire)
+
+Maguire handles formatting currencies in various locales with capabilities to layer custom data sets on top.
+
+## Adding your own locales
+
+To add your own locale information, point Maguire to the directory in your project where the locale files will be:
+
+```ruby
+Maguire.locale_paths << "path/to/my/locales"
+```
+
+If you're adding a customization for French-speaking Canadians, the JSON file should be named `fr_CA.json`.
+
+The file should *at least* have a layouts hash for providing information on how to format the currencies. The layout format should always be in US Dollars (using the code `USD`, and symbol `$`) and use the monetary value of `1234567890.12`.
+
+So a layout for use in Quebec might be:
+
+```json
+{
+  "layouts": {
+    "positive": "1.234.567.890,12 $",
+    "negative": "-1.234.567.890,12"
+  }
+}
+```
+
+Note: positive and negative layouts must be provided.
+
+## Adding your own currencies
+
+Adding your own custom currencies works just like adding your own locales; point Maguire to the directory where your currency files are:
+
+```ruby
+Maguire.data_paths << "path/to/my/currencies"
+```
+
+If you're adding Bitcoin to your project, the JSON file should be named `BTC`. (This corresponds to the lookup code used by the currency parameter passed into the `format` method.)
+
+Currency files are required to have a `"symbol"` (and `"symbol_html"` if needed), `"code"`, and `"minor_units"` values. (`"minor_units"` says how many minor units make up a major unit in the currency. If there is no minor unit, this should be 0.)
+
+A file for the Bitcoin currency would look like:
+
+```json
+{
+  "name": "Bitcoin",
+  "code": "BTC",
+  "symbol": "฿",
+  "symbol_html": "&#3647;",
+  "minor_units": 0
+}
+```
+
+After doing this, you can format your Bitcoins:
+
+```ruby
+Maguire.format({ value: 400_000, currency: "BTC" })
+# ฿400,000
+```

data/iso_data/seed_layer/aed.json

@@ -0,0 +1,9 @@
+{
+  "name": "UAE Dirham",
+  "code": "AED",
+  "number": "784",
+  "minor_units": 2,
+  "countries": [
+    "UNITED ARAB EMIRATES"
+  ]
+}

data/iso_data/seed_layer/afn.json

@@ -0,0 +1,9 @@
+{
+  "name": "Afghani",
+  "code": "AFN",
+  "number": "971",
+  "minor_units": 2,
+  "countries": [
+    "AFGHANISTAN"
+  ]
+}

data/iso_data/seed_layer/all.json

@@ -0,0 +1,9 @@
+{
+  "name": "Lek",
+  "code": "ALL",
+  "number": "008",
+  "minor_units": 2,
+  "countries": [
+    "ALBANIA"
+  ]
+}

data/iso_data/seed_layer/amd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Armenian Dram",
+  "code": "AMD",
+  "number": "051",
+  "minor_units": 2,
+  "countries": [
+    "ARMENIA"
+  ]
+}

data/iso_data/seed_layer/ang.json

@@ -0,0 +1,10 @@
+{
+  "name": "Netherlands Antillean Guilder",
+  "code": "ANG",
+  "number": "532",
+  "minor_units": 2,
+  "countries": [
+    "CURAÇAO",
+    "SINT MAARTEN (DUTCH PART)"
+  ]
+}

data/iso_data/seed_layer/aoa.json

@@ -0,0 +1,9 @@
+{
+  "name": "Kwanza",
+  "code": "AOA",
+  "number": "973",
+  "minor_units": 2,
+  "countries": [
+    "ANGOLA"
+  ]
+}

data/iso_data/seed_layer/ars.json

@@ -0,0 +1,9 @@
+{
+  "name": "Argentine Peso",
+  "code": "ARS",
+  "number": "032",
+  "minor_units": 2,
+  "countries": [
+    "ARGENTINA"
+  ]
+}

data/iso_data/seed_layer/aud.json

@@ -0,0 +1,16 @@
+{
+  "name": "Australian Dollar",
+  "code": "AUD",
+  "number": "036",
+  "minor_units": 2,
+  "countries": [
+    "AUSTRALIA",
+    "CHRISTMAS ISLAND",
+    "COCOS (KEELING) ISLANDS",
+    "HEARD ISLAND AND McDONALD ISLANDS",
+    "KIRIBATI",
+    "NAURU",
+    "NORFOLK ISLAND",
+    "TUVALU"
+  ]
+}

data/iso_data/seed_layer/awg.json

@@ -0,0 +1,9 @@
+{
+  "name": "Aruban Florin",
+  "code": "AWG",
+  "number": "533",
+  "minor_units": 2,
+  "countries": [
+    "ARUBA"
+  ]
+}

data/iso_data/seed_layer/azn.json

@@ -0,0 +1,9 @@
+{
+  "name": "Azerbaijanian Manat",
+  "code": "AZN",
+  "number": "944",
+  "minor_units": 2,
+  "countries": [
+    "AZERBAIJAN"
+  ]
+}

data/iso_data/seed_layer/bam.json

@@ -0,0 +1,9 @@
+{
+  "name": "Convertible Mark",
+  "code": "BAM",
+  "number": "977",
+  "minor_units": 2,
+  "countries": [
+    "BOSNIA AND HERZEGOVINA"
+  ]
+}

data/iso_data/seed_layer/bbd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Barbados Dollar",
+  "code": "BBD",
+  "number": "052",
+  "minor_units": 2,
+  "countries": [
+    "BARBADOS"
+  ]
+}

data/iso_data/seed_layer/bdt.json

@@ -0,0 +1,9 @@
+{
+  "name": "Taka",
+  "code": "BDT",
+  "number": "050",
+  "minor_units": 2,
+  "countries": [
+    "BANGLADESH"
+  ]
+}

data/iso_data/seed_layer/bgn.json

@@ -0,0 +1,9 @@
+{
+  "name": "Bulgarian Lev",
+  "code": "BGN",
+  "number": "975",
+  "minor_units": 2,
+  "countries": [
+    "BULGARIA"
+  ]
+}

data/iso_data/seed_layer/bhd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Bahraini Dinar",
+  "code": "BHD",
+  "number": "048",
+  "minor_units": 3,
+  "countries": [
+    "BAHRAIN"
+  ]
+}

data/iso_data/seed_layer/bif.json

@@ -0,0 +1,9 @@
+{
+  "name": "Burundi Franc",
+  "code": "BIF",
+  "number": "108",
+  "minor_units": 0,
+  "countries": [
+    "BURUNDI"
+  ]
+}

data/iso_data/seed_layer/bmd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Bermudian Dollar",
+  "code": "BMD",
+  "number": "060",
+  "minor_units": 2,
+  "countries": [
+    "BERMUDA"
+  ]
+}

data/iso_data/seed_layer/bnd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Brunei Dollar",
+  "code": "BND",
+  "number": "096",
+  "minor_units": 2,
+  "countries": [
+    "BRUNEI DARUSSALAM"
+  ]
+}

data/iso_data/seed_layer/bob.json

@@ -0,0 +1,9 @@
+{
+  "name": "Boliviano",
+  "code": "BOB",
+  "number": "068",
+  "minor_units": 2,
+  "countries": [
+    "BOLIVIA, PLURINATIONAL STATE OF"
+  ]
+}

data/iso_data/seed_layer/bov.json

@@ -0,0 +1,9 @@
+{
+  "name": "Mvdol",
+  "code": "BOV",
+  "number": "984",
+  "minor_units": 2,
+  "countries": [
+    "BOLIVIA, PLURINATIONAL STATE OF"
+  ]
+}

data/iso_data/seed_layer/brl.json

@@ -0,0 +1,9 @@
+{
+  "name": "Brazilian Real",
+  "code": "BRL",
+  "number": "986",
+  "minor_units": 2,
+  "countries": [
+    "BRAZIL"
+  ]
+}

data/iso_data/seed_layer/bsd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Bahamian Dollar",
+  "code": "BSD",
+  "number": "044",
+  "minor_units": 2,
+  "countries": [
+    "BAHAMAS"
+  ]
+}

data/iso_data/seed_layer/btn.json

@@ -0,0 +1,9 @@
+{
+  "name": "Ngultrum",
+  "code": "BTN",
+  "number": "064",
+  "minor_units": 2,
+  "countries": [
+    "BHUTAN"
+  ]
+}

data/iso_data/seed_layer/bwp.json

@@ -0,0 +1,9 @@
+{
+  "name": "Pula",
+  "code": "BWP",
+  "number": "072",
+  "minor_units": 2,
+  "countries": [
+    "BOTSWANA"
+  ]
+}

data/iso_data/seed_layer/byr.json

@@ -0,0 +1,9 @@
+{
+  "name": "Belarussian Ruble",
+  "code": "BYR",
+  "number": "974",
+  "minor_units": 0,
+  "countries": [
+    "BELARUS"
+  ]
+}

data/iso_data/seed_layer/bzd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Belize Dollar",
+  "code": "BZD",
+  "number": "084",
+  "minor_units": 2,
+  "countries": [
+    "BELIZE"
+  ]
+}

data/iso_data/seed_layer/cad.json

@@ -0,0 +1,9 @@
+{
+  "name": "Canadian Dollar",
+  "code": "CAD",
+  "number": "124",
+  "minor_units": 2,
+  "countries": [
+    "CANADA"
+  ]
+}

data/iso_data/seed_layer/cdf.json

@@ -0,0 +1,9 @@
+{
+  "name": "Congolese Franc",
+  "code": "CDF",
+  "number": "976",
+  "minor_units": 2,
+  "countries": [
+    "CONGO, DEMOCRATIC REPUBLIC OF THE "
+  ]
+}

data/iso_data/seed_layer/che.json

@@ -0,0 +1,9 @@
+{
+  "name": "WIR Euro",
+  "code": "CHE",
+  "number": "947",
+  "minor_units": 2,
+  "countries": [
+    "SWITZERLAND"
+  ]
+}

data/iso_data/seed_layer/chf.json

@@ -0,0 +1,10 @@
+{
+  "name": "Swiss Franc",
+  "code": "CHF",
+  "number": "756",
+  "minor_units": 2,
+  "countries": [
+    "LIECHTENSTEIN",
+    "SWITZERLAND"
+  ]
+}

data/iso_data/seed_layer/chw.json

@@ -0,0 +1,9 @@
+{
+  "name": "WIR Franc",
+  "code": "CHW",
+  "number": "948",
+  "minor_units": 2,
+  "countries": [
+    "SWITZERLAND"
+  ]
+}

data/iso_data/seed_layer/clf.json

@@ -0,0 +1,9 @@
+{
+  "name": "Unidad de Fomento",
+  "code": "CLF",
+  "number": "990",
+  "minor_units": 4,
+  "countries": [
+    "CHILE"
+  ]
+}

data/iso_data/seed_layer/clp.json

@@ -0,0 +1,9 @@
+{
+  "name": "Chilean Peso",
+  "code": "CLP",
+  "number": "152",
+  "minor_units": 0,
+  "countries": [
+    "CHILE"
+  ]
+}

data/iso_data/seed_layer/cny.json

@@ -0,0 +1,9 @@
+{
+  "name": "Yuan Renminbi",
+  "code": "CNY",
+  "number": "156",
+  "minor_units": 2,
+  "countries": [
+    "CHINA"
+  ]
+}

data/iso_data/seed_layer/cop.json

@@ -0,0 +1,9 @@
+{
+  "name": "Colombian Peso",
+  "code": "COP",
+  "number": "170",
+  "minor_units": 2,
+  "countries": [
+    "COLOMBIA"
+  ]
+}

data/iso_data/seed_layer/cou.json

@@ -0,0 +1,9 @@
+{
+  "name": "Unidad de Valor Real",
+  "code": "COU",
+  "number": "970",
+  "minor_units": 2,
+  "countries": [
+    "COLOMBIA"
+  ]
+}

data/iso_data/seed_layer/crc.json

@@ -0,0 +1,9 @@
+{
+  "name": "Costa Rican Colon",
+  "code": "CRC",
+  "number": "188",
+  "minor_units": 2,
+  "countries": [
+    "COSTA RICA"
+  ]
+}

data/iso_data/seed_layer/cuc.json

@@ -0,0 +1,9 @@
+{
+  "name": "Peso Convertible",
+  "code": "CUC",
+  "number": "931",
+  "minor_units": 2,
+  "countries": [
+    "CUBA"
+  ]
+}

data/iso_data/seed_layer/cup.json

@@ -0,0 +1,9 @@
+{
+  "name": "Cuban Peso",
+  "code": "CUP",
+  "number": "192",
+  "minor_units": 2,
+  "countries": [
+    "CUBA"
+  ]
+}

data/iso_data/seed_layer/cve.json

@@ -0,0 +1,9 @@
+{
+  "name": "Cape Verde Escudo",
+  "code": "CVE",
+  "number": "132",
+  "minor_units": 2,
+  "countries": [
+    "CAPE VERDE"
+  ]
+}

data/iso_data/seed_layer/czk.json

@@ -0,0 +1,9 @@
+{
+  "name": "Czech Koruna",
+  "code": "CZK",
+  "number": "203",
+  "minor_units": 2,
+  "countries": [
+    "CZECH REPUBLIC"
+  ]
+}

data/iso_data/seed_layer/djf.json

@@ -0,0 +1,9 @@
+{
+  "name": "Djibouti Franc",
+  "code": "DJF",
+  "number": "262",
+  "minor_units": 0,
+  "countries": [
+    "DJIBOUTI"
+  ]
+}

data/iso_data/seed_layer/dkk.json

@@ -0,0 +1,11 @@
+{
+  "name": "Danish Krone",
+  "code": "DKK",
+  "number": "208",
+  "minor_units": 2,
+  "countries": [
+    "DENMARK",
+    "FAROE ISLANDS",
+    "GREENLAND"
+  ]
+}

data/iso_data/seed_layer/dop.json

@@ -0,0 +1,9 @@
+{
+  "name": "Dominican Peso",
+  "code": "DOP",
+  "number": "214",
+  "minor_units": 2,
+  "countries": [
+    "DOMINICAN REPUBLIC"
+  ]
+}

data/iso_data/seed_layer/dzd.json

@@ -0,0 +1,9 @@
+{
+  "name": "Algerian Dinar",
+  "code": "DZD",
+  "number": "012",
+  "minor_units": 2,
+  "countries": [
+    "ALGERIA"
+  ]
+}

data/iso_data/seed_layer/egp.json

@@ -0,0 +1,9 @@
+{
+  "name": "Egyptian Pound",
+  "code": "EGP",
+  "number": "818",
+  "minor_units": 2,
+  "countries": [
+    "EGYPT"
+  ]
+}

data/iso_data/seed_layer/ern.json

@@ -0,0 +1,9 @@
+{
+  "name": "Nakfa",
+  "code": "ERN",
+  "number": "232",
+  "minor_units": 2,
+  "countries": [
+    "ERITREA"
+  ]
+}

data/iso_data/seed_layer/etb.json

@@ -0,0 +1,9 @@
+{
+  "name": "Ethiopian Birr",
+  "code": "ETB",
+  "number": "230",
+  "minor_units": 2,
+  "countries": [
+    "ETHIOPIA"
+  ]
+}

data/iso_data/seed_layer/eur.json

@@ -0,0 +1,42 @@
+{
+  "name": "Euro",
+  "code": "EUR",
+  "number": "978",
+  "minor_units": 2,
+  "countries": [
+    "ÅLAND ISLANDS",
+    "ANDORRA",
+    "AUSTRIA",
+    "BELGIUM",
+    "CYPRUS",
+    "ESTONIA",
+    "EUROPEAN UNION",
+    "FINLAND",
+    "FRANCE",
+    "FRENCH GUIANA",
+    "FRENCH SOUTHERN TERRITORIES",
+    "GERMANY",
+    "GREECE",
+    "GUADELOUPE",
+    "HOLY SEE (VATICAN CITY STATE)",
+    "IRELAND",
+    "ITALY",
+    "LATVIA",
+    "LUXEMBOURG",
+    "MALTA",
+    "MARTINIQUE",
+    "MAYOTTE",
+    "MONACO",
+    "MONTENEGRO",
+    "NETHERLANDS",
+    "PORTUGAL",
+    "RÉUNION",
+    "SAINT BARTHÉLEMY",
+    "SAINT MARTIN (FRENCH PART)",
+    "SAINT PIERRE AND MIQUELON",
+    "SAN MARINO",
+    "SLOVAKIA",
+    "SLOVENIA",
+    "SPAIN"
+  ]
+}