*   <li>192.0.2.1
 *   <li>192.0.2.1:80
 *   <li>[2001:db8::1] - {@link #getHost()} omits brackets
 *   <li>[2001:db8::1]:80 - {@link #getHost()} omits brackets
 *   <li>2001:db8::1 - Use {@link #requireBracketsForIPv6()} to prohibit this
 * </ul>
 *
 * <p>Note that this is not an exhaustive list, because these methods are only concerned with
 * brackets, colons, and port numbers. Full validation of the host field (if desired) is the

- name: fastapi-pagination
  html_url: https://github.com/uriyyo/fastapi-pagination
  stars: 1638
  owner_login: uriyyo
  owner_html_url: https://github.com/uriyyo
- name: bracket
  html_url: https://github.com/evroon/bracket
  stars: 1638
  owner_login: evroon
  owner_html_url: https://github.com/evroon
- name: langchain-serve
  html_url: https://github.com/jina-ai/langchain-serve
  stars: 1634

/* Fira Code, including characters used by Rich output, like the "heavy right-pointing angle bracket ornament", not included in Google Fonts */
@import url(https://cdn.jsdelivr.net/npm/firacode@6.2.0/distr/fira_code.css);
/* Noto Color Emoji for emoji support with the same font everywhere */
@import url(https://fonts.googleapis.com/css2?family=Noto+Color+Emoji&display=swap);

/* Override default code font in Material for MkDocs to Fira Code */
:root {

     * Used in conjunction with the access key for cloud storage.
     */
    @Size(max = 1000)
    public String storageSecretKey;

    /**
     * Storage bucket name for cloud storage operations.
     * Specifies which bucket to use for storing files in cloud storage.
     */
    @Size(max = 1000)
    public String storageBucket;

    /**
     * Storage type for cloud storage (s3, gcs, auto).

        }
    }

    /**
     * Formats an IP address string for use in a URL.
     * IPv6 addresses are wrapped in brackets, IPv4 addresses are returned as-is.
     *
     * @param address the IP address string to format
     * @return the formatted address (IPv6 with brackets, IPv4 unchanged)
     */
    public static String formatForUrl(final String address) {
        if (address == null) {
            return null;

  private transient int size;
  private transient int modCount;

  /** Maps a bucket to the "entry" of its first element. */
  private transient int[] hashTableKToV;

  /** Maps a bucket to the "entry" of its first element. */
  private transient int[] hashTableVToK;

  /** Maps an "entry" to the "entry" that follows it in its bucket. */
  private transient int[] nextInBucketKToV;

German translations, separated by a colon (:). Use these translations, do not use your own. If an existing translation does not use these terms, update it to use them. In the below list, a term or a translation may be followed by an explanation in brackets, which explains when to translate the term this way. If a translation is preceded by `NOT`, then that means: do NOT use this translation for this term. English nouns, starting with the word `the`, have the German genus – `der`, `die`, `das` – prepended...

    @Test
    public void testFormatForUrl() {
        // IPv6 addresses - should add brackets
        assertEquals("[::1]", IpAddressUtil.formatForUrl("::1"));
        assertEquals("[2001:db8::1]", IpAddressUtil.formatForUrl("2001:db8::1"));
        assertEquals("[fe80::1]", IpAddressUtil.formatForUrl("fe80::1"));

        // IPv6 addresses already with brackets - should not double-wrap
        assertEquals("[::1]", IpAddressUtil.formatForUrl("[::1]"));

        try {
            final Bucket existingBucket = storage.get(bucket);
            if (existingBucket == null) {
                storage.create(BucketInfo.newBuilder(bucket).build());
                logger.info("Created storage bucket: {}", bucket);
            }
        } catch (final Exception e) {
            logger.warn("Failed to ensure bucket exists: {}", bucket, e);
        }
    }

    @Override

        // Various GCS bucket and path formats
        assertEquals("gcs://bucket/", wizardAction.convertCrawlingPath("gcs://bucket/"));
        assertEquals("gcs://my-bucket/", wizardAction.convertCrawlingPath("gcs://my-bucket/"));
        assertEquals("gcs://bucket.with.dots/path", wizardAction.convertCrawlingPath("gcs://bucket.with.dots/path"));