douglas-ne-checks 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 33edfc3be6ddd141940d567939b4b5d143ef0e96
+  data.tar.gz: 17d5aea2e1669bb5cd1e5dd9235d4226f8c2dcba
+SHA512:
+  metadata.gz: b30239590eb4d942908e519b46fabde531475ca8d362d98edd70ae6b7678e09f3bd8d58af0a2f3478bda2eac4aa6fb12a40fd4df9af64c11a931e032e19f0c72
+  data.tar.gz: 7e6890fac1c8788b7d97f902d68a80e6b4b145b175a6d35351fe26ab830fa17c803fcfb1c2adac26e4577bc2839e57ceb534a7781a4873aab0d3ed548b7da0ab

data/.gitignore

@@ -0,0 +1,18 @@
+*.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

data/.travis.yml

@@ -0,0 +1,6 @@
+rvm:
+ - 1.9.3
+ - 2.0.0
+
+notifications:
+ disabled: true

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Aramis Group, LLC dba code lever
+
+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,97 @@
+# Douglas::NE::Checks
+[![Build Status](https://travis-ci.org/code-lever/douglas-ne-checks.png)](https://travis-ci.org/code-lever/douglas-ne-checks) [![Dependency Status](https://gemnasium.com/code-lever/douglas-ne-checks.png)](https://gemnasium.com/code-lever/douglas-ne-checks) [![Code Climate](https://codeclimate.com/github/code-lever/douglas-ne-checks.png)](https://codeclimate.com/github/code-lever/douglas-ne-checks)
+
+Inspired by [@OpenNebraska](https://twitter.com/OpenNebraska)'s presentation @ [HOW Conf 2013](http://www.howconf.org), I figured I'd do a little civic hacking.
+
+This gem will convert (as of the time of writing, of course) the [HTML dumps of supplier's checks](http://www.douglascountyclerk.org/supplierchecks) that the Douglas County Clerk's office provides weekly.
+
+So instead of this: [2013-09-10 check dump](http://www.douglascountyclerk.org/images/stories/supplierchecks/2013-09-10%20Supplier%20Checks%20by%20dept.htm).
+
+We can have this:
+
+    {
+      "11111 - GENERAL" => {
+        "501015 - REAL ESTATE APPRAISE" => [
+          [0] {
+            :supplier => "COSTAR REALTY INFORMATION INC",
+            :account => "42411 - MAINTENANCE CONTRACT",
+            :description => "COSTAR GROUP, INC - Inv. 102152750 (August)",
+            :invoice => "102152750",
+            :check_number => 363593,
+            :check_date => #<Date: 2013-09-10 ((2456546j,0s,0n),+0s,2299161j)>,
+            :check_status => "NEGOTIABLE",
+            :amount => 500.0
+          }
+        ],
+        "502011 - ADMIN COUNTY CLERK" => [
+          [0] {
+            :supplier => "TOSHIBA FINANCIAL SERVICES",
+            :account => "42471 - LEASE COPY MACHINES",
+            :description => "CO CLERK S/N CEI02847 ESTUDIO 855/CONTRACT 500-279467-000",
+            :invoice => "233826767",
+            :check_number => 363494,
+            :check_date => #<Date: 2013-09-10 ((2456546j,0s,0n),+0s,2299161j)>,
+            :check_status => "NEGOTIABLE",
+            :amount => 334.72
+          }
+        ],
+        "502012 - RECORDS COUNTY CLERK" => [
+          [0] {
+            :supplier => "DOT COMM",
+            :account => "42411 - MAINTENANCE CONTRACT",
+            :description => "PSI Capture annual maintenance.",
+            :invoice => "93311",
+            :check_number => 363484,
+            :check_date => #<Date: 2013-09-10 ((2456546j,0s,0n),+0s,2299161j)>,
+            :check_status => "NEGOTIABLE",
+            :amount => 575.0
+          }
+        ],
+        # ...
+      }
+      # ...
+    }
+
+Where the basic structure is:
+
+    {
+      "FUND 1" => {
+        "ORGANIZATION 1" => [
+          [0] { entry 0 },
+          [1] { entry 0 }
+        ],
+        "ORGANIZATION 2" => [
+          [0] { entry 0 }
+        ],
+      }
+      "FUND 2" => { ... }
+    }
+
+
+* http://hackomaha.mindmixer.com/identifying-hack-omaha-projects/make-a-government-checkbook-app
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'douglas-ne-checks'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install douglas-ne-checks
+
+## Usage
+
+TODO: Write usage instructions here
+
+## 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,6 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+task :default => :spec

data/douglas-ne-checks.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'douglas/ne/checks/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "douglas-ne-checks"
+  spec.version       = Douglas::NE::Checks::VERSION
+  spec.authors       = ["Nick Veys"]
+  spec.email         = ["nick@codelever.com"]
+  spec.description   = %q{Read and convert Douglas County NE check dumps to something more useful.}
+  spec.summary       = %q{Douglas County, NE check log reader}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'nokogiri', '~> 1.0'
+
+  spec.add_development_dependency 'awesome_print'
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'ci_reporter', '= 1.8.4'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 2.13'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'simplecov-gem-adapter'
+  spec.add_development_dependency 'simplecov-rcov'
+end

data/lib/.rspec

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

data/lib/douglas/ne/checks/file.rb

@@ -0,0 +1,80 @@
+require 'nokogiri'
+require 'open-uri'
+
+module Douglas; module NE; module Checks
+
+  class File
+
+    attr_reader :funds
+
+    def initialize(uri)
+
+      @funds = {}
+
+      # open the file and snag the two main elements
+      doc = Nokogiri::HTML(open(uri))
+      title = doc.at_xpath('//discotitlexhtml')
+      table = doc.at_xpath('//body/table')
+
+      # initialize the state tracking variables
+      fund_rows = 0
+      fund = nil
+      org_rows = 0
+      org = nil
+
+      table.children.each_with_index do |row, idx|
+
+        # first row is a header
+        next if idx == 0
+
+        cols = row.children
+
+        # rows with TOTAL don't include useful data
+        if cols.last.text.include? 'TOTAL'
+          fund_rows -= 1
+          next
+        end
+
+        # first cell has number of rows for the fund, if we're not already in one
+        offset = 0
+        if fund_rows <= 0
+          fund_rows = cols[0]['rowspan'].to_i
+          org_rows = 0
+          fund = cols[0].text.strip
+          @funds[fund] = {}
+          offset += 1
+        end
+
+        # second cell has number of rows for the organization, if we're not already in one
+        if org_rows == 0
+          org_rows = cols[0 + offset]['rowspan'].to_i
+          org = cols[0 + offset].text.strip
+          @funds[fund][org] = []
+          offset += 1
+        end
+
+        # finally, data, pick it all out!
+        values = cols.drop(offset).map(&:text)
+        @funds[fund][org] << {
+          supplier: values[0],
+          account: values[1],
+          description: values[2],
+          invoice: values[3],
+          check_number: values[4].to_i,
+          check_date: Date.parse(values[5]),
+          check_status: values[6],
+          amount: values[7].gsub(/,/, '').to_f,
+        }
+
+        fund_rows -= 1
+        org_rows -= 1
+
+      end
+
+    rescue
+      raise ArgumentError, 'File does not appear to be a Supplier Checks Report by Department report'
+    end
+
+  end
+
+end; end; end

data/lib/douglas/ne/checks/version.rb

@@ -0,0 +1,3 @@
+module Douglas; module NE; module Checks
+  VERSION = "0.0.1"
+end; end; end

data/lib/douglas/ne/checks.rb

@@ -0,0 +1,2 @@
+require 'douglas/ne/checks/file'
+require 'douglas/ne/checks/version'