un_locode 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3793656f2e8a019e5f31026caac9967ec35946e5
+  data.tar.gz: 62959bd158236bde648d9a68a690adaf3d53ba20
+SHA512:
+  metadata.gz: c21c0b8702f0d0e70846d08cdc91c55340510c4d70ecb4780b74a8671d2640e6fe73c8a472a08f39bc89e4246bdb571544ec8f75404eb76be1192426366323e1
+  data.tar.gz: f6437cc441506e37f35987c02d7a4344b31adc4f9853b79a19d31bfedd5982341abe65771e8c6caa2b1d61058187333d2a06dfd49bf86635b73cded7f010b9c4

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.idea
+*.iml
+.rakeTasks

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p247

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in un_locode.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Michel de Graaf
+
+MIT License
+
+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,46 @@
+# Locode
+
+The Locode gem gives you the ability to lookup UN/LOCODE codes. You can read more about the UN/LOCODE specifications here: [wiki](http://en.wikipedia.org/wiki/UN/LOCODE).
+
+All data used by this gem has been taken from the *UN Centre for Trade Facilitation and E-business* official website. **No guarantees for the accuracy or up-to-dateness are given.**
+
+`http://www.unece.org/cefact/locode/welcome.html` and `http://www.unece.org/cefact/codesfortrade/codes_index.html`
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'un_locode'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install un_locode
+
+## Usage
+
+Find locations whose name is like the supplied search string. The search is case insensitive and also tries to match
+location name without diacritics (and also alternative names when available). By default the amount of locations
+returned are 10 but you can override this value by passing a number as second argument.
+
+    UnLocode::Locode.find_by_fuzzy_name('Göte', 5)
+    #=> [#<UnLocode::Locode city_code: "GOT", name: "Göteborg", ...
+
+
+Same search mechanisms as above but filter by function. You can find a list of possible functions @ UnLocode::FUNCTIONS.
+Like above you can limit the query result.
+
+    UnLocode::Locode.find_by_name_and_function('US', :port)
+    #=> [<UnLocode::Locode: city_code: "GOT", name: ">,>
+         <UnLocode::Locode: 'US LAX'>, ... ]
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+require './data/locode_data_update'
+require 'benchmark'
+
+desc 'Update the datasource of the gem from csv files'
+task :dataupdate do
+  puts 'updating data'
+  puts Benchmark.measure { LocodeDataUpdate.parse }
+  puts 'end of data update'
+end