Merge geojsontables

.github/workflows/CI.yml

@@ -13,13 +13,13 @@ jobs:
       fail-fast: false
       matrix:
         version:
-          - '1.0'
+          - '1.6'
           - '1'
           - 'nightly'
         os:
           - ubuntu-latest
           - macOS-latest
-          - windows-latest
+          # - windows-latest  # re-enable when new GeoInterface is released
         arch:
           - x64
     steps:

.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+/Manifest.toml
+/dev/

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2019 Martijn Visser <mgvisser@gmail.com>
+
+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.

Project.toml

@@ -1,19 +1,27 @@
-name = "GeoJSON"
-uuid = "61d90e0f-e114-555e-ac52-39dfb47a3ef9"
-license = "MIT"
-version = "0.5.1"
+name = "GeoJSONTables"
+uuid = "b51d8a2e-9f51-4bbc-a3e6-443ab3727fd0"
+authors = ["Martijn Visser <mgvisser@gmail.com>"]
+version = "0.1.0"
 
 [deps]
+Extents = "411431e0-e8b7-467b-b5e0-f676ba4f2910"
+GeoFormatTypes = "68eda718-8dee-11e9-39e7-89f7f65f511f"
 GeoInterface = "cf35fbd7-0cd7-5166-be24-54bfbe79505f"
 JSON3 = "0f8b85d8-7281-11e9-16c2-39a750bddbf1"
+Tables = "bd369af6-aec1-5ad0-b16a-f7cc5008161c"
 
 [compat]
-GeoInterface = "0.4, 0.5"
-JSON3 = "0.1.5, 1.0"
-julia = "1"
+Aqua = "0.5"
+Extents = "0.1"
+GeoFormatTypes = "0.4"
+GeoInterface = "1"
+JSON3 = "1"
+Tables = "1"
+julia = "1.6"
 
 [extras]
+Aqua = "4c88cf16-eb10-579e-8560-4a9242c79595"
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
 
 [targets]
-test = ["Test"]
+test = ["Aqua", "Test"]

README.md

@@ -1,22 +1,33 @@
-# GeoJSON.jl
+# GeoJSONTables
 
-[![CI](https://github.com/JuliaGeo/GeoJSON.jl/workflows/CI/badge.svg)](https://github.com/JuliaGeo/GeoJSON.jl/actions?query=workflow%3ACI)
-[![Coverage Status](https://coveralls.io/repos/JuliaGeo/GeoJSON.jl/badge.svg)](https://coveralls.io/r/JuliaGeo/GeoJSON.jl)
-[![Latest Documentation](https://img.shields.io/badge/docs-dev-blue.svg)](https://juliageo.github.io/GeoJSON.jl/dev/)
+Read [GeoJSON](https://geojson.org/) [FeatureCollections](https://tools.ietf.org/html/rfc7946#section-3.3) using [JSON3.jl](https://github.com/quinnj/JSON3.jl), and provide the [Tables.jl](https://github.com/JuliaData/Tables.jl) interface.
 
-This library is developed independently of, but is heavily influenced in design by the [python-geojson](https://github.com/frewsxcv/python-geojson) package. It contains:
+This package is unregistered and in development, so expect changes. It only supports reading, and only of FeatureCollections.
 
-- Functions for encoding and decoding GeoJSON formatted data
-- a type hierarchy (according to the [GeoJSON specification](http://geojson.org/geojson-spec.html))
-- An implementation of the [\__geo_interface\__](https://gist.github.com/sgillies/2217756), a GeoJSON-like protocol for geo-spatial (GIS) vector data.
+This package is heavily inspired by, and borrows code from, [JSONTables.jl](https://github.com/JuliaData/JSONTables.jl), which
+does the same thing for the general JSON format. GeoJSONTables puts the geometry in a `geometry` column, and adds all
+properties in the columns individually. The geometry and non-scalar properties are kept as JSON3.Object and JSON3.Array.
+Right now that means the geometries are hard to use, but at least parsing is fast.
 
-Note that GeoJSON.jl loads features into the GeoInterface.jl format and that this differs from GeoJSON in the following ways:
+Going forward, it would be nice to try developing a GeoTables.jl, similarly to Tables.jl, but with special support
+for a geometry column, that supports a diverse set of geometries, such as those of [LibGEOS](https://github.com/JuliaGeo/LibGEOS.jl), [Shapefile](https://github.com/JuliaGeo/Shapefile.jl), [ArchGDAL.jl](https://github.com/yeesian/ArchGDAL.jl/), [GeometryBasics](https://github.com/SimonDanisch/GeometryBasics.jl) and of course this package.
 
-- Julia Geometries do not provide a `bbox` and `crs` method. If you wish to provide a `bbox` or `crs` attribute, wrap the geometry into a `Feature` or `FeatureCollection`.
-- Features do not have special fields for `id`, `bbox`, and `crs`. These are to be provided (or found) in the `properties` field, under the keys `featureid`, `bbox`, and `crs` respectively (if they exist).
+It would also be good to explore integrating this code into [GeoJSON.jl](https://github.com/JuliaGeo/GeoJSON.jl) and
+archiving this package. See [GeoJSON.jl#23](https://github.com/JuliaGeo/GeoJSON.jl/pull/23) for discussion.
 
-When saving GeoJSON, these transformations will be reversed: if `properties` has a key `featureid`, that will be removed from `properties` and a matching member `id` will be added to the Feature; similarly for `crs` and `bbox`.
+## Usage
 
-## Documentation
+```julia
+julia> using GeoJSONTables, DataFrames
 
-Documentation for GeoJSON.jl can be found at https://juliageo.github.io/GeoJSON.jl/dev/.
+julia> jsonbytes = read("path/to/a.geojson");
+
+julia> fc = GeoJSONTables.read(jsonbytes)
+FeatureCollection with 171 Features
+
+julia> first(fc)
+Feature with geometry type Polygon and properties Symbol[:geometry, :timestamp, :version, :changeset, :user, :uid, :area, :highway, :type, :id]
+
+# use the Tables interface to convert the format, extract data, or iterate over the rows
+julia> df = DataFrame(fc)
+```