Added Turnout Item Parser

src/parsers/genericParser.ts

@@ -4,7 +4,7 @@ import { eraseParser, storeParser } from './eeproms/index.js'
 import { powerParser } from './powers/index.js'
 import { locoParser, throttleParser } from './throttles/index.js'
 import { decoderAddressParser } from './decoders/index.js'
-import { turnoutDCCParser, turnoutListParser, turnoutParser } from './turnouts/index.js'
+import { turnoutDCCParser, turnoutItemParser, turnoutListParser, turnoutParser } from './turnouts/index.js'
 
 type ParserFunction = (command: string) => ParserResult<any>
 type ParseResult = (command: string) => Promise<ParserResult<any>>
@@ -45,6 +45,7 @@ export const genericParser: GenericParser = () => {
     decoderAddressParser,
     turnoutParser,
     turnoutListParser,
+    turnoutItemParser,
     turnoutDCCParser
   ]
 

src/parsers/turnouts/index.ts

@@ -1,3 +1,4 @@
 export * from './turnoutParser.js'
 export * from './turnoutDCCParser.js'
 export * from './turnoutListParser.js'
+export * from './turnoutItemParser.js'

src/parsers/turnouts/turnoutItemParser.ts

@@ -0,0 +1,47 @@
+import { Command, parseCommand, removeDoubleQuotes } from '../../utils/index.js'
+import {
+  FunctionName,
+  ParserResult,
+  ParserStatus
+} from '../../types/index.js'
+import { ParserAttributeError, ParserKeyError } from '../errors/index.js'
+import { TurnoutState } from '../../commands/index.js'
+
+interface TurnoutItemParams {
+  turnoutId: number
+  thrown: TurnoutState
+  description: string
+}
+
+export type TurnoutItemResult = ParserResult<TurnoutItemParams>
+const turnoutItemParserKey = 'jT'
+
+const parseFromCommand: (params: Command) => TurnoutItemResult = ({ key, attributes }) => {
+  const [turnoutId, state, description] = attributes
+
+  if (key !== turnoutItemParserKey || attributes.length !== 3) {
+    throw new ParserKeyError('turnoutItemParser', key)
+  }
+
+  if (!description.includes('"')) {
+    throw new ParserAttributeError('description', description, 'description must be wrapped in double quotes')
+  }
+
+  const thrown = parseInt(state)
+
+  return {
+    key: turnoutItemParserKey,
+    parser: FunctionName.TURNOUT_ITEM,
+    status: ParserStatus.SUCCESS,
+    params: {
+      turnoutId: parseInt(turnoutId),
+      thrown: thrown === 0 ? TurnoutState.CLOSED : TurnoutState.THROWN,
+      description: removeDoubleQuotes(description)
+    }
+  }
+}
+
+export const turnoutItemParser: (command: string) => TurnoutItemResult = (command) => {
+  const commandParams = parseCommand(command)
+  return parseFromCommand(commandParams)
+}

src/types/index.ts

@@ -24,6 +24,7 @@ export enum FunctionName {
   DECODER_ADDRESS = 'decoderAddress',
   TURNOUT = 'turnoutParser',
   TURNOUT_LIST = 'turnoutListParser',
+  TURNOUT_ITEM = 'turnoutItemParser',
   TURNOUT_DCC = 'turnoutDCCParser'
 }
 

tests/unit/parsers/genericParser.test.ts

@@ -275,6 +275,44 @@ describe('genericParser()', () => {
         status: ParserStatus.SUCCESS
       }
     },
+    {
+      command: '<jT 1 22 333 4444>',
+      expectation: {
+        key: 'jT',
+        parser: FunctionName.TURNOUT_LIST,
+        params: {
+          turnoutIds: [1, 22, 333, 4444]
+        },
+        status: ParserStatus.SUCCESS
+      }
+    },
+    {
+      command: '<jT 70 1 "Turnout 70 Thrown">',
+      expectation: {
+        key: 'jT',
+        parser: FunctionName.TURNOUT_ITEM,
+        status: ParserStatus.SUCCESS,
+        params: {
+          turnoutId: 70,
+          thrown: TurnoutState.THROWN,
+          description: 'Turnout 70 Thrown'
+        }
+      }
+    },
+
+    {
+      command: '<jT 70 1 "10">',
+      expectation: {
+        key: 'jT',
+        parser: FunctionName.TURNOUT_ITEM,
+        status: ParserStatus.SUCCESS,
+        params: {
+          turnoutId: 70,
+          thrown: TurnoutState.THROWN,
+          description: '10'
+        }
+      }
+    },
     {
       command: '<H 1 0>',
       expectation: {

tests/unit/parsers/turnouts/turnoutItemParser.test.ts

@@ -0,0 +1,32 @@
+import {
+  FunctionName, ParserKeyError,
+  ParserStatus,
+  turnoutItemParser, TurnoutItemResult,
+  TurnoutState
+} from '../../../../src'
+
+describe('turnoutItemParser()', function () {
+  it('parses `<jT 1 0 "Description">`', () => {
+    const result = turnoutItemParser('<jT 1 0 "Description">')
+
+    const expected: TurnoutItemResult = {
+      key: 'jT',
+      parser: FunctionName.TURNOUT_ITEM,
+      status: ParserStatus.SUCCESS,
+      params: {
+        turnoutId: 1,
+        thrown: TurnoutState.CLOSED,
+        description: 'Description'
+      }
+    }
+    expect(result).toEqual(expected)
+  })
+
+  describe('with incorrect key', function () {
+    it('throws a ParserKeyError', function () {
+      expect(() => {
+        turnoutItemParser('<incorrect-key>')
+      }).toThrowError(ParserKeyError)
+    })
+  })
+})