terc_parser 0.0.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e0891392b8c802d19f1a84bf41de1af2d97860a3
+  data.tar.gz: 50930c5ddb4b6f418fc47f09767591a05879f8a3
+SHA512:
+  metadata.gz: 905bcdcd042aba9b888284712787314ab2d8ecb0da6842f1b017e731dcbb717a72301f14247d071a963a64f226a5321c225503497077d521d4fc800f62106315
+  data.tar.gz: bbcac2b5488cc3134c8ba736015cd027d9fdb4b3a9a8e000cda1f7e7df9edc0b6ac01896e312ef9261884653a396358ff0910e21d3d1d663761f86810d59497c

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.idea/*
+*TERC*.xml

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

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

data/README.md

@@ -0,0 +1,72 @@
+#TERC parser
+
+Gem składa się praktycznie z jednej metody: `TercParser::parse_terc`. Po jej wywołaniu, opcjonalnie podając jako argument ścieżkę do pliku `TERC.xml`, zwróci ona hash zawierający cztery klucze:
+
+* **:stan_na** - zawiera datę (jako string) utworzenia pliku `TERC.xml`
+* **:wojewodztwa** - zawiera tablice hashy, każdy hash zawiera informacje o jednym województwie
+* **:powiaty** - jw. ale dane o powiatach
+* **:gminy** - jw. ale dane o gminach
+
+Aktualny plik `TERC.xml` można pobrać ze strony GUSu:
+http://www.stat.gov.pl/broker/access/prefile/listPreFiles.jspa
+
+Plik `TERC.xml` jest cyfrową wersją [rejestru identyfikatorów i nazw jednostek podziału administracyjnego Polski](http://pl.wikipedia.org/wiki/TERC) udostępnionym przez [GUS](http://pl.wikipedia.org/wiki/GUS) i jest częścią rejestru [TERYT](http://pl.wikipedia.org/wiki/TERYT).
+
+## Instalacja
+
+``` bash
+gem install terc_parser
+```
+
+## Przykład
+
+Wynik działania:
+
+``` bash
+STAN NA: 2011-01-01
+-------- WOJEWODZTWA (16) ---------
+2 - dolnośląskie
+4 - kujawsko-pomorskie
+6 - lubelskie
+8 - lubuskie
+10 - łódzkie
+12 - małopolskie
+14 - mazowieckie
+16 - opolskie
+18 - podkarpackie
+20 - podlaskie
+22 - pomorskie
+24 - śląskie
+26 - świętokrzyskie
+28 - warmińsko-mazurskie
+30 - wielkopolskie
+32 - zachodniopomorskie
+-------- POWIATY (379) -------------
+-------- GMINY (2479) -------------
+```
+
+Kod:
+
+``` ruby
+require "terc_parser"
+
+terc = TercParser::parse_terc "/path_to_terc/TERC.xml"
+
+puts "STAN NA: #{terc[:stan_na]}"
+
+puts "-------- WOJEWODZTWA (#{terc[:wojewodztwa].count}) ---------"
+terc[:wojewodztwa].each do |w|
+	puts "#{w[:id]} - #{w[:name]}"
+end
+
+puts "-------- POWIATY (#{terc[:powiaty].count}) -------------"
+terc[:powiaty].each do |p|
+	#puts "#{p[:id]} - #{p[:woj_id]} - #{p[:name]}"
+end
+
+puts "-------- GMINY (#{terc[:gminy].count}) -------------"
+terc[:gminy].each do |g|
+	#puts "#{g[:id]} - #{g[:woj_id]} - #{g[:pow_id]} - #{g[:name]}"
+end
+
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/terc_parser.rb

@@ -0,0 +1,2 @@
+require "terc_parser/version"
+require "terc_parser/terc_parser"

data/lib/terc_parser/terc_parser.rb

@@ -0,0 +1,54 @@
+#encoding: utf-8
+require "nokogiri"
+require "active_support/core_ext/string/multibyte"
+
+module TercParser
+  class << self
+    def parse_terc(terc_file_path = "TERC.xml")
+      stan_na = wojewodztwa = powiaty = gminy = nil
+
+      process_xml_file terc_file_path do |doc|
+        stan_na             = doc.xpath("/teryt/catalog/@date").text
+
+        ### WOJEWODZTWA ## ----------------------------------
+        wojewodztwa_nodeset = doc.xpath("//col[@name='NAZDOD' and text()='województwo']/..")
+
+        wojewodztwa     = wojewodztwa_nodeset.map do |woj|
+          id   = woj.xpath("col[@name = 'WOJ']").text.to_i
+          name = woj.xpath("col[@name = 'NAZWA']/text()").text.mb_chars.downcase.to_s
+          {id: id, name: name}
+        end
+
+        ### POWIATY ## --------------------------------------
+        powiaty_nodeset = doc.xpath("//col[@name='NAZDOD' and contains(text(),'powiat')]/..")
+
+        powiaty       = powiaty_nodeset.map do |woj|
+          id     = woj.xpath("col[@name = 'POW']").text.to_i
+          woj_id = woj.xpath("col[@name = 'WOJ']").text.to_i
+          name   = woj.xpath("col[@name = 'NAZWA']/text()").text.mb_chars.downcase.to_s
+          {id: id, woj_id: woj_id, name: name}
+        end
+
+        ### GMINY ## --------------------------------------
+        gminy_nodeset = doc.xpath("//col[@name='NAZDOD' and contains(text(),'gmina')]/..")
+
+        gminy = gminy_nodeset.map do |woj|
+          id     = woj.xpath("col[@name = 'GMI']").text.to_i
+          woj_id = woj.xpath("col[@name = 'WOJ']").text.to_i
+          pow_id = woj.xpath("col[@name = 'POW']").text.to_i
+          name   = woj.xpath("col[@name = 'NAZWA']/text()").text.mb_chars.downcase.to_s
+          {id: id, woj_id: woj_id, pow_id: pow_id, name: name}
+        end
+      end
+
+      return {stan_na: stan_na, wojewodztwa: wojewodztwa, powiaty: powiaty, gminy: gminy}
+    end
+
+    def process_xml_file(file_name, &block)
+      f   = File.open(file_name)
+      doc = Nokogiri::XML(f) { |config| config.strict }
+      yield doc
+      f.close
+    end
+  end
+end

data/lib/terc_parser/version.rb

@@ -0,0 +1,3 @@
+module TercParser
+  VERSION = "0.0.7"
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'terc_parser'

data/spec/terc_parser/terc_parser_spec.rb

@@ -0,0 +1,28 @@
+#encoding: utf-8
+require 'spec_helper'
+
+TERC_XML_FILE_PATH = File.expand_path('../../../vendor/TERC.xml', __FILE__)
+
+describe TercParser do
+  let(:terc) { TercParser::parse_terc TERC_XML_FILE_PATH }
+
+  it "should collect data that are correct type" do
+    terc.should be_instance_of Hash
+    terc[:stan_na].class.should == String
+
+    terc[:wojewodztwa].should be_instance_of Array
+    terc[:wojewodztwa][0][:id].should be_instance_of Fixnum
+    terc[:wojewodztwa][0][:name].should be_instance_of String
+
+    terc[:powiaty].should be_instance_of Array
+    terc[:powiaty][0][:id].should be_instance_of Fixnum
+    terc[:powiaty][0][:woj_id].should be_instance_of Fixnum
+    terc[:powiaty][0][:name].should be_instance_of String
+
+    terc[:gminy].should be_instance_of Array
+    terc[:gminy][0][:id].should be_instance_of Fixnum
+    terc[:gminy][0][:woj_id].should be_instance_of Fixnum
+    terc[:gminy][0][:pow_id].should be_instance_of Fixnum
+    terc[:gminy][0][:name].should be_instance_of String
+  end
+end

data/terc_parser.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "terc_parser/version"
+
+Gem::Specification.new do |s|
+  s.name          = "terc_parser"
+  s.version       = TercParser::VERSION
+  s.authors       = ["TeWu"]
+  s.email         = ["tewu.dev@gmail.com"]
+  s.homepage      = "https://github.com/TeWu/TERC_parser"
+  s.summary       = %q{Nazwy województw, powiatów i gmin w jednym Hashu}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec", "~> 3.5"
+  s.add_runtime_dependency "nokogiri", "~> 1.6"
+  s.add_runtime_dependency "activesupport", "~> 5.0"
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: terc_parser
+version: !ruby/object:Gem::Version
+  version: 0.0.7
+platform: ruby
+authors:
+- TeWu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-10-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: 
+email:
+- tewu.dev@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- README.md
+- Rakefile
+- lib/terc_parser.rb
+- lib/terc_parser/terc_parser.rb
+- lib/terc_parser/version.rb
+- spec/spec_helper.rb
+- spec/terc_parser/terc_parser_spec.rb
+- terc_parser.gemspec
+- vendor/.gitkeep
+homepage: https://github.com/TeWu/TERC_parser
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Nazwy województw, powiatów i gmin w jednym Hashu
+test_files: []