/* * Copyright (C) 2012 The Guava Authors * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except * in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package com.google.common.io; import static com.google.common.base.Charsets.UTF_8; import static com.google.common.io.BaseEncoding.base16; import static com.google.common.io.BaseEncoding.base32; import static com.google.common.io.BaseEncoding.base32Hex; import static com.google.common.io.BaseEncoding.base64; import static com.google.common.truth.Truth.assertThat; import com.google.common.annotations.GwtCompatible; import com.google.common.annotations.GwtIncompatible; import com.google.common.base.Ascii; import com.google.common.base.Joiner; import com.google.common.base.Splitter; import com.google.common.collect.ImmutableList; import com.google.common.io.BaseEncoding.DecodingException; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; import java.io.StringReader; import java.io.StringWriter; import junit.framework.TestCase; import org.checkerframework.checker.nullness.qual.Nullable; /** * Tests for {@code BaseEncoding}. * * @author Louis Wasserman */ @GwtCompatible(emulated = true) public class BaseEncodingTest extends TestCase { public void testSeparatorsExplicitly() { testEncodes(base64().withSeparator("\n", 3), "foobar", "Zm9\nvYm\nFy"); testEncodes(base64().withSeparator("$", 4), "foobar", "Zm9v$YmFy"); testEncodes(base32().withSeparator("*", 4), "foobar", "MZXW*6YTB*OI==*===="); } public void testSeparatorSameAsPadChar() { try { base64().withSeparator("=", 3); fail("Expected IllegalArgumentException"); } catch (IllegalArgumentException expected) { } try { base64().withPadChar('#').withSeparator("!#!", 3); fail("Expected IllegalArgumentException"); } catch (IllegalArgumentException expected) { } } public void testAtMostOneSeparator() { BaseEncoding separated = base64().withSeparator("\n", 3); try { separated.withSeparator("$", 4); fail("Expected UnsupportedOperationException"); } catch (UnsupportedOperationException expected) { } } public void testBase64() { // The following test vectors are specified in RFC 4648 itself testEncodingWithSeparators(base64(), "", ""); testEncodingWithSeparators(base64(), "f", "Zg=="); testEncodingWithSeparators(base64(), "fo", "Zm8="); testEncodingWithSeparators(base64(), "foo", "Zm9v"); testEncodingWithSeparators(base64(), "foob", "Zm9vYg=="); testEncodingWithSeparators(base64(), "fooba", "Zm9vYmE="); testEncodingWithSeparators(base64(), "foobar", "Zm9vYmFy"); } @GwtIncompatible // Reader/Writer public void testBase64Streaming() throws IOException { // The following test vectors are specified in RFC 4648 itself testStreamingEncodingWithSeparators(base64(), "", ""); testStreamingEncodingWithSeparators(base64(), "f", "Zg=="); testStreamingEncodingWithSeparators(base64(), "fo", "Zm8="); testStreamingEncodingWithSeparators(base64(), "foo", "Zm9v"); testStreamingEncodingWithSeparators(base64(), "foob", "Zm9vYg=="); testStreamingEncodingWithSeparators(base64(), "fooba", "Zm9vYmE="); testStreamingEncodingWithSeparators(base64(), "foobar", "Zm9vYmFy"); } public void testBase64LenientPadding() { testDecodes(base64(), "Zg", "f"); testDecodes(base64(), "Zg=", "f"); testDecodes(base64(), "Zg==", "f"); // proper padding length testDecodes(base64(), "Zg===", "f"); testDecodes(base64(), "Zg====", "f"); } public void testBase64InvalidDecodings() { // These contain bytes not in the decodabet. assertFailsToDecode(base64(), "A\u007f", "Unrecognized character: 0x7f"); assertFailsToDecode(base64(), "Wf2!", "Unrecognized character: !"); // This sentence just isn't base64() encoded. assertFailsToDecode(base64(), "let's not talk of love or chains!"); // A 4n+1 length string is never legal base64(). assertFailsToDecode(base64(), "12345", "Invalid input length 5"); // These have a combination of invalid length, unrecognized characters and wrong padding. assertFailsToDecode(base64(), "AB=C", "Unrecognized character: ="); assertFailsToDecode(base64(), "A=BCD", "Invalid input length 5"); assertFailsToDecode(base64(), "?", "Invalid input length 1"); } public void testBase64CannotUpperCase() { try { base64().upperCase(); fail(); } catch (IllegalStateException expected) { // success } } public void testBase64CannotLowerCase() { try { base64().lowerCase(); fail(); } catch (IllegalStateException expected) { // success } } public void testBase64AlternatePadding() { BaseEncoding enc = base64().withPadChar('~'); testEncodingWithSeparators(enc, "", ""); testEncodingWithSeparators(enc, "f", "Zg~~"); testEncodingWithSeparators(enc, "fo", "Zm8~"); testEncodingWithSeparators(enc, "foo", "Zm9v"); testEncodingWithSeparators(enc, "foob", "Zm9vYg~~"); testEncodingWithSeparators(enc, "fooba", "Zm9vYmE~"); testEncodingWithSeparators(enc, "foobar", "Zm9vYmFy"); } @GwtIncompatible // Reader/Writer public void testBase64StreamingAlternatePadding() throws IOException { BaseEncoding enc = base64().withPadChar('~'); testStreamingEncodingWithSeparators(enc, "", ""); testStreamingEncodingWithSeparators(enc, "f", "Zg~~"); testStreamingEncodingWithSeparators(enc, "fo", "Zm8~"); testStreamingEncodingWithSeparators(enc, "foo", "Zm9v"); testStreamingEncodingWithSeparators(enc, "foob", "Zm9vYg~~"); testStreamingEncodingWithSeparators(enc, "fooba", "Zm9vYmE~"); testStreamingEncodingWithSeparators(enc, "foobar", "Zm9vYmFy"); } public void testBase64OmitPadding() { BaseEncoding enc = base64().omitPadding(); testEncodingWithSeparators(enc, "", ""); testEncodingWithSeparators(enc, "f", "Zg"); testEncodingWithSeparators(enc, "fo", "Zm8"); testEncodingWithSeparators(enc, "foo", "Zm9v"); testEncodingWithSeparators(enc, "foob", "Zm9vYg"); testEncodingWithSeparators(enc, "fooba", "Zm9vYmE"); testEncodingWithSeparators(enc, "foobar", "Zm9vYmFy"); } @GwtIncompatible // Reader/Writer public void testBase64StreamingOmitPadding() throws IOException { BaseEncoding enc = base64().omitPadding(); testStreamingEncodingWithSeparators(enc, "", ""); testStreamingEncodingWithSeparators(enc, "f", "Zg"); testStreamingEncodingWithSeparators(enc, "fo", "Zm8"); testStreamingEncodingWithSeparators(enc, "foo", "Zm9v"); testStreamingEncodingWithSeparators(enc, "foob", "Zm9vYg"); testStreamingEncodingWithSeparators(enc, "fooba", "Zm9vYmE"); testStreamingEncodingWithSeparators(enc, "foobar", "Zm9vYmFy"); } public void testBase64Offset() { testEncodesWithOffset(base64(), "foobar", 0, 6, "Zm9vYmFy"); testEncodesWithOffset(base64(), "foobar", 1, 5, "b29iYXI="); testEncodesWithOffset(base64(), "foobar", 2, 3, "b2Jh"); testEncodesWithOffset(base64(), "foobar", 3, 1, "Yg=="); testEncodesWithOffset(base64(), "foobar", 4, 0, ""); } public void testBase32() { // The following test vectors are specified in RFC 4648 itself testEncodingWithCasing(base32(), "", ""); testEncodingWithCasing(base32(), "f", "MY======"); testEncodingWithCasing(base32(), "fo", "MZXQ===="); testEncodingWithCasing(base32(), "foo", "MZXW6==="); testEncodingWithCasing(base32(), "foob", "MZXW6YQ="); testEncodingWithCasing(base32(), "fooba", "MZXW6YTB"); testEncodingWithCasing(base32(), "foobar", "MZXW6YTBOI======"); } @GwtIncompatible // Reader/Writer public void testBase32Streaming() throws IOException { // The following test vectors are specified in RFC 4648 itself testStreamingEncodingWithCasing(base32(), "", ""); testStreamingEncodingWithCasing(base32(), "f", "MY======"); testStreamingEncodingWithCasing(base32(), "fo", "MZXQ===="); testStreamingEncodingWithCasing(base32(), "foo", "MZXW6==="); testStreamingEncodingWithCasing(base32(), "foob", "MZXW6YQ="); testStreamingEncodingWithCasing(base32(), "fooba", "MZXW6YTB"); testStreamingEncodingWithCasing(base32(), "foobar", "MZXW6YTBOI======"); } public void testBase32LenientPadding() { testDecodes(base32(), "MZXW6", "foo"); testDecodes(base32(), "MZXW6=", "foo"); testDecodes(base32(), "MZXW6==", "foo"); testDecodes(base32(), "MZXW6===", "foo"); // proper padding length testDecodes(base32(), "MZXW6====", "foo"); testDecodes(base32(), "MZXW6=====", "foo"); } public void testBase32AlternatePadding() { BaseEncoding enc = base32().withPadChar('~'); testEncodingWithCasing(enc, "", ""); testEncodingWithCasing(enc, "f", "MY~~~~~~"); testEncodingWithCasing(enc, "fo", "MZXQ~~~~"); testEncodingWithCasing(enc, "foo", "MZXW6~~~"); testEncodingWithCasing(enc, "foob", "MZXW6YQ~"); testEncodingWithCasing(enc, "fooba", "MZXW6YTB"); testEncodingWithCasing(enc, "foobar", "MZXW6YTBOI~~~~~~"); } public void testBase32InvalidDecodings() { // These contain bytes not in the decodabet. assertFailsToDecode(base32(), "A ", "Unrecognized character: 0x20"); assertFailsToDecode(base32(), "Wf2!", "Unrecognized character: f"); // This sentence just isn't base32() encoded. assertFailsToDecode(base32(), "let's not talk of love or chains!"); // An 8n+{1,3,6} length string is never legal base32. assertFailsToDecode(base32(), "A", "Invalid input length 1"); assertFailsToDecode(base32(), "ABC"); assertFailsToDecode(base32(), "ABCDEF"); // These have a combination of invalid length, unrecognized characters and wrong padding. assertFailsToDecode(base32(), "AB=C", "Unrecognized character: ="); assertFailsToDecode(base32(), "A=BCDE", "Invalid input length 6"); assertFailsToDecode(base32(), "?", "Invalid input length 1"); } public void testBase32UpperCaseIsNoOp() { assertSame(base32(), base32().upperCase()); } public void testBase32Offset() { testEncodesWithOffset(base32(), "foobar", 0, 6, "MZXW6YTBOI======"); testEncodesWithOffset(base32(), "foobar", 1, 5, "N5XWEYLS"); testEncodesWithOffset(base32(), "foobar", 2, 3, "N5RGC==="); testEncodesWithOffset(base32(), "foobar", 3, 1, "MI======"); testEncodesWithOffset(base32(), "foobar", 4, 0, ""); } public void testBase32Hex() { // The following test vectors are specified in RFC 4648 itself testEncodingWithCasing(base32Hex(), "", ""); testEncodingWithCasing(base32Hex(), "f", "CO======"); testEncodingWithCasing(base32Hex(), "fo", "CPNG===="); testEncodingWithCasing(base32Hex(), "foo", "CPNMU==="); testEncodingWithCasing(base32Hex(), "foob", "CPNMUOG="); testEncodingWithCasing(base32Hex(), "fooba", "CPNMUOJ1"); testEncodingWithCasing(base32Hex(), "foobar", "CPNMUOJ1E8======"); } @GwtIncompatible // Reader/Writer public void testBase32HexStreaming() throws IOException { // The following test vectors are specified in RFC 4648 itself testStreamingEncodingWithCasing(base32Hex(), "", ""); testStreamingEncodingWithCasing(base32Hex(), "f", "CO======"); testStreamingEncodingWithCasing(base32Hex(), "fo", "CPNG===="); testStreamingEncodingWithCasing(base32Hex(), "foo", "CPNMU==="); testStreamingEncodingWithCasing(base32Hex(), "foob", "CPNMUOG="); testStreamingEncodingWithCasing(base32Hex(), "fooba", "CPNMUOJ1"); testStreamingEncodingWithCasing(base32Hex(), "foobar", "CPNMUOJ1E8======"); } public void testBase32HexLenientPadding() { testDecodes(base32Hex(), "CPNMU", "foo"); testDecodes(base32Hex(), "CPNMU=", "foo"); testDecodes(base32Hex(), "CPNMU==", "foo"); testDecodes(base32Hex(), "CPNMU===", "foo"); // proper padding length testDecodes(base32Hex(), "CPNMU====", "foo"); testDecodes(base32Hex(), "CPNMU=====", "foo"); } public void testBase32HexInvalidDecodings() { // These contain bytes not in the decodabet. assertFailsToDecode(base32Hex(), "A\u007f", "Unrecognized character: 0x7f"); assertFailsToDecode(base32Hex(), "Wf2!", "Unrecognized character: W"); // This sentence just isn't base32 encoded. assertFailsToDecode(base32Hex(), "let's not talk of love or chains!"); // An 8n+{1,3,6} length string is never legal base32. assertFailsToDecode(base32Hex(), "A"); assertFailsToDecode(base32Hex(), "ABC"); assertFailsToDecode(base32Hex(), "ABCDEF"); } public void testBase32HexUpperCaseIsNoOp() { assertSame(base32Hex(), base32Hex().upperCase()); } public void testBase16() { testEncodingWithCasing(base16(), "", ""); testEncodingWithCasing(base16(), "f", "66"); testEncodingWithCasing(base16(), "fo", "666F"); testEncodingWithCasing(base16(), "foo", "666F6F"); testEncodingWithCasing(base16(), "foob", "666F6F62"); testEncodingWithCasing(base16(), "fooba", "666F6F6261"); testEncodingWithCasing(base16(), "foobar", "666F6F626172"); } public void testBase16UpperCaseIsNoOp() { assertSame(base16(), base16().upperCase()); } public void testBase16InvalidDecodings() { // These contain bytes not in the decodabet. assertFailsToDecode(base16(), "\n\n", "Unrecognized character: 0xa"); assertFailsToDecode(base16(), "EFGH", "Unrecognized character: G"); // Valid base16 strings always have an even length. assertFailsToDecode(base16(), "A", "Invalid input length 1"); assertFailsToDecode(base16(), "ABC"); // These have a combination of invalid length and unrecognized characters. assertFailsToDecode(base16(), "?", "Invalid input length 1"); } public void testBase16Offset() { testEncodesWithOffset(base16(), "foobar", 0, 6, "666F6F626172"); testEncodesWithOffset(base16(), "foobar", 1, 5, "6F6F626172"); testEncodesWithOffset(base16(), "foobar", 2, 3, "6F6261"); testEncodesWithOffset(base16(), "foobar", 3, 1, "62"); testEncodesWithOffset(base16(), "foobar", 4, 0, ""); } private static void testEncodingWithCasing( BaseEncoding encoding, String decoded, String encoded) { testEncodingWithSeparators(encoding, decoded, encoded); testEncodingWithSeparators(encoding.upperCase(), decoded, Ascii.toUpperCase(encoded)); testEncodingWithSeparators(encoding.lowerCase(), decoded, Ascii.toLowerCase(encoded)); } private static void testEncodingWithSeparators( BaseEncoding encoding, String decoded, String encoded) { testEncoding(encoding, decoded, encoded); // test separators work for (int sepLength = 3; sepLength <= 5; sepLength++) { for (String separator : ImmutableList.of(",", "\n", ";;", "")) { testEncoding( encoding.withSeparator(separator, sepLength), decoded, Joiner.on(separator).join(Splitter.fixedLength(sepLength).split(encoded))); } } } private static void testEncoding(BaseEncoding encoding, String decoded, String encoded) { testEncodes(encoding, decoded, encoded); testDecodes(encoding, encoded, decoded); } private static void testEncodes(BaseEncoding encoding, String decoded, String encoded) { assertThat(encoding.encode(decoded.getBytes(UTF_8))).isEqualTo(encoded); } private static void testEncodesWithOffset( BaseEncoding encoding, String decoded, int offset, int len, String encoded) { assertThat(encoding.encode(decoded.getBytes(UTF_8), offset, len)).isEqualTo(encoded); } private static void testDecodes(BaseEncoding encoding, String encoded, String decoded) { assertTrue(encoding.canDecode(encoded)); assertThat(encoding.decode(encoded)).isEqualTo(decoded.getBytes(UTF_8)); } private static void assertFailsToDecode(BaseEncoding encoding, String cannotDecode) { assertFailsToDecode(encoding, cannotDecode, null); } private static void assertFailsToDecode( BaseEncoding encoding, String cannotDecode, @Nullable String expectedMessage) { assertFalse(encoding.canDecode(cannotDecode)); try { encoding.decode(cannotDecode); fail("Expected IllegalArgumentException"); } catch (IllegalArgumentException expected) { if (expectedMessage != null) { assertThat(expected).hasCauseThat().hasMessageThat().isEqualTo(expectedMessage); } } try { encoding.decodeChecked(cannotDecode); fail("Expected DecodingException"); } catch (DecodingException expected) { if (expectedMessage != null) { assertThat(expected).hasMessageThat().isEqualTo(expectedMessage); } } } @GwtIncompatible // Reader/Writer private static void testStreamingEncodingWithCasing( BaseEncoding encoding, String decoded, String encoded) throws IOException { testStreamingEncodingWithSeparators(encoding, decoded, encoded); testStreamingEncodingWithSeparators(encoding.upperCase(), decoded, Ascii.toUpperCase(encoded)); testStreamingEncodingWithSeparators(encoding.lowerCase(), decoded, Ascii.toLowerCase(encoded)); } @GwtIncompatible // Reader/Writer private static void testStreamingEncodingWithSeparators( BaseEncoding encoding, String decoded, String encoded) throws IOException { testStreamingEncoding(encoding, decoded, encoded); // test separators work for (int sepLength = 3; sepLength <= 5; sepLength++) { for (String separator : ImmutableList.of(",", "\n", ";;", "")) { testStreamingEncoding( encoding.withSeparator(separator, sepLength), decoded, Joiner.on(separator).join(Splitter.fixedLength(sepLength).split(encoded))); } } } @GwtIncompatible // Reader/Writer private static void testStreamingEncoding(BaseEncoding encoding, String decoded, String encoded) throws IOException { testStreamingEncodes(encoding, decoded, encoded); testStreamingDecodes(encoding, encoded, decoded); } @GwtIncompatible // Writer private static void testStreamingEncodes(BaseEncoding encoding, String decoded, String encoded) throws IOException { StringWriter writer = new StringWriter(); OutputStream encodingStream = encoding.encodingStream(writer); encodingStream.write(decoded.getBytes(UTF_8)); encodingStream.close(); assertThat(writer.toString()).isEqualTo(encoded); } @GwtIncompatible // Reader private static void testStreamingDecodes(BaseEncoding encoding, String encoded, String decoded) throws IOException { byte[] bytes = decoded.getBytes(UTF_8); InputStream decodingStream = encoding.decodingStream(new StringReader(encoded)); for (int i = 0; i < bytes.length; i++) { assertThat(decodingStream.read()).isEqualTo(bytes[i] & 0xFF); } assertThat(decodingStream.read()).isEqualTo(-1); decodingStream.close(); } public void testToString() { assertEquals("BaseEncoding.base64().withPadChar('=')", base64().toString()); assertEquals("BaseEncoding.base32Hex().omitPadding()", base32Hex().omitPadding().toString()); assertEquals( "BaseEncoding.base32().lowerCase().withPadChar('$')", base32().lowerCase().withPadChar('$').toString()); assertEquals( "BaseEncoding.base16().withSeparator(\"\n\", 10)", base16().withSeparator("\n", 10).toString()); } }