pg_query 1.3.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3d7de9759711a5e173db293a6120a15ee6ab1f0f4c5804e7f68aaba99ec8ff8
-  data.tar.gz: 974e3fb0b709021a771803e52de2a8ca19309a679d81c1ee2a3deb105f297769
+  metadata.gz: ce01a7fe50bcabcd0416813bf71543f4b8f16a922d17a52bf398d510a0c5aa46
+  data.tar.gz: fea65174ec2fa31bea2254e3206c92f185f6d9ab457eb9d2a09c49727a08a305
 SHA512:
-  metadata.gz: 3c13b36c353e6de6aaaba2b6428be7e21c933bf8ef159212cdd64ee4a765f8a664defe735f2f3e94ef6441f3403d7be6fbf19ca4d6b98e07a6b42a68a635238a
-  data.tar.gz: cc742d80bdf934c89e1faa1dd6e6560764339ecabb6fe2af67fd219b2a71b4fb6756e649ddc237d995413a90c6b036d33fe8492eb91030d8a891f970ca10510a
+  metadata.gz: b7b84af5ffca59fa2beaa5a5a2866f1ed6ca0e7200ac163717c26066265a8adb77a620c7c49347d35e6bbb7dbc49697480f369c12c5b07d2d6986a331118335d
+  data.tar.gz: d762f31c00650b8682e1e346508d3cd83c7933204f67e6278504eddb6c6f99b6e578a856e4f360ec8783e813192fc1085eb7817bbc629dee5f5500f44720553a

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 2.0.0     2021-03-18
+
+* Update to PostgreSQL 13 parser
+* Update to libpg_query v2, and new Protobuf-based format
+  * WARNING: This is a breaking change if you are directly interacting with the
+    parsetree (helpers like `table` and such still work the same way)
+* Use actual Ruby classes for parser result, instead of decoded JSON
+  * This is essentialy to enable easy and fast two-way communication with
+    the C library, and as a bonus makes for a better interaction on the Ruby
+    side, as we are handling actual objects instead of hashes and arrays.
+* Use new deparser maintained directly in libpg_query
+  * This replaces the complete Ruby deparser with a new, more complete deparser
+    that is directly maintained in libpg_query. Further deparser improvements
+    should be directly contributed to [libpg_query](https://github.com/pganalyze/libpg_query)
+* Tables helper: Return more details through "tables_with_details" method
+  * This is renamed from the previously badly named "tables_with_types"
+    method. Note that this change should not affect the output of the
+    primary "tables" helper.
+* Replace on-demand libpg_query source download with bundled source code
+  * Its unnecessary to download the source on-demand, and makes this more
+    complex than it needs to be. Instead, introduce a new "update_source" rake
+    task that can be called to refresh the source for a specified revision.
+* Re-implement smart truncation without requiring a special node type
+  * This ensures the truncate method works with the new deparser, without
+    the C level code needing to know about it. We may add it in the C library
+    in the future for edge cases that can't be covered by this slightly
+    hack-ish approach, but for now this avoids unnecessary C library
+    deparser modifications with non-standard node types.
+* Update Ruby finterprinting to new fingerprint format and XXH3 hash
+  * Note that its recommended to use PgQuery.fingerprint for performance
+    reasons, but when the tree has been modified, it can be convenient to
+    run a Ruby-side fingerprint instead of the C-based one that is faster.
+
+
 ## 1.3.0     2020-12-28
 
 * Incorporate newer libpg_query updates in 10-1.0.3 and 10-1.0.4
@@ -74,33 +108,33 @@
 ## 1.1.0     2018-10-04
 
 * Deparsing improvements by [@herwinw](https://github.com/herwinw)
-  * Add NULLS FIRST/LAST to ORDER BY [#95](https://github.com/lfittl/pg_query/pull/95)
-  * VACUUM [#97](https://github.com/lfittl/pg_query/pull/97)
-  * UPDATE with multiple columns [#99](https://github.com/lfittl/pg_query/pull/99)
-  * DISTINCT ON [#101](https://github.com/lfittl/pg_query/pull/101)
-  * CREATE TABLE AS [#102](https://github.com/lfittl/pg_query/pull/102)
-  * SQL value functions [#103](https://github.com/lfittl/pg_query/pull/103)
-  * LOCK [#105](https://github.com/lfittl/pg_query/pull/105)
-  * EXPLAIN [#107](https://github.com/lfittl/pg_query/pull/107)
-  * COPY [#108](https://github.com/lfittl/pg_query/pull/108)
-  * DO [#109](https://github.com/lfittl/pg_query/pull/109)
-* Ignore pg_query.so in git checkout [#110](https://github.com/lfittl/pg_query/pull/110) [@herwinw](https://github.com/herwinw)
-* Prefer __dir__ over File.dirname(__FILE__) [#110](https://github.com/lfittl/pg_query/pull/104) [@herwinw](https://github.com/herwinw)
+  * Add NULLS FIRST/LAST to ORDER BY [#95](https://github.com/pganalyze/pg_query/pull/95)
+  * VACUUM [#97](https://github.com/pganalyze/pg_query/pull/97)
+  * UPDATE with multiple columns [#99](https://github.com/pganalyze/pg_query/pull/99)
+  * DISTINCT ON [#101](https://github.com/pganalyze/pg_query/pull/101)
+  * CREATE TABLE AS [#102](https://github.com/pganalyze/pg_query/pull/102)
+  * SQL value functions [#103](https://github.com/pganalyze/pg_query/pull/103)
+  * LOCK [#105](https://github.com/pganalyze/pg_query/pull/105)
+  * EXPLAIN [#107](https://github.com/pganalyze/pg_query/pull/107)
+  * COPY [#108](https://github.com/pganalyze/pg_query/pull/108)
+  * DO [#109](https://github.com/pganalyze/pg_query/pull/109)
+* Ignore pg_query.so in git checkout [#110](https://github.com/pganalyze/pg_query/pull/110) [@herwinw](https://github.com/herwinw)
+* Prefer __dir__ over File.dirname(__FILE__) [#110](https://github.com/pganalyze/pg_query/pull/104) [@herwinw](https://github.com/herwinw)
 
 
 ## 1.0.2     2018-04-11
 
 * Deparsing improvements
-  * SELECT DISTINCT clause [#77](https://github.com/lfittl/pg_query/pull/77) [@Papierkorb](https://github.com/Papierkorb)
-  * "CASE expr WHEN ... END" clause [#78](https://github.com/lfittl/pg_query/pull/78) [@Papierkorb](https://github.com/Papierkorb)
-  * LEFT/RIGHT/FULL/NATURAL JOIN [#79](https://github.com/lfittl/pg_query/pull/79) [@Papierkorb](https://github.com/Papierkorb)
-  * SELECT that includes schema name [#80](https://github.com/lfittl/pg_query/pull/80) [@jcsjcs](https://github.com/jcsjcs)
+  * SELECT DISTINCT clause [#77](https://github.com/pganalyze/pg_query/pull/77) [@Papierkorb](https://github.com/Papierkorb)
+  * "CASE expr WHEN ... END" clause [#78](https://github.com/pganalyze/pg_query/pull/78) [@Papierkorb](https://github.com/Papierkorb)
+  * LEFT/RIGHT/FULL/NATURAL JOIN [#79](https://github.com/pganalyze/pg_query/pull/79) [@Papierkorb](https://github.com/Papierkorb)
+  * SELECT that includes schema name [#80](https://github.com/pganalyze/pg_query/pull/80) [@jcsjcs](https://github.com/jcsjcs)
 
 
 ## 1.0.1     2018-02-02
 
-* Parse CTEs and nested selects in INSERT/UPDATE [#76](https://github.com/lfittl/pg_query/pull/76) [@jcoleman](https://github.com/jcoleman)
-* Drop explicit json dependency [#74](https://github.com/lfittl/pg_query/pull/74) [@yuki24](https://github.com/yuki24)
+* Parse CTEs and nested selects in INSERT/UPDATE [#76](https://github.com/pganalyze/pg_query/pull/76) [@jcoleman](https://github.com/jcoleman)
+* Drop explicit json dependency [#74](https://github.com/pganalyze/pg_query/pull/74) [@yuki24](https://github.com/yuki24)
 
 
 ## 1.0.0     2017-10-31
@@ -121,18 +155,18 @@
 ## 0.13.4    2017-10-20
 
 * Update to libpg_query 9.5-1.7.0
-  - Fixes compilation old gcc before 4.6.0 [#73](https://github.com/lfittl/pg_query/issues/73)
+  - Fixes compilation old gcc before 4.6.0 [#73](https://github.com/pganalyze/pg_query/issues/73)
 
 
 ## 0.13.3    2017-09-04
 
-* Fix table detection for SELECTs that have sub-SELECTs without FROM clause [#69](https://github.com/lfittl/pg_query/issues/69)
+* Fix table detection for SELECTs that have sub-SELECTs without FROM clause [#69](https://github.com/pganalyze/pg_query/issues/69)
 
 
 ## 0.13.2    2017-08-10
 
-* Support table detection in sub-SELECTs in JOINs [#68](https://github.com/lfittl/pg_query/pull/65) [@seanmdick](https://github.com/seanmdick)
-* Legacy ".parsetree" helper: Fix "Between" and "In" operator does not have "AEXPR" [#66](https://github.com/lfittl/pg_query/issues/66)
+* Support table detection in sub-SELECTs in JOINs [#68](https://github.com/pganalyze/pg_query/pull/65) [@seanmdick](https://github.com/seanmdick)
+* Legacy ".parsetree" helper: Fix "Between" and "In" operator does not have "AEXPR" [#66](https://github.com/pganalyze/pg_query/issues/66)
   * For new applications please use ".tree" method which uses the native structure
     returned from libpg_query which resembles Postgres node names more closely
 
@@ -145,7 +179,7 @@
 
 ## 0.13.0    2017-07-30
 
-* Introduce split between SELECT/DML/DDL for tables method [#65](https://github.com/lfittl/pg_query/pull/65) [@chrisfrommann](https://github.com/chrisfrommann)
+* Introduce split between SELECT/DML/DDL for tables method [#65](https://github.com/pganalyze/pg_query/pull/65) [@chrisfrommann](https://github.com/chrisfrommann)
   * Backwards compatible, use the new select_tables/dml_tables/ddl_tables to
     access the categorized table references
 * Update libpg_query to 9.5-1.6.2
@@ -173,14 +207,14 @@
 
 ## 0.11.5    2017-07-09
 
-* Deparse coldeflist [#64](https://github.com/lfittl/pg_query/pull/64) [@jcsjcs](https://github.com/jcsjcs)
-* Use Integer class for checking integer instead of Fixnum [#62](https://github.com/lfittl/pg_query/pull/62) [@makimoto](https://github.com/makimoto)
+* Deparse coldeflist [#64](https://github.com/pganalyze/pg_query/pull/64) [@jcsjcs](https://github.com/jcsjcs)
+* Use Integer class for checking integer instead of Fixnum [#62](https://github.com/pganalyze/pg_query/pull/62) [@makimoto](https://github.com/makimoto)
 
 
 ## 0.11.4    2017-01-18
 
-* Compatibility with Ruby 2.4 [#59](https://github.com/lfittl/pg_query/pull/59) [@merqlove](https://github.com/merqlove)
-* Deparse varchar and numeric casts without arguments [#61](https://github.com/lfittl/pg_query/pull/61) [@jcsjcs](https://github.com/jcsjcs)
+* Compatibility with Ruby 2.4 [#59](https://github.com/pganalyze/pg_query/pull/59) [@merqlove](https://github.com/merqlove)
+* Deparse varchar and numeric casts without arguments [#61](https://github.com/pganalyze/pg_query/pull/61) [@jcsjcs](https://github.com/jcsjcs)
 
 
 ## 0.11.3    2016-12-06
@@ -189,11 +223,11 @@
   * Cut off fingerprints at 100 nodes deep to avoid excessive runtimes/memory
   * Fix warning on Linux due to missing asprintf include
 * Improved deparsing [@jcsjcs](https://github.com/jcsjcs)
-  * Float [#54](https://github.com/lfittl/pg_query/pull/54)
-  * BETWEEN [#55](https://github.com/lfittl/pg_query/pull/55)
-  * NULLIF [#56](https://github.com/lfittl/pg_query/pull/56)
-  * SELECT NULL and BooleanTest [#57](https://github.com/lfittl/pg_query/pull/57)
-* Fix build on BSD systems [#58](https://github.com/lfittl/pg_query/pull/58) [@myfreeweb](https://github.com/myfreeweb)
+  * Float [#54](https://github.com/pganalyze/pg_query/pull/54)
+  * BETWEEN [#55](https://github.com/pganalyze/pg_query/pull/55)
+  * NULLIF [#56](https://github.com/pganalyze/pg_query/pull/56)
+  * SELECT NULL and BooleanTest [#57](https://github.com/pganalyze/pg_query/pull/57)
+* Fix build on BSD systems [#58](https://github.com/pganalyze/pg_query/pull/58) [@myfreeweb](https://github.com/myfreeweb)
 
 
 ## 0.11.2    2016-06-27
@@ -212,9 +246,9 @@
 ## 0.11.0    2016-06-22
 
 * Improved table name analysis (#tables method)
-  * Don't include CTE names, make them accessible as #cte_names instead [#52](https://github.com/lfittl/pg_query/issues/52)
-  * Include table names in target list sub selects [#38](https://github.com/lfittl/pg_query/issues/38)
-  * Add support for ORDER/GROUP BY, HAVING, and booleans in WHERE [#53](https://github.com/lfittl/pg_query/pull/53) [@jcoleman](https://github.com/jcoleman)
+  * Don't include CTE names, make them accessible as #cte_names instead [#52](https://github.com/pganalyze/pg_query/issues/52)
+  * Include table names in target list sub selects [#38](https://github.com/pganalyze/pg_query/issues/38)
+  * Add support for ORDER/GROUP BY, HAVING, and booleans in WHERE [#53](https://github.com/pganalyze/pg_query/pull/53) [@jcoleman](https://github.com/jcoleman)
   * Fix parsing of DROP TYPE statements
 
 
@@ -223,19 +257,19 @@
 * Based on PostgreSQL 9.5.3
 * Use LLVM extracted parser for significantly improved build times (via libpg_query)
 * Deparsing Improvements
-  * SET statements [#48](https://github.com/lfittl/pg_query/pull/48) [@Winslett](https://github.com/Winslett)
-  * LIKE/NOT LIKE [#49](https://github.com/lfittl/pg_query/pull/49) [@Winslett](https://github.com/Winslett)
-  * CREATE FUNCTION improvements [#50](https://github.com/lfittl/pg_query/pull/50) [@Winslett](https://github.com/Winslett)
+  * SET statements [#48](https://github.com/pganalyze/pg_query/pull/48) [@Winslett](https://github.com/Winslett)
+  * LIKE/NOT LIKE [#49](https://github.com/pganalyze/pg_query/pull/49) [@Winslett](https://github.com/Winslett)
+  * CREATE FUNCTION improvements [#50](https://github.com/pganalyze/pg_query/pull/50) [@Winslett](https://github.com/Winslett)
 
 
 ## 0.9.2    2016-05-03
 
-* Fix issue with A_CONST string values in `.parsetree` compatibility layer (Fixes [#47](https://github.com/lfittl/pg_query/issues/47))
+* Fix issue with A_CONST string values in `.parsetree` compatibility layer (Fixes [#47](https://github.com/pganalyze/pg_query/issues/47))
 
 
 ## 0.9.1    2016-04-20
 
-* Add support for Ruby 1.9 (Fixes [#44](https://github.com/lfittl/pg_query/issues/44))
+* Add support for Ruby 1.9 (Fixes [#44](https://github.com/pganalyze/pg_query/issues/44))
 
 
 ## 0.9.0    2016-04-17
@@ -261,14 +295,14 @@
 ## 0.7.2    2015-12-20
 
 * Deparsing
-  * Quote all column refs [#40](https://github.com/lfittl/pg_query/pull/40) [@avinoamr](https://github.com/avinoamr)
-  * Quote all range vars [#43](https://github.com/lfittl/pg_query/pull/43) [@avinoamr](https://github.com/avinoamr)
-  * Support for COUNT(DISTINCT ...) [#42](https://github.com/lfittl/pg_query/pull/42) [@avinoamr](https://github.com/avinoamr)
+  * Quote all column refs [#40](https://github.com/pganalyze/pg_query/pull/40) [@avinoamr](https://github.com/avinoamr)
+  * Quote all range vars [#43](https://github.com/pganalyze/pg_query/pull/43) [@avinoamr](https://github.com/avinoamr)
+  * Support for COUNT(DISTINCT ...) [#42](https://github.com/pganalyze/pg_query/pull/42) [@avinoamr](https://github.com/avinoamr)
 
 
 ## 0.7.1    2015-11-17
 
-* Abstracted parser access into libpg_query [#24](https://github.com/lfittl/pg_query/pull/35)
+* Abstracted parser access into libpg_query [#24](https://github.com/pganalyze/pg_query/pull/35)
 * libpg_query
   * Use UTF-8 encoding for parsing [#4](https://github.com/lfittl/libpg_query/pull/4) [@zhm](https://github.com/zhm)
   * Add type to A_CONST nodes[#5](https://github.com/lfittl/libpg_query/pull/5) [@zhm](https://github.com/zhm)
@@ -276,20 +310,20 @@
 
 ## 0.7.0    2015-10-17
 
-* Restructure build process to use upstream tarballs [#35](https://github.com/lfittl/pg_query/pull/35)
-  * Avoid bison/flex dependency to make deployment easier [#31](https://github.com/lfittl/pg_query/issues/31)
-* Solve issues with deployments to Heroku [#32](https://github.com/lfittl/pg_query/issues/32)
+* Restructure build process to use upstream tarballs [#35](https://github.com/pganalyze/pg_query/pull/35)
+  * Avoid bison/flex dependency to make deployment easier [#31](https://github.com/pganalyze/pg_query/issues/31)
+* Solve issues with deployments to Heroku [#32](https://github.com/pganalyze/pg_query/issues/32)
 * Deparsing
-  * HAVING and FOR UPDATE [#36](https://github.com/lfittl/pg_query/pull/36) [@JackDanger](https://github.com/JackDanger)
+  * HAVING and FOR UPDATE [#36](https://github.com/pganalyze/pg_query/pull/36) [@JackDanger](https://github.com/JackDanger)
 
 
 ## 0.6.4    2015-10-01
 
 * Deparsing
-  * Constraints & Interval Types [#28](https://github.com/lfittl/pg_query/pull/28) [@JackDanger](https://github.com/JackDanger)
-  * Cross joins [#29](https://github.com/lfittl/pg_query/pull/29) [@mme](https://github.com/mme)
-  * ALTER TABLE [#30](https://github.com/lfittl/pg_query/pull/30) [@JackDanger](https://github.com/JackDanger)
-  * LIMIT and OFFSET [#33](https://github.com/lfittl/pg_query/pull/33) [@jcsjcs](https://github.com/jcsjcs)
+  * Constraints & Interval Types [#28](https://github.com/pganalyze/pg_query/pull/28) [@JackDanger](https://github.com/JackDanger)
+  * Cross joins [#29](https://github.com/pganalyze/pg_query/pull/29) [@mme](https://github.com/mme)
+  * ALTER TABLE [#30](https://github.com/pganalyze/pg_query/pull/30) [@JackDanger](https://github.com/JackDanger)
+  * LIMIT and OFFSET [#33](https://github.com/pganalyze/pg_query/pull/33) [@jcsjcs](https://github.com/jcsjcs)
 
 
 ## 0.6.3    2015-08-20

data/README.md

@@ -1,10 +1,10 @@
-# pg_query [ ![](https://img.shields.io/gem/v/pg_query.svg)](https://rubygems.org/gems/pg_query) [ ![](https://img.shields.io/gem/dt/pg_query.svg)](https://rubygems.org/gems/pg_query) [ ![](https://travis-ci.org/lfittl/pg_query.svg?branch=master)](https://travis-ci.org/lfittl/pg_query)
+# pg_query [ ![](https://img.shields.io/gem/v/pg_query.svg)](https://rubygems.org/gems/pg_query) [ ![](https://img.shields.io/gem/dt/pg_query.svg)](https://rubygems.org/gems/pg_query)
 
 This Ruby extension uses the actual PostgreSQL server source to parse SQL queries and return the internal PostgreSQL parsetree.
 
 In addition the extension allows you to normalize queries (replacing constant values with ?) and parse these normalized queries into a parsetree again.
 
-When you build this extension, it builds parts of the PostgreSQL server source (see [libpg_query](https://github.com/lfittl/libpg_query)), and then statically links it into this extension.
+When you build this extension, it builds parts of the PostgreSQL server source (see [libpg_query](https://github.com/pganalyze/libpg_query)), and then statically links it into this extension.
 
 This is slightly crazy, but is the only reliable way of parsing all valid PostgreSQL queries.
 
@@ -25,17 +25,49 @@ Due to compiling parts of PostgreSQL, installation might take a while on slower
 ```ruby
 PgQuery.parse("SELECT 1")
 
-=> #<PgQuery:0x007fe92b27ea18
- @tree=
-  [{"SelectStmt"=>
-     {"targetList"=>
-       [{"ResTarget"=>
-          {"val"=>{"A_Const"=>{"val"=>{"Integer"=>{"ival"=>1}}, "location"=>7}},
-           "location"=>7}}],
-      "op"=>0,
-  }}],
- @query="SELECT 1",
- @warnings=[]>
+=> #<PgQuery::ParserResult:0x00007fb69a958820
+  @query="SELECT 1",
+  @tree=<PgQuery::ParseResult:
+    version: 130002,
+    stmts: [
+      <PgQuery::RawStmt:
+        stmt: <PgQuery::Node:
+          select_stmt: <PgQuery::SelectStmt:
+            distinct_clause: [],
+            target_list: [
+              <PgQuery::Node:
+                res_target: <PgQuery::ResTarget:
+                  name: "",
+                  indirection: [],
+                  val: <PgQuery::Node:
+                    a_const: <PgQuery::A_Const:
+                      val: <PgQuery::Node:
+                        integer: <PgQuery::Integer: ival: 1>
+                      >,
+                      location: 7
+                    >
+                  >,
+                  location: 7
+                >
+              >
+            ],
+            from_clause: [],
+            group_clause: [],
+            window_clause: [],
+            values_lists: [],
+            sort_clause: [],
+            limit_option: :LIMIT_OPTION_DEFAULT,
+            locking_clause: [],
+            op: :SETOP_NONE,
+            all: false
+          >
+        >,
+        stmt_location: 0,
+        stmt_len: 0
+      >
+    ]
+  >,
+  @warnings=[]>
 ```
 
 ### Modifying a parsed query and turning it into SQL again
@@ -43,35 +75,14 @@ PgQuery.parse("SELECT 1")
 ```ruby
 parsed_query = PgQuery.parse("SELECT * FROM users")
 
-=> #<PgQuery:0x007ff3e956c8b0
- @tree=
-  [{"SelectStmt"=>
-    {"targetList"=>
-      [{"ResTarget"=>
-        {"val"=>
-          {"ColumnRef"=> {"fields"=>[{"A_Star"=>{}}], "location"=>7}},
-         "location"=>7}
-      }],
-     "fromClause"=>
-      [{"RangeVar"=>
-        {"relname"=>"users",
-         "inhOpt"=>2,
-         "relpersistence"=>"p",
-         "location"=>14}}],
-   }}],
- @query="SELECT * FROM users",
- @warnings=[]>
-
 # Modify the parse tree in some way
-parsed_query.tree[0]['SelectStmt']['fromClause'][0]['RangeVar']['relname'] = 'other_users'
+parsed_query.tree.stmts[0].stmt.select_stmt.from_clause[0].range_var.relname = 'other_users'
 
 # Turn it into SQL again
 parsed_query.deparse
-=> "SELECT * FROM \"other_users\""
+=> "SELECT * FROM other_users"
 ```
 
-Note: The deparsing feature is experimental and does not support outputting all SQL yet.
-
 ### Parsing a normalized query
 
 ```ruby
@@ -83,29 +94,10 @@ PgQuery.normalize("SELECT 1 FROM x WHERE y = 'foo'")
 # Parsing a normalized query (pre-Postgres 10 style)
 PgQuery.parse("SELECT ? FROM x WHERE y = ?")
 
-=> #<PgQuery:0x007fb99455a438
- @tree=
-  [{"SelectStmt"=>
-     {"targetList"=>
-       [{"ResTarget"=>
-          {"val"=>{"ParamRef"=>{"location"=>7}},
-           "location"=>7}}],
-      "fromClause"=>
-       [{"RangeVar"=>
-          {"relname"=>"x",
-           "inhOpt"=>2,
-           "relpersistence"=>"p",
-           "location"=>14}}],
-      "whereClause"=>
-       {"A_Expr"=>
-         {"kind"=>0,
-          "name"=>[{"String"=>{"str"=>"="}}],
-          "lexpr"=>{"ColumnRef"=>{"fields"=>[{"String"=>{"str"=>"y"}}], "location"=>22}},
-          "rexpr"=>{"ParamRef"=>{"location"=>26}},
-          "location"=>24}},
-  }}],
- @query="SELECT ? FROM x WHERE y = ?",
- @warnings=[]>
+=> #<PgQuery::ParserResult:0x00007fb69a97a5d8
+  @query="SELECT ? FROM x WHERE y = ?",
+  @tree=<PgQuery::ParseResult: ...>,
+  @warnings=[]>
 ```
 
 ### Extracting tables from a query
@@ -129,21 +121,21 @@ PgQuery.parse("SELECT ? FROM x WHERE x.y = ? AND z = ?").filter_columns
 ```ruby
 PgQuery.parse("SELECT 1").fingerprint
 
-=> "8e1acac181c6d28f4a923392cf1c4eda49ee4cd2"
+=> "50fde20626009aba"
 
 PgQuery.parse("SELECT 2; --- comment").fingerprint
 
-=> "8e1acac181c6d28f4a923392cf1c4eda49ee4cd2"
+=> "50fde20626009aba"
 
-# Faster fingerprint method that is implemented inside the native library
+# Faster fingerprint method that is implemented inside the native C library
 PgQuery.fingerprint("SELECT ?")
 
-=> "8e1acac181c6d28f4a923392cf1c4eda49ee4cd2"
+=> "50fde20626009aba"
 ```
 
 ## Differences from Upstream PostgreSQL
 
-This gem is based on [libpg_query](https://github.com/lfittl/libpg_query),
+This gem is based on [libpg_query](https://github.com/pganalyze/libpg_query),
 which uses the latest stable PostgreSQL version, but with a patch applied
 to support parsing normalized queries containing `?` replacement characters.
 
@@ -161,9 +153,24 @@ Not supported:
 * JRuby: `pg_query` relies on a C extension, which is discouraged / not properly supported for JRuby
 * TruffleRuby: GraalVM [does not support sigjmp](https://www.graalvm.org/reference-manual/llvm/NativeExecution/), which is used by the Postgres error handling code (`pg_query` uses a copy of the Postgres parser & error handling code)
 
+## Developer tasks
+
+### Update libpg_query source
+
+In order to update to a newer Postgres parser, first update [libpg_query](https://github.com/pganalyze/libpg_query) to the new Postgres version and tag a release.
+
+Once that is done, follow the following steps:
+
+1. Update `LIB_PG_QUERY_TAG` and `LIB_PG_QUERY_SHA256SUM` in `Rakefile`
+
+2. Run `rake update_source` to update the source code
+
+3. Commit the `Rakefile` and the modified files in `ext/pg_query` to this source tree and make a PR
+
+
 ## Resources
 
-See [libpg_query](https://github.com/lfittl/libpg_query/blob/10-latest/README.md#resources) for pg_query in other languages, as well as products/tools built on pg_query.
+See [libpg_query](https://github.com/pganalyze/libpg_query/blob/13-latest/README.md#resources) for pg_query in other languages, as well as products/tools built on pg_query.
 
 ## Original Author