epok 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee8d9d659f3f1da4d0e290c2fe57173ca577ccaf6ae8c9ab5d6fb0df5a41045d
-  data.tar.gz: d075af0af60603bfc513f65f26f6656cc9a43e3e3a6dd25da47245cd96a0ea05
+  metadata.gz: 74780db81aad8442533598aab22a695b4565710ce30ab5504439f59e55587195
+  data.tar.gz: d3562a616e0f3d28a666041f43abaa770e0bdbf386b581f64f5d225ccc6cbbd4
 SHA512:
-  metadata.gz: d57ad60dcd6be25dcd1ad82039809fccc8d9039ed31439e3209fd2c85cdbe82cccf83a9e9c9846989f182c9290ccd60d440a69d3aa673f500f160cd31cf55ee2
-  data.tar.gz: 7b850241d36d95455e480cb26222233927447bab1cffe547388a53c5d0c92c6d61ae387c3c70db9aae7eb784623c38a5bf220f693f6fde06fc39a10cd01c83fb
+  metadata.gz: 02e22d2fb37d7b44611461af1bcc7e006b6a97d78c54a07416f092e9a00a989b26bd6a0bc38a6558378a200fb177e7c921a54f970e388711fa520888ab71f16e
+  data.tar.gz: 637d65db4058187386da2b632685b1488749eb859689bfaf242d962803d05fbfd1147f78d41256ea005445307e3ec8e5258c7b4c9437c2187181ddd5e9b4dfc7

data/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project
+follows [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.6.0] - 2026-09-15
+
+### Changed
+
+- **Breaking:** `Epok.geocoder` is now `Epok.nearby`. Next to `Epok.geocode`
+  (address to point) the old name read as the same thing backwards.
+- Every string in an API response is stripped and squeezed once in `API.get`.
+  The API pads and double-spaces names at random, in every endpoint, and the
+  per-field strips it replaces only covered some of them.
+- Gemspec declares `required_ruby_version >= 3.3`, links the changelog and
+  source on rubygems.org, and ships only `lib/`, README, CHANGELOG and
+  LICENSE instead of the whole repository (tests and cassettes included).
+
+### Fixed
+
+- Malformed responses no longer escape as `NoMethodError`: an unparseable
+  centroid raises `Epok::Error`, non-string content values are kept as
+  strings, and a geocode match without coordinates has a nil `location`.
+
+## [0.5.0] - 2026-09-15
+
+### Added
+
+- `Epok.geocode(text)` turns "cabildo 1234" or "callao y corrientes" into
+  `Address` structs with the normalized text, partido, localidad and a
+  `Location`, via USIG's normalizer. Unknown addresses raise `Epok::NotFound`
+  with the service's message.
+- `Epok.datos_utiles(location)` returns the barrio, comuna, comisaría,
+  hospital area, health region and school district for a point. Outside the
+  city those are nil and `partido_amba` and `localidad_amba` are filled.
+- `Epok.search` accepts `categories:` (one or an array) and `limit:`.
+
+### Changed
+
+- README rewritten around an end-to-end example.
+- Removed minitest-reporters from the development dependencies.
+
+## [0.4.0] - 2026-09-15
+
+### Added
+
+- `Epok::Object` keeps listing data: `name`, `kind`, `category` and
+  `distance` (metres, from the geocoder) are available without a request.
+  `content`, `normalized_address` and `location` fetch lazily.
+- `Epok::Object#location` returns longitude and latitude, converted from the
+  city's projected grid through USIG. Nil when the object has no centroid.
+- `Epok.categories` lists all EPOk categories as `Category` structs.
+- `Epok.geocoder` accepts `radius:` (default 500 metres) and an array of
+  categories.
+- `Epok::Error` wraps timeouts, network failures, non-2xx responses and bad
+  JSON. `Epok::NotFound` for unknown ids.
+
+## [0.3.0] - 2026-09-15
+
+Tagged but never pushed to rubygems.org.
+
+### Changed
+
+- **Breaking:** `Epok.search` and `Epok.geocoder` return an
+  `Epok::Collection`, which is `Enumerable` and lazy. `Epok::Search`,
+  `Epok::Geocoder` and `Epok::Collectable` are removed, along with the
+  `query`, `x`, `y` and `categories` readers.
+
+### Fixed
+
+- Query parameters are URL-encoded, so non-ASCII searches like "peña" no
+  longer raise `URI::InvalidURIError`.
+
+## [0.2.0] - 2026-09-15
+
+### Fixed
+
+- Requests go over HTTPS. The API started redirecting plain HTTP to HTTPS
+  with an empty body, which made every call fail with a JSON parse error.
+- Object content values are stripped of surrounding whitespace.
+- Test suite runs on Ruby 4: vcr bumped to 6.x, lockfile regenerated,
+  bundler dev dependency dropped.
+
+## [0.1.1] - 2019-04-24
+
+Initial release: `Epok.search`, `Epok.geocoder` and `Epok::Object`.
+
+[Unreleased]: https://github.com/arzezak/epok/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/arzezak/epok/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/arzezak/epok/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/arzezak/epok/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/arzezak/epok/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/arzezak/epok/compare/e629f99...v0.2.0
+[0.1.1]: https://github.com/arzezak/epok/commits/e629f99

data/README.md

@@ -34,7 +34,7 @@ area = Epok.datos_utiles(here.location)
 puts "That's #{area.barrio}, #{area.comuna}"
 
 # 3. What's within 300 metres, by category?
-nearby = Epok.geocoder(here.location, %w[estaciones_de_subte farmacias], radius: 300)
+nearby = Epok.nearby(here.location, %w[estaciones_de_subte farmacias], radius: 300)
 nearby.sort_by(&:distance).first(5).each do |place|
   puts "  #{place.distance.round} m  #{place.name} (#{place.kind})"
 end
@@ -72,16 +72,16 @@ Epok.search("cgp", categories: "sedes_de_comunas", limit: 3).map(&:name)
 # => ["Sede Comunal 4", "Sede Comunal 9", "Sede Comunal 10"]
 ```
 
-**Categories** are what the geocoder and the search filter take. There are 167, each with an id, a display name and a description:
+**Categories** are what `nearby` and the search filter take. There are 167, each with an id, a display name and a description:
 
 ```ruby
 Epok.categories.find { |c| c.id == "farmacias" }
 # => #<struct Epok::Category id="farmacias", name="Farmacias", description="">
 ```
 
-**Collections** from `search` and `geocoder` are `Enumerable` and lazy: nothing is requested until you iterate.
+**Collections** from `search` and `nearby` are `Enumerable` and lazy: nothing is requested until you iterate.
 
-**Objects** know their `id`, `name`, `kind`, `category` and, from the geocoder, `distance` in metres straight from the listing. `content`, `normalized_address` and `location` fetch the full record on first use; `location` also converts the city's projected coordinates through USIG. `Epok::Object.new("farmacias|1082")` looks one up by id.
+**Objects** know their `id`, `name`, `kind`, `category` and, from `nearby`, `distance` in metres straight from the listing. `content`, `normalized_address` and `location` fetch the full record on first use; `location` also converts the city's projected coordinates through USIG. `Epok::Object.new("farmacias|1082")` looks one up by id.
 
 **Locations** are `Epok::Location.new(x: longitude, y: latitude)`. `geocode` returns every match across the metro area, city first, as `Address` structs with `address`, `partido`, `localidad` and `location`. `datos_utiles` returns nil for the city fields outside CABA and fills `partido_amba` and `localidad_amba` instead.
 

data/lib/epok/api.rb

@@ -24,7 +24,7 @@ module Epok
       get(EPOK_URL, "/buscar/", params)["instancias"]
     end
 
-    def self.geocoder(x, y, categories, radius)
+    def self.nearby(x, y, categories, radius)
       get(EPOK_URL, "/reverseGeocoderLugares/",
         x: x, y: y, categorias: categories, radio: radius)["instancias"]
     end
@@ -67,10 +67,22 @@ module Epok
         raise Error, "EPOk responded #{response.code} to #{uri}"
       end
 
-      JSON.parse(response.body)
+      normalize(JSON.parse(response.body))
     rescue SystemCallError, SocketError, Timeout::Error, OpenSSL::SSL::SSLError, JSON::ParserError => e
       raise Error, "#{e.class}: #{e.message}"
     end
     private_class_method :get
+
+    # The API pads and double-spaces strings at random. Clean every string
+    # in a response once, here, so no field needs its own strip.
+    def self.normalize(value)
+      case value
+      when Hash then value.transform_values { |v| normalize(v) }
+      when Array then value.map { |v| normalize(v) }
+      when String then value.strip.squeeze(" ")
+      else value
+      end
+    end
+    private_class_method :normalize
   end
 end

data/lib/epok/object.rb

@@ -3,13 +3,13 @@ module Epok
     attr_reader :id, :distance
 
     # Accepts either an id ("farmacias|1082") or a result hash from a search
-    # or geocoder listing. Listing attributes are available immediately; the
+    # or nearby listing. Listing attributes are available immediately; the
     # full content is fetched on first use.
     def initialize(attributes)
       attributes = { "id" => attributes } if attributes.is_a?(String)
 
       @id = attributes.fetch("id")
-      @name = attributes["nombre"]&.strip
+      @name = attributes["nombre"]
       @kind = attributes["clase"]
       @distance = attributes["distancia"]&.to_f
     end
@@ -37,8 +37,10 @@ module Epok
 
       centroid = object.dig("ubicacion", "centroide")
       @location = centroid && begin
-        x, y = centroid[/\(([^)]*)\)/, 1].split.map(&:to_f)
-        lon, lat = API.to_lonlat(x, y)
+        point = centroid[/\(([^)]*)\)/, 1]
+        raise Error, "unparseable centroid #{centroid.inspect} for #{id}" unless point
+
+        lon, lat = API.to_lonlat(*point.split.map(&:to_f))
         Location.new(x: lon, y: lat)
       end
     end
@@ -46,7 +48,7 @@ module Epok
     def content
       object["contenido"].each_with_object({}) do |entry, hash|
         name, value = entry.values_at("nombre", "valor")
-        value = value.strip
+        value = value.to_s
         hash[name] = value unless value.empty?
       end
     end

data/lib/epok/version.rb

@@ -1,3 +1,3 @@
 module Epok
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/lib/epok.rb

@@ -23,21 +23,24 @@ module Epok
     Collection.new { API.search(query, categories, limit) }
   end
 
-  def self.geocoder(location, categories, radius: DEFAULT_RADIUS)
+  def self.nearby(location, categories, radius: DEFAULT_RADIUS)
     categories = Array(categories).join(",")
 
-    Collection.new { API.geocoder(location.x, location.y, categories, radius) }
+    Collection.new { API.nearby(location.x, location.y, categories, radius) }
   end
 
   def self.geocode(text)
     API.geocode(text).map do |address|
-      x, y = address["coordenadas"].values_at("x", "y").map(&:to_f)
+      coordinates = address["coordenadas"]
+      location = coordinates && Location.new(
+        x: coordinates["x"].to_f, y: coordinates["y"].to_f
+      )
 
       Address.new(
         address: address["direccion"],
         partido: address["nombre_partido"],
         localidad: address["nombre_localidad"],
-        location: Location.new(x: x, y: y)
+        location: location
       )
     end
   end
@@ -47,8 +50,8 @@ module Epok
 
     DatosUtiles.new(
       DatosUtiles.members.to_h do |member|
-        value = datos[member.to_s].to_s.strip.squeeze(" ")
-        [member, value.empty? ? nil : value]
+        value = datos[member.to_s]
+        [member, value.to_s.empty? ? nil : value]
       end
     )
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: epok
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Ariel Rzezak
@@ -71,44 +71,31 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.5.1
-description: GCBA EPOk wrapper to query indexed geographic objects.
+description: Search the city's indexed geographic objects, find what is near a point,
+  geocode addresses and look up the barrio and comuna of a location, through the GCBA
+  EPOk and USIG services.
 email:
 - arzezak@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".claude/skills/swarf/SKILL.md"
-- ".gitignore"
-- CLAUDE.md
-- CODE_OF_CONDUCT.md
-- Gemfile
-- Gemfile.lock
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
-- Rakefile
-- bin/console
-- bin/setup
-- epok.gemspec
 - lib/epok.rb
 - lib/epok/api.rb
 - lib/epok/collection.rb
 - lib/epok/object.rb
 - lib/epok/version.rb
-- test/epok/api_test.rb
-- test/epok/categories_test.rb
-- test/epok/collection_test.rb
-- test/epok/datos_utiles_test.rb
-- test/epok/geocode_test.rb
-- test/epok/geocoder_test.rb
-- test/epok/object_test.rb
-- test/epok/search_test.rb
-- test/epok_test.rb
-- test/test_helper.rb
 homepage: https://github.com/arzezak/epok
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/arzezak/epok
+  changelog_uri: https://github.com/arzezak/epok/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/arzezak/epok/issues
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -116,7 +103,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -125,5 +112,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.20
 specification_version: 4
-summary: GCBA EPOk wrapper.
+summary: Ruby client for the Buenos Aires city EPOk geographic API.
 test_files: []

data/.claude/skills/swarf/SKILL.md

@@ -1,77 +0,0 @@
----
-name: swarf
-description: Score Ruby methods by complexity against test coverage with swarf, and turn the worst rows into the next test to write. Use after writing or changing Ruby code and before calling a change done.
----
-
-# swarf
-
-swarf scores every Ruby method with `CRAP = CC² · (1 − coverage)³ + CC` and lists them worst first. Complexity is parsed from source. Coverage is recorded by a probe loaded into the test run and stored in `.swarf/coverage.json`, so scoring works without setup but coverage needs a test run.
-
-## The loop
-
-1. Run the suite with the probe loaded (see Setup if unsure):
-
-   ```
-   bundle exec rspec          # or: bundle exec rake test
-   ```
-
-2. Score the files you touched, not the whole project:
-
-   ```
-   git diff --name-only --diff-filter=d main -- '*.rb' | xargs bundle exec swarf
-   ```
-
-   Named paths are always scored, even under `test/`, `db/` or a `.swarfignore` pattern.
-
-3. Take the top rows and act on the Evidence column (next section). Write or extend the test, re-run the suite, score again.
-
-4. Stop when the touched methods sit at `CRAP = CC` with `Cov% 100.0`. Nothing you test pulls a score under its CC. If a score is too high at full coverage, that is complexity, which is a refactor question, not a testing one. Do not split methods to chase the number.
-
-Before saying a change is done, run step 2 and report the top rows.
-
-## Reading a row
-
-```
-Method          CC    Cov%   CRAP      Evidence  Location
-Cart#checkout    6    0.0%  42.00  never called  lib/cart.rb:31
-Cart#discount    4   50.0%   6.00        3/6 br  lib/cart.rb:24
-```
-
-| Evidence       | Meaning                                      | Do                                                            |
-| -------------- | -------------------------------------------- | ------------------------------------------------------------- |
-| `never called` | A VM call count of zero. No test reaches it. | Write a test that calls it.                                   |
-| `3/6 br`       | 3 of 6 branch outcomes ran.                  | Extend a test to the untaken outcomes.                        |
-| `1/1 ln`       | No branches, so lines are the whole truth.   | Nothing, at 100%.                                             |
-| `no data`      | No run has been recorded for this file.      | The probe is not loaded, or the suite has not run. Fix Setup. |
-| `stale`        | The file changed after it was measured.      | Re-run the suite, then score again.                           |
-
-`no data` and `stale` both score at the `CC² + CC` floor rather than guess. They are also counted per file under the table, because the fix is per file.
-
-A `never called` on a method a test clearly exercises means the test ran without the probe, or the probe loaded after the file. Check Setup before writing a duplicate test.
-
-## Setup
-
-The probe must load before the code under test, because `Coverage` only sees files loaded after it starts. One line, placed first:
-
-- **RSpec**: first line of `.rspec`: `--require swarf/probe`
-- **Minitest**: first line of `test/test_helper.rb`: `require "swarf/probe"`
-- **Rails**: in `test/test_helper.rb`, after `require "bundler/setup"` and before `require_relative "../config/environment"`. Below the environment require, the whole app is invisible to it.
-- **Anything**: `RUBYOPT="-rswarf/probe" bundle exec rake test`
-
-Add `.swarf/` to `.gitignore`. Runs merge, so a single spec file adds to what earlier runs proved; nothing is erased until the file's bytes change.
-
-Do not run swarf's probe alongside SimpleCov. Ruby allows one `Coverage.start` per process; if SimpleCov started first, swarf warns and records nothing.
-
-## Commands
-
-```
-bundle exec swarf                       # whole project, worst 20
-bundle exec swarf lib/ app/             # directories
-bundle exec swarf app/models/cart.rb    # one file
-bundle exec swarf --limit 0             # every row
-bundle exec swarf --ignore "app/legacy/**"
-bundle exec swarf --all                 # ignore nothing, including db/ and .swarfignore
-SWARF_DIR=/tmp/swarf bundle exec swarf  # store elsewhere; set for the test run too
-```
-
-swarf's CC counts `if`, `unless`, `while`, `until`, `for`, `when`, `in`, `rescue`, `&&`, `||` and `&.`, not blocks, so it will not match RuboCop's. Methods made by `define_method` are not seen.

data/.gitignore

@@ -1,10 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-/test/fixtures/
-.swarf/

data/CLAUDE.md

@@ -1,47 +0,0 @@
-# Epok
-
-Ruby gem wrapping the GCBA EPOk API (https://epok.buenosaires.gob.ar).
-No runtime dependencies beyond the standard library.
-
-## Development
-
-```
-bundle install
-bundle exec rake test     # records VCR cassettes into test/fixtures on first run
-bundle exec swarf lib/    # complexity vs. coverage report, worst first
-```
-
-Cassettes are gitignored, so the first test run hits the live API.
-The API rejects curl's default User-Agent, but Ruby's Net::HTTP works fine.
-
-## API notes
-
-Official docs are Swagger specs on the city's 3scale portal. The HTML at
-https://datosabiertos-apis.buenosaires.gob.ar/BA_Root/Documentacion is
-JavaScript-rendered; fetch the JSON directly:
-
-- Index: https://datosabiertos-apis.buenosaires.gob.ar/api_docs/services.json
-- EPOk ("Busquedas de Lugares"): .../api_docs/services/10.json
-- USIG Geocoder: .../api_docs/services/8.json
-- Datos Útiles: .../api_docs/services/9.json
-
-The specs list `datosabiertos-*-apis.buenosaires.gob.ar` hosts that return
-404. The live hosts are `epok.buenosaires.gob.ar` for EPOk and
-`ws.usig.buenosaires.gob.ar` for USIG (REST index with docs at
-https://ws.usig.buenosaires.gob.ar/rest/).
-
-- `/buscar/` also takes `categoria` (comma-separated), `clase`, `bbox`,
-  `start`, `limit` and `totalFull`.
-- `/reverseGeocoderLugares/` takes `srid` (default 4326) and `radio`
-  (default 1 metre, hence our 500 default).
-- Unknown ids return `200 {}`, unknown categories return an empty list.
-- Object coordinates are projected (Gauss-Krüger Buenos Aires). USIG's
-  `/rest/convertir_coordenadas` turns them into longitude and latitude.
-- `ws.usig.buenosaires.gob.ar/datos_utiles?x=&y=` answers with empty strings
-  outside the city; `Epok.datos_utiles` turns those into nil.
-- `servicios.usig.buenosaires.gob.ar/normalizar/?direccion=&geocodificar=true`
-  matches across the whole AMBA, CABA first. Coordinates come back as
-  strings for CABA and floats elsewhere. No match is `200` with an empty
-  list and an `errorMessage`; `Epok.geocode` raises NotFound with it.
-- A December 2025 city report says "API USIG" is being replaced by
-  "API Servicios Geo" during 2026. The USIG hosts above may move.

data/CODE_OF_CONDUCT.md

@@ -1,74 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at arzezak@gmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [http://contributor-covenant.org/version/1/4][version]
-
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -1,8 +0,0 @@
-source "https://rubygems.org"
-
-git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
-
-gemspec
-
-gem "irb", group: :development
-gem "swarf", group: :development

data/Gemfile.lock

@@ -1,90 +0,0 @@
-PATH
-  remote: .
-  specs:
-    epok (0.5.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    addressable (2.9.0)
-      public_suffix (>= 2.0.2, < 8.0)
-    bigdecimal (4.1.3)
-    crack (1.0.1)
-      bigdecimal
-      rexml
-    erb (6.0.7)
-    hashdiff (1.2.1)
-    io-console (0.9.3)
-    irb (1.18.0)
-      pp (>= 0.6.0)
-      prism (>= 1.3.0)
-      rdoc (>= 4.0.0)
-      reline (>= 0.4.2)
-    logger (1.7.0)
-    minitest (5.27.0)
-    pp (0.6.4)
-      prettyprint
-    prettyprint (0.2.0)
-    prism (1.9.0)
-    public_suffix (7.0.5)
-    rake (13.4.2)
-    rbs (4.2.0)
-      logger
-      prism (>= 1.6.0)
-      tsort
-    rdoc (8.0.0)
-      erb
-      prism (>= 1.6.0)
-      rbs (>= 4.0.0)
-      tsort
-    reline (0.7.0)
-      io-console (~> 0.5)
-    rexml (3.4.4)
-    swarf (0.2.0)
-    tsort (0.2.0)
-    vcr (6.4.0)
-    webmock (3.26.4)
-      addressable (>= 2.8.0)
-      crack (>= 0.3.2)
-      hashdiff (>= 0.4.0, < 2.0.0)
-
-PLATFORMS
-  arm64-darwin-23
-  ruby
-
-DEPENDENCIES
-  epok!
-  irb
-  minitest (~> 5.0)
-  rake (~> 13.0)
-  swarf
-  vcr (~> 6.0)
-  webmock (~> 3.5, >= 3.5.1)
-
-CHECKSUMS
-  addressable (2.9.0) sha256=7fdf6ac3660f7f4e867a0838be3f6cf722ace541dd97767fa42bc6cfa980c7af
-  bigdecimal (4.1.3) sha256=61ebe1e5e559bdc3cc6f2c0ee7f427321fc838f59611c294356eb04d6e21cf66
-  crack (1.0.1) sha256=ff4a10390cd31d66440b7524eb1841874db86201d5b70032028553130b6d4c7e
-  epok (0.5.0)
-  erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92
-  hashdiff (1.2.1) sha256=9c079dbc513dfc8833ab59c0c2d8f230fa28499cc5efb4b8dd276cf931457cd1
-  io-console (0.9.3) sha256=f555049461b0afb78a5448b5be8e7c7b48371347cd48abfc22814764160000dd
-  irb (1.18.0) sha256=de9454a0703a54704b9811a5ef31a60c86949fbf4013fcf244fabc7c775248e3
-  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
-  minitest (5.27.0) sha256=2d3b17f8a36fe7801c1adcffdbc38233b938eb0b4966e97a6739055a45fa77d5
-  pp (0.6.4) sha256=dfcb0fce700c41456265922884f9fe195d7fbb0674a3578e6c0f69588e82b570
-  prettyprint (0.2.0) sha256=2bc9e15581a94742064a3cc8b0fb9d45aae3d03a1baa6ef80922627a0766f193
-  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
-  public_suffix (7.0.5) sha256=1a8bb08f1bbea19228d3bed6e5ed908d1cb4f7c2726d18bd9cadf60bc676f623
-  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
-  rbs (4.2.0) sha256=51f7b886dcc05bc09e10b901daa6a81829f6adc03101d6ca9ea4aac6103e0674
-  rdoc (8.0.0) sha256=03bf8c08a9639658855a0cfd77c0abca8325c227693f7f33f82957811348c469
-  reline (0.7.0) sha256=5b012d8e55dbf9d450f12bde2cf7d15ff546ae80b3f8f3b30e570d431815583d
-  rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
-  swarf (0.2.0) sha256=b4306a244fe4b096cfe263e452e666156856eac2467ae5d770639ef11388b375
-  tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f
-  vcr (6.4.0) sha256=077ac92cc16efc5904eb90492a18153b5e6ca5398046d8a249a7c96a9ea24ae6
-  webmock (3.26.4) sha256=8d8da206d217ebe6968cfb09c77f4533c23074e1432bad865f3994eacbaad50d
-
-BUNDLED WITH
-  4.0.20

data/Rakefile

@@ -1,10 +0,0 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
-end
-
-task default: :test

data/bin/console

@@ -1,7 +0,0 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "epok"
-require "irb"
-
-IRB.start(__FILE__)

data/bin/setup

@@ -1,7 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install

data/epok.gemspec

@@ -1,24 +0,0 @@
-lib = File.expand_path("lib", __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-
-require "epok/version"
-
-Gem::Specification.new do |spec|
-  spec.name          = "epok"
-  spec.version       = Epok::VERSION
-  spec.authors       = ["Ariel Rzezak"]
-  spec.email         = ["arzezak@gmail.com"]
-
-  spec.summary       = "GCBA EPOk wrapper."
-  spec.description   = "GCBA EPOk wrapper to query indexed geographic objects."
-  spec.homepage      = "https://github.com/arzezak/epok"
-  spec.license       = "MIT"
-
-  spec.files = `git ls-files`.split("\n")
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "minitest", "~> 5.0"
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "vcr", "~> 6.0"
-  spec.add_development_dependency "webmock", "~> 3.5", ">= 3.5.1"
-end

data/test/epok/api_test.rb

@@ -1,65 +0,0 @@
-require "test_helper"
-
-module Epok
-  class APITest < Minitest::Test
-    include WebMock::API
-
-    def setup
-      VCR.eject_cassette
-      VCR.turn_off!
-    end
-
-    def teardown
-      WebMock.reset!
-      VCR.turn_on!
-    end
-
-    def test_that_a_server_error_raises
-      stub_request(:get, /epok/).to_return(status: 500, body: "boom")
-
-      error = assert_raises(Error) { Epok.search("x").first }
-      assert_match "500", error.message
-    end
-
-    def test_that_a_timeout_raises
-      stub_request(:get, /epok/).to_timeout
-
-      assert_raises(Error) { Epok.categories }
-    end
-
-    def test_that_a_non_json_body_raises
-      stub_request(:get, /epok/).to_return(status: 200, body: "<html>")
-
-      assert_raises(Error) { Epok.search("x").first }
-    end
-
-    def test_that_a_missing_object_raises_not_found
-      stub_request(:get, /getObjectContent/).to_return(status: 200, body: "{}")
-
-      assert_raises(NotFound) { Object.new("nope|1").content }
-    end
-
-    def test_that_an_object_without_a_centroid_has_no_location
-      stub_request(:get, /getObjectContent/)
-        .to_return(status: 200, body: '{"contenido": [], "ubicacion": null}')
-
-      object = Object.new("espacios_verdes_publicos|1")
-
-      assert_nil object.location
-      assert_nil object.location
-    end
-
-    def test_that_a_failed_coordinate_conversion_raises
-      stub_request(:get, /getObjectContent/)
-        .to_return(status: 200, body: '{"ubicacion": {"centroide": "POINT (1 2)"}}')
-      stub_request(:get, /usig/)
-        .to_return(status: 200, body: '{"tipo_resultado":"Error","resultado":{"x":"","y":""}}')
-
-      assert_raises(Error) { Object.new("x|1").location }
-    end
-
-    def test_that_not_found_is_an_error
-      assert_operator NotFound, :<, Error
-    end
-  end
-end

data/test/epok/categories_test.rb

@@ -1,26 +0,0 @@
-require "test_helper"
-
-module Epok
-  class CategoriesTest < Minitest::Test
-    def setup
-      VCR.insert_cassette("categories")
-    end
-
-    def teardown
-      VCR.eject_cassette("categories")
-    end
-
-    def test_that_categories_are_listed
-      categories = Epok.categories
-
-      assert_operator categories.size, :>, 100
-      assert categories.all? { |category| category.is_a?(Category) }
-    end
-
-    def test_that_a_category_has_an_id_and_a_name
-      pharmacies = Epok.categories.find { |category| category.id == "farmacias" }
-
-      assert_equal "Farmacias", pharmacies.name
-    end
-  end
-end

data/test/epok/collection_test.rb

@@ -1,22 +0,0 @@
-require "test_helper"
-
-module Epok
-  class CollectionTest < Minitest::Test
-    def test_that_a_collection_is_enumerable
-      collection = Collection.new { [{"id" => "a|1"}, {"id" => "a|2"}] }
-
-      assert_equal ["a|1", "a|2"], collection.map(&:id)
-      assert_equal 2, collection.count
-    end
-
-    def test_that_a_collection_fetches_lazily_and_once
-      calls = 0
-      collection = Collection.new { calls += 1; [{"id" => "a|1"}] }
-
-      assert_equal 0, calls
-      collection.first
-      collection.to_a
-      assert_equal 1, calls
-    end
-  end
-end

data/test/epok/datos_utiles_test.rb

@@ -1,39 +0,0 @@
-require "test_helper"
-
-module Epok
-  class DatosUtilesTest < Minitest::Test
-    def setup
-      VCR.insert_cassette("datos_utiles")
-    end
-
-    def teardown
-      VCR.eject_cassette("datos_utiles")
-    end
-
-    def test_that_datos_utiles_returns_the_barrio_and_comuna
-      datos = Epok.datos_utiles(Location.new(x: -58.381570, y: -34.603738))
-
-      assert_equal "San Nicolas", datos.barrio
-      assert_equal "Comuna 1", datos.comuna
-    end
-
-    def test_that_datos_utiles_returns_the_other_jurisdictions
-      datos = Epok.datos_utiles(Location.new(x: -58.381570, y: -34.603738))
-
-      assert_equal "3", datos.comisaria
-      assert_equal "1B", datos.comisaria_vecinal
-      assert_equal "HTAL. DR. J.M. RAMOS MEJÍA", datos.area_hospitalaria
-      assert_equal "I (Este)", datos.region_sanitaria
-      assert_equal "Distrito Escolar I", datos.distrito_escolar
-    end
-
-    def test_that_outside_the_city_fields_are_nil_and_amba_is_filled
-      datos = Epok.datos_utiles(Location.new(x: -58.60, y: -34.60))
-
-      assert_nil datos.barrio
-      assert_nil datos.comuna
-      assert_equal "Tres de Febrero", datos.partido_amba
-      assert_equal "Ciudad Jardín Lomas de El Palomar", datos.localidad_amba
-    end
-  end
-end

data/test/epok/geocode_test.rb

@@ -1,36 +0,0 @@
-require "test_helper"
-
-module Epok
-  class GeocodeTest < Minitest::Test
-    def setup
-      VCR.insert_cassette("geocode")
-    end
-
-    def teardown
-      VCR.eject_cassette("geocode")
-    end
-
-    def test_that_an_address_is_normalized_and_located
-      address = Epok.geocode("cabildo 1234").first
-
-      assert_equal "CABILDO AV. 1234, CABA", address.address
-      assert_in_delta(-58.448466, address.location.x)
-      assert_in_delta(-34.568290, address.location.y)
-    end
-
-    def test_that_an_address_has_a_partido_and_localidad
-      addresses = Epok.geocode("cabildo 1234")
-
-      assert_equal "CABA", addresses.first.partido
-      assert_equal "CABA", addresses.first.localidad
-      assert_equal "La Matanza", addresses[1].partido
-      assert_equal "Villa Madero", addresses[1].localidad
-    end
-
-    def test_that_an_unknown_address_raises_not_found
-      error = assert_raises(NotFound) { Epok.geocode("xyzzy 999") }
-
-      assert_equal "Calle inexistente: xyzzy 999", error.message
-    end
-  end
-end

data/test/epok/geocoder_test.rb

@@ -1,49 +0,0 @@
-require "test_helper"
-
-module Epok
-  class GeocoderTest < Minitest::Test
-    def setup
-      VCR.insert_cassette("geocoder")
-    end
-
-    def teardown
-      VCR.eject_cassette("geocoder")
-    end
-
-    def test_that_geocoder_results_are_epok_objects
-      assert_instance_of Object, result
-    end
-
-    def test_that_a_single_geocoder_result_has_a_name
-      assert_match "Línea D", result.name
-    end
-
-    def test_that_geocoder_results_have_a_distance
-      assert_operator result.distance, :<, 500
-    end
-
-    def test_that_geocoder_accepts_a_radius
-      near = Epok.geocoder(obelisco, "estaciones_de_subte", radius: 100)
-      far = Epok.geocoder(obelisco, "estaciones_de_subte", radius: 1000)
-
-      assert_operator near.count, :<, far.count
-      assert near.all? { |station| station.distance <= 100 }
-    end
-
-    def test_that_geocoder_accepts_several_categories
-      results = Epok.geocoder(obelisco, %w[estaciones_de_subte farmacias])
-
-      assert_equal %w[estaciones_de_subte farmacias].sort, results.map(&:category).uniq.sort
-    end
-
-    private
-
-    def result
-      Epok.geocoder(obelisco, "estaciones_de_subte").first
-    end
-
-    def obelisco
-      Location.new(x: -58.381570, y: -34.603738)
-    end
-  end
-end

data/test/epok/object_test.rb

@@ -1,82 +0,0 @@
-require "test_helper"
-
-module Epok
-  class ObjectTest < Minitest::Test
-    def setup
-      VCR.insert_cassette("object")
-    end
-
-    def teardown
-      VCR.eject_cassette("object")
-    end
-
-    def test_that_an_object_has_a_name
-      assert_equal "BIBLIOTECA ANMAT", object.name
-    end
-
-    def test_that_an_object_has_a_kind
-      assert_equal "Dependencias Culturales", object.kind
-    end
-
-    def test_that_an_object_has_a_category
-      assert_equal "dependencias_culturales", object.category
-    end
-
-    def test_that_an_object_has_a_normalized_address
-      assert_equal "DE MAYO AV. 869", object.normalized_address
-    end
-
-    def test_that_an_object_has_a_location
-      location = object.location
-
-      assert_instance_of Location, location
-      assert_in_delta(-58.38, location.x, 0.01)
-      assert_in_delta(-34.61, location.y, 0.01)
-    end
-
-    def test_that_an_object_has_content
-      expected_content = {
-        "Nombre" => "BIBLIOTECA ANMAT",
-        "Categoria" => "BIBLIOTECA",
-        "Subcategoria" => "ESPECIALIZADA GUBERNAMENTAL",
-        "Teléfonos" => "54.011 4340-0800 INT. 1047 FAX 54.011 4340-0800 INT. 1048",
-        "E-Mail" => "<a href=\"mailto:NDURAND@ANMAT.GOV.AR\">NDURAND@ANMAT.GOV.AR</a>",
-        "Página WEB" => "<a href=\"http://WWW.ANMAT.GOV.AR\" target=\"_blank\">WWW.ANMAT.GOV.AR</a>",
-        "Dependencia" => "ADMINISTRACION NACIONAL DE MEDICAMENTOS Y TECNOLOGIA MEDICA ANMAT",
-        "Sector" => "PUBLICO",
-        "Dirección" => "DE MAYO AV. 869",
-        "Barrio" => "MONSERRAT",
-        "Comuna" => "Comuna 1"
-      }
-
-      assert_equal expected_content, object.content
-    end
-
-    def test_that_listing_attributes_do_not_fetch
-      object = Object.new(
-        "id" => "farmacias|1082",
-        "nombre" => "Farmacia en CERRITO 342 ",
-        "clase" => "Farmacia",
-        "distancia" => "112.31"
-      )
-
-      VCR.eject_cassette
-      VCR.turned_off do
-        assert_equal "Farmacia en CERRITO 342", object.name
-        assert_equal "Farmacia", object.kind
-        assert_equal "farmacias", object.category
-        assert_in_delta 112.31, object.distance
-      end
-    end
-
-    def test_that_an_object_built_from_an_id_has_no_distance
-      assert_nil object.distance
-    end
-
-    private
-
-    def object
-      Object.new("dependencias_culturales|1635")
-    end
-  end
-end

data/test/epok/search_test.rb

@@ -1,47 +0,0 @@
-require "test_helper"
-
-module Epok
-  class SearchTest < Minitest::Test
-    def setup
-      VCR.insert_cassette("search")
-    end
-
-    def teardown
-      VCR.eject_cassette("search")
-    end
-
-    def test_that_search_results_are_epok_objects
-      assert_instance_of Object, result
-    end
-
-    def test_that_a_single_search_result_has_a_name
-      assert_match "San Miguel de Garicoits", result.name
-    end
-
-    def test_that_search_encodes_the_query
-      assert_match "Peña", Epok.search("plaza peña").first.name
-    end
-
-    def test_that_search_filters_by_category
-      results = Epok.search("san martin", categories: "estaciones_de_subte")
-
-      assert_equal ["estaciones_de_subte"], results.map(&:category).uniq
-    end
-
-    def test_that_search_filters_by_several_categories
-      results = Epok.search("san martin", categories: %w[estaciones_de_subte estaciones_de_ferrocarril])
-
-      assert_equal %w[estaciones_de_ferrocarril estaciones_de_subte], results.map(&:category).uniq.sort
-    end
-
-    def test_that_search_limits_results
-      assert_equal 2, Epok.search("san martin", limit: 2).count
-    end
-
-    private
-
-    def result
-      Epok.search("garicoits").first
-    end
-  end
-end

data/test/epok_test.rb

@@ -1,13 +0,0 @@
-require "test_helper"
-
-class EpokTest < Minitest::Test
-  def test_that_search_builds_a_collection
-    assert_instance_of Epok::Collection, Epok.search("garicoits")
-  end
-
-  def test_that_geocoder_builds_a_collection
-    obelisco = Epok::Location.new(x: -58.381570, y: -34.603738)
-
-    assert_instance_of Epok::Collection, Epok.geocoder(obelisco, "farmacias")
-  end
-end

data/test/test_helper.rb

@@ -1,13 +0,0 @@
-require "swarf/probe"
-
-$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
-
-require "epok"
-require "minitest/autorun"
-require "vcr"
-
-VCR.configure do |config|
-  config.cassette_library_dir = "test/fixtures"
-  config.hook_into :webmock
-  config.default_cassette_options = { record: :new_episodes }
-end