funktor 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6216b831ca8e28aa8d17cb86295d740bf63e95df6ce36ec966f435b6df7f427c
-  data.tar.gz: 7ade52e2f087fce2b5f61461bcbec625f7a72a82557500e3c2efb98606deadb7
+  metadata.gz: f23eb6f9be928f479660d5320e71f6766105cbf0ab2c143346186b08b5b58bb8
+  data.tar.gz: 456f201c8eea7705017823b27161ab3acc1ad7325575d2125e9793943d8ac8cd
 SHA512:
-  metadata.gz: 6a9b429d66bbf60a0bd64a040616eb7743b861466646550f98151dc99320ed882233e131a82d21badcacfc2f7916b05c5b6c52168bb8899c8c81823289b24ab3
-  data.tar.gz: c594578835a62eda89537a42c55021badcdb1a5e240abb1a493d36dea7e3aed5e4a3cf7126afd2aef75bcae17c7619c0e404268488308c6f5e1974d2e2ffc322
+  metadata.gz: 04aa22cc41754a5ee59c0b095ea18df52313185bc440fc94bacd167fb9bfdaa4291fa3e9fb4f9bcd305212cd230505af905c295c6894239ffea4ca948f65f153
+  data.tar.gz: 9051f19ce855b54cab65d5c224a9044e48227af4c8a22725b9d1ab6ae6f6ee31d1dde84956e3cd3a88b16ab0b46f586cfdc30354ddb928eb2460125d23935038

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    funktor (0.5.0)
+    funktor (0.6.0)
       activesupport
       aws-sdk-dynamodb (~> 1.62)
       aws-sdk-sqs (~> 1.37)
@@ -22,8 +22,8 @@ GEM
     addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
     aws-eventstream (1.1.1)
-    aws-partitions (1.487.0)
-    aws-sdk-core (3.119.0)
+    aws-partitions (1.490.0)
+    aws-sdk-core (3.119.1)
       aws-eventstream (~> 1, >= 1.0.2)
       aws-partitions (~> 1, >= 1.239.0)
       aws-sigv4 (~> 1.1)
@@ -51,6 +51,8 @@ GEM
     jmespath (1.4.0)
     method_source (1.0.0)
     minitest (5.14.4)
+    mustermann (1.1.1)
+      ruby2_keywords (~> 0.0.1)
     pry (0.13.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
@@ -58,6 +60,9 @@ GEM
       byebug (~> 11.0)
       pry (~> 0.13.0)
     public_suffix (4.0.6)
+    rack (2.2.3)
+    rack-protection (2.1.0)
+      rack
     rake (12.3.3)
     rexml (3.2.5)
     rspec (3.10.0)
@@ -73,13 +78,21 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
     rspec-support (3.10.2)
+    ruby2_keywords (0.0.5)
     simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.12.3)
     simplecov_json_formatter (0.1.2)
+    sinatra (2.1.0)
+      mustermann (~> 1.0)
+      rack (~> 2.2)
+      rack-protection (= 2.1.0)
+      tilt (~> 2.0)
     thor (1.1.0)
+    tilt (2.0.10)
+    timecop (0.9.4)
     tzinfo (2.0.4)
       concurrent-ruby (~> 1.0)
     webmock (3.12.2)
@@ -98,6 +111,8 @@ DEPENDENCIES
   rake (~> 12.0)
   rspec (~> 3.0)
   simplecov
+  sinatra
+  timecop
   webmock
 
 BUNDLED WITH

data/funktor-testapp/Gemfile.lock

@@ -1,14 +1,14 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.1.4)
+    activesupport (6.1.4.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
       tzinfo (~> 2.0)
       zeitwerk (~> 2.3)
     aws-eventstream (1.1.1)
-    aws-partitions (1.483.0)
+    aws-partitions (1.488.0)
     aws-sdk-core (3.119.0)
       aws-eventstream (~> 1, >= 1.0.2)
       aws-partitions (~> 1, >= 1.239.0)

data/funktor-testapp/app/services/job_flood.rb

@@ -23,7 +23,7 @@ class JobFlood
         job_target_time = Time.now + (minute * 60) + rand(60)
         job_sleep = rand(0.0..max_job_length_in_seconds.to_f)
         puts job_target_time
-        AuditWorker.perform_at(job_target_time, {
+        [AuditWorker, AuditWorker, SingleThreadAuditWorker].sample.perform_at(job_target_time, {
           mode: 'later',
           message: 'msg: from random JobFlood - ' + SecureRandom.hex,
           target_time: job_target_time,

data/funktor-testapp/app/workers/single_thread_audit_worker.rb

@@ -0,0 +1,3 @@
+class SingleThreadAuditWorker < AuditWorker
+  funktor_options queue: :low_concurrency
+end

data/funktor-testapp/funktor_config/environment.yml

@@ -7,8 +7,8 @@ FUNKTOR_INCOMING_JOB_QUEUE:
   Ref: IncomingJobQueue
 FUNKTOR_DEFAULT_QUEUE:
   Ref: DefaultQueue
-FUNKTOR_SINGLE_THREAD_QUEUE:
-  Ref: SingleThreadQueue
+FUNKTOR_LOW_CONCURRENCY_QUEUE:
+  Ref: LowConcurrencyQueue
 FUNKTOR_ACTIVITY_TABLE:
   Ref: ActivityTable
 FUNKTOR_JOBS_TABLE:

data/funktor-testapp/funktor_config/function_definitions/default_queue_handler.yml

@@ -1,10 +1,12 @@
 handler: lambda_event_handlers/default_queue_handler.call
-timeout: ${self:custom.funktor.DefaultQueueHandler.timeout, 900}
+timeout: ${self:custom.funktor.DefaultQueueHandler.functionTimeout, 900}
 reservedConcurrency: ${self:custom.funktor.DefaultQueueHandler.reservedConcurrency, null}
 provisionedConcurrency: ${self:custom.funktor.DefaultQueueHandler.provisionedConcurrency, null}
 memorySize: ${self:custom.funktor.DefaultQueueHandler.memorySize, 256}
 events:
   - sqs:
+      batchSize: ${self:custom.funktor.DefaultQueueHandler.batchSize, 1}
+      maximumBatchingWindow: ${self:custom.funktor.DefaultQueueHandler.maximumBatchingWindow, 0}
       arn:
         Fn::GetAtt:
           - DefaultQueue

data/funktor-testapp/funktor_config/function_definitions/incoming_job_handler.yml

@@ -1,10 +1,12 @@
 handler: lambda_event_handlers/incoming_job_handler.call
-timeout: ${self:custom.funktor.IncomingJobHandler.timeout, 30}
+timeout: ${self:custom.funktor.IncomingJobHandler.functionTimeout, 30}
 reservedConcurrency: ${self:custom.funktor.IncomingJobHandler.reservedConcurrency, null}
 provisionedConcurrency: ${self:custom.funktor.IncomingJobHandler.provisionedConcurrency, null}
 memorySize: ${self:custom.funktor.IncomingJobHandler.memorySize, 256}
 events:
   - sqs:
+      batchSize: ${self:custom.funktor.IncomingJobHandler.batchSize, 1}
+      maximumBatchingWindow: ${self:custom.funktor.IncomingJobHandler.maximumBatchingWindow, 0}
       arn:
         Fn::GetAtt:
           - IncomingJobQueue

data/funktor-testapp/funktor_config/function_definitions/job_activator.yml

@@ -1,8 +1,7 @@
 handler: lambda_event_handlers/job_activator.call
-timeout: ${self:custom.funktor.JobActivator.timeout, 30}
+timeout: ${self:custom.funktor.JobActivator.functionTimeout, 30}
 reservedConcurrency: ${self:custom.funktor.JobActivator.reservedConcurrency, null}
 provisionedConcurrency: ${self:custom.funktor.JobActivator.provisionedConcurrency, null}
 memorySize: ${self:custom.funktor.JobActivator.memorySize, 256}
-#reservedConcurrency: 1
 events:
   - schedule: rate(1 minute)

data/funktor-testapp/funktor_config/function_definitions/low_concurrency_queue_handler.yml

@@ -0,0 +1,13 @@
+handler: lambda_event_handlers/low_concurrency_queue_handler.call
+timeout: ${self:custom.funktor.LowConcurrencyQueueHandler.functionTimeout, 900}
+reservedConcurrency: ${self:custom.funktor.LowConcurrencyQueueHandler.reservedConcurrency, null}
+provisionedConcurrency: ${self:custom.funktor.LowConcurrencyQueueHandler.provisionedConcurrency, null}
+memorySize: ${self:custom.funktor.LowConcurrencyQueueHandler.memorySize, 256}
+events:
+  - sqs:
+      batchSize: ${self:custom.funktor.LowConcurrencyQueueHandler.batchSize, 1}
+      maximumBatchingWindow: ${self:custom.funktor.LowConcurrencyQueueHandler.maximumBatchingWindow, 0}
+      arn:
+        Fn::GetAtt:
+          - LowConcurrencyQueue
+          - Arn

data/funktor-testapp/funktor_config/funktor.yml

@@ -3,7 +3,7 @@ IncomingJobHandler:
   # to a handler at one time, so you'll want this to be at least 10x the maximum time you
   # expect to spend for one message. The incoming job handler usually will be pretty fast,
   # but we default to a high number here to allow for the times when things go weird.
-  timeout: 300
+  functionTimeout: 300
   # reservedConcurrency represents the maximum number of concurrent executions.
   # For the incoming job handler you probably don't want to limit it because you
   # want to get things onto work queues as quickly as possible.
@@ -16,17 +16,17 @@ IncomingJobHandler:
   # For the incoming jobs handler you probably don't need this to be too large,
   # but if you're seeing large delays at this stage it might help to bump it up.
   memorySize: 256
-  batchSize: 10
-  maximumBatchingWindow: 1
-  visibilityTimeout: 900
-  logRetentionInDays: 30
+  batchSize: 1
+  maximumBatchingWindow: 0
+  visibilityTimeout: 1800
+  maxReceiveCount: 20
 
 JobActivator:
   # timeout is how long the handler can possibly run. Up to 10 messages may be delivered
   # to a handler at one time, so you'll want this to be at least 10x the maximum time you
   # expect to spend for one message. The job activator usually will be pretty fast,
   # but we default to a high number here to allow for the times when things go weird.
-  timeout: 300
+  functionTimeout: 300
   # reservedConcurrency represents the maximum number of concurrent executions.
   # For the job activator you probably don't want to limit it because you
   # want to get things onto work queues as quickly as possible when they're ready.
@@ -39,10 +39,10 @@ JobActivator:
   # For the job activator you probably don't need this to be too large,
   # but if you're seeing large delays at this stage it might help to bump it up.
   memorySize: 256
-  batchSize: 10
-  maximumBatchingWindow: 1
-  visibilityTimeout: 900
-  logRetentionInDays: 30
+  batchSize: 1
+  maximumBatchingWindow: 0
+  visibilityTimeout: 1800
+  maxReceiveCount: 20
 
 
 
@@ -51,7 +51,7 @@ DefaultQueueHandler:
   # to a handler at one time, so you'll want this to be at least 10x the maximum time you
   # expect to spend for one message. The active job handler may be slow if your jobs are
   # doing a lot of work, so we default to the maximum here.
-  timeout: 300
+  functionTimeout: 300
   # reservedConcurrency represents the maximum number of concurrent executions.
   # For the active job handler you may want to limit it if you have resource limitations
   # like database connections that you need to avoid exhausting.
@@ -65,21 +65,21 @@ DefaultQueueHandler:
   # required to actually do your jobs. You can choose an even higher number to increase
   # the available CPU to make the jobs run faster.
   memorySize: 256
-  batchSize: 10
-  maximumBatchingWindow: 1
-  visibilityTimeout: 900
-  logRetentionInDays: 30
+  batchSize: 1
+  maximumBatchingWindow: 0
+  visibilityTimeout: 1800
+  maxReceiveCount: 20
 
-SingleThreadQueueHandler:
+LowConcurrencyQueueHandler:
   # timeout is how long the handler can possibly run. Up to 10 messages may be delivered
   # to a handler at one time, so you'll want this to be at least 10x the maximum time you
   # expect to spend for one message. The active job handler may be slow if your jobs are
   # doing a lot of work, so we default to the maximum here.
-  timeout: 300
+  functionTimeout: 300
   # reservedConcurrency represents the maximum number of concurrent executions.
   # For the active job handler you may want to limit it if you have resource limitations
   # like database connections that you need to avoid exhausting.
-  reservedConcurrency: 1
+  reservedConcurrency: 10
   # provisionedConcurrency represents the number of lambda functions that will always
   # be available. For the active job handler you probably don't need to set this
   # unless your jobs are very bursty AND very time sensitive.
@@ -89,10 +89,10 @@ SingleThreadQueueHandler:
   # required to actually do your jobs. You can choose an even higher number to increase
   # the available CPU to make the jobs run faster.
   memorySize: 256
-  batchSize: 10
-  maximumBatchingWindow: 1
-  visibilityTimeout: 900
-  logRetentionInDays: 30
+  batchSize: 1
+  maximumBatchingWindow: 0
+  visibilityTimeout: 1800
+  maxReceiveCount: 20
 
 
 
@@ -106,9 +106,9 @@ DashboardName: ${self:service}-${self:custom.stage}-dashboard
 DefaultQueueName: ${self:service}-${self:custom.stage}-default
 DefaultDeadJobQueueName: ${self:service}-${self:custom.stage}-default-dead
 DefaultQueueHandlerName: ${self:service}-${self:custom.stage}-DefaultQueueHandler
-SingleThreadQueueName: ${self:service}-${self:custom.stage}-single-thread
-SingleThreadDeadJobQueueName: ${self:service}-${self:custom.stage}-single-thread-dead
-SingleThreadQueueHandlerName: ${self:service}-${self:custom.stage}-SingleThreadQueueHandler
+LowConcurrencyQueueName: ${self:service}-${self:custom.stage}-low-concurrency
+LowConcurrencyDeadJobQueueName: ${self:service}-${self:custom.stage}-low-concurrency-dead
+LowConcurrencyQueueHandlerName: ${self:service}-${self:custom.stage}-LowConcurrencyQueueHandler
 JobsTableName: ${self:service}-${self:custom.stage}-jobs
 ActivityTableName: ${self:service}-${self:custom.stage}-activity
 JobActivatorName: ${self:service}-${self:custom.stage}-JobActivator

data/funktor-testapp/funktor_config/iam_permissions/{single_thread_queue.yml → low_concurrency_queue.yml}

@@ -5,4 +5,4 @@ Action:
   - sqs:SendMessage
   - sqs:GetQueueAttributes
 Resource:
-  - "Fn::GetAtt": [ SingleThreadQueue, Arn ]
+  - "Fn::GetAtt": [ LowConcurrencyQueue, Arn ]

data/funktor-testapp/funktor_config/resources/cloudwatch_dashboard.yml

@@ -34,6 +34,8 @@ Resources:
                             [ "funktor-testapp", "Duration", "WorkerClassName", "GreetingsWorker" ],
                             [ "...", { "stat": "p99" } ],
                             [ "funktor-testapp", "Duration", "WorkerClassName", "HelloWorker" ],
+                            [ "...", { "stat": "p99" } ],
+                            [ "funktor-testapp", "Duration", "WorkerClassName", "SingleThreadAuditWorker" ],
                             [ "...", { "stat": "p99" } ]
                         ],
                         "view": "timeSeries",
@@ -58,6 +60,8 @@ Resources:
                             [ "funktor-testapp", "processed", "WorkerClassName", "GreetingsWorker" ],
                             [ ".", "failed", ".", "." ],
                             [ "funktor-testapp", "processed", "WorkerClassName", "HelloWorker" ],
+                            [ ".", "failed", ".", "." ],
+                            [ "funktor-testapp", "processed", "WorkerClassName", "SingleThreadAuditWorker" ],
                             [ ".", "failed", ".", "." ]
                         ],
                         "view": "timeSeries",
@@ -79,7 +83,7 @@ Resources:
                         "metrics": [
                             [ "funktor-testapp", "Duration", "Queue", "default" ],
                             [ "...", { "stat": "p99" } ],
-                            [ "funktor-testapp", "Duration", "Queue", "singleThread" ],
+                            [ "funktor-testapp", "Duration", "Queue", "low_concurrency" ],
                             [ "...", { "stat": "p99" } ]
                         ],
                         "view": "timeSeries",
@@ -100,7 +104,7 @@ Resources:
                         "metrics": [
                             [ "funktor-testapp", "processed", "Queue", "default" ],
                             [ ".", "failed", ".", "." ],
-                            [ "funktor-testapp", "processed", "Queue", "singleThread" ],
+                            [ "funktor-testapp", "processed", "Queue", "low_concurrency" ],
                             [ ".", "failed", ".", "." ]
                         ],
                         "view": "timeSeries",
@@ -426,7 +430,7 @@ Resources:
                     "x": 0,
                     "type": "text",
                     "properties": {
-                        "markdown": "\n# SingleThread Queue\n"
+                        "markdown": "\n# LowConcurrency Queue\n"
                     }
                 },
                 { 
@@ -438,7 +442,7 @@ Resources:
                     "properties": {
                         "metrics": [
                             [ "AWS/SQS", "NumberOfMessagesReceived", "QueueName",
-                              "${self:custom.funktor.SingleThreadQueueName}", { "label": "Messages Per Minute" } ]
+                              "${self:custom.funktor.LowConcurrencyQueueName}", { "label": "Messages Per Minute" } ]
                         ],
                         "view": "singleValue",
                         "region": "us-east-1",
@@ -456,8 +460,8 @@ Resources:
                     "properties": {
                         "metrics": [
                             [ "AWS/Lambda", "Duration", "FunctionName",
-                              "${self:custom.funktor.SingleThreadQueueHandlerName}", "Resource",
-                              "${self:custom.funktor.SingleThreadQueueHandlerName}", { "label": "p10" } ],
+                              "${self:custom.funktor.LowConcurrencyQueueHandlerName}", "Resource",
+                              "${self:custom.funktor.LowConcurrencyQueueHandlerName}", { "label": "p10" } ],
                             [ "...", { "label": "p50", "stat": "p50" } ],
                             [ "...", { "label": "p99", "stat": "p99" } ],
                             [ "...", { "label": "Average", "stat": "Average" } ]
@@ -478,14 +482,14 @@ Resources:
                     "properties": {
                         "metrics": [
                             [ "AWS/SQS", "NumberOfMessagesReceived", "QueueName",
-                              "${self:custom.funktor.SingleThreadQueueName}",
+                              "${self:custom.funktor.LowConcurrencyQueueName}",
                               { "label": "Received" } ],
                             [ ".", "NumberOfMessagesDeleted", ".", ".", { "label": "Handled" } ],
                             [ "AWS/Lambda", "Invocations", "FunctionName",
-                              "${self:custom.funktor.SingleThreadQueueHandlerName}", "Resource",
-                              "${self:custom.funktor.SingleThreadQueueHandlerName}", { "label": "Handler Invocations" } ],
+                              "${self:custom.funktor.LowConcurrencyQueueHandlerName}", "Resource",
+                              "${self:custom.funktor.LowConcurrencyQueueHandlerName}", { "label": "Handler Invocations" } ],
                             [ "AWS/SQS", "ApproximateNumberOfMessagesVisible", "QueueName",
-                              "${self:custom.funktor.SingleThreadQueueName}", { "label": "Pending?" } ],
+                              "${self:custom.funktor.LowConcurrencyQueueName}", { "label": "Pending?" } ],
                             [ ".", "ApproximateNumberOfMessagesNotVisible", ".", ".", { "label": "Backlog?" } ],
                             [ ".", "NumberOfMessagesSent", ".", ".", { "label": "Sent" } ],
                             [ ".", "ApproximateNumberOfMessagesDelayed", ".", ".", { "label": "Delayed" } ]
@@ -493,7 +497,7 @@ Resources:
                         "view": "timeSeries",
                         "stacked": false,
                         "region": "us-east-1",
-                        "title": "SingleThread Queue (Async jobs go here immediately, scheduled jobs land here in the minute before they're scheduled)",
+                        "title": "LowConcurrency Queue (Async jobs go here immediately, scheduled jobs land here in the minute before they're scheduled)",
                         "period": 60,
                         "stat": "Sum",
                         "liveData": true
@@ -508,12 +512,12 @@ Resources:
                     "properties": {
                         "period": 60,
                         "metrics": [
-                            [ "AWS/Lambda", "Duration", "FunctionName", "${self:custom.funktor.SingleThreadQueueHandlerName}", { "stat": "Minimum" } ],
+                            [ "AWS/Lambda", "Duration", "FunctionName", "${self:custom.funktor.LowConcurrencyQueueHandlerName}", { "stat": "Minimum" } ],
                             [ "...", { "stat": "Average" } ],
                             [ "...", { "stat": "Maximum" } ]
                         ],
                         "region": "us-east-1",
-                        "title": "SingleThread Queue Handler Duration in Milliseconds",
+                        "title": "LowConcurrency Queue Handler Duration in Milliseconds",
                         "view": "timeSeries",
                         "stacked": false,
                         "liveData": true
@@ -529,12 +533,12 @@ Resources:
                         "period": 60,
                         "metrics": [
                             [ "AWS/Lambda", "Errors", "FunctionName",
-                              "${self:custom.funktor.SingleThreadQueueHandlerName}", { "id": "errors", "stat": "Sum", "color": "#d13212" } ],
+                              "${self:custom.funktor.LowConcurrencyQueueHandlerName}", { "id": "errors", "stat": "Sum", "color": "#d13212" } ],
                             [ ".", "Invocations", ".", ".", { "id": "invocations", "stat": "Sum", "visible": false } ],
                             [ { "expression": "100 - 100 * errors / MAX([errors, invocations])", "label": "Success rate (%)", "id": "availability", "yAxis": "right", "region": "us-east-1" } ]
                         ],
                         "region": "us-east-1",
-                        "title": "SingleThread Queue Handler Error count and success rate (%)",
+                        "title": "LowConcurrency Queue Handler Error count and success rate (%)",
                         "yAxis": {
                             "right": {
                                 "max": 100
@@ -555,10 +559,10 @@ Resources:
                         "period": 60,
                         "metrics": [
                             [ "AWS/Lambda", "ConcurrentExecutions", "FunctionName",
-                              "${self:custom.funktor.SingleThreadQueueHandlerName}", { "stat": "Maximum" } ]
+                              "${self:custom.funktor.LowConcurrencyQueueHandlerName}", { "stat": "Maximum" } ]
                         ],
                         "region": "us-east-1",
-                        "title": "SingleThread Queue Handler Concurrent executions",
+                        "title": "LowConcurrency Queue Handler Concurrent executions",
                         "view": "timeSeries",
                         "stacked": false,
                         "liveData": true
@@ -765,6 +769,7 @@ Resources:
                             [ "...", "Query" ],
                             [ ".", "ThrottledRequests", ".", ".", ".", "PutItem", { "yAxis": "right", "visible": false } ],
                             [ ".", "SuccessfulRequestLatency", ".", ".", ".", "DeleteItem" ],
+                            [ ".", "SuccessfulRequestLatency", ".", ".", ".", "UpdateItem" ],
                             [ ".", "ThrottledRequests", ".", ".", ".", ".", { "yAxis": "right", "visible": false } ]
                         ],
                         "view": "timeSeries",

data/funktor-testapp/funktor_config/resources/default_queue.yml

@@ -3,11 +3,11 @@ Resources:
     Type: AWS::SQS::Queue
     Properties:
       QueueName: ${self:custom.funktor.DefaultQueueName}
-      VisibilityTimeout: 300
+      VisibilityTimeout: ${self:custom.funktor.DefaultQueueHandler.visibilityTimeout}
       RedrivePolicy:
         deadLetterTargetArn:
           "Fn::GetAtt": [ DefaultDeadLetterQueue, Arn ]
-        maxReceiveCount: 5
+        maxReceiveCount: ${self:custom.funktor.DefaultQueueHandler.maxReceiveCount}
   DefaultDeadLetterQueue:
     Type: AWS::SQS::Queue
     Properties: