@Test
    @DisplayName("verify getters return stubbed values")
    void testGettersHappyPath() {
        when(mockAllocInfo.getCapacity()).thenReturn(1000L);
        when(mockAllocInfo.getFree()).thenReturn(400L);

        assertEquals(1000L, mockAllocInfo.getCapacity(), "capacity should match stubbed value");
        assertEquals(400L, mockAllocInfo.getFree(), "free space should match stubbed value");

        verify(locator, times(1)).shouldForceSigning();
        verifyNoMoreInteractions(locator);
    }

    // Happy path: overlaps delegates to implementation and returns as stubbed
    @Test
    @DisplayName("overlaps returns true then false as stubbed")
    void overlapsReturnsTrueThenFalse() throws Exception {
        when(locator.overlaps(other)).thenReturn(true, false);

        assertTrue(locator.overlaps(other));

        assertEquals("login failed", ex.getMessage());
        verify(tree).connectLogon(context);
    }

    @Test
    @DisplayName("send without params returns the stubbed response")
    void send_noParams_returnsResponse() throws Exception {
        // Arrange - generic return type respected
        when(tree.send(request)).thenReturn(response);

        // Act

            throw new SmbUnsupportedOperationException();
        });
        assertEquals("Operation is not supported with the negotiated capabilities", ex.getMessage());
    }

    @Test
    @DisplayName("Mockito: stubbed collaborator throws RuntimeException wrapper and interactions are verified")
    void mockInteraction_stubsThrow_andVerifiesInvocation() {

                Arguments.of(-1, -2L, -3L, -4L, -5L) // negative values
        );
    }

    // --- Mockito interaction: verify each getter is invoked and returns stubbed values ---
    @Test
    void mockitoMock_verifiesGetterInteractions() {
        // Arrange: mock and stub each getter with distinct values
        SmbBasicFileInfo mock = Mockito.mock(SmbBasicFileInfo.class);

        verify(session).getSmbTree(eq(share), eq(service));
    }

    // Edge: unknown service returns null per stub
    @Test
    @DisplayName("getSmbTree unknown service returns null as stubbed")
    void getSmbTree_unknownService() {
        when(session.getSmbTree(eq("share"), eq("UNKNOWN"))).thenReturn(null);
        assertNull(session.getSmbTree("share", "UNKNOWN"));

        CredentialsInternal result = renewable.renew();

        // Assert: verify interaction and returned value
        verify(renewable, times(1)).renew();
        assertSame(returned, result, "renew() should return the stubbed value");

        // Negative interaction check: no further interactions with the mock
        verifyNoMoreInteractions(renewable);
    }

    @Test

        .testForwarding(
            interfaceType,
            delegate -> {
              T mock = mock(forwarderClass, CALLS_REAL_METHODS);
              try {
                T stubber = doReturn(delegate).when(mock);
                DELEGATE_METHOD.invoke(stubber);
              } catch (Exception e) {
                throw new RuntimeException(e);
              }
              return mock;
            });
  }

        .testForwarding(
            interfaceType,
            delegate -> {
              T mock = mock(forwarderClass, CALLS_REAL_METHODS);
              try {
                T stubber = doReturn(delegate).when(mock);
                DELEGATE_METHOD.invoke(stubber);
              } catch (Exception e) {
                throw new RuntimeException(e);
              }
              return mock;
            });
  }

      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.inlinehilite
  - pymdownx.magiclink
  - pymdownx.smartsymbols
  - pymdownx.superfences
  - pymdownx.tilde
  - pymdownx.tabbed:
      alternate_style: true
  - tables

plugins:
  - search
  - redirects:
      redirect_maps:
        # Redirect all feature pages to features/*
        'caching.md': 'features/caching.md'