@kensio/yulin 1.4.1 → 1.6.0

package/dist/service/sqs/cfn/queue/sim-cfn-sqs-queue-property-rules.js

@@ -1,75 +1,32 @@
-/**
- * The AWS::SQS::Queue properties carrying a queue attribute of the same name.
- *
- * CloudFormation names these exactly as the SQS API names the attributes, so
- * they are handed to CreateQueue rather than applied here. That leaves the
- * ranges and defaults in one place: the ones simulated SQS already validates.
- */
-const attributePropertyNames = new Set([
-    "DelaySeconds",
-    "MaximumMessageSize",
-    "MessageRetentionPeriod",
-    "ReceiveMessageWaitTimeSeconds",
-    "VisibilityTimeout",
-]);
-/**
- * Real AWS::SQS::Queue properties this simulation does not model.
- *
- * A queue deployed without its redrive policy would look like a queue with a
- * dead-letter queue to the template and have none, so these fail the Resource
- * rather than being dropped on the way through.
- */
-const unsimulatedPropertyNames = new Set([
-    "ContentBasedDeduplication",
-    "DeduplicationScope",
-    "FifoThroughputLimit",
-    "KmsDataKeyReusePeriodSeconds",
-    "KmsMasterKeyId",
-    "RedriveAllowPolicy",
-    "RedrivePolicy",
-    "SqsManagedSseEnabled",
-    "Tags",
-]);
-/**
- * The FifoQueue values that ask for a FIFO queue. CloudFormation carries a
- * boolean property as either, depending on where the value came from.
- */
-const fifoQueueValues = new Set([
-    true,
-    "true",
-]);
-/**
- * The FifoQueue values that ask for a standard queue, which is the only kind
- * this simulation creates.
- */
-const standardQueueValues = new Set([
-    false,
-    "false",
-]);
+import { attributePropertyNames, fifoQueueValues, standardQueueValues, unsimulatedPropertyReasons, } from "./sim-cfn-sqs-queue-property-names.js";
 /**
  * Build the error a property of an AWS::SQS::Queue Resource is refused with.
  *
- * The wording matters. Sim CloudFormation skips a Resource whose error reads as
- * an unsupported Resource type, and skipping is the wrong answer for a queue
- * that cannot be created as the template asks: the stack would deploy without
- * it.
+ * Refusing is the rarer answer now. A property simulated SQS cannot act on is
+ * recorded against the Resource and the queue is created without it, so what
+ * is left here is the template that describes no queue at all: a QueueName
+ * that is not a name, a FifoQueue that is neither true nor false.
  */
 export function sqsQueuePropertyError(logicalId, reason) {
     return new Error(`Invalid AWS::SQS::Queue Resource ${logicalId}: ${reason}`);
 }
 /**
- * Which AWS::SQS::Queue properties simulated SQS can act on.
+ * What simulated SQS does with each AWS::SQS::Queue property it is handed.
  *
- * Anything else fails the Resource. Being stricter than CloudFormation shows up
- * as a puzzling deployment failure here; being looser shows up as a queue
- * behaving one way in a test and another way on AWS.
+ * A property this simulation cannot act on does not stop the queue being
+ * created. It is left out and recorded against the Resource, where a test can
+ * find it, so a stack full of queues still deploys around the settings this
+ * models nothing for. Refusing is kept for the template that describes no
+ * queue at all.
  */
 export class SimCfnSqsQueuePropertyRules {
     logicalId;
     properties;
+    ignorer;
     constructor(properties) {
         this.logicalId = properties.logicalId;
         this.properties = properties.properties;
+        this.ignorer = properties.ignorer;
     }
     /**
      * Whether a property carries a queue attribute of the same name.
@@ -78,44 +35,53 @@ export class SimCfnSqsQueuePropertyRules {
         return attributePropertyNames.has(name);
     }
     /**
-     * Refuse everything about this Resource that is not simulated.
+     * Record everything about this Resource the queue is created without.
      */
-    assertSimulated() {
-        this.refuseFifoQueue();
+    apply() {
+        this.applyToFifoQueue();
         for (const name of Object.keys(this.properties)) {
-            this.assertSimulatedProperty(name);
+            this.applyToProperty(name);
         }
     }
     /**
      * Refuse a FIFO queue.
      *
-     * Only standard queues are simulated, and a FIFO queue quietly created as a
-     * standard one would take messages in an order the deployment does not
-     * promise, so the Resource fails instead. A value that is neither true nor
-     * false is refused as well, rather than read as false: CloudFormation would
-     * refuse it too, and the queue it asked for is not knowable.
+     * This is one of the few properties still worth refusing over. A FIFO queue
+     * is named `<name>.fifo`, and simulated SQS refuses that name to an SDK
+     * caller as well, so there is no queue to create the Resource without the
+     * property as: the only queue that could exist would answer to a different
+     * name from the one the template gave it, and everything referring to it
+     * would be referring to nothing.
+     *
+     * A value that is neither true nor false is refused as well, rather than
+     * read as false: CloudFormation refuses it too, and the queue it asked for
+     * is not knowable.
      */
-    refuseFifoQueue() {
+    applyToFifoQueue() {
         const fifo = this.properties["FifoQueue"];
         if (fifo === undefined || standardQueueValues.has(fifo)) {
             return;
         }
         if (fifoQueueValues.has(fifo)) {
             throw sqsQueuePropertyError(this.logicalId, "FifoQueue names a FIFO queue, which simulated SQS does not " +
-                "simulate. Only standard queues are simulated, so the queue is not " +
-                "created rather than created as a standard queue");
+                "simulate. Only standard queues are simulated, and a FIFO queue " +
+                "is named <name>.fifo, which simulated SQS refuses, so there is no " +
+                "queue to create under the name the template gave it");
         }
         throw sqsQueuePropertyError(this.logicalId, "FifoQueue must be true or false");
     }
-    assertSimulatedProperty(name) {
-        if (unsimulatedPropertyNames.has(name)) {
-            throw sqsQueuePropertyError(this.logicalId, `${name} is a real AWS::SQS::Queue property that simulated SQS does ` +
-                `not simulate, so it is refused rather than ignored`);
+    applyToProperty(name) {
+        const unsimulatedReason = unsimulatedPropertyReasons.get(name);
+        if (unsimulatedReason !== undefined) {
+            this.ignorer.ignoreProperty(name, `${name} is a real AWS::SQS::Queue property simulated SQS does not ` +
+                `act on: ${unsimulatedReason}`);
+            return;
         }
         if (name !== "QueueName" &&
             name !== "FifoQueue" &&
             !this.isAttributeProperty(name)) {
-            throw sqsQueuePropertyError(this.logicalId, `${name} is not an AWS::SQS::Queue property`);
+            this.ignorer.ignoreProperty(name, `${name} is not a property simulated SQS knows about, so the queue ` +
+                `is created without it`);
         }
     }
 }

package/dist/service/sqs/cfn/queue/sim-cfn-sqs-queue-property-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-cfn-sqs-queue-property-rules.js","sourceRoot":"","sources":["../../../../../src/service/sqs/cfn/queue/sim-cfn-sqs-queue-property-rules.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IAC1D,cAAc;IACd,oBAAoB;IACpB,wBAAwB;IACxB,+BAA+B;IAC/B,mBAAmB;CACpB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC;IAC5D,2BAA2B;IAC3B,oBAAoB;IACpB,qBAAqB;IACrB,8BAA8B;IAC9B,gBAAgB;IAChB,oBAAoB;IACpB,eAAe;IACf,sBAAsB;IACtB,MAAM;CACP,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,eAAe,GAAqC,IAAI,GAAG,CAAC;IAChE,IAAI;IACJ,MAAM;CACP,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,mBAAmB,GAAqC,IAAI,GAAG,CAAC;IACpE,KAAK;IACL,OAAO;CACR,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,MAAc;IAEd,OAAO,IAAI,KAAK,CAAC,oCAAoC,SAAS,KAAK,MAAM,EAAE,CAAC,CAAC;AAC/E,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,OAAO,2BAA2B;IACrB,SAAS,CAAS;IAClB,UAAU,CAA4B;IAEvD,YAAY,UAAiD;QAC3D,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAY;QAC9B,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACK,eAAe;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAE1C,IAAI,IAAI,KAAK,SAAS,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,OAAO;QACT,CAAC;QAED,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,qBAAqB,CACzB,IAAI,CAAC,SAAS,EACd,6DAA6D;gBAC3D,oEAAoE;gBACpE,iDAAiD,CACpD,CAAC;QACJ,CAAC;QAED,MAAM,qBAAqB,CACzB,IAAI,CAAC,SAAS,EACd,iCAAiC,CAClC,CAAC;IACJ,CAAC;IAEO,uBAAuB,CAAC,IAAY;QAC1C,IAAI,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,qBAAqB,CACzB,IAAI,CAAC,SAAS,EACd,GAAG,IAAI,8DAA8D;gBACnE,oDAAoD,CACvD,CAAC;QACJ,CAAC;QAED,IACE,IAAI,KAAK,WAAW;YACpB,IAAI,KAAK,WAAW;YACpB,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAC/B,CAAC;YACD,MAAM,qBAAqB,CACzB,IAAI,CAAC,SAAS,EACd,GAAG,IAAI,qCAAqC,CAC7C,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"sim-cfn-sqs-queue-property-rules.js","sourceRoot":"","sources":["../../../../../src/service/sqs/cfn/queue/sim-cfn-sqs-queue-property-rules.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,MAAc;IAEd,OAAO,IAAI,KAAK,CAAC,oCAAoC,SAAS,KAAK,MAAM,EAAE,CAAC,CAAC;AAC/E,CAAC;AAQD;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IACrB,SAAS,CAAS;IAClB,UAAU,CAA4B;IACtC,OAAO,CAAwB;IAEhD,YAAY,UAAiD;QAC3D,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAY;QAC9B,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACK,gBAAgB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAE1C,IAAI,IAAI,KAAK,SAAS,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,OAAO;QACT,CAAC;QAED,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,qBAAqB,CACzB,IAAI,CAAC,SAAS,EACd,6DAA6D;gBAC3D,iEAAiE;gBACjE,oEAAoE;gBACpE,qDAAqD,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,qBAAqB,CACzB,IAAI,CAAC,SAAS,EACd,iCAAiC,CAClC,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,IAAY;QAClC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE/D,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,cAAc,CACzB,IAAI,EACJ,GAAG,IAAI,6DAA6D;gBAClE,WAAW,iBAAiB,EAAE,CACjC,CAAC;YAEF,OAAO;QACT,CAAC;QAED,IACE,IAAI,KAAK,WAAW;YACpB,IAAI,KAAK,WAAW;YACpB,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAC/B,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,cAAc,CACzB,IAAI,EACJ,GAAG,IAAI,6DAA6D;gBAClE,uBAAuB,CAC1B,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": {
     "type": "git",