feat(docs): add terraform-docs tests

Additionally, support installing and running the action
on Windows based systems.

Author: virgofx

__tests__/__mocks__/context.mock.ts

@@ -79,15 +79,33 @@ const defaultPullRequestPayload = {
   },
 };
 
-// Create a mock context factory function
-//export function createContextMock(overrides: Partial<Context> = {}): Context {
-//  return merge(defaultContext, overrides);
-//}
-
 // Create a mock pull request factory function
 export function createPullRequestMock(overrides = {}) {
   return merge(defaultPullRequestPayload, overrides);
 }
 
-// Create the mock handler
-export const contextMock = vi.fn(() => defaultContext);
+// Create a mocked context object with a set method to deep merge additional ovverides.
+export const contextMock: Context & {
+  reset: () => void;
+  set: (overrides?: Partial<Context>) => void;
+} = {
+  ...defaultContext,
+
+  reset: () => {
+    for (const key of Object.keys(defaultContext)) {
+      if (key !== 'reset' && key !== 'set') {
+        contextMock[key] = defaultContext[key];
+      }
+    }
+  },
+
+  // Method to update specific values
+  set: (overrides: Partial<Context> = {}) => {
+    const updated = merge(contextMock, overrides);
+    for (const key of Object.keys(updated)) {
+      if (key !== 'reset' && key !== 'set') {
+        contextMock[key] = updated[key];
+      }
+    }
+  },
+};

__tests__/context.test.ts

@@ -4,11 +4,15 @@ import { clearContextForTesting, context, getContext } from '../src/context';
 import { createPullRequestMock } from './__mocks__/context.mock';
 import { mockCore } from './setup';
 
-// Mock functions
-vi.mock('node:fs', () => ({
-  existsSync: vi.fn(),
-  readFileSync: vi.fn(),
-}));
+// Mock node:fs. (Note: Appears we can't spy on functions via node:fs)
+vi.mock('node:fs', async () => {
+  const original = await vi.importActual('node:fs');
+  return {
+    ...original,
+    existsSync: vi.fn(),
+    readFileSync: vi.fn(),
+  };
+});
 
 describe('context', () => {
   // Mock implementations for fs just in this current test