*
 * <p>Usage examples:</p>
 * <pre>
 *     throw new CurlException("Error message");
 *     throw new CurlException("Error message", cause);
 * </pre>
 *
 * @see RuntimeException
 */
public class CurlException extends RuntimeException {

    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new CurlException with the specified detail message and cause.
     *

        CurlException exception = new CurlException(message);
        String toString = exception.toString();

        assertNotNull(toString);
        assertTrue(toString.contains("CurlException"));
        assertTrue(toString.contains(message));
    }

    @Test
    public void testStackTrace() {
        CurlException exception = new CurlException("Test message");

     * @return the content as a string.
     * @throws CurlException if an error occurs while accessing the content.
     */
    public String getContentAsString() {
        if (contentCache == null) {
            if (contentException != null) {
                throw new CurlException("Failed to access the content.", contentException);
            }
            throw new CurlException("Failed to access the content.");
        }
        try {

        try {
            response.getContentAsStream();
            fail("Expected CurlException");
        } catch (CurlException e) {
            assertTrue(e.getMessage().contains("The content does not exist"));
            assertSame(exception, e.getCause());
        } catch (IOException e) {
            fail("Should throw CurlException, not IOException");
        }
    }

    @Test

     *
     * @param encoding the encoding
     * @return this CurlRequest instance
     * @throws CurlException if the method is called after the param method
     */
    public CurlRequest encoding(final String encoding) {
        if (paramList != null) {
            throw new CurlException("This method must be called before param method.");
        }
        this.encoding = encoding;
        return this;

        request.param("key", "value");

        try {
            request.encoding("ISO-8859-1");
            fail("Expected CurlException");
        } catch (CurlException e) {
            assertTrue(e.getMessage().contains("must be called before param method"));
        }
    }

    @Test
    public void testThresholdMethod() {

│   │   ├── Curl.java              # Static entry point with factory methods
│   │   ├── CurlRequest.java       # Fluent request builder
│   │   ├── CurlResponse.java      # Response wrapper (implements Closeable)
│   │   ├── CurlException.java     # Unchecked exception for HTTP errors
│   │   └── io/
│   │       ├── ContentCache.java       # In-memory or file-based caching
│   │       └── ContentOutputStream.java # Threshold-based output stream

            throw new IOException("Simulated connection failure");
        });

        // ## Act & Assert ##
        try {
            req.execute();
            fail("Should throw CurlException");
        } catch (CurlException e) {
            assertTrue(e.getMessage().contains("Failed to"));
            assertNotNull(e.getCause());
        }
    }

    @Test

- `org.codelibs.curl.CurlRequest`: builder for HTTP requests.
- `org.codelibs.curl.CurlResponse`: wrapper for HTTP responses.
- `org.codelibs.curl.CurlException`: unchecked exception for errors.
- `org.codelibs.curl.io.ContentCache` and `ContentOutputStream`: internal utilities for streaming and caching.

Refer to the Javadoc for full API details.

## Building and Testing