normalize_country 0.1.0 → 0.1.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,15 +1,7 @@
1
1
  ---
2
- !binary "U0hBMQ==":
3
- metadata.gz: !binary |-
4
- MGIyNjllZTViNTQ3ZjEyZjlkMDBlZDk1ZDgwMGU1YTczOTkxMjNhMQ==
5
- data.tar.gz: !binary |-
6
- OGQ1NDRlYTgzYjk0MWJhYzQ5MTFiYjM0ZGZjOTIyZGI5ZDIwMzNhZg==
7
- !binary "U0hBNTEy":
8
- metadata.gz: !binary |-
9
- MTA4MWExODA0NDQyZjIwMTM3YmJkNzM0NTkzM2JmZjFlNWFjYzc4NjVhY2E5
10
- MTk4ZjlkYTkyMTU1OGYzZTUxN2QwZmIxNThkY2Y4Yzk4OTlmODUwYTg4Y2E5
11
- N2I5NjMxMjQzMWIzYmRhNDhmZGFmYWYwMTVkOTY3ZDkzYmFjMDQ=
12
- data.tar.gz: !binary |-
13
- ZDk2YTRhYTZmMWMxM2RiOTA4NzRmZTNhMDM1MzM0ZDdlODVjYWVhNDk0OWI5
14
- MWM5Njk4ZWFlMGZjMTZlY2M5NzU5ZTg2NjNhNjliOGJkMjczODNmYWFlMDli
15
- OWZkM2VhNTZlZDZmMmI1NDMzOTg1ODk1YTlkZDBiM2IzMzY1ZWQ=
2
+ SHA1:
3
+ metadata.gz: 720b98ff2eaf8ba074e13dd4b579de5d574651f6
4
+ data.tar.gz: 3143241445d0755a2af8b6a3cd5f43f0f242d350
5
+ SHA512:
6
+ metadata.gz: e97e36e0249acb98d7aa31687f306d5b86e687d88ca242ac18d012392a820302188b5334987c3819ac1369c0bf553c46c95d0b2cb13d39cc4bb13530e78c3f75
7
+ data.tar.gz: 68c7833905d7e1461e793cb73658fbd4e113c2b3f8fd9a844ccf786828c8e7112e12700594249f0d3c1d184d55c3c8fa7d2ad62906c75760bbe0289fbe387faa
@@ -23,23 +23,33 @@ Convert country names and codes to a standard.
23
23
 
24
24
  # Or
25
25
  NormalizeCountry.convert("U.S.", :to => :alpha2) # "US"
26
-
26
+
27
27
  # Set the default
28
- NormalizeCountry.to = :alpha3
28
+ NormalizeCountry.to = :alpha3
29
29
  NormalizeCountry.convert("Mexico") # "MEX"
30
30
  NormalizeCountry.convert("United Mexican States") # "MEX"
31
31
 
32
+ === Installation
33
+
34
+ Rubygems ({part of Ruby}[https://www.ruby-lang.org]):
35
+
36
+ shell > gem install normalize_country
37
+
38
+ {Bundler}[http://bundler.io]:
39
+
40
+ gem "normalize_country"
41
+
32
42
  === Supported Conversions
33
43
 
34
- In addition to trying to convert from common, non-standardized names and abbrivations, +NormalizeCountry+
44
+ In addition to trying to convert from common, non-standardized names and abbrivations, +NormalizeCountry+
35
45
  will convert to/from the following:
36
46
 
37
47
  [:alpha2] ISO 3166-1 alpha-2
38
48
  [:alpha3] ISO 3166-1 alpha-3
39
49
  [:fifa] FIFA (International Federation of Association Football)
40
50
  [:official] The country's official name
41
- [:ioc] International Olympic Committee
42
- [:iso_name] Country name used by ISO 3166-1
51
+ [:ioc] International Olympic Committee
52
+ [:iso_name] Country name used by ISO 3166-1
43
53
  [:numeric] ISO 3166-1 numeric code
44
54
  [:short] A shortned version of the country's name, commonly used when speaking and/or writing (US English)
45
55
 
@@ -47,9 +57,9 @@ A list of valid formats can be obtained by calling +NormalizeCountry.formats+.
47
57
 
48
58
  === Obtaining an Array or Hash
49
59
 
50
- NormalizeCountry.to_a # Defaults to NormalizeCountry.to
51
- NormalizeCountry.to_a(:ioc) # Array of IOC codes in ascending order
52
- NormalizeCountry.to_h(:ioc) # :ioc => NormalizeCountry.to
60
+ NormalizeCountry.to_a # Defaults to NormalizeCountry.to
61
+ NormalizeCountry.to_a(:ioc) # Array of IOC codes in ascending order
62
+ NormalizeCountry.to_h(:ioc) # :ioc => NormalizeCountry.to
53
63
  NormalizeCountry.to_h(:ioc, :to => :numeric) # :ioc => :numeric
54
64
 
55
65
  === Conversion Utility
@@ -62,7 +72,7 @@ A small script is included that can convert country names contained in a DB tabl
62
72
  -f, --format FORMAT The format of SOURCE
63
73
  -t, --to CONVERSION Convert country names to this format (see docs for valid formats)
64
74
  -l, --location LOCATION The location of the conversion
65
-
75
+
66
76
  Some examples
67
77
 
68
78
  normalize_country -t alpha2 -l 'Country Name' -f csv data.csv
@@ -74,13 +84,13 @@ If the format is +xml+ or +csv+ you can spefify a directory instead of a filenam
74
84
  normalize_country -t alpha2 -l 'Country Name' -f csv /home/sshaw/capital-losses/2008
75
85
 
76
86
  With a format of +csv+ it will read all files with an extension of +csv+ or +tsv+.
77
- For +csv+ and +xml+ <b>the original file(s) will be overwritten with new file(s) containing the converted country names</b>.
87
+ For +csv+ and +xml+ <b>the original file(s) will be overwritten with new file(s) containing the converted country names</b>.
78
88
 
79
- To convert an XML file with namespaces just include the namespace prefix defined in the file in the
89
+ To convert an XML file with namespaces just include the namespace prefix defined in the file in the
80
90
  XPath query (+LOCATION+).
81
91
 
82
92
  The +db+ format's +SOURCE+ argument must be a {Sequel connection string}[http://sequel.jeremyevans.net/rdoc/classes/Sequel.html#method-c-connect].
83
- Here +LOCATION+ is in the format +table.column+, which will be updated with the converted name.
93
+ Here +LOCATION+ is in the format +table.column+, which will be updated with the converted name.
84
94
 
85
95
  === Random Country Data for Your Tests
86
96
 
@@ -97,7 +107,7 @@ This code was -to some extent- part of a larger project that allowed users to pe
97
107
  Country names were stored in the DB by their ISO names.
98
108
 
99
109
  Several years later at work we had to extract country names from a web service that didn't standardize
100
- them. Sometimes they used UK, other times U.K. It then occured to me that this code could be useful outside
110
+ them. Sometimes they used UK, other times U.K. It then occured to me that this code could be useful outside
101
111
  of the original project. The web service was fixed but, nevertheless...
102
112
 
103
113
  === Somewhat Similar Gems
@@ -1,7 +1,7 @@
1
1
  require "yaml"
2
2
 
3
3
  module NormalizeCountry
4
- VERSION = "0.1.0"
4
+ VERSION = "0.1.1"
5
5
  Countries = {}
6
6
 
7
7
  class << self
@@ -146,10 +146,10 @@ AX:
146
146
  alpha3: ALA
147
147
  fifa:
148
148
  ioc:
149
- iso_name: "\xC3\x85land Islands"
149
+ iso_name: Åland Islands
150
150
  numeric: "248"
151
- official: "\xC3\x85land Islands"
152
- short: "\xC3\x85land Islands"
151
+ official: Åland Islands
152
+ short: Åland Islands
153
153
  AZ:
154
154
  alpha2: AZ
155
155
  alpha3: AZE
@@ -251,9 +251,9 @@ BL:
251
251
  alpha3: BLM
252
252
  fifa:
253
253
  ioc:
254
- iso_name: "Saint Barth\xC3\xA9lemy"
254
+ iso_name: Saint Barthélemy
255
255
  numeric: "652"
256
- official: "Territorial Collectivity of Saint Barth\xC3\xA9lemy"
256
+ official: Territorial Collectivity of Saint Barthélemy
257
257
  short: Saint Barths
258
258
  BM:
259
259
  aliases:
@@ -418,9 +418,9 @@ CI:
418
418
  alpha3: CIV
419
419
  fifa: CIV
420
420
  ioc: CIV
421
- iso_name: "C\xC3\xB4te D'Ivoire"
421
+ iso_name: Côte D'Ivoire
422
422
  numeric: "384"
423
- official: "Republic of C\xC3\xB4te D'Ivoire"
423
+ official: Republic of Côte D'Ivoire
424
424
  short: Ivory Coast
425
425
  CK:
426
426
  alpha2: CK
@@ -1753,10 +1753,10 @@ RE:
1753
1753
  alpha3: REU
1754
1754
  fifa:
1755
1755
  ioc:
1756
- iso_name: "R\xC3\xA9union"
1756
+ iso_name: Réunion
1757
1757
  numeric: "638"
1758
- official: "R\xC3\xA9union Island"
1759
- short: "R\xC3\xA9union"
1758
+ official: Réunion Island
1759
+ short: Réunion
1760
1760
  RO:
1761
1761
  alpha2: RO
1762
1762
  alpha3: ROU
@@ -1945,15 +1945,15 @@ SS:
1945
1945
  short: South Sudan
1946
1946
  ST:
1947
1947
  aliases:
1948
- - Democratic Republic of Sao Tome and Principe"
1949
- - "S\xC3\xA3o Tom\xC3\xA9 and Pr\xC3\xADncipe"
1948
+ - Democratic Republic of Sao Tome and Principe
1949
+ - São Tomé and Príncipe
1950
1950
  alpha2: ST
1951
1951
  alpha3: STP
1952
1952
  fifa: STP
1953
1953
  ioc: STP
1954
1954
  iso_name: Sao Tome and Principe
1955
1955
  numeric: "678"
1956
- official: "Democratic Republic of S\xC3\xA3o Tom\xC3\xA9 and Pr\xC3\xADncipe"
1956
+ official: Democratic Republic of São Tomé and Príncipe
1957
1957
  short: Sao Tome and Principe
1958
1958
  SV:
1959
1959
  alpha2: SV
metadata CHANGED
@@ -1,47 +1,48 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: normalize_country
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.1.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Skye Shaw
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2013-11-21 00:00:00.000000000 Z
11
+ date: 2014-07-21 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: rake
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - ~>
17
+ - - "~>"
18
18
  - !ruby/object:Gem::Version
19
19
  version: '0.9'
20
20
  type: :development
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
- - - ~>
24
+ - - "~>"
25
25
  - !ruby/object:Gem::Version
26
26
  version: '0.9'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: minitest
29
29
  requirement: !ruby/object:Gem::Requirement
30
30
  requirements:
31
- - - ! '>='
31
+ - - ">="
32
32
  - !ruby/object:Gem::Version
33
33
  version: '0'
34
34
  type: :development
35
35
  prerelease: false
36
36
  version_requirements: !ruby/object:Gem::Requirement
37
37
  requirements:
38
- - - ! '>='
38
+ - - ">="
39
39
  - !ruby/object:Gem::Version
40
40
  version: '0'
41
- description: ! " Converts country names and codes from standardized and non-standardized
42
- names and abbreviations to one of the following:\n ISO 3166-1 (code/name/number),
43
- FIFA, IOC, a country's official name or shortened name.\n\n Includes a small
44
- script to convert names/codes in a DB, XML or CSV file.\n"
41
+ description: |2
42
+ Converts country names and codes from standardized and non-standardized names and abbreviations to one of the following:
43
+ ISO 3166-1 (code/name/number), FIFA, IOC, a country's official name or shortened name.
44
+
45
+ Includes a small script to convert names/codes in a DB, XML or CSV file.
45
46
  email: skye.shaw@gmail.com
46
47
  executables:
47
48
  - normalize_country
@@ -64,17 +65,17 @@ require_paths:
64
65
  - lib
65
66
  required_ruby_version: !ruby/object:Gem::Requirement
66
67
  requirements:
67
- - - ! '>='
68
+ - - ">="
68
69
  - !ruby/object:Gem::Version
69
70
  version: '0'
70
71
  required_rubygems_version: !ruby/object:Gem::Requirement
71
72
  requirements:
72
- - - ! '>='
73
+ - - ">="
73
74
  - !ruby/object:Gem::Version
74
75
  version: '0'
75
76
  requirements: []
76
77
  rubyforge_project:
77
- rubygems_version: 2.0.7
78
+ rubygems_version: 2.1.11
78
79
  signing_key:
79
80
  specification_version: 4
80
81
  summary: Convert country names and codes to a standard