restful-trades 0.8.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 62ac6e8e67358970cc32da5c78097870d2b4185d
+  data.tar.gz: 5f0a6f5ba2f8e72c586b30fbaaaf185e0a4bbaea
+SHA512:
+  metadata.gz: da19ba8eb43a4bb3ef39920460e47d1d9284bb58f78b141c21faf029687e5252b2cc1ff1994e9c73cd5aa9accbc9d2d763e035a377542abd4e520eb3e79f5b27
+  data.tar.gz: a11df3126317a46423523fbf067b50a4faeca1e332a962cae863672c57be68b396340e885f48fb24adadbab582a7d7dbbece655b7cdd76606fb6a166f6856cd2

data/bin/razorrisk-microservice-trades

@@ -0,0 +1,392 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+# ######################################################################## #
+# File:         tools/servers/restful/trades/ws.rb
+#
+# Purpose:      Main module/entry file for the Trades Microservice
+#
+# Author:       Matthew Wilson
+#
+# Copyright (c) 2018, Razor Risk Technologies Pty Ltd
+# All rights reserved.
+#
+# ######################################################################## #
+
+
+# ##########################################################################
+
+# Microservices: Trades (trades)
+#
+# Supported:
+#
+#  - [GET] / {Unsecured}
+#  - [DELETE] /delete/:sysId {Secured}
+#  - [GET] /get {Secured}
+#  - [GET] /get/:id {Secured}
+#  - [POST] /post {Secured}
+#  - [PUT] /put/:id {Secured}
+
+# ##########################################################################
+# requires
+
+require 'razor_risk/cassini/diagnostics/zeroth_include'
+
+require 'razor_risk/cassini/applications/microservices/restful/trades'
+
+require 'razor_risk/cassini/applications/route_verb_adaptors/trades'
+
+require 'razor_risk/cassini/main'
+
+require 'razor_risk/cassini/applications/rest_framework/route_verb_dispatcher'
+require 'razor_risk/cassini/applications/secured_microservice'
+require 'razor_risk/cassini/authorisation'
+require 'razor_risk/cassini/common/version'
+require 'razor_risk/cassini/util/version_util'
+
+require 'razor_risk/razor/connectivity/razor_3/header_maker'
+require 'razor_risk/razor/connectivity/razor_3/razor_requester'
+require 'razor_risk/razor/connectivity/version'
+
+require 'razor_risk/core/diagnostics/extensions/libclimate'
+require 'razor_risk/core/diagnostics/logger'
+
+require 'active_support/core_ext/hash'
+require 'pantheios'
+require 'xqsr3/version'
+
+require 'csv'
+require 'json'
+require 'nokogiri'
+
+# ##########################################################################
+# includes
+
+include ::RazorRisk::Cassini::Applications
+include ::RazorRisk::Cassini::Applications::RESTFramework
+include ::RazorRisk::Cassini::Applications::RouteVerbAdaptors
+include ::RazorRisk::Cassini::Authorisation::SecurityModelHelpers
+include ::RazorRisk::Cassini::Constants
+include ::RazorRisk::Cassini::Util::SecretsUtil
+include ::RazorRisk::Cassini::Util::VersionUtil
+
+include ::RazorRisk::Razor::Connectivity::Razor3
+
+include ::RazorRisk::Cassini::Diagnostics
+include ::RazorRisk::Core::Diagnostics::Logger
+
+include ::Pantheios
+
+# ##########################################################################
+# constants
+
+PROGRAM_VERSION     =   ::RazorRisk::Cassini::Applications::Microservices::RESTful::Trades::VERSION
+
+SUPPORTED_ROUTES = [
+
+    [ '/delete/:sysId', :delete, 'deletes the specified trade', ],
+    [ '/get', :get, 'gets the collection of trades', ],
+    [ '/get/:id', :get, 'gets the specified trade', ],
+    [ '/post', :post, 'posts a specified trade', ],
+    [ '/put/:id', :put, 'puts a specified trade', ],
+    [ '/post/getTradeContribution/?', :post, 'puts a specified trade', ],
+]
+
+HTTP_ACCEPTS = %w{ text/html application/json application/xml text/xml text/csv text/plain text/tab-separated-values text/tsv }
+
+# ##########################################################################
+# compatibility checks
+
+check_version_compatibility ::RazorRisk::Cassini::Common, [ 0, 21 ], 'RazorRisk.Cassini.Common'
+check_version_compatibility ::RazorRisk::Razor::Connectivity, [ 0, 11, 2 ], 'RazorRisk.Razor.Connectivity'
+check_version_compatibility ::LibCLImate, '0.10'
+check_version_compatibility ::Pantheios, '0.20'
+check_version_compatibility ::Xqsr3::VERSION, '0.30'
+
+# ##########################################################################
+# functions
+
+def make_CSV_routes routes
+
+    CSV.generate do |csv|
+
+        routes.each do |ar|
+
+            csv << ar
+        end
+    end
+end
+
+def make_HTML_routes routes, **options
+
+    # TODO: use erb
+
+    routes = routes.map do |ar|
+
+        <<END_OF_tr
+   <tr>
+    <td>#{ar[0]}</td>
+    <td>#{ar[1]}</td>
+    <td>#{ar[2]}</td>
+   </tr>
+END_OF_tr
+    end
+
+    <<END_OF_html
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.we.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+  <title>Razor Risk Web Service API - Internal Microservice - trade</title>
+  <meta name="revisit-after" content="24 hours" />
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+ </head>
+ <body>
+  <h1>Routes</h1>
+  <table>
+   <tr>
+    <th>Route</th>
+    <th>Verb</th>
+    <th>Description</th>
+   </tr>
+#{routes.map { |r| r.chomp("\n") }.join("\n")}
+  </table>
+ </body>
+</html>
+END_OF_html
+end
+
+def make_JSON_routes routes, **options
+
+    r = {
+
+        'routes' => []
+    }
+
+    r['routes'] = SUPPORTED_ROUTES.map { |ar| { route: ar[0], verb: ar[1].to_s.upcase, description: ar[2] } }
+
+    r.to_json
+end
+
+def make_Plain_routes routes
+
+    make_TSV_routes routes
+end
+
+def make_TSV_routes routes
+
+    routes.map { |ar| "#{ar[0]}\t#{ar[1]}\t#{ar[2]}\n" }
+end
+
+def make_XML_routes routes
+
+    <<END_OF_xml
+<?xml version="1.0">
+<routes>#{routes.map { |ar| %Q{  <route route="#{ar[0]}" verb="#{ar[1].to_s.upcase}" description="#{ar[2]}"/>}}.join(%Q{\n})}
+</routes>
+END_OF_xml
+end
+
+# ##########################################################################
+# static set-up
+
+# ##########################################################################
+# lambdas
+
+Lambdas_XML_to_JSON = lambda do |xml|
+
+    ConversionUtil.convert_XML_to_JSON xml
+end
+
+# ##########################################################################
+# application
+
+class TradesApp < SecuredMicroservice
+
+    include RouteVerbDispatch
+
+    include ::Pantheios
+
+
+    FULL_DESIGNATION    =   'Trades'
+    SHORT_DESIGNATION   =   'trades'
+    SERVICE_TYPE        =   :microservice
+
+    PROGRAM_FEATURES    =   {
+
+        has_web_server: true,
+
+        has_host_and_port:  true,
+
+        has_razor_connectivity: true,
+
+        authentication: :with_credentials_algorithm,
+
+        copyright_year: 2017,
+    }
+
+
+    def self.on_init_service options
+
+        trace ParamNames[ :options ], options
+
+        raise ArgumentError, 'missing keyword: razor_requester' unless options.has_key? :razor_requester
+
+        set :razor_requester, options[:razor_requester]
+    end
+
+
+
+    private
+    def sec
+
+        return '' if credentials.empty?
+        " (for #{credentials.join(':')})"
+    end
+    public
+
+
+    # functional routes (DELETE, GET, POST, PUT)
+
+    delete '/delete/:sysId/?' do
+
+        # trace
+
+        trace ParamNames[ :request, :params ], request, params
+
+        dispatch Trades::ItemDelete
+    end
+
+    # params:
+    # +result-form+:: Specifies the form of the result: +default+ gets the
+    #  full Razor body, and is the default if none specified; +summary+ gets
+    #  the trade-summary form; +trade+ gets the trade form
+    get '/get/:id/?' do
+
+        # trace
+
+        trace ParamNames[ :request, :params ], request, params
+
+        dispatch Trades::ItemGet
+    end
+
+    # params:
+    # +page-base+:: Specifies the (0-based) index index of the first element
+    #  to be presented. Defaults to 0 if not specified
+    # +page-extent+:: Specifies the number of records to return in the
+    #  retrieval window. Defaults to 1000 if not specified
+    # +quick-search+:: Specifies a quick-search string
+    get '/get/?' do
+
+        trace ParamNames[ :request, :params ], request, params
+
+        dispatch Trades::CollectionGet
+    end
+
+    # params:
+    # +result-form+:: Specifies the form of the result: +id+ gets the
+    #  ID of the trade, and is the default if none specified; +body+ gets
+    #  the XML body response
+    post '/post/?' do
+
+        trace ParamNames[ :request, :params ], request, params
+
+        dispatch Trades::ItemPost
+    end
+
+    post '/post/getTradeContribution/?' do
+        trace ParamNames[ :request, :params ], request, params
+        dispatch Trades::CollectionPost
+    end
+
+    # params:
+    # +result-form+:: Specifies the form of the result: +id+ gets the
+    #  ID of the trade, and is the default if none specified; +body+ gets
+    #  the XML body response
+    put '/put/:id/?' do
+
+        trace ParamNames[ :request, :params ], request, params
+
+        dispatch Trades::ItemPut
+    end
+
+    get '/' do
+
+        HTTP_ACCEPTS.each do |accept_type|
+
+            if request.accept? accept_type
+
+                content_type accept_type
+
+                case accept_type
+                when 'application/json'
+
+                    r = make_JSON_routes SUPPORTED_ROUTES
+                when 'application/xml', 'text/xml'
+
+                    r = make_XML_routes SUPPORTED_ROUTES
+                when 'text/csv'
+
+                    r = make_CSV_routes SUPPORTED_ROUTES
+                when 'text/html'
+
+                    r = make_HTML_routes SUPPORTED_ROUTES
+                when 'text/plain'
+
+                    r = make_Plain_routes SUPPORTED_ROUTES
+                when 'text/tsv', 'text/tab-separated-values'
+
+                    r = make_TSV_routes SUPPORTED_ROUTES
+                else
+
+                    log :violation, 'unrecognised accept type \'', accept_type, '\''
+
+                    halt *[ 500, {}, 'internal server failure' ]
+                end
+
+                return r
+            end
+        end
+
+        halt *[ 406, {}, "supports only the Accept types #{HTTP_ACCEPTS.map { |t| %Q<'#{t}'> }.join(', ')}" ]
+    end
+
+    define_catch_all_handlers
+end
+
+TheApp = TradesApp
+
+# now define the OPTIONS support
+
+supported_routes = Hash.new { |h, k| h[k] = [] }
+
+SUPPORTED_ROUTES.each do |ar|
+
+    supported_routes[ar[0]].push ar[1]
+end
+
+supported_routes.each do |k, v|
+
+    if k =~ /:id(?:\/\?)?$/
+
+        route = "#$`*"
+    else
+
+        route = k
+    end
+
+    TheApp.options route do
+
+        verbs = v.map { |t| t.upcase }.join(',')
+
+        halt *[200, { 'Allow' => verbs }, [ verbs ] ]
+    end
+end
+
+TheApp.options '/' do
+
+    halt *[200, { 'Allow' => 'GET' }, '' ]
+end
+
+# ############################## end of file ############################# #
+
+

data/lib/razor_risk/cassini/applications/microservices/restful/trades/version.rb

@@ -0,0 +1,59 @@
+# encoding: UTF-8
+
+# ######################################################################## #
+# File:         razor_risk/cassini/applications/microservices/restful/trades/version.rb
+#
+# Purpose:      Version for RazorRisk.Cassini.Microservices.RESTful.Trades library
+#
+# Created:      7th January 2019
+# Updated:     16th January 2019
+#
+# Copyright (c) 2019, Razor Risk Technologies Pty Ltd
+# All rights reserved.
+#
+# ######################################################################## #
+
+
+=begin
+=end
+
+module RazorRisk
+module Cassini
+module Applications
+module Microservices
+module RESTful
+
+module Trades
+
+    # Current version of the RazorRisk.Cassini.Microservices.RESTful.Trades library
+    VERSION             =   '0.8.7'
+
+    private
+    VERSION_PARTS_      =   VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
+    public
+    # Major version of the RazorRisk.Cassini.Microservices.RESTful.Trades library
+    VERSION_MAJOR       =   VERSION_PARTS_[0]       # :nodoc:
+    # Minor version of the RazorRisk.Cassini.Microservices.RESTful.Trades library
+    VERSION_MINOR       =   VERSION_PARTS_[1]       # :nodoc:
+    # Patch version of the RazorRisk.Cassini.Microservices.RESTful.Trades library
+    VERSION_PATCH       =   VERSION_PARTS_[2]       # :nodoc:
+    # Commit version of the RazorRisk.Cassini.Microservices.RESTful.Trades library
+    VERSION_COMMIT      =   VERSION_PARTS_[3] || 0  # :nodoc:
+
+
+    # The description of the framework
+    DESCRIPTION         =   "Razor Risk's Cassini Web-framework's Trades RESTful microservice"
+
+    # [DEPRECATED] Instead use +DESCRIPTION+
+    FRAMEWORK_DESCRIPTION = DESCRIPTION
+end # module Trades
+
+end # module RESTful
+end # module Microservices
+end # module Applications
+end # module Cassini
+end # module RazorRisk
+
+# ############################## end of file ############################# #
+
+

data/lib/razor_risk/cassini/applications/microservices/restful/trades.rb

@@ -0,0 +1,2 @@
+
+require 'razor_risk/cassini/applications/microservices/restful/trades/version'