Advance to Apache AGE version 1.5.0 (apache#1482) (apache#1493)

Updated the following files to advance the Apache AGE version to
1.5.0

    modified:   Makefile
    modified:   README.md
    modified:   RELEASE
    modified:   age.control

Corrected whitespace issues in -

    modified:   sql/age_agtype.sql
    modified:   sql/agtype_coercions.sql
    modified:   sql/agtype_comparison.sql
    modified:   sql/agtype_gin.sql
    modified:   sql/agtype_operators.sql
    modified:   sql/agtype_string.sql

Corrected the file cleanup in Makefile.

Author: jrgemignani

Makefile

@@ -17,7 +17,7 @@
 
 MODULE_big = age
 
-age_sql = age--1.4.0.sql
+age_sql = age--1.5.0.sql
 
 OBJS = src/backend/age.o \
        src/backend/catalog/ag_catalog.o \
@@ -75,10 +75,12 @@ OBJS = src/backend/age.o \
 
 EXTENSION = age
 
-#SQLS = $(sort ($(wildcard sql/*.sql)))
+# to allow cleaning of previous (old) age--.sql files
+all_age_sql = $(shell find . -maxdepth 1 -type f -regex './age--[0-9]+\.[0-9]+\.[0-9]+\.sql')
+
 SQLS := $(shell cat sql/sql_files)
-SQLS := $(addprefix sql/,$(SQLS)) 
-SQLS := $(addsuffix .sql,$(SQLS)) 
+SQLS := $(addprefix sql/,$(SQLS))
+SQLS := $(addsuffix .sql,$(SQLS))
 
 DATA_built = $(age_sql)
 
@@ -115,7 +117,7 @@ ag_regress_dir = $(srcdir)/regress
 REGRESS_OPTS = --load-extension=age --inputdir=$(ag_regress_dir) --outputdir=$(ag_regress_dir) --temp-instance=$(ag_regress_dir)/instance --port=61958 --encoding=UTF-8 --temp-config $(ag_regress_dir)/age_regression.conf
 
 ag_regress_out = instance/ log/ results/ regression.*
-EXTRA_CLEAN = $(addprefix $(ag_regress_dir)/, $(ag_regress_out)) src/backend/parser/cypher_gram.c src/include/parser/cypher_gram_def.h src/include/parser/cypher_kwlist_d.h $(age_sql)
+EXTRA_CLEAN = $(addprefix $(ag_regress_dir)/, $(ag_regress_out)) src/backend/parser/cypher_gram.c src/include/parser/cypher_gram_def.h src/include/parser/cypher_kwlist_d.h $(all_age_sql)
 
 GEN_KEYWORDLIST = $(PERL) -I ./tools/ ./tools/gen_keywordlist.pl
 GEN_KEYWORDLIST_DEPS = ./tools/gen_keywordlist.pl tools/PerfectHash.pm

README.md

@@ -30,11 +30,11 @@
   </a>
   &nbsp;
   <a href="https://github.com/apache/age/releases">
-    <img src="https://img.shields.io/badge/Release-v1.4.0-FFA500?labelColor=gray&style=flat&link=https://github.com/apache/age/releases"/>
+    <img src="https://img.shields.io/badge/Release-v1.5.0-FFA500?labelColor=gray&style=flat&link=https://github.com/apache/age/releases"/>
   </a>
   &nbsp;
   <a href="https://www.postgresql.org/docs/16/index.html">
-    <img src="https://img.shields.io/badge/Version-Postgresql 16-00008B?labelColor=gray&style=flat&link=https://www.postgresql.org/docs/16/index.html"/>
+    <img src="https://img.shields.io/badge/Version-Postgresql 17-00008B?labelColor=gray&style=flat&link=https://www.postgresql.org/docs/16/index.html"/>
   </a>
   &nbsp;
   <a href="https://github.com/apache/age/issues">
@@ -53,321 +53,29 @@
     <img src="https://img.shields.io/discord/1022177873127280680.svg?label=discord&style=flat&color=5a66f6"></a>
 </p>
 
-<br>
-
-
-<h2><img height="30" src="/img/AGE.png">&nbsp;&nbsp;What is Apache AGE?</h2>
-
-[Apache AGE](https://age.apache.org/#) is an extension for PostgreSQL that enables users to leverage a graph database on top of the existing relational databases. AGE is an acronym for A Graph Extension and is inspired by Bitnine's AgensGraph, a multi-model database fork of PostgreSQL. The basic principle of the project is to create a single storage that handles both the relational and graph data model so that the users can use the standard ANSI SQL along with openCypher, one of the most popular graph query languages today. 
-</br>
-</br>
-</br>
-
-<p align="center">
-<img src="/img/age-01.png" width="80%" height="80%">
-</p>
-
-</br>
-
-Since AGE is based on the powerful PostgreSQL RDBMS, it is robust and fully featured. AGE is optimized for handling complex connected graph data. It provides plenty of robust database features essential to the database environment, including ACID transactions, multi-version concurrency control (MVCC), stored procedure, triggers, constraints, sophisticated monitoring, and a flexible data model (JSON). Users with a relational database background who require graph data analytics can use this extension with minimal effort because they can use existing data without going through migration. 
-
-There is a strong need for cohesive, easy-to-implement multi-model databases. As an extension of PostgreSQL, AGE supports all the functionalities and features of PostgreSQL while also offering a graph model to boot.
-
-
-<h2><img height="30" src="/img/tick.svg">&nbsp;&nbsp;Overview</h2>
-
-Apache AGE is :
-
-- **Powerful**: adds graph database support to the already popular PostgreSQL database: PostgreSQL is used by organizations including Apple, Spotify, and NASA.
-- **Flexible**: allows you to perform openCypher queries, which makes complex queries much easier to write. It also enables querying multiple graphs at the same time.
-- **Intelligent**: allows you to perform graph queries that are the basis for many next-level web services such as fraud detection, master data management, product recommendations, identity and relationship management, experience personalization, knowledge management, and more.
-
-<h2><img height="30" src="/img/features.svg">&nbsp;&nbsp;Features</h2>
-</br>
-</br>
-
-<p align="center">
-<img src="/img/age-03.png" width="80%" height="80%">
-</p>
-</br>
-
-- **Cypher Query**: supports graph query language
-- **Hybrid Querying**: enables SQL and/or Cypher
-- **Querying**: enables multiple graphs
-- **Hierarchical**: graph label organization
-- **Property Indexes**: on both vertices(nodes) and edges
-- **Full PostgreSQL**: supports PG features
-
-
-
-<h2><img height="30" src="/img/documentation.svg">&nbsp;&nbsp;Documentation</h2>
-
-Refer to our latest [Apache AGE documentation](https://age.apache.org/age-manual/master/index.html) to learn about installation, features, built-in functions, and  Cypher queries.
-
-
-
-<h2><img height="30" src="/img/installation.svg">&nbsp;&nbsp;Pre-Installation</h2>
-
-Install the following essential libraries according to each OS. Building AGE from the source depends on the following Linux libraries (Ubuntu package names shown below):
-
-- **CentOS**
-```bash
-yum install gcc glibc glib-common readline readline-devel zlib zlib-devel flex bison
-```
-- **Fedora**
-```bash
-dnf install gcc glibc bison flex readline readline-devel zlib zlib-devel
-```
-- **Ubuntu**
-```bash
-sudo apt-get install build-essential libreadline-dev zlib1g-dev flex bison
-```
-
-<h2><img height="30" src="/img/installation.svg">&nbsp;&nbsp;Installation</h2>
-
-Apache AGE is intended to be simple to install and run. It can be installed with Docker and other traditional ways. 
-
-<h4><a><img width="20" src="/img/pg.svg"></a>
-&nbsp;Install PostgreSQL
-</h4>
-
-You will need to install an AGE compatible version of Postgres<a>, for now AGE supports Postgres 11, 12, 13, 14, 15 & 16. Supporting the latest versions is on AGE roadmap.
-
-<h4>
-&nbsp;Installation via Package Manager
-</h4>
-
-You can use a <a href="https://www.postgresql.org/download/">package management </a> that your OS provides to download AGE.
-
-<br>
-
-```bash
-sudo apt install postgresql
-
-```
-<h4>
-&nbsp;Installation From Source Code
-</h4>
-
-You can <a href="https://www.postgresql.org/ftp/source/"> download the Postgres </a> source code and install your own instance of Postgres. You can read instructions on how to install from source code for different versions on the <a href="https://www.postgresql.org/docs/16/installation.html">official Postgres Website.</a>
-
-
-
-<h4><img width="20" src="/img/tux.svg"><img width="20" src="/img/apple.svg"> &nbsp;Install AGE on Linux and MacOS
-</h4>
-
-Clone the <a href="https://github.com/apache/age">github repository</a> or download the <a href="https://github.com/apache/age/releases">download an official release.
-</a>
-Run the pg_config utility and check the version of PostgreSQL. Currently, only PostgreSQL versions 11, 12, 13, 14, 15 & 16 are supported. If you have any other version of Postgres, you will need to install PostgreSQL version 11, 12, 13, 14, 15 or 16.
-<br>
-    
-```bash
-pg_config
-```
-Run the following command in the source code directory of Apache AGE to build and install the extension.  
-     
-```bash
-make install
-```
-     
-If the path to your Postgres installation is not in the PATH variable, add the path in the arguments:
-```bash
-make PG_CONFIG=/path/to/postgres/bin/pg_config install
-```
-
-
-<h4></a><img width="30" src="/img/docker.svg"></a>
-&nbsp;Run using Docker
-</h4>
-
-<h5> Get the docker image </h5>
-
-```bash
-docker pull apache/age
-
-```
-<h5> Create AGE docker container </h5>
-
-```bash
-docker run \
-    --name age  \
-    -p 5455:5432 \
-    -e POSTGRES_USER=postgresUser \
-    -e POSTGRES_PASSWORD=postgresPW \
-    -e POSTGRES_DB=postgresDB \
-    -d \
-    apache/age
-```
-
-<h5> Enter PostgreSQL's psql: </h5>
-
-```bash
-docker exec -it age psql -d postgresDB -U postgresUser
-```
-
-
-
-<h2><img height="20" src="/img/contents.svg">&nbsp;&nbsp;Post Installation</h2>
-
-For every connection of AGE you start, you will need to load the AGE extension.
-
-```bash
-CREATE EXTENSION age;
-```
-```bash
-LOAD 'age';
-```
-```bash
-SET search_path = ag_catalog, "$user", public;
-```
-
-
-
-<h2><img height="20" src="/img/contents.svg">&nbsp;&nbsp;Quick Start</h2>
-
-To create a graph, use the create_graph function located in the ag_catalog namespace.
-
-```bash
-SELECT create_graph('graph_name');
-```
-
-To create a single vertex, use the CREATE clause. 
-
-```bash
-SELECT * 
-FROM cypher('graph_name', $$
-    CREATE (n)
-$$) as (v agtype);
-```
-
-
-To create a single vertex with the label, use the CREATE clause. 
-
-```bash
-SELECT * 
-FROM cypher('graph_name', $$
-    CREATE (:label)
-$$) as (v agtype);
-```
-
-To create a single vertex with label and properties, use the CREATE clause.
-
-```bash
-SELECT * 
-FROM cypher('graph_name', $$
-    CREATE (:label {property:value})
-$$) as (v agtype);
-```
-
-To query the graph, you can use the MATCH clause.  
-
-```bash
-SELECT * 
-FROM cypher('graph_name', $$
-    MATCH (v)
-    RETURN v
-$$) as (v agtype);
-```
-
-You can use the following to create an edge, for example, between two nodes. 
-
-```bash
-SELECT * 
-FROM cypher('graph_name', $$
-    MATCH (a:label), (b:label)
-    WHERE a.property = 'Node A' AND b.property = 'Node B'
-    CREATE (a)-[e:RELTYPE]->(b)
-    RETURN e
-$$) as (e agtype);
-```
-
-
-To create an edge and set properties.
-
-```bash
-SELECT * 
-FROM cypher('graph_name', $$
-    MATCH (a:label), (b:label)
-    WHERE a.property = 'Node A' AND b.property = 'Node B'
-    CREATE (a)-[e:RELTYPE {property:a.property + '<->' + b.property}]->(b)
-    RETURN e
-$$) as (e agtype);
-```
-
-Example 
-
-```bash
-SELECT * 
-FROM cypher('graph_name', $$
-    MATCH (a:Person), (b:Person)
-    WHERE a.name = 'Node A' AND b.name = 'Node B'
-    CREATE (a)-[e:RELTYPE {name:a.name + '<->' + b.name}]->(b)
-    RETURN e
-$$) as (e agtype);
-```
-
-
-
-<h2><img height="20" src="/img/gettingstarted.svg">&nbsp;&nbsp;Language Specific Drivers</h2>
-
-Starting with Apache AGE is very simple. You can easily select your platform and incorporate the relevant SDK into your code.
-</br>
-</br>
-
-<p align="center">
-<img src="/img/age-02.png" width="80%" height="80%">
-</p>
-
-
-<h4>Built-in</h4>
-
-- [Go driver](./drivers/golang)
-- [Java driver](./drivers/jdbc)
-- [NodeJs driver](./drivers/nodejs)
-- [Python driver](./drivers/python)
-
-<h4>Community-driven Driver</h4>
-
-- [Apache AGE Rust Driver](https://github.com/Dzordzu/rust-apache-age.git)
-
-
-
-
-<h2><img height="20" src="/img/contributing.svg">&nbsp;&nbsp;Community</h2>
-
-Join the AGE community for help, questions, discussions, and contributions. 
-
-- Check our [website](https://age.apache.org/)
-- Join the Live Chat on [Discord](https://discord.gg/EuK6EEg3k7)
-- Follow us on [Twitter](https://twitter.com/apache_age?s=20&t=7Hu8Txk4vjvuEp-ryakacg)
-- Subscribe to our developer mailing list by sending an email to [email protected]
-- Subscribe to our user mailing list by sending an email to [email protected]
-- Subscribe to our committer mailing list (To become a committer) by sending an email to [email protected]
-
-
-<h2><img height="20" src="/img/visualization.svg">&nbsp;&nbsp;Graph Visualization Tool for AGE</h2>
-
-
-Apache AGE Viewer is a user interface for Apache AGE that provides visualization and exploration of data.
-This web visualization tool allows users to enter complex graph queries and explore the results in graph and table forms.
-Apache AGE Viewer is enhanced to proceed with extensive graph data and discover insights through various graph algorithms.
-Apache AGE Viewer will become a graph data administration and development platform for Apache AGE to support multiple relational databases: <https://github.com/apache/age-viewer>.
-
-**This is a visualization tool.**
-After installing AGE Extension, you may use this tool to get access to the visualization features.
-
-
-![Viewer gdb, and graph](/img/agce.gif)
-
-
-<h2><img height="20" src="/img/videos.png">&nbsp;&nbsp;Video Links</h2>
-
-You can also get help from these videos. 
-
-- Install on [Windows](https://www.youtube.com/watch?v=ddk8VX8Hm-I&list=PLGp3huJbWNDjgwP7s99Q-9_w1vxpjNHXG)
-- Install on [MacOS](https://www.youtube.com/watch?v=0-qMwpDh0CA)
-
-
+## Purpose of this project
+Sometimes I need to work with graph databases on Windows, Neo4j is heavy and I prefer PostgreSQL and PGVector as a whole solution. Then Apache AGE is a good choice.
+
+However, Apache AGE does not provide Windows support, the tutorials are based on WSL. I want to make it simple for Windows users to use the Apache AGE Along with PostgreSQL and PGVector.
+
+This project is a fork of the [Apache AGE](https://github.com/apache/age) project. To provide Windows distribution for the Apache AGE project.
+It will provide a binary package for Windows, along with PostgreSQL 17 and PGVector 0.8.0.
+
+# Steps to compile if you want to do it on your machine:
+1. Install MSYS2-MINGW64, and install the following packages:
+   ```
+   pacman -Syu
+   pacman --needed -S git mingw-w64-x86_64-gcc base-devel bison flex mingw-w64-x86_64-minizip mingw-w64-x86_64-zlib mingw-w64-x86_64-icu
+   pacman -S mingw64/mingw-w64-x86_64-openssl
+   ```
+2. Install PostgreSQL
+   `pacman -S mingw-w64-x86_64-postgresql`
+3. Checkout the source and build:
+  ```
+  git clone --branch "PG17/Windows" https://github.com/ShanGor/age.git
+  cd age
+  make install
+  ```
 
 <h2><img height="20" src="/img/community.svg">&nbsp;&nbsp;Contributing</h2>