module Octet ( Octet(..), octet_from_int, octet_properties, octet_tests, ) where import Data.Maybe (fromJust) import Test.HUnit (assertEqual) import Test.Framework (Test, testGroup) import Test.Framework.Providers.HUnit (testCase) import Test.Framework.Providers.QuickCheck2 (testProperty) import Test.QuickCheck (Arbitrary(..), Gen, Property, (==>)) import Bit as B import Maskable import Maskbits -- | An Octet consists of eight bits. For our purposes, the most -- significant bit will come "first." That is, b1 is in the 2^7 -- place while b8 is in the 2^0 place. data Octet = Octet { b1 :: Bit, b2 :: Bit, b3 :: Bit, b4 :: Bit, b5 :: Bit, b6 :: Bit, b7 :: Bit, b8 :: Bit } deriving (Eq) instance Show Octet where show oct = show (fromEnum oct) instance Arbitrary Octet where arbitrary = do a1 <- arbitrary :: Gen Bit a2 <- arbitrary :: Gen Bit a3 <- arbitrary :: Gen Bit a4 <- arbitrary :: Gen Bit a5 <- arbitrary :: Gen Bit a6 <- arbitrary :: Gen Bit a7 <- arbitrary :: Gen Bit a8 <- arbitrary :: Gen Bit return (Octet a1 a2 a3 a4 a5 a6 a7 a8) instance Maskable Octet where apply_mask oct Eight _ = oct apply_mask oct Seven bit = oct { b8 = bit } apply_mask oct Six bit = oct { b8 = bit, b7 = bit } apply_mask oct Five bit = oct { b8 = bit, b7 = bit, b6 = bit } apply_mask oct Four bit = oct { b8 = bit, b7 = bit, b6 = bit, b5 = bit } apply_mask oct Three bit = oct { b8 = bit, b7 = bit, b6 = bit, b5 = bit, b4 = bit } apply_mask oct Two bit = oct { b8 = bit, b7 = bit, b6 = bit, b5 = bit, b4 = bit, b3 = bit } apply_mask oct Maskbits.One bit = oct { b8 = bit, b7 = bit, b6 = bit, b5 = bit, b4 = bit, b3 = bit, b2 = bit } apply_mask oct Maskbits.Zero bit = oct { b8 = bit, b7 = bit, b6 = bit, b5 = bit, b4 = bit, b3 = bit, b2 = bit, b1 = bit } -- The Maskbits must be in [Eight..ThirtyTwo]. apply_mask oct _ _ = oct instance Ord Octet where (Octet x1 x2 x3 x4 x5 x6 x7 x8) <= (Octet y1 y2 y3 y4 y5 y6 y7 y8) | x1 > y1 = False | x2 > y2 = False | x3 > y3 = False | x4 > y4 = False | x5 > y5 = False | x6 > y6 = False | x7 > y7 = False | x8 > y8 = False | otherwise = True instance Bounded Octet where -- | The octet with the least possible value. minBound = Octet B.Zero B.Zero B.Zero B.Zero B.Zero B.Zero B.Zero B.Zero -- | The octet with the greatest possible value. maxBound = Octet B.One B.One B.One B.One B.One B.One B.One B.One instance Enum Octet where -- We're supposed to throw a runtime error if you call (succ -- maxBound), so the fromJust here doesn't introduce any additional -- badness. toEnum = fromJust . octet_from_int -- | Convert each bit to its integer value, and multiply by the -- appropriate power of two. Sum them up, and we should get an integer -- between 0 and 255. fromEnum x = 128 * (bit_to_int (b1 x)) + 64 * (bit_to_int (b2 x)) + 32 * (bit_to_int (b3 x)) + 16 * (bit_to_int (b4 x)) + 8 * (bit_to_int (b5 x)) + 4 * (bit_to_int (b6 x)) + 2 * (bit_to_int (b7 x)) + 1 * (bit_to_int (b8 x)) octet_from_int :: Int -> Maybe Octet octet_from_int x | (x < 0) || (x > 255) = Nothing | otherwise = Just (Octet a1 a2 a3 a4 a5 a6 a7 a8) where a1 = if (x >= 128) then B.One else B.Zero a2 = if ((x `mod` 128) >= 64) then B.One else B.Zero a3 = if ((x `mod` 64) >= 32) then B.One else B.Zero a4 = if ((x `mod` 32) >= 16) then B.One else B.Zero a5 = if ((x `mod` 16) >= 8) then B.One else B.Zero a6 = if ((x `mod` 8) >= 4) then B.One else B.Zero a7 = if ((x `mod` 4) >= 2) then B.One else B.Zero a8 = if ((x `mod` 2) == 1) then B.One else B.Zero instance Read Octet where readsPrec _ = \s -> case (reads s :: [(Int, String)]) of [] -> [] (x,leftover):_ -> case (octet_from_int x) of Nothing -> [] Just oct -> [(oct, leftover)] -- Test lists. octet_tests :: Test octet_tests = testGroup "Octet Tests" [ test_octet_from_int1, test_octet_mask1, test_octet_mask2 ] octet_properties :: Test octet_properties = testGroup "Octet Properties " [ testProperty "fromEnum/toEnum are inverses" prop_from_enum_to_enum_inverses, testProperty "read/show are inverses" prop_read_show_inverses ] -- QuickCheck properties prop_from_enum_to_enum_inverses :: Int -> Property prop_from_enum_to_enum_inverses x = (0 <= x) && (x <= 255) ==> fromEnum (toEnum x :: Octet) == x prop_read_show_inverses :: Int -> Property prop_read_show_inverses x = (0 <= x) && (x <= 255) ==> x' == x where oct :: Octet oct = read $ show x x' :: Int x' = read $ show oct -- HUnit Tests test_octet_from_int1 :: Test test_octet_from_int1 = testCase desc $ assertEqual desc oct1 oct2 where desc = "octet_from_int 128 should parse as 10000000" oct1 = Octet B.One B.Zero B.Zero B.Zero B.Zero B.Zero B.Zero B.Zero oct2 = fromJust $ octet_from_int 128 test_octet_mask1 :: Test test_octet_mask1 = testCase desc $ assertEqual desc oct2 (apply_mask oct1 Four B.Zero) where desc = "The network bits of 255/4 should equal 240" oct1 = fromJust $ octet_from_int 255 oct2 = fromJust $ octet_from_int 240 test_octet_mask2 :: Test test_octet_mask2 = testCase desc $ assertEqual desc oct2 (apply_mask oct1 Maskbits.One B.Zero) where desc = "The network bits of 255/1 should equal 128" oct1 = fromJust $ octet_from_int 255 oct2 = fromJust $ octet_from_int 128