proj4rb 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdd77e892a3126bb4c0b4c984356e9ba6a32e73811813c2d5dcc5a2eb36a02ae
-  data.tar.gz: 0217052b386be354cd4b48c5bc0536c179336c5c73026a3cb544e9630ad66810
+  metadata.gz: 4d2946731ccd3cf4e96e214fce1e8e3c7fc46313f5f1d1fcc119c84e9b88f26f
+  data.tar.gz: 17ca8b08ed1b03be5d910ba77013b7028d88e45160b352764619799f7f156887
 SHA512:
-  metadata.gz: 9d0e577ede5260d24da9b474e10c52700f9179fe9a42e61728fba85f051be1b152af847c6c45c8df9ef9ad9f5b5ea71ca82ecbef977056b2361dfb2de3be7dac
-  data.tar.gz: 050366cf1ce478ee809a4d82af9a9ed0a9e54e3fd28d4fd58d4fac4b22c0ddbb431969a61581c8a5e3990525e567f2fb7f03b1f9a010b734867c67c9795f7369
+  metadata.gz: 6a23e8938aa5d6289dabe4b1f0e5ad2aa204281f6ff2f0073fcbc20b6d404bc6b265120cb0c22561ad68338248a16959fd36873777cdbe7ebae4cbf86258ad2f
+  data.tar.gz: 78b42798c55214f7d73df85575b5d6a4a64283ab51583656a9441a725c369fde5a7b12c36944a8dd0a66c67bdf9ef6b48e189e34a3c6d280f11e0adca4116835

data/ChangeLog

@@ -1,16 +1,42 @@
-2.0.0 (December 30, 2019)
+3.0.0 (September 26, 2021)
+=========================
+* Support Proj 8 which removes the old Proj API (Charlie Savage)
+* Support newer versions of FFI which remove support for returning strings from callbacks (Charlie Savage)
+
+2.2.2 (January 10, 2020)
 =========================
-- Full rewrite to support API changes in Proj versions 5 and 6
-- As part of rewrite switch bindings to use FFI versus a C extension
-- Split Ruby code into multiple files based on classes
-- Add in a bunch of new classes including Context, Crs, Coordinate, Ellipsoid, Prime Meridian and Transform
-- Deprecate Projection and Point - these will stop working with Proj 7 since the use an older deprecated API
+* Move proj_context_set_autoclose_database to api 6.2 (Jan Klimke)
+* Improve search path generation code (Charlie Savage)
 
-- Calling this 1.0.0 since its a very stable gem
+2.2.1 (January 8, 2020)
+=========================
+* Move proj_as_projjson from version 6.0 to 6.2 api (Charlie Savage)
+* Improve search path generation code (Charlie Savage)
+
+2.2.0 (January 7, 2020)
+=========================
+* Fix broken gem - was not including all api files (Jan Klimke)
+* Add paths on MacOS when using Brew (Jan Klimke)
+* Various code cleanups (Charlie Savage)
+
+2.1.0 (January 5, 2020)
+=========================
+* Set Ruby 2.4.1 to be the minimum allowed version (Samuel Williams)
+* Fix incorrect use of context, reduce warnings when running tests (Samuel Williams)
+* Fix `bundle exec rake test` (Samuel Williams)
+* Add 2.4.1 to the travis test matrix  (Samuel Williams)
+
+2.0.0 (December 30, 2019)
+=========================
+- Full rewrite to support API changes in Proj versions 5 and 6 (Charlie Savage)
+- As part of rewrite switch bindings to use FFI versus a C extension (Charlie Savage)
+- Split Ruby code into multiple files based on classes (Charlie Savage)
+- Add in a bunch of new classes including Context, Crs, Coordinate, Ellipsoid, Prime Meridian and Transform (Charlie Savage)
+- Deprecate Projection and Point - these will stop working with Proj 7 since the use an older deprecated API (Charlie Savage)
 
 1.0.0 (December 14, 2014)
 =========================
-- Calling this 1.0.0 since its a very stable gem
+- Calling this 1.0.0 since its a very stable gem  (Charlie Savage)
 
 0.4.3 (August 30, 2011)
 =========================

data/README.rdoc

@@ -1,7 +1,10 @@
-=Proj4rb
+= Proj4rb
 This gem provides Ruby bindings for the Proj Library (https://proj.org). The Proj Library supports converting coordinates
 between a number of different coordinate systems and projections.
 
+== Documentation
+Besides this readme file, reference documentation is available at https://rubydoc.info/github/cfis/proj4rb.
+
 == Installation
 First install the gem in the usual manner:
 
@@ -21,8 +24,8 @@ If you are using the old Proj4 namespace, then you can do this:
   require 'proj4'
 
 === Crs
-If you are using Proj 6 create a coordinate system. To create a coordinate system, you can use CRS codes, well-known text (WKT) strings
-or old-style Proj4 strings (which are deprecated).
+If you are using Proj 6, or newer, create a coordinate system. To create a coordinate system, you can use CRS codes,
+well-known text (WKT) strings or old-style Proj4 strings (which are deprecated).
 
     crs1 = Proj::Crs.new('EPSG:4326')
 
@@ -76,24 +79,20 @@ the +forward+ or +inverse+ methods. The forward transformation looks like this:
     from = Proj::Coordinate.new(x: 5428192.0, y: 3458305.0, z: -5.1790915237)
     to = transform.forward(from)
 
-    assert_in_delta(48.98963932450735, to.x, PRECISION)
-    assert_in_delta(8.429263044355544, to.y, PRECISION)
-    assert_in_delta(-5.1790915237, to.z, PRECISION)
-    assert_in_delta(0, to.t, PRECISION)
+    assert_in_delta(48.98963932450735, to.x, 0.01)
+    assert_in_delta(8.429263044355544, to.y, 0.01)
+    assert_in_delta(-5.1790915237, to.z, 0.01)
+    assert_in_delta(0, to.t, 0.01)
 
 While the inverse transformation looks like this:
 
     from = Proj::Coordinate.new(lam: 48.9906726079, phi: 8.4302123334)
     to = transform.inverse(from)
 
-    assert_in_delta(5428306.389495558, to.x, PRECISION)
-    assert_in_delta(3458375.3367194114, to.y, PRECISION)
-    assert_in_delta(0, to.z, PRECISION)
-    assert_in_delta(0, to.t, PRECISION)
-
-Transformation objects can also be created directly like this:
-
-    transform = Proj::Transformation.new('epsg:31467', 'epsg:4326')
+    assert_in_delta(5428306.389495558, to.x, 0.01)
+    assert_in_delta(3458375.3367194114, to.y, 0.01)
+    assert_in_delta(0, to.z, 0.01)
+    assert_in_delta(0, to.t, 0.01)
 
 === Coordinate
 Notice the examples above transform Coordinate objects. A Coordinate consists
@@ -114,8 +113,8 @@ Both Crs and Transformation objects take a context object in their constructors.
 to using Context.current
 
 === Projection
-If you are using Proj 4, then instead of using Coordinates, Crses and Tranformations you use Points and Projections. Those
-are deprecated classes but will continue to work until the release of Proj 7.  Please refer to the documentation
+If you are using Proj 4, then instead of using Coordinates, Crses and Tranformations you need to us Points and Projections.
+Those are deprecated classes but will continue to work with Proj version 7 and older.  Please refer to the documentation
 for more information.
 
 == Error handling
@@ -133,15 +132,15 @@ variable and have it work correctly (at least not on windows).
 == Backwards Compatibility
 Proj versions 5 and 6 are *very* different than Proj version 4. Changes are documented at
 https://proj.org/development/migration.html. Note that the gem should gracefully degrade
-(as in newer functionality stops working) depending on if you are using Proj 6, Proj 5 or Proj 4.
+(as in newer functionality stops working but older functionality keeps working) depending on
+the version of Proj you are using.
 
 To ensure backwards compatiblity, the Ruby bindings still include the older Point and Projection
-classes. However, these classes are no longer documented in this Readme because they will be
-removed upon the release of Proj 7 which will remove the underlying API's they are dependent upon.
-So please port your code! But take note of the changes in Proj 6 described below.
+classes. However, these classes are no longer documented in this Readme because the underlying API
+they rely on was removed in Proj 8. So please port your code! But take note of the changes in Proj 6 described below.
 
-Proj 5 introduced the the Coordinate, Crs and Tranformation apis. However, it wasn't until Proj 6 that additional
-metadata APIs were added, so the amount of information about each object is somewhat limited.
+Proj 5 introduced the Coordinate, Crs and Tranformation APIs. However, it wasn't until Proj 6 that additional
+metadata APIs were added, so the amount of information about each object is somewhat limited in Proj 5.
 
 Proj 6 makes a big change compared to previous releases that is not well documented (see
 https://github.com/OSGeo/PROJ/pull/1182). When creating tranformations with EPSG values Proj 6
@@ -166,5 +165,5 @@ Proj4rb is released under the MIT license.
 ==Authors
 The proj4rb Ruby bindings were started by Guilhem Vellut with most of the code 
 written by Jochen Topf.  Charlie Savage ported the code to Windows and added 
-the Windows build infrastructure. Later, he updated the code to support
-Proj version 5 and 6 and ported the code to use FFI.
+the Windows build infrastructure. Later, he rewrote the code to support
+Proj version 5 and 6 and ported it to use FFI.

data/Rakefile

@@ -23,5 +23,6 @@ YARD::Rake::YardocTask.new
 # Test Task
 Rake::TestTask.new do |t|
   t.libs << "test"
+  t.test_files = FileList['test/*_test.rb']
   t.verbose = true
 end

data/lib/api/api.rb

@@ -0,0 +1,118 @@
+require 'rbconfig'
+require 'ffi'
+
+module Proj
+  module Api
+    extend FFI::Library
+
+    def self.library_versions
+      [22, # 8.0 and 8.1
+       19, # 7.x
+       17, # 6.2 *and* 6.1
+       15, # 6.0
+       14, # 5.2
+       13, # 5.0
+       12, # 4.9
+       11] # 4.9
+    end
+
+    def self.search_paths
+      result = case RbConfig::CONFIG['host_os']
+                 when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+                   self.windows_search_paths
+                 when /darwin|mac os/
+                   self.macos_search_paths
+                 else
+                   self.linux_search_paths
+               end
+
+      result << 'libproj'
+      result
+    end
+
+    def self.windows_search_paths
+      self.library_versions.map do |version|
+        "libproj-#{version}"
+      end
+    end
+
+    def self.linux_search_paths
+      self.library_versions.map do |version|
+        "libproj.so.#{version}"
+      end
+    end
+
+    def self.macos_search_paths
+      # Mac Ports
+      paths1 = self.library_versions.map do |version|
+        case version
+          when 15..17
+            "/opt/local/lib/proj6/lib/libproj.#{version}.dylib"
+          when 13..14
+            "/opt/local/lib/proj5/lib/libproj.#{version}.dylib"
+          when 11..12
+            "/opt/local/lib/proj49/lib/libproj.#{version}.dylib"
+        end
+      end
+
+      # Mac HomeBrew
+      paths2 = self.library_versions.map do |version|
+        "/usr/local/lib/libproj.#{version}.dylib"
+      end
+
+      paths1 + paths2
+    end
+
+    ffi_lib self.search_paths
+
+    library = ffi_libraries.first
+
+    # proj_info was introduced in Proj 5
+    if library.find_function('proj_info')
+      require_relative './api_5_0'
+      PROJ_VERSION = Gem::Version.new(self.proj_info[:version])
+    else
+      # Load the old deprecated api
+      require_relative './api_4_9'
+
+      release = self.pj_get_release
+      version = release.match(/\d\.\d\.\d/)
+      PROJ_VERSION = Gem::Version.new(version)
+    end
+  end
+
+  if Api::PROJ_VERSION < Gem::Version.new('5.0.0')
+    def Api.proj_torad(value)
+      value * 0.017453292519943296
+    end
+
+    def Api.proj_todeg(value)
+      value * 57.295779513082321
+    end
+  end
+
+  # Load the old deprecated API for versions before version 8
+  if Api::PROJ_VERSION < Gem::Version.new('8.0.0')
+    require_relative './api_4_9'
+  end
+
+  if Api::PROJ_VERSION >= Gem::Version.new('5.1.0')
+    require_relative './api_5_1'
+  end
+
+  if Api::PROJ_VERSION >= Gem::Version.new('5.2.0')
+    require_relative './api_5_2'
+  end
+
+  if Api::PROJ_VERSION >= Gem::Version.new('6.0.0')
+    require_relative './api_6_0'
+  end
+
+  if Api::PROJ_VERSION >= Gem::Version.new('6.1.0')
+    require_relative './api_6_1'
+  end
+
+  if Api::PROJ_VERSION >= Gem::Version.new('6.2.0')
+    require_relative './api_6_2'
+  end
+end

data/lib/api/api_4_9.rb

@@ -0,0 +1,31 @@
+module Proj
+  module Api
+    #########  Deprecated API from proj_api.h. Don't use these anymore! ##############
+    typedef :pointer, :projPJ
+
+    class ProjUV < FFI::Struct
+      layout :u, :double,
+             :v, :double
+    end
+
+    ProjXY = ProjUV
+    ProjLP = ProjUV
+
+    attach_function :pj_init, [:int, :pointer], :projPJ
+    attach_function :pj_free, [:projPJ], :void
+
+    attach_function :pj_get_release, [], :string
+    attach_function :pj_set_searchpath, [:int, :pointer], :void
+
+    attach_function :pj_get_errno_ref, [], :pointer
+    attach_function :pj_strerrno, [:int], :string
+
+    attach_function :pj_get_def, [:projPJ, :int], :string
+    attach_function :pj_is_latlong, [:projPJ], :bool
+    attach_function :pj_is_geocent, [:projPJ], :bool
+
+    attach_function :pj_fwd, [ProjLP.by_value, :projPJ], ProjXY.by_value
+    attach_function :pj_inv, [ProjXY.by_value, :projPJ], ProjLP.by_value
+    attach_function :pj_transform, [:projPJ, :projPJ, :long, :int, :pointer, :pointer, :pointer], :bool
+  end
+end

data/lib/api/api_5_0.rb

@@ -0,0 +1,301 @@
+module Proj
+  module Api
+    typedef :pointer, :PJ
+    typedef :pointer, :PJ_CONTEXT
+    typedef :pointer, :PJ_AREA
+
+    class P5_FACTORS < FFI::Struct
+      layout :meridional_scale, :double,               # h 
+             :parallel_scale, :double,                 # k 
+             :areal_scale, :double,                    # s 
+         
+             :angular_distortion, :double,             # omega 
+             :meridian_parallel_angle, :double,        # theta-prime 
+             :meridian_convergence, :double,           # alpha 
+        
+             :tissot_semimajor, :double,               # a 
+             :tissot_semiminor, :double,               # b 
+         
+             :dx_dlam, :double,
+             :dx_dphi, :double,
+             :dy_dlam, :double,
+             :dy_dphi, :double
+    end
+
+    # Data types for list of operations, ellipsoids, datums and units used in PROJ.4 */
+    class PJ_LIST < FFI::Struct
+      layout :id,    :string,   # projection keyword
+             :PJ,    :pointer,  # projection entry point
+             :descr, :pointer   # description text
+    end
+    PJ_OPERATIONS = PJ_LIST
+
+    class PJ_ELLPS < FFI::Struct
+      layout :id, :string, # ellipse keyword name
+             :major, :string, # a= value
+             :ell, :string, # elliptical parameter
+             :name, :string # comments
+    end
+
+    class PJ_UNITS < FFI::Struct
+      layout :id, :string, # units keyword
+             :to_meter, :string, # multiply by value to get meters
+             :name, :string, # comments
+             :factor, :double # to_meter factor in actual numbers
+    end
+
+    class PJ_PRIME_MERIDIANS < FFI::Struct
+      layout :id, :string, # prime meridian keyword
+             :defn, :string # offset from greenwich in DMS format.
+    end
+
+    # Geodetic, mostly spatiotemporal coordinate types
+    class PJ_XYZT < FFI::Struct
+      layout :x, :double,
+             :y, :double,
+             :z, :double,
+             :t, :double
+    end
+
+    class PJ_UVWT < FFI::Struct
+      layout :u, :double,
+             :v, :double,
+             :w, :double,
+             :t, :double
+    end
+
+    class PJ_LPZT < FFI::Struct
+      layout :lam, :double,
+             :phi, :double,
+             :z, :double,
+             :t, :double
+    end
+
+    # Rotations: omega, phi, kappa
+    class PJ_OPK < FFI::Struct
+      layout :o, :double,
+             :p, :double,
+             :k, :double
+    end
+
+    # East, North, Up
+    class PJ_ENU < FFI::Struct
+      layout :e, :double,
+             :n, :double,
+             :u, :double
+    end
+
+    # Geodesic length, fwd azi, rev azi
+    class PJ_GEOD < FFI::Struct
+      layout :s, :double,
+             :a1, :double,
+             :a2, :double
+    end
+
+    # Classic proj.4 pair/triplet types - moved into the PJ_ name space.
+    class PJ_UV < FFI::Struct
+      layout :u, :double,
+             :v, :double
+    end
+
+    class PJ_XY < FFI::Struct
+      layout :x, :double,
+             :y, :double
+    end
+
+    class PJ_LP < FFI::Struct
+      layout :lam, :double,
+             :phi, :double
+    end
+
+    class PJ_XYZ < FFI::Struct
+      layout :x, :double,
+             :y, :double,
+             :z, :double
+    end
+
+    class PJ_UVW < FFI::Struct
+      layout :u, :double,
+             :v, :double,
+             :w, :double
+    end
+
+    class PJ_LPZ < FFI::Struct
+      layout :lam, :double,
+             :phi, :double,
+             :z, :double
+    end
+
+    class PJ_COORD < FFI::Union
+      layout :v, [:double, 4],
+             :xyzt, PJ_XYZT,
+             :uvwt, PJ_UVWT,
+             :lpzt, PJ_LPZT,
+             :geod, PJ_GEOD,
+             :opk, PJ_OPK,
+             :enu, PJ_ENU,
+             :xyz, PJ_XYZ,
+             :uvw, PJ_UVW,
+             :lpz, PJ_LPZ,
+             :xy,  PJ_XY,
+             :uv, PJ_UV,
+             :lp, PJ_LP
+    end
+
+    class PJ_INFO < FFI::Struct
+      layout :major, :int, # Major release number
+             :minor, :int,  # Minor release number
+             :patch, :int,  # Patch level
+             :release, :string,  # Release info. Version + date
+             :version, :string,   # Full version number
+             :searchpath, :string,  # Paths where init and grid files are looked for. Paths are separated by
+                                    # semi-colons on Windows, and colons on non-Windows platforms.
+             :paths, :pointer,
+             :path_count, :size_t
+    end
+
+    class PJ_PROJ_INFO < FFI::Struct
+      layout :id, :string, # Name of the projection in question
+             :description, :string, # Description of the projection
+             :definition, :string, # Projection definition
+             :has_inverse, :int, # 1 if an inverse mapping exists, 0 otherwise
+             :accuracy, :double # Expected accuracy of the transformation. -1 if unknown.
+
+      def to_s
+        "<#{self.class.name} id: #{self[:id]},  description: #{self[:description]}, definition: #{self[:definition]}, has_inverse: #{self[:has_inverse]} accuracy: #{self[:accuracy]}"
+      end
+    end
+
+    class PJ_GRID_INFO < FFI::Struct
+      layout :gridname, [:string, 32],  # name of grid
+             :filename, [:string, 260], # full path to grid
+             :format, [:string, 8],     # file format of grid
+             :lowerleft, PJ_LP,         # Coordinates of lower left corner
+             :upperright, PJ_LP,        # Coordinates of upper right corner
+             :n_lon, :int,              # Grid size
+             :n_lat, :int,              # Grid size
+             :cs_lon, :double,          # Cell size of grid
+             :cs_lat, :double           # Cell size of grid
+    end
+
+    class PJ_INIT_INFO < FFI::Struct
+      layout :name, [:string, 32],       # name init file
+             :filename, [:string, 260],  # full path to the init file
+             :version, [:string, 32],    # version of the init file
+             :origin, [:string, 32],     # origin of the file, e.g. EPSG
+             :lastupdate, [:string, 16] # Date of last update in YYYY-MM-DD format
+    end
+
+    enum :PJ_LOG_LEVEL, [:PJ_LOG_NONE , 0,
+                         :PJ_LOG_ERROR, 1,
+                         :PJ_LOG_DEBUG, 2,
+                         :PJ_LOG_TRACE, 3,
+                         :PJ_LOG_TELL , 4,
+                         :PJ_LOG_DEBUG_MAJOR, 2, # for proj_api.h compatibility
+                         :PJ_LOG_DEBUG_MINOR, 3] # for proj_api.h compatibility
+
+    # Apply transformation to observation - in forward or inverse direction
+    enum :PJ_DIRECTION, [:PJ_FWD, 1,   # Forward
+                         :PJ_IDENT, 0, # Do nothing
+                         :PJ_INV, -1]   # Inverse
+
+    enum :PJ_CATEGORY, [:PJ_CATEGORY_ELLIPSOID,
+                        :PJ_CATEGORY_PRIME_MERIDIAN,
+                        :PJ_CATEGORY_DATUM,
+                        :PJ_CATEGORY_CRS,
+                        :PJ_CATEGORY_COORDINATE_OPERATION]
+
+    enum :PJ_TYPE, [:PJ_TYPE_UNKNOWN,
+                    :PJ_TYPE_ELLIPSOID,
+                    :PJ_TYPE_PRIME_MERIDIAN,
+                    :PJ_TYPE_GEODETIC_REFERENCE_FRAME,
+                    :PJ_TYPE_DYNAMIC_GEODETIC_REFERENCE_FRAME,
+                    :PJ_TYPE_VERTICAL_REFERENCE_FRAME,
+                    :PJ_TYPE_DYNAMIC_VERTICAL_REFERENCE_FRAME,
+                    :PJ_TYPE_DATUM_ENSEMBLE,
+
+                    # Abstract type, not returned by proj_get_type()
+                    :PJ_TYPE_CRS,
+
+                    :PJ_TYPE_GEODETIC_CRS,
+                    :PJ_TYPE_GEOCENTRIC_CRS,
+
+                    # proj_get_type() will never return that type, but
+                    # :PJ_TYPE_GEOGRAPHIC_2D_CRS or :PJ_TYPE_GEOGRAPHIC_3D_CRS.
+                    :PJ_TYPE_GEOGRAPHIC_CRS,
+
+                    :PJ_TYPE_GEOGRAPHIC_2D_CRS,
+                    :PJ_TYPE_GEOGRAPHIC_3D_CRS,
+                    :PJ_TYPE_VERTICAL_CRS,
+                    :PJ_TYPE_PROJECTED_CRS,
+                    :PJ_TYPE_COMPOUND_CRS,
+                    :PJ_TYPE_TEMPORAL_CRS,
+                    :PJ_TYPE_ENGINEERING_CRS,
+                    :PJ_TYPE_BOUND_CRS,
+                    :PJ_TYPE_OTHER_CRS,
+
+                    :PJ_TYPE_CONVERSION,
+                    :PJ_TYPE_TRANSFORMATION,
+                    :PJ_TYPE_CONCATENATED_OPERATION,
+                    :PJ_TYPE_OTHER_COORDINATE_OPERATION]
+
+    enum :PJ_PROJ_STRING_TYPE, [:PJ_PROJ_5,
+                                :PJ_PROJ_4]
+
+    enum :PJ_COORDINATE_SYSTEM_TYPE, [:PJ_CS_TYPE_UNKNOWN,
+                                      :PJ_CS_TYPE_CARTESIAN,
+                                      :PJ_CS_TYPE_ELLIPSOIDAL,
+                                      :PJ_CS_TYPE_VERTICAL,
+                                      :PJ_CS_TYPE_SPHERICAL,
+                                      :PJ_CS_TYPE_ORDINAL,
+                                      :PJ_CS_TYPE_PARAMETRIC,
+                                      :PJ_CS_TYPE_DATETIMETEMPORAL,
+                                      :PJ_CS_TYPE_TEMPORALCOUNT,
+                                      :PJ_CS_TYPE_TEMPORALMEASURE]
+
+    enum :PJ_WKT_TYPE, [:PJ_WKT2_2015,
+                        :PJ_WKT2_2015_SIMPLIFIED,
+                        :PJ_WKT2_2018,
+                        :PJ_WKT2_2018_SIMPLIFIED,
+                        :PJ_WKT1_GDAL,
+                        :PJ_WKT1_ESRI]
+
+    attach_function :proj_info, [], PJ_INFO.by_value
+    attach_function :proj_pj_info, [:PJ], PJ_PROJ_INFO.by_value
+    attach_function :proj_grid_info, [:string], PJ_GRID_INFO.by_value
+    attach_function :proj_init_info, [:string], PJ_INIT_INFO.by_value
+
+    # Contexts
+    attach_function :proj_context_create, [], :PJ_CONTEXT
+    attach_function :proj_context_destroy, [:PJ_CONTEXT], :PJ_CONTEXT
+
+    # Error handling
+    attach_function :proj_context_errno, [:PJ_CONTEXT], :int
+    attach_function :proj_errno, [:PJ], :int
+    attach_function :proj_errno_set, [:PJ, :int], :int
+    attach_function :proj_errno_reset, [:PJ], :int
+    attach_function :proj_errno_restore, [:PJ, :int], :int
+
+    # Manage the transformation definition object PJ
+    attach_function :proj_create, [:PJ_CONTEXT, :string], :PJ
+    attach_function :proj_create_argv, [:PJ_CONTEXT, :int, :pointer], :PJ
+    attach_function :proj_create_crs_to_crs, [:PJ_CONTEXT, :string, :string, :PJ_AREA], :PJ
+    attach_function :proj_destroy, [:PJ], :PJ
+
+    attach_function :proj_trans, [:PJ, :PJ_DIRECTION, PJ_COORD.by_value], PJ_COORD.by_value
+
+    # Get lists of operations, ellipsoids, units and prime meridians
+    attach_function :proj_list_operations, [], :pointer #PJ_LIST
+    attach_function :proj_list_ellps, [], :pointer #PJ_ELLPS
+    attach_function :proj_list_units, [], :pointer #PJ_UNITS
+    attach_function :proj_list_prime_meridians, [], :pointer #PJ_PRIME_MERIDIANS
+
+    # Degrees/radians
+    attach_function :proj_torad, [:double], :double
+    attach_function :proj_todeg, [:double], :double
+    attach_function :proj_dmstor, [:string, :pointer], :double
+    attach_function :proj_rtodms, [:string, :double, :int, :int], :string
+    attach_function :proj_angular_input, [:PJ, :PJ_DIRECTION], :bool
+    attach_function :proj_angular_output, [:PJ, :PJ_DIRECTION], :bool
+  end
+end

data/lib/api/api_5_1.rb

@@ -0,0 +1,7 @@
+module Proj
+  module Api
+    attach_function :proj_log_level, [:PJ_CONTEXT, :PJ_LOG_LEVEL], :PJ_LOG_LEVEL
+    callback :pj_log_function, [:pointer, :int, :string], :void
+    attach_function :proj_log_func, [:PJ_CONTEXT, :pointer, :pj_log_function], :void
+  end
+end

data/lib/api/api_5_2.rb

@@ -0,0 +1,5 @@
+module Proj
+  module Api
+    attach_function :proj_errno_string, [:int], :string
+  end
+end

data/lib/api/api_6_0.rb

@@ -0,0 +1,42 @@
+module Proj
+  module Api
+    callback :proj_file_finder, [:PJ_CONTEXT, :string, :pointer], :pointer
+    attach_function :proj_context_set_file_finder, [:PJ_CONTEXT, :proj_file_finder, :pointer], :void
+    attach_function :proj_context_set_search_paths, [:PJ_CONTEXT, :int, :pointer], :void
+
+    attach_function :proj_context_use_proj4_init_rules, [:PJ_CONTEXT, :int], :void
+    attach_function :proj_context_get_use_proj4_init_rules, [:PJ_CONTEXT, :int], :bool
+    attach_function :proj_list_angular_units, [], :pointer #PJ_UNITS
+
+    # Base methods
+    attach_function :proj_get_name, [:PJ], :string
+    attach_function :proj_get_id_auth_name, [:PJ, :int], :string
+    attach_function :proj_get_id_code, [:PJ, :int], :string
+    attach_function :proj_get_type, [:PJ], :PJ_TYPE
+    attach_function :proj_is_deprecated, [:PJ], :bool
+    attach_function :proj_is_crs, [:PJ], :bool
+    attach_function :proj_get_area_of_use, [:PJ_CONTEXT, :PJ, :pointer, :pointer, :pointer, :pointer, :pointer], :bool
+
+    # Export to various formats
+    attach_function :proj_as_wkt, [:PJ_CONTEXT, :PJ, :PJ_WKT_TYPE, :pointer], :string
+    attach_function :proj_as_proj_string, [:PJ_CONTEXT, :PJ, :PJ_PROJ_STRING_TYPE, :pointer], :string
+
+    # Projection database functions    
+    attach_function :proj_context_set_database_path, [:PJ_CONTEXT, :string, :pointer, :pointer], :int
+    attach_function :proj_context_get_database_path, [:PJ_CONTEXT], :string
+    attach_function :proj_context_get_database_metadata, [:PJ_CONTEXT, :string], :string
+
+    # CRS methods
+    attach_function :proj_crs_get_geodetic_crs, [:PJ_CONTEXT, :PJ], :PJ
+    attach_function :proj_crs_get_horizontal_datum, [:PJ_CONTEXT, :PJ], :PJ
+    attach_function :proj_crs_get_sub_crs, [:PJ_CONTEXT, :PJ, :int], :PJ
+    attach_function :proj_crs_get_datum, [:PJ_CONTEXT, :PJ], :PJ
+    attach_function :proj_crs_get_coordinate_system, [:PJ_CONTEXT, :PJ], :PJ
+    attach_function :proj_cs_get_type, [:PJ_CONTEXT, :PJ], :PJ_COORDINATE_SYSTEM_TYPE
+    attach_function :proj_cs_get_axis_count, [:PJ_CONTEXT, :PJ], :int
+    attach_function :proj_cs_get_axis_info, [:PJ_CONTEXT, :PJ, :int, :pointer, :pointer, :pointer, :pointer, :pointer, :pointer, :pointer], :bool
+    attach_function :proj_get_prime_meridian, [:PJ_CONTEXT, :PJ], :PJ
+    attach_function :proj_get_ellipsoid, [:PJ_CONTEXT, :PJ], :PJ
+    attach_function :proj_crs_get_coordoperation, [:PJ_CONTEXT, :PJ], :PJ
+  end
+end

data/lib/api/api_6_1.rb

@@ -0,0 +1,5 @@
+module Proj
+  module Api
+    attach_function :proj_normalize_for_visualization, [:PJ_CONTEXT, :PJ], :PJ
+  end
+end