## Test Coverage

The project includes comprehensive unit tests for all core components:
- `CurlTest`: Tests for static factory methods and basic HTTP operations
- `CurlRequestTest`: Tests for request builder, headers, parameters, body content, SSL, proxies, timeouts
- `CurlResponseTest`: Tests for response handling, status codes, content retrieval, resource management
- `CurlExceptionTest`: Tests for exception handling and error scenarios

# Build distribution packages
mvn rpm:rpm          # .rpm package
mvn jdeb:jdeb        # .deb package
```

### Testing
```bash
# Run unit tests (*Test.java)
mvn test

# Run single unit test
mvn test -Dtest=SearchEngineClientTest

# Run integration tests (*Tests.java in src/test/java/org/codelibs/fess/it/)
# Requires Fess server and OpenSearch running

**UrlConvertHelper**: URL normalization

---

## Development Workflow

### Build Commands

```bash
mvn clean install              # Build all
mvn clean install -DskipTests  # Skip tests
mvn test                       # Run tests
mvn formatter:format           # Format code
mvn license:format             # Update license headers
```

### Code Style

- 4 spaces (no tabs)
- Opening brace on same line

    $ mvn jdeb:jdeb # .deb package

### Generate Source Code

    $ mvn dbflute:download # (one time command)
    $ mvn dbflute:freegen
    $ mvn license:format

### Integration Tests

Integration tests require a running Fess server with OpenSearch. Follow these steps:

#### 1. Build Fess

    $ mvn antrun:run  # Download OpenSearch plugins (if not done)
    $ mvn package     # Build the package

mvn test                                 # Run all tests
mvn test -Dtest=SuggesterTest           # Run specific test
mvn package                              # Package JAR
mvn formatter:format license:format     # Format code and apply licenses
mvn clean jacoco:prepare-agent test jacoco:report  # Generate coverage report
```

### Adding New Features

1. Read related source files and tests
2. Write implementation following existing patterns

        List<TermQuery> queryList = SuggestUtil.getTermQueryList(null, fields);
        assertNotNull(queryList);
        assertEquals(0, queryList.size());
    }

    // Additional tests for createSuggestTextId boundary cases
    @Test
    public void testCreateSuggestTextIdBoundaryExactly445() {
        // Create text that encodes to exactly 445 characters

import org.opensearch.action.admin.indices.create.CreateIndexResponse;
import org.opensearch.transport.client.Client;

/**
 * Test class for refactoring changes made to Suggester class.
 *
 * Tests cover:
 * - Index alias helper method (getIndicesForAlias)
 * - Edge cases for switchIndex with EXPECTED_INDEX_COUNT
 * - Index lifecycle with refactored methods
 */
public class SuggesterRefactoringTest {

        assertEquals("first", result.get(0));
        assertNull(result.get(1));
        assertEquals("third", result.get(2));
    }

    /**
     * Test helper class for serialization tests
     */
    public static class TestSerializableClass implements Serializable {
        private static final long serialVersionUID = 1L;

        public String name;
        public int value;

     */
    @Override
    public synchronized void mark(final int readlimit) {
        fileInputStream.mark(readlimit);
    }

    /**
     * Tests if this input stream supports the mark and reset methods.
     * This method delegates to {@link FileInputStream#markSupported()}.
     *

import static org.hamcrest.CoreMatchers.is;
import static org.hamcrest.CoreMatchers.not;
import static org.junit.Assert.assertArrayEquals;
import static org.junit.Assert.assertThat;

import org.junit.Test;

/**
 * Tests for {@link CachedCipher}.
 */
public class CachedCipherTest {

    @Test
    public void testEncryptDecryptBytes() {
        final CachedCipher cipher = new CachedCipher();
        cipher.setKey("mySecretKey");