### Helpers

**RobotsTxtHelper**: RFC 9309 parsing, user-agent matching, crawl-delay, sitemaps
**SitemapsHelper**: Sitemap XML parsing, index handling
**MimeTypeHelper**: MIME detection via Tika
**EncodingHelper**: Charset detection with BOM
**UrlConvertHelper**: URL normalization

---

## Development Workflow

### Build Commands

```bash
mvn clean install              # Build all

 */
public class SmbShareInfo implements FileEntry {

    /**
     * The network name of the share.
     */
    protected String netName;
    /**
     * The type of the share (e.g., disk, printer, IPC).
     */
    protected int type;
    /**
     * The optional comment or description for the share.
     */
    protected String remark;

    /**
     * Default constructor for SmbShareInfo.
     */

        assertEquals(1L, crawlerContext.decrementAndGetAccessCount());

        // Test large increments
        for (int i = 0; i < 1000; i++) {
            crawlerContext.incrementAndGetAccessCount();
        }
        assertEquals(1001L, crawlerContext.getAccessCount());

        // Test large decrements
        for (int i = 0; i < 500; i++) {
            crawlerContext.decrementAndGetAccessCount();

        return OptionalObject.empty();
    }

    @Override
    public TimeZone getRequestedTimeZone(final RequestManager requestManager) { // not null
        return centralTimeZone; // you can change it if you like
    }

    @Override
    public String toString() {
        final StringBuilder sb = new StringBuilder();
        sb.append(DfTypeUtil.toClassTitle(this));

        content = "...;charset=UTF-8\"...";
        assertEquals("UTF-8", htmlTransformer.parseCharset(content));

        content = "...; charset=UTF-8\"...";
        assertEquals("UTF-8", htmlTransformer.parseCharset(content));

        content = "...;charset = UTF-8\"...";
        assertEquals("UTF-8", htmlTransformer.parseCharset(content));

        content = "...;charset=UTF-8 \"...";

        assertNotNull(verifyCacheEntry);
        assertTrue(verifyCacheEntry.isComplete());
        assertEquals(2, verifyCacheEntry.getChildren().size());

        // Step 8: Test change notifications
        // Simulate file addition
        directoryLeaseManager.handleDirectoryChange(directoryPath, "newfile.txt", DirectoryChangeNotifier.DirectoryChangeType.FILE_ADDED);

        stubValidTree(99L, true, true);
        SmbFileHandleImpl h = new SmbFileHandleImpl(cfg, 1, tree, "//server/share", 0, 0, 0, 0, 0L);
        assertTrue(h.isValid());
    }

    @Test
    @DisplayName("isValid() false when tree id changed or disconnected or closed")
    void isValid_false_inVariousCases() {
        when(cfg.isTraceResourceUsage()).thenReturn(false);

    public int pathConsumed;
    /** Time to live for this referral in seconds */
    public long ttl;
    /** Target server for this referral */
    public String server; // Server
    /** Target share for this referral */
    public String share; // Share
    /** The complete UNC path link */
    public String link;
    /** Path relative to tree from which this referral was thrown */

        @Test
        @DisplayName("Should handle share type")
        void testShareType() throws Exception {
            // Test DISK share type
            setPrivateField(response, "shareType", Smb2TreeConnectResponse.SMB2_SHARE_TYPE_DISK);
            assertEquals(Smb2TreeConnectResponse.SMB2_SHARE_TYPE_DISK, response.getShareType(), "Should handle DISK share type");

            // Test PIPE share type

    static Stream<Arguments> portSpecs() {
        return Stream.of(
                // spec, expectedPort
                Arguments.of("smb://server/share", SmbConstants.DEFAULT_PORT), Arguments.of("smb://server:445/share", 445),
                Arguments.of("smb://server:139/share", 139));
    }

    @ParameterizedTest(name = "parseURL: {0} -> port {1}")
    @MethodSource("portSpecs")