api: add hardcoded versioning support

Added the _VERSION variable to the exported table.
Is part of the task [1].

1. github.com/tarantool/roadmap-internal/issues/204

Author: GRISHNOV

.github/workflows/test_on_push.yaml

@@ -5,6 +5,35 @@ on:
   pull_request:
 
 jobs:
+  hardcoded_ver_check:
+    runs-on: ubuntu-20.04
+
+    steps:
+      - name: Clone the module
+        uses: actions/checkout@v2
+
+      - name: Fetch tags
+        # Found that Github checkout Actions pulls all the tags, but
+        # right it deannotates the testing tag, check:
+        #   https://github.com/actions/checkout/issues/290
+        # But we use 'git describe ..' calls w/o '--tags' flag and it
+        # prevents us from getting the needed tag for packages version
+        # setup. To avoid of it, let's fetch it manually, to be sure
+        # that all tags will exists always.
+        run: git fetch --tags -f
+
+      - name: Fetch hardcoded and last repository tag versions
+        run: |
+          echo HARDCODED_VERSION=$(cat crud/version.lua | grep -oP "'\K[^']+" ) >> $GITHUB_ENV
+          echo REPO_LAST_TAG=$(git describe --tags `git rev-list --tags --max-count=1`) >> $GITHUB_ENV
+
+      - name: Hardcoded version relevance check
+        if: env.HARDCODED_VERSION != env.REPO_LAST_TAG
+        run: |
+          echo "Hardcoded version and the last repository tag are not equal"
+          echo "You may have forgotten to update the value in the version.lua file"
+          exit 1
+
   run-tests-ce:
     if: |
       github.event_name == 'push' ||

CHANGELOG.md

@@ -6,6 +6,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+* Add versioning support (PR #342).
 
 ### Fixed
 * Pre-hotreload `cartridge` support (older than 2.4.0) (PR #341).

crud.lua

@@ -23,6 +23,11 @@ local stats = require('crud.stats')
 
 local crud = {}
 
+-- @refer crud.version
+-- @field _VERSION
+--  Contains hardcoded value of the CRUD version.
+crud._VERSION = require('crud.version')
+
 --- CRUD operations.
 -- @section crud
 

crud/version.lua

@@ -0,0 +1,4 @@
+-- Сontains the module version.
+-- Requires manual update in case of release commit.
+
+return '1.0.0'