asn_parser 1.0.0 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1628c8dc84e2e0c43952846d265255f6bdc3924013af21bec76e06d00473f320
-  data.tar.gz: 232f7a2687e601af5a9821b698de90f7614fadca89081a71c25a499cfa890d50
+  metadata.gz: b7a82bf179aece367294da268bfdbab781b09009aeaabf98c7acfa81ebeac76e
+  data.tar.gz: 02eb25c3fc4f9e0a3b63ab0b123270e65769667cfab28d94b1cb7e7aa5c0d31a
 SHA512:
-  metadata.gz: 65eee1bb69a5cddcab1c942adc724fd57654b2b3e27d1d266af854d59745733aac038b2d63e2cccb8ed100fc4a8d7bb35f047d52724f2a7261c5b35379394f1e
-  data.tar.gz: 274c715ef5bda76b0a4fc3d04bf1465cc4e0f04977e8b272a16119d1f7cac723096da63ae124aa2c6cc67a16a895ece9dd95fa4458568088e7f20c0b7a5e6b6b
+  metadata.gz: dedeae37baec5a7215a8824535efaf29f415666ad74ed13cae5bea38eea534afebb0420c53d647863aecbd82956f7c2941478be319dded16a99ead400abc2d04
+  data.tar.gz: 5190d869ad803d253c6d2b31075faa31154fb822c3e73be6e28b78dc133b1cff8ab96f69a38959ea402cbf6653120a5e7e7b54a8f269465f406d0467cf25b122

data/Gemfile

@@ -9,4 +9,10 @@ end
 
 group :development, :test do
   gem 'rake'
+  gem 'rspec'
+  gem 'rubocop'
+  gem 'rubocop-rspec'
+  gem 'amazing_print'
+  gem 'simplecov'
+  gem 'rubocop-rake'
 end

data/Rakefile

@@ -2,6 +2,7 @@ require 'bundler'
 
 require 'antlr4-native'
 require 'etc'
+require 'rspec/core/rake_task'
 
 def ruby_installer?
   Object.const_defined?(:RubyInstaller)
@@ -9,22 +10,35 @@ end
 
 Bundler::GemHelper.install_tasks
 
-desc 'Generate the C++ code for the grammer file'
 task :generate do
   generator = Antlr4Native::Generator.new(
-    grammar_files:      ["./ASN.g4"],
+    grammar_files:      ["./ASN1.g4"],
     output_dir:         'ext/',
-    parser_root_method: 'modules'
+    parser_root_method: 'moduleDefinition'
   )
 
   generator.generate
 end
 
-desc 'Compile the native extension'
-task :compile do
-  Dir.chdir(File.join(%w(ext asn_parser))) do
-    load 'extconf.rb'
-    RubyInstaller::Runtime.enable_msys_apps if ruby_installer?
-    exec "make -j #{Etc.nprocessors}"
+
+namespace :cmake do
+  desc "Configure and build the CMake project"
+  task :build do
+    build_dir = "build"
+    mkdir_p build_dir
+
+    cd build_dir do
+      sh "cmake ../ext/asn1_parser"
+      sh "cmake --build ."
+    end
+  end
+
+  desc "Clean CMake build files"
+  task :clean do
+    rm_rf "build"
   end
 end
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: %w[generate cmake:build spec]

data/asn1_parser.gemspec

@@ -0,0 +1,33 @@
+$:.unshift File.join(File.dirname(__FILE__), 'lib')
+require 'asn1_parser/version'
+
+Gem::Specification.new do |s|
+  s.name     = 'asn_parser'
+  s.version  = ::ASN1Parser::VERSION
+  s.authors  = ['Rick Mark']
+  s.email    = ['rickmark@outlook.com']
+  s.homepage = 'https://github.com/rickmark/rasn2_parser'
+
+  s.description = s.summary = 'A Native Gem for Parsing ASN1 Text Files'
+
+  s.platform = Gem::Platform::RUBY
+
+  s.add_dependency 'rice', '~> 4.0'
+
+  s.extensions = ['ext/asn1_parser/CMakeLists.txt']
+
+  s.require_path = 'lib'
+  s.files = Dir[
+    'bin/*',
+    '{lib,spec}/**/*.rb',
+    'ext/asn1_parser/*.{cpp,h}',
+    'ext/asn1_parser/CMakeLists.txt',
+    'ext/asn1_parser/VERSION',
+    'ext/asn1_parser/antlrgen/*',
+    'ext/asn1_parser/antlr4-upstream/runtime/Cpp/**/*',
+    'Gemfile',
+    'README.md',
+    'Rakefile',
+    'asn1_parser.gemspec'
+  ]
+end

data/bin/console

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'pry'
+require_relative '../lib/asn1_parser'
+
+Pry.start

data/ext/asn1_parser/CMakeLists.txt

@@ -0,0 +1,39 @@
+cmake_minimum_required(VERSION 3.5)
+project(asn1_parser CXX)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+include(FetchContent)
+FetchContent_Declare(
+  rice
+  GIT_REPOSITORY https://github.com/ruby-rice/rice.git
+  GIT_TAG 4.8.0
+)
+FetchContent_MakeAvailable(rice)
+
+list(PREPEND CMAKE_MODULE_PATH "${rice_SOURCE_DIR}")
+
+find_package(Ruby REQUIRED)
+
+include(FetchContent)
+
+set(ANTLR_BUILD_CPP_TESTS OFF)
+add_subdirectory(antlr4-upstream/runtime/Cpp)
+
+file(GLOB ANTLRGEN_SOURCES CONFIGURE_DEPENDS "${CMAKE_SOURCE_DIR}/antlrgen/*.cpp")
+
+add_library(${CMAKE_PROJECT_NAME} MODULE asn1_parser.cpp ${ANTLRGEN_SOURCES})
+
+
+get_target_property(RUBY_EXT_SUFFIX Ruby::Ruby INTERFACE_RUBY_EXTENSION_SUFFIX)
+
+set_target_properties(${CMAKE_PROJECT_NAME} PROPERTIES
+  PREFIX ""
+  SUFFIX "${RUBY_EXT_SUFFIX}"
+  OUTPUT_NAME "asn1_parser"
+  LIBRARY_OUTPUT_DIRECTORY "${CMAKE_SOURCE_DIR}/../../lib/asn1_parser"
+)
+
+target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE Rice::Rice Ruby::Module antlr4_static)

data/ext/asn1_parser/VERSION

@@ -0,0 +1 @@
+1.0.1

data/ext/asn1_parser/antlr4-upstream/runtime/Cpp/CMakeLists.txt

@@ -0,0 +1,216 @@
+# -*- mode:cmake -*-
+cmake_minimum_required (VERSION 3.15)
+# 3.14 needed because of FetchContent
+# 3.15 needed to avid spew of warnings related to overriding cl command line flags
+
+set(CMAKE_MACOSX_RPATH OFF)
+
+enable_testing()
+
+# Detect build type, fallback to release and throw a warning if use didn't specify any
+if(NOT CMAKE_BUILD_TYPE)
+  message(WARNING "Build type not set, falling back to Release mode.
+ To specify build type use:
+ -DCMAKE_BUILD_TYPE=<mode> where <mode> is Debug or Release.")
+  set(CMAKE_BUILD_TYPE "Release" CACHE STRING
+       "Choose the type of build, options are: Debug Release."
+       FORCE)
+endif(NOT CMAKE_BUILD_TYPE)
+
+if(NOT WITH_DEMO)
+  message(STATUS "Building without demo. To enable demo build use: -DWITH_DEMO=True")
+  set(WITH_DEMO False CACHE STRING
+    "Chose to build with or without demo executable"
+    FORCE)
+endif(NOT WITH_DEMO)
+
+option(WITH_LIBCXX "Building with clang++ and libc++(in Linux). To enable with: -DWITH_LIBCXX=On" Off)
+option(WITH_STATIC_CRT "(Visual C++) Enable to statically link CRT, which avoids requiring users to install the redistribution package.
+ To disable with: -DWITH_STATIC_CRT=Off" On)
+option(DISABLE_WARNINGS "Suppress compiler warnings for all built ANTLR targets" OFF)
+ 
+cmake_policy(SET CMP0091 NEW) # Enable use of CMAKE_MSVC_RUNTIME_LIBRARY
+if(WITH_STATIC_CRT)
+  set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+else()
+  set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL")
+endif(WITH_STATIC_CRT)
+
+project(LIBANTLR4)
+
+if(APPLE)
+  find_library(COREFOUNDATION_LIBRARY CoreFoundation)
+endif()
+
+file(STRINGS "VERSION" ANTLR_VERSION)
+
+if(WITH_DEMO)
+  # Java is not necessary if building without demos.
+  find_package(Java COMPONENTS Runtime REQUIRED)
+
+  if(NOT ANTLR_JAR_LOCATION)
+    message(FATAL_ERROR "Missing antlr4.jar location. You can specify it's path using: -DANTLR_JAR_LOCATION=<path>")
+  else()
+    get_filename_component(ANTLR_NAME ${ANTLR_JAR_LOCATION} NAME_WE)
+    if(NOT EXISTS "${ANTLR_JAR_LOCATION}")
+      message(FATAL_ERROR "Unable to find ${ANTLR_NAME} in ${ANTLR_JAR_LOCATION}")
+    else()
+      message(STATUS "Found ${ANTLR_NAME}: ${ANTLR_JAR_LOCATION}")
+    endif()
+  endif()
+endif(WITH_DEMO)
+
+if(CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
+  set(MY_CXX_WARNING_FLAGS "  /W4")
+
+  if(DISABLE_WARNINGS)
+    set(MY_CXX_WARNING_FLAGS "  /w")
+  endif()
+else()
+  set(MY_CXX_WARNING_FLAGS "  -Wall -pedantic -W")
+
+  if(DISABLE_WARNINGS)
+    set(MY_CXX_WARNING_FLAGS "  -w")
+  endif()
+endif()
+
+# Define USE_UTF8_INSTEAD_OF_CODECVT macro.
+# set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DUSE_UTF8_INSTEAD_OF_CODECVT")
+
+# Initialize CXXFLAGS.
+if(NOT DEFINED CMAKE_CXX_STANDARD)
+  # only set CMAKE_CXX_STANDARD if not already set
+  # this allows the standard to be set by the caller, for example with -DCMAKE_CXX_STANDARD:STRING=17
+  set(CMAKE_CXX_STANDARD 17)
+endif()
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+set(CMAKE_CXX_FLAGS                  "${CMAKE_CXX_FLAGS} ${MY_CXX_WARNING_FLAGS}")
+
+if(CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
+  set(CMAKE_CXX_FLAGS_DEBUG          "${CMAKE_CXX_FLAGS_DEBUG} /Od /Zi /MP ${MY_CXX_WARNING_FLAGS}")
+  set(CMAKE_CXX_FLAGS_MINSIZEREL     "${CMAKE_CXX_FLAGS_MINSIZEREL} /O1 /Oi /Ob2 /Gy /MP /DNDEBUG ${MY_CXX_WARNING_FLAGS}")
+  set(CMAKE_CXX_FLAGS_RELEASE        "${CMAKE_CXX_FLAGS_RELEASE} /O2 /Oi /Ob2 /Gy /MP /DNDEBUG ${MY_CXX_WARNING_FLGAS}")
+  set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS_RELWITHDEBINFO} /O2 /Oi /Ob2 /Gy /MP /Zi ${MY_CXX_WARNING_FLAGS}")
+else()
+  set(CMAKE_CXX_FLAGS_DEBUG          "${CMAKE_CXX_FLAGS_DEBUG} -O0 -g ${MY_CXX_WARNING_FLAGS}")
+  set(CMAKE_CXX_FLAGS_MINSIZEREL     "${CMAKE_CXX_FLAGS_MINSIZEREL} -Os -DNDEBUG ${MY_CXX_WARNING_FLAGS}")
+  set(CMAKE_CXX_FLAGS_RELEASE        "${CMAKE_CXX_FLAGS_RELEASE} -O3 -DNDEBUG ${MY_CXX_WARNING_FLGAS}")
+  set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS_RELWITHDEBINFO} -O2 -g ${MY_CXX_WARNING_FLAGS}")
+endif()
+
+# Compiler-specific C++17 activation.
+if(CMAKE_CXX_COMPILER_ID MATCHES "GNU" OR CMAKE_CXX_COMPILER_ID MATCHES "Intel")
+    execute_process(
+        COMMAND ${CMAKE_CXX_COMPILER} -dumpversion OUTPUT_VARIABLE GCC_VERSION)
+    # Just g++-5.0 and greater contain <codecvt> header. (test in ubuntu)
+    if(NOT (GCC_VERSION VERSION_GREATER 5.0 OR GCC_VERSION VERSION_EQUAL 5.0))
+        message(FATAL_ERROR "${PROJECT_NAME} requires g++ 5.0 or greater.")
+    endif ()
+elseif (CMAKE_CXX_COMPILER_ID MATCHES "Clang" AND ANDROID)
+	# Need -Os cflag and cxxflags here to work with exception handling on armeabi.
+	# see  https://github.com/android-ndk/ndk/issues/573
+	# and without -stdlib=libc++ cxxflags
+elseif (CMAKE_CXX_COMPILER_ID MATCHES "Clang" AND APPLE)
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++17 -stdlib=libc++")
+elseif (CMAKE_CXX_COMPILER_ID MATCHES "Clang" AND ( CMAKE_SYSTEM_NAME MATCHES "Linux" OR CMAKE_SYSTEM_NAME MATCHES "FreeBSD") )
+    execute_process(
+        COMMAND ${CMAKE_CXX_COMPILER} -dumpversion OUTPUT_VARIABLE CLANG_VERSION)
+    if(NOT (CLANG_VERSION VERSION_GREATER 4.2.1 OR CLANG_VERSION VERSION_EQUAL 4.2.1))
+        message(FATAL_ERROR "${PROJECT_NAME} requires clang 4.2.1 or greater.")
+    endif()
+    # You can use libc++ to compile this project when g++ is NOT greater than or equal to 5.0.
+    if(WITH_LIBCXX)
+        set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -stdlib=libc++")
+    endif()
+elseif(MSVC_VERSION GREATER 1800 OR MSVC_VERSION EQUAL 1800)
+  # Visual Studio 2012+ supports C++17 features
+elseif(CMAKE_SYSTEM_NAME MATCHES "Emscripten")
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++17 -stdlib=libc++")
+else()
+    message(FATAL_ERROR "Your C++ compiler does not support C++17.")
+endif()
+
+
+add_subdirectory(runtime)
+if(WITH_DEMO)
+ add_subdirectory(demo)
+endif(WITH_DEMO)
+
+# Generate CMake Package Files only if install is active
+if (ANTLR4_INSTALL)
+
+  include(GNUInstallDirs)
+  include(CMakePackageConfigHelpers)
+
+  if(NOT ANTLR4_CMAKE_DIR)
+    set(ANTLR4_CMAKE_DIR ${CMAKE_INSTALL_LIBDIR}/cmake CACHE STRING
+      "Installation directory for cmake files." FORCE )
+  endif(NOT ANTLR4_CMAKE_DIR)
+
+  set(version_runtime_config ${PROJECT_BINARY_DIR}/antlr4-runtime-config-version.cmake)
+  set(version_generator_config ${PROJECT_BINARY_DIR}/antlr4-generator-config-version.cmake)
+  set(project_runtime_config ${PROJECT_BINARY_DIR}/antlr4-runtime-config.cmake)
+  set(project_generator_config ${PROJECT_BINARY_DIR}/antlr4-generator-config.cmake)
+  set(targets_export_name antlr4-targets)
+
+  set(ANTLR4_LIB_DIR ${CMAKE_INSTALL_LIBDIR} CACHE STRING
+      "Installation directory for libraries, relative to ${CMAKE_INSTALL_PREFIX}.")
+
+  set(ANTLR4_INCLUDE_DIR ${CMAKE_INSTALL_INCLUDEDIR}/antlr4-runtime CACHE STRING
+      "Installation directory for include files, relative to ${CMAKE_INSTALL_PREFIX}.")
+
+  configure_package_config_file(
+    cmake/antlr4-runtime.cmake.in
+    ${project_runtime_config}
+    INSTALL_DESTINATION ${ANTLR4_CMAKE_DIR}/antlr4-runtime
+    PATH_VARS
+    ANTLR4_INCLUDE_DIR
+    ANTLR4_LIB_DIR )
+
+  configure_package_config_file(
+    cmake/antlr4-generator.cmake.in
+    ${project_generator_config}
+    INSTALL_DESTINATION ${ANTLR4_CMAKE_DIR}/antlr4-generator
+    PATH_VARS
+    ANTLR4_INCLUDE_DIR
+    ANTLR4_LIB_DIR )
+
+  write_basic_package_version_file(
+    ${version_runtime_config}
+    VERSION ${ANTLR_VERSION}
+    COMPATIBILITY SameMajorVersion )
+
+  write_basic_package_version_file(
+    ${version_generator_config}
+    VERSION ${ANTLR_VERSION}
+    COMPATIBILITY SameMajorVersion )
+
+  install(EXPORT ${targets_export_name}
+          DESTINATION ${ANTLR4_CMAKE_DIR}/antlr4-runtime )
+
+  install(FILES ${project_runtime_config}
+                ${version_runtime_config}
+          DESTINATION ${ANTLR4_CMAKE_DIR}/antlr4-runtime )
+
+  install(FILES ${project_generator_config}
+                ${version_generator_config}
+          DESTINATION ${ANTLR4_CMAKE_DIR}/antlr4-generator )
+
+endif(ANTLR4_INSTALL)
+
+if(EXISTS LICENSE.txt)
+install(FILES LICENSE.txt
+        DESTINATION "share/doc/libantlr4")
+elseif(EXISTS ../../LICENSE.txt)
+install(FILES ../../LICENSE.txt
+    DESTINATION "share/doc/libantlr4")
+endif()
+
+install(FILES README.md VERSION
+    DESTINATION "share/doc/libantlr4")
+
+set(CPACK_PACKAGE_CONTACT "antlr-discussion@googlegroups.com")
+set(CPACK_PACKAGE_VERSION ${ANTLR_VERSION})
+include(CPack)

data/ext/asn1_parser/antlr4-upstream/runtime/Cpp/CMakeSettings.json

@@ -0,0 +1,105 @@
+{
+    // See https://go.microsoft.com//fwlink//?linkid=834763 for more information about this file.
+    "configurations": [
+        {
+            "name": "x86-Debug",
+            "generator": "Ninja",
+            "configurationType": "Debug",
+            "inheritEnvironments": [ "msvc_x86" ],
+            "buildRoot": "${projectDir}\\out\\build\\${name}",
+            "installRoot": "${projectDir}\\out\\install\\${name}",
+            "cmakeCommandArgs": "",
+            "variables": [
+                {
+                    "name": "ANTLR4_INSTALL",
+                    "value": "1"
+                },
+                {
+                    "name": "WITH_STATIC_CRT",
+                    "value": "OFF"
+                },
+                {
+                    "name": "WITH_DEMO",
+                    "value": "OFF"
+                }
+            ],
+            "buildCommandArgs": "-v",
+            "ctestCommandArgs": ""
+        },
+        {
+            "name": "x86-Release",
+            "generator": "Ninja",
+            "configurationType": "RelWithDebInfo",
+            "inheritEnvironments": [ "msvc_x86" ],
+            "buildRoot": "${projectDir}\\out\\build\\${name}",
+            "installRoot": "${projectDir}\\out\\install\\${name}",
+            "cmakeCommandArgs": "",
+            "variables": [
+                {
+                    "name": "ANTLR4_INSTALL",
+                    "value": "1"
+                },
+                {
+                    "name": "WITH_STATIC_CRT",
+                    "value": "OFF"
+                },
+                {
+                    "name": "WITH_DEMO",
+                    "value": "OFF"
+                }
+            ],
+            "buildCommandArgs": "-v",
+            "ctestCommandArgs": ""
+        },
+        {
+            "name": "x64-Debug",
+            "generator": "Ninja",
+            "configurationType": "Debug",
+            "inheritEnvironments": [ "msvc_x64_x64" ],
+            "buildRoot": "${projectDir}\\out\\build\\${name}",
+            "installRoot": "${projectDir}\\out\\install\\${name}",
+            "cmakeCommandArgs": "",
+            "variables": [
+                {
+                    "name": "ANTLR4_INSTALL",
+                    "value": "1"
+                },
+                {
+                    "name": "WITH_STATIC_CRT",
+                    "value": "OFF"
+                },
+                {
+                    "name": "WITH_DEMO",
+                    "value": "OFF"
+                }
+            ],
+            "buildCommandArgs": "-v",
+            "ctestCommandArgs": ""
+        },
+        {
+            "name": "x64-Release",
+            "generator": "Ninja",
+            "configurationType": "RelWithDebInfo",
+            "inheritEnvironments": [ "msvc_x64_x64" ],
+            "buildRoot": "${projectDir}\\out\\build\\${name}",
+            "installRoot": "${projectDir}\\out\\install\\${name}",
+            "cmakeCommandArgs": "",
+            "variables": [
+                {
+                    "name": "ANTLR4_INSTALL",
+                    "value": "1"
+                },
+                {
+                    "name": "WITH_STATIC_CRT",
+                    "value": "OFF"
+                },
+                {
+                    "name": "WITH_DEMO",
+                    "value": "OFF"
+                }
+            ],
+            "buildCommandArgs": "-v",
+            "ctestCommandArgs": ""
+        }
+    ]
+}

data/ext/asn1_parser/antlr4-upstream/runtime/Cpp/README.md

@@ -0,0 +1,72 @@
+# C++ target for ANTLR 4
+
+This folder contains the C++ runtime support for ANTLR.  See [the canonical antlr4 repository](https://github.com/antlr/antlr4) for in depth detail about how to use ANTLR 4.
+
+## Authors and major contributors
+
+ANTLR 4 is the result of substantial effort of the following people:
+
+* [Terence Parr](http://www.cs.usfca.edu/~parrt/), parrt@cs.usfca.edu
+  ANTLR project lead and supreme dictator for life
+  [University of San Francisco](http://www.usfca.edu/)
+* [Sam Harwell](http://tunnelvisionlabs.com/)
+  Tool co-author, Java and C# target)
+
+The C++ target has been the work of the following people:
+
+* Dan McLaughlin, dan.mclaughlin@gmail.com (initial port, got code to compile)
+* David Sisson, dsisson@google.com (initial port, made the runtime C++ tests runnable)
+* [Mike Lischke](http://www.soft-gems.net), mike@lischke-online.de (brought the initial port to a working library, made most runtime tests passing)
+
+## Other contributors
+
+* Marcin Szalowicz, mszalowicz@mailplus.pl (cmake build setup)
+* Tim O'Callaghan, timo@linux.com (additional superbuild cmake pattern script)
+
+## Project Status
+
+* Building on macOS, Windows, Android and Linux
+* No errors and warnings
+* Library linking
+* Some unit tests in the macOS project, for important base classes with almost 100% code coverage.
+* All memory allocations checked
+* Simple command line demo application working on all supported platforms.
+* All runtime tests pass.
+
+### Build + Usage Notes
+
+The minimum C++ version to compile the ANTLR C++ runtime with is C++17. The supplied projects can built the runtime either as static or dynamic library, as both 32bit and 64bit arch. The macOS project contains a target for iOS and can also be built using cmake (instead of XCode).
+
+Include the antlr4-runtime.h umbrella header in your target application to get everything needed to use the library.
+
+If you are compiling with cmake, the minimum version required is cmake 2.8.
+By default, the libraries produced by the CMake build target C++17. If you want to target a different C++ standard, you can explicitly pass the standard - e.g. `-DCMAKE_CXX_STANDARD=17`.
+
+#### Compiling on Windows with Visual Studio using he Visual Studio projects
+Simply open the VS project from the runtime folder (VS 2019+) and build it.
+
+#### Compiling on Windows using cmake with Visual Studio VS2019 and later
+Use the "Open Folder" Feature from the File->Open->Folder menu to open the runtime/Cpp directory.
+It will automatically use the CMake description to open up a Visual Studio Solution.
+
+#### Compiling on macOS
+Either open the included XCode project and build that or use the cmake compilation as described for linux.
+
+#### Compiling on Android
+Try run cmake -DCMAKE_ANDROID_NDK=/folder/of/android_ndkr17_and_above -DCMAKE_SYSTEM_NAME=Android -DCMAKE_ANDROID_API=14 -DCMAKE_ANDROID_ARCH_ABI=x86 -DCMAKE_ANDROID_STL_TYPE=c++_shared -DCMAKE_ANDROID_NDK_TOOLCHAIN_VERSION=clang -DCMAKE_BUILD_TYPE=Release /folder/antlr4_src_dir -G Ninja.
+
+#### Compiling on Linux
+- cd \<antlr4-dir\>/runtime/Cpp (this is where this readme is located)
+- mkdir build && mkdir run && cd build
+- cmake .. -DANTLR_JAR_LOCATION=full/path/to/antlr4-4.5.4-SNAPSHOT.jar -DWITH_DEMO=True
+- make
+- DESTDIR=\<antlr4-dir\>/runtime/Cpp/run make install
+
+If you don't want to build the demo then replace the "cmake .. -DANTLR_JAR_LOCATION<...>" command in the above recipe with "cmake .." without any further parameters.
+There is another cmake script available in the subfolder cmake/ for those who prefer the superbuild cmake pattern.
+
+#### CMake Package support
+If the CMake variable 'ANTLR4_INSTALL' is set, CMake Packages will be build and installed during the install step.
+They expose two packages: antlr4_runtime and antlr4_generator which can be referenced to ease up the use of the
+ANTLR Generator and runtime.
+Use and Sample can be found [here](cmake/Antlr4Package.md)

data/ext/asn1_parser/antlr4-upstream/runtime/Cpp/VERSION

@@ -0,0 +1 @@
+4.13.2