fips_lookup 0.2.0 → 0.3.0

data/lib/data/subdivision/WV.csv

@@ -0,0 +1,228 @@
+WV,54,001,Barbour County,92328,01928323,North district,Z1,N
+WV,54,001,Barbour County,92892,01928358,South district,Z1,N
+WV,54,001,Barbour County,93588,01928406,West district,Z1,N
+WV,54,003,Berkeley County,90006,01928161,Adam Stephens district,Z1,N
+WV,54,003,Berkeley County,92322,01928322,Norborne district,Z1,N
+WV,54,003,Berkeley County,92526,01928342,Potomac district,Z1,N
+WV,54,003,Berkeley County,92754,01928353,Shenandoah district,Z1,N
+WV,54,003,Berkeley County,93171,01928382,Tuscarora district,Z1,N
+WV,54,003,Berkeley County,93388,01928394,Valley district,Z1,N
+WV,54,005,Boone County,90762,01928204,District 1,Z1,N
+WV,54,005,Boone County,90796,01928215,District 2,Z1,N
+WV,54,005,Boone County,90832,01928226,District 3,Z1,N
+WV,54,007,Braxton County,90968,01928262,Eastern district,Z1,N
+WV,54,007,Braxton County,92346,01928330,Northern district,Z1,N
+WV,54,007,Braxton County,92922,01928366,Southern district,Z1,N
+WV,54,007,Braxton County,93597,01928413,Western district,Z1,N
+WV,54,009,Brooke County,91104,01928271,Follansbee district,Z1,N
+WV,54,009,Brooke County,93552,01928403,Weirton district,Z1,N
+WV,54,009,Brooke County,93564,01928404,Wellsburg district,Z1,N
+WV,54,011,Cabell County,90764,01928205,District 1,Z1,N
+WV,54,011,Cabell County,90798,01928216,District 2,Z1,N
+WV,54,011,Cabell County,90834,01928227,District 3,Z1,N
+WV,54,011,Cabell County,90870,01928237,District 4,Z1,N
+WV,54,011,Cabell County,90882,01928241,District 5,Z1,N
+WV,54,013,Calhoun County,90766,01928206,District 1,Z1,N
+WV,54,013,Calhoun County,90800,01928217,District 2,Z1,N
+WV,54,013,Calhoun County,90836,01928228,District 3,Z1,N
+WV,54,013,Calhoun County,90873,01928238,District 4,Z1,N
+WV,54,013,Calhoun County,90885,01928242,District 5,Z1,N
+WV,54,015,Clay County,90891,01928244,District A,Z1,N
+WV,54,015,Clay County,90893,01928246,District B,Z1,N
+WV,54,015,Clay County,90895,01928248,District C,Z1,N
+WV,54,017,Doddridge County,90138,01928165,Beech district,Z1,N
+WV,54,017,Doddridge County,92094,01928309,Maple district,Z1,N
+WV,54,017,Doddridge County,92374,01928333,Oak district,Z1,N
+WV,54,017,Doddridge County,92466,01928337,Pine district,Z1,N
+WV,54,019,Fayette County,92280,01928319,New Haven district,Z1,N
+WV,54,019,Fayette County,92472,01928338,Plateau district,Z1,N
+WV,54,019,Fayette County,93396,01928396,Valley district,Z1,N
+WV,54,021,Gilmer County,90408,01928180,Center district,Z1,N
+WV,54,021,Gilmer County,90534,01928191,City district,Z1,N
+WV,54,021,Gilmer County,90758,01928203,De Kalb-Troy district,Z1,N
+WV,54,021,Gilmer County,91236,01928274,Glenville district,Z1,N
+WV,54,023,Grant County,91296,01928277,Grant district,Z1,N
+WV,54,023,Grant County,92208,01928315,Milroy district,Z1,N
+WV,54,023,Grant County,93216,01928385,Union district,Z1,N
+WV,54,025,Greenbrier County,90449,01928181,Central district,Z1,N
+WV,54,025,Greenbrier County,90972,01928256,Eastern district,Z1,N
+WV,54,025,Greenbrier County,93601,01928408,Western district,Z1,N
+WV,54,027,Hampshire County,90204,01928169,Bloomery district,Z1,N
+WV,54,027,Hampshire County,90360,01928177,Capon district,Z1,N
+WV,54,027,Hampshire County,91248,01928275,Gore district,Z1,N
+WV,54,027,Hampshire County,92184,01928314,Mill Creek district,Z1,N
+WV,54,027,Hampshire County,92676,01928347,Romney district,Z1,N
+WV,54,027,Hampshire County,92820,01928356,Sherman district,Z1,N
+WV,54,027,Hampshire County,92988,01928369,Springfield district,Z1,N
+WV,54,029,Hancock County,90312,01928175,Butler district,Z1,N
+WV,54,029,Hancock County,90540,01928192,Clay district,Z1,N
+WV,54,029,Hancock County,91308,01928278,Grant district,Z1,N
+WV,54,031,Hardy County,90372,01928178,Capon district,Z1,N
+WV,54,031,Hardy County,91968,01928305,Lost River district,Z1,N
+WV,54,031,Hardy County,92232,01928317,Moorefield district,Z1,N
+WV,54,031,Hardy County,92382,01928334,Old Fields district,Z1,N
+WV,54,031,Hardy County,92928,01928360,South Fork district,Z1,N
+WV,54,033,Harrison County,90975,01928257,Eastern district,Z1,N
+WV,54,033,Harrison County,92352,01928331,Northern district,Z1,N
+WV,54,033,Harrison County,92368,01928326,North Urban district,Z1,N
+WV,54,033,Harrison County,92923,01928363,Southern district,Z1,N
+WV,54,033,Harrison County,92932,01928361,South Urban district,Z1,N
+WV,54,033,Harrison County,92952,01928367,Southwest district,Z1,N
+WV,54,035,Jackson County,90976,01928258,Eastern district,Z1,N
+WV,54,035,Jackson County,92353,01928328,Northern district,Z1,N
+WV,54,035,Jackson County,93605,01928409,Western district,Z1,N
+WV,54,037,Jefferson County,90504,01928190,Charles Town district,Z1,N
+WV,54,037,Jefferson County,91548,01928287,Harpers Ferry district,Z1,N
+WV,54,037,Jefferson County,91740,01928295,Kabletown district,Z1,N
+WV,54,037,Jefferson County,92160,01928313,Middleway district,Z1,N
+WV,54,037,Jefferson County,92760,01928354,Shepherdstown district,Z1,N
+WV,54,039,Kanawha County,90768,01928207,District 1,Z1,N
+WV,54,039,Kanawha County,90804,01928218,District 2,Z1,N
+WV,54,039,Kanawha County,90840,01928229,District 3,Z1,N
+WV,54,039,Kanawha County,90876,01928239,District 4,Z1,N
+WV,54,041,Lewis County,90676,01928199,Courthouse-Collins Settlement district,Z1,N
+WV,54,041,Lewis County,91176,01928273,Freemans Creek district,Z1,N
+WV,54,041,Lewis County,91480,01928283,Hackers Creek-Skin Creek district,Z1,N
+WV,54,043,Lincoln County,90770,02727444,District 1,Z1,N
+WV,54,043,Lincoln County,90806,02727447,District 2,Z1,N
+WV,54,043,Lincoln County,90842,02727449,District 3,Z1,N
+WV,54,045,Logan County,90453,01928182,Central district,Z1,N
+WV,54,045,Logan County,90979,01928259,Eastern district,Z1,N
+WV,54,045,Logan County,93608,01928410,Western district,Z1,N
+WV,54,047,McDowell County,90168,01928167,Big Creek district,Z1,N
+WV,54,047,McDowell County,90240,01928171,Browns Creek district,Z1,N
+WV,54,047,McDowell County,92345,01928325,North Elkin district,Z1,N
+WV,54,047,McDowell County,92712,01928348,Sandy River district,Z1,N
+WV,54,049,Marion County,92154,01928312,Middletown district,Z1,N
+WV,54,049,Marion County,92418,01928335,Palatine district,Z1,N
+WV,54,049,Marion County,93594,01928405,West Augusta district,Z1,N
+WV,54,051,Marshall County,90780,01928208,District 1,Z1,N
+WV,54,051,Marshall County,90816,01928219,District 2,Z1,N
+WV,54,051,Marshall County,90852,01928230,District 3,Z1,N
+WV,54,053,Mason County,90048,01928162,Arbuckle district,Z1,N
+WV,54,053,Mason County,90612,01928195,Clendenin district,Z1,N
+WV,54,053,Mason County,90648,01928197,Cologne district,Z1,N
+WV,54,053,Mason County,90660,01928198,Cooper district,Z1,N
+WV,54,053,Mason County,91260,01928276,Graham district,Z1,N
+WV,54,053,Mason County,91512,01928285,Hannan district,Z1,N
+WV,54,053,Mason County,91860,01928302,Lewis district,Z1,N
+WV,54,053,Mason County,92652,01928346,Robinson district,Z1,N
+WV,54,053,Mason County,93264,01928387,Union district,Z1,N
+WV,54,053,Mason County,93432,01928398,Waggener district,Z1,N
+WV,54,055,Mercer County,90900,01928250,District I,Z1,N
+WV,54,055,Mercer County,90912,01928251,District II,Z1,N
+WV,54,055,Mercer County,90924,01928252,District III,Z1,N
+WV,54,057,Mineral County,90784,01928209,District 1,Z1,N
+WV,54,057,Mineral County,90820,01928220,District 2,Z1,N
+WV,54,057,Mineral County,90856,01928231,District 3,Z1,N
+WV,54,059,Mingo County,90141,02071872,Beech Ben Mate district,Z1,N
+WV,54,059,Mingo County,91770,02071873,Kermit Harvey district,Z1,N
+WV,54,059,Mingo County,91848,01928301,Lee district,Z1,N
+WV,54,059,Mingo County,92064,01928308,Magnolia district,Z1,N
+WV,54,059,Mingo County,93012,01928372,Stafford district,Z1,N
+WV,54,059,Mingo County,93162,02071874,Tug Hardee district,Z1,N
+WV,54,059,Mingo County,93696,01928420,Williamson district,Z1,N
+WV,54,061,Monongalia County,90456,01928186,Central district,Z1,N
+WV,54,061,Monongalia County,90983,01928263,Eastern district,Z1,N
+WV,54,061,Monongalia County,93612,01928414,Western district,Z1,N
+WV,54,063,Monroe County,90457,01928183,Central district,Z1,N
+WV,54,063,Monroe County,90984,01928260,Eastern district,Z1,N
+WV,54,063,Monroe County,93613,01928411,Western district,Z1,N
+WV,54,065,Morgan County,90786,01928210,District 1,Z1,N
+WV,54,065,Morgan County,90822,01928221,District 2,Z1,N
+WV,54,065,Morgan County,90858,01928232,District 3,Z1,N
+WV,54,067,Nicholas County,90132,01928164,Beaver district,Z1,N
+WV,54,067,Nicholas County,91344,01928279,Grant district,Z1,N
+WV,54,067,Nicholas County,91500,01928284,Hamilton district,Z1,N
+WV,54,067,Nicholas County,91716,01928294,Jefferson district,Z1,N
+WV,54,067,Nicholas County,91752,01928296,Kentucky district,Z1,N
+WV,54,067,Nicholas County,93072,01928376,Summersville district,Z1,N
+WV,54,067,Nicholas County,93660,01928418,Wilderness district,Z1,N
+WV,54,069,Ohio County,90788,01928211,District 1,Z1,N
+WV,54,069,Ohio County,90824,01928222,District 2,Z1,N
+WV,54,069,Ohio County,90862,01928233,District 3,Z1,N
+WV,54,071,Pendleton County,90462,01928184,Central district,Z1,N
+WV,54,071,Pendleton County,90987,01928261,Eastern district,Z1,N
+WV,54,071,Pendleton County,93615,01928412,Western district,Z1,N
+WV,54,073,Pleasants County,90892,01928243,District A,Z1,N
+WV,54,073,Pleasants County,90894,01928245,District B,Z1,N
+WV,54,073,Pleasants County,90896,01928247,District C,Z1,N
+WV,54,073,Pleasants County,90898,01928249,District D,Z1,N
+WV,54,075,Pocahontas County,90996,01928266,Edray district,Z1,N
+WV,54,075,Pocahontas County,91416,01928281,Greenbank district,Z1,N
+WV,54,075,Pocahontas County,91656,01928291,Huntersville district,Z1,N
+WV,54,075,Pocahontas County,91944,01928304,Little Levels district,Z1,N
+WV,54,077,Preston County,91096,01928268,Fifth district,Z1,N
+WV,54,077,Preston County,91100,01928269,First district,Z1,N
+WV,54,077,Preston County,91134,01928272,Fourth district,Z1,N
+WV,54,077,Preston County,92742,01928350,Second district,Z1,N
+WV,54,077,Preston County,93102,01928379,Third district,Z1,N
+WV,54,079,Putnam County,90790,02807599,District 1,Z1,N
+WV,54,079,Putnam County,90826,02807600,District 2,Z1,N
+WV,54,079,Putnam County,90863,02807601,District 3,Z1,N
+WV,54,081,Raleigh County,90792,01928212,District 1,Z1,N
+WV,54,081,Raleigh County,90828,01928223,District 2,Z1,N
+WV,54,081,Raleigh County,90864,01928234,District 3,Z1,N
+WV,54,083,Randolph County,90156,01928166,Beverly district,Z1,N
+WV,54,083,Randolph County,90936,01928253,Dry Fork district,Z1,N
+WV,54,083,Randolph County,91668,01928292,Huttonsville district,Z1,N
+WV,54,083,Randolph County,91824,01928300,Leadsville district,Z1,N
+WV,54,083,Randolph County,92148,01928311,Middle Fork district,Z1,N
+WV,54,083,Randolph County,92220,01928316,Mingo district,Z1,N
+WV,54,083,Randolph County,92292,01928320,New Interest district,Z1,N
+WV,54,083,Randolph County,92640,01928345,Roaring Creek district,Z1,N
+WV,54,083,Randolph County,93420,01928395,Valley Bend district,Z1,N
+WV,54,085,Ritchie County,90552,01928193,Clay district,Z1,N
+WV,54,085,Ritchie County,91380,01928280,Grant district,Z1,N
+WV,54,085,Ritchie County,92244,01928318,Murphy district,Z1,N
+WV,54,085,Ritchie County,93336,01928390,Union district,Z1,N
+WV,54,087,Roane County,90906,01953485,District I,Z1,N
+WV,54,087,Roane County,90918,01953486,District II,Z1,N
+WV,54,087,Roane County,90930,01953487,District III,Z1,N
+WV,54,089,Summers County,90216,01928170,Bluestone River district,Z1,N
+WV,54,089,Summers County,91440,01928282,Greenbrier River district,Z1,N
+WV,54,089,Summers County,92316,01928321,New River district,Z1,N
+WV,54,091,Taylor County,90993,01928265,Eastern district,Z1,N
+WV,54,091,Taylor County,93175,01928383,Tygart district,Z1,N
+WV,54,091,Taylor County,93621,01928416,Western district,Z1,N
+WV,54,093,Tucker County,90192,01928168,Black Fork district,Z1,N
+WV,54,093,Tucker County,90624,01928196,Clover district,Z1,N
+WV,54,093,Tucker County,90744,01928202,Davis district,Z1,N
+WV,54,093,Tucker County,90948,01928254,Dry Fork district,Z1,N
+WV,54,093,Tucker County,91056,01928267,Fairfax district,Z1,N
+WV,54,093,Tucker County,91896,01928303,Licking district,Z1,N
+WV,54,093,Tucker County,92688,01928371,St. George district,Z1,N
+WV,54,095,Tyler County,90469,01928187,Central district,Z1,N
+WV,54,095,Tyler County,92334,01928324,North district,Z1,N
+WV,54,095,Tyler County,92898,01928359,South district,Z1,N
+WV,54,095,Tyler County,93592,01928407,West district,Z1,N
+WV,54,097,Upshur County,91102,01928270,First district,Z1,N
+WV,54,097,Upshur County,92745,01928351,Second district,Z1,N
+WV,54,097,Upshur County,93105,01928380,Third district,Z1,N
+WV,54,099,Wayne County,90324,01928176,Butler district,Z1,N
+WV,54,099,Wayne County,90492,01928189,Ceredo district,Z1,N
+WV,54,099,Wayne County,93036,01928374,Stonewall district,Z1,N
+WV,54,099,Wayne County,93372,01928392,Union district,Z1,N
+WV,54,099,Wayne County,93624,01928417,Westmoreland district,Z1,N
+WV,54,101,Webster County,90471,01928185,Central district,Z1,N
+WV,54,101,Webster County,92360,01928329,Northern district,Z1,N
+WV,54,101,Webster County,92925,01928365,Southern district,Z1,N
+WV,54,103,Wetzel County,90794,01928213,District 1,Z1,N
+WV,54,103,Wetzel County,90830,01928224,District 2,Z1,N
+WV,54,103,Wetzel County,90867,01928235,District 3,Z1,N
+WV,54,105,Wirt County,90473,01928188,Central district,Z1,N
+WV,54,105,Wirt County,92344,01928327,Northeast district,Z1,N
+WV,54,105,Wirt County,92958,01928368,Southwest district,Z1,N
+WV,54,107,Wood County,90588,01928194,Clay district,Z1,N
+WV,54,107,Wood County,91560,01928288,Harris district,Z1,N
+WV,54,107,Wood County,91980,01928306,Lubeck district,Z1,N
+WV,54,107,Wood County,92424,01928336,Parkersburg district,Z1,N
+WV,54,107,Wood County,92856,01928357,Slate district,Z1,N
+WV,54,107,Wood County,93024,01928373,Steele district,Z1,N
+WV,54,107,Wood County,93180,01928384,Tygart district,Z1,N
+WV,54,107,Wood County,93384,01928393,Union district,Z1,N
+WV,54,107,Wood County,93444,01928399,Walker district,Z1,N
+WV,54,107,Wood County,93672,01928419,Williams district,Z1,N
+WV,54,109,Wyoming County,90795,01928214,District 1,Z1,N
+WV,54,109,Wyoming County,90831,01928225,District 2,Z1,N
+WV,54,109,Wyoming County,90868,01928236,District 3,Z1,N

data/lib/data/subdivision/WY.csv

@@ -0,0 +1,71 @@
+WY,56,001,Albany County,91100,01939703,East Albany CCD,Z5,S
+WY,56,001,Albany County,92090,01939721,Laramie CCD,Z5,S
+WY,56,001,Albany County,92695,01939732,Rock River CCD,Z5,S
+WY,56,001,Albany County,93135,01939740,South Albany CCD,Z5,S
+WY,56,003,Big Horn County,90688,01939686,Central Big Horn CCD,Z5,S
+WY,56,003,Big Horn County,92393,01939687,North Big Horn CCD,Z5,S
+WY,56,003,Big Horn County,93142,01939688,South Big Horn CCD,Z5,S
+WY,56,005,Campbell County,91210,01939705,Gillette North CCD,Z5,S
+WY,56,005,Campbell County,91265,01939706,Gillette South CCD,Z5,S
+WY,56,007,Carbon County,91650,01939713,Hanna CCD,Z5,S
+WY,56,007,Carbon County,92640,01939731,Rawlins CCD,Z5,S
+WY,56,007,Carbon County,92860,01939735,Saratoga CCD,Z5,S
+WY,56,009,Converse County,90990,01939701,Douglas CCD,Z5,S
+WY,56,009,Converse County,91375,01939708,Glenrock CCD,Z5,S
+WY,56,011,Crook County,91760,01939715,Hulett CCD,Z5,S
+WY,56,011,Crook County,92200,01939723,Moorcroft CCD,Z5,S
+WY,56,011,Crook County,93190,01939741,Sundance CCD,Z5,S
+WY,56,013,Fremont County,91045,01939702,Dubois CCD,Z5,S
+WY,56,013,Fremont County,91842,01939742,Jeffrey City CCD,Z5,S
+WY,56,013,Fremont County,92035,01939720,Lander CCD,Z5,S
+WY,56,013,Fremont County,93080,01939739,Shoshoni CCD,Z5,S
+WY,56,013,Fremont County,93742,01939750,Wind River Reservation CCD,Z5,S
+WY,56,015,Goshen County,91430,01939709,Goshen Hole CCD,Z5,S
+WY,56,015,Goshen County,92585,01939730,Rawhide Creek CCD,Z5,S
+WY,56,015,Goshen County,93465,01939746,Torrington CCD,Z5,S
+WY,56,017,Hot Springs County,93355,01939744,Thermopolis East CCD,Z5,S
+WY,56,017,Hot Springs County,93410,01939745,Thermopolis West CCD,Z5,S
+WY,56,017,Hot Springs County,93744,01939751,Wind River Reservation CCD,Z5,S
+WY,56,019,Johnson County,90495,01939692,Buffalo CCD,Z5,S
+WY,56,019,Johnson County,91870,01939717,Kaycee CCD,Z5,S
+WY,56,021,Laramie County,90715,01939696,Cheyenne CCD,Z5,S
+WY,56,021,Laramie County,90770,01939697,Cheyenne East CCD,Z5,S
+WY,56,021,Laramie County,90825,01939698,Cheyenne West CCD,Z5,S
+WY,56,021,Laramie County,92420,01939727,Pine Bluffs CCD,Z5,S
+WY,56,023,Lincoln County,90055,01939684,Afton CCD,Z5,S
+WY,56,023,Lincoln County,91925,01939718,Kemmerer East CCD,Z5,S
+WY,56,023,Lincoln County,91980,01939719,Kemmerer West CCD,Z5,S
+WY,56,025,Natrona County,90550,01939693,Casper CCD,Z5,S
+WY,56,025,Natrona County,90605,01939694,Casper North CCD,Z5,S
+WY,56,025,Natrona County,90660,01939695,Casper South CCD,Z5,S
+WY,56,025,Natrona County,91705,01939714,Hells Half Acre CCD,Z5,S
+WY,56,027,Niobrara County,91128,01939725,East Niobrara CCD,Z5,S
+WY,56,027,Niobrara County,93603,01939726,West Niobrara CCD,Z5,S
+WY,56,029,Park County,90935,01939700,Cody CCD,Z5,S
+WY,56,029,Park County,92145,01939722,Meeteetse CCD,Z5,S
+WY,56,029,Park County,92530,01939729,Powell CCD,Z5,S
+WY,56,029,Park County,93850,01939753,Yellowstone National Park CCD,Z5,S
+WY,56,031,Platte County,90880,01939699,Chugwater CCD,Z5,S
+WY,56,031,Platte County,91320,01939707,Glendo CCD,Z5,S
+WY,56,031,Platte County,91595,01939712,Guernsey CCD,Z5,S
+WY,56,031,Platte County,93630,01939749,Wheatland CCD,Z5,S
+WY,56,033,Sheridan County,92915,01939736,Sheridan CCD,Z5,S
+WY,56,033,Sheridan County,92970,01939737,Sheridan South CCD,Z5,S
+WY,56,033,Sheridan County,93025,01939738,Sheridan West CCD,Z5,S
+WY,56,035,Sublette County,90330,01939689,Big Piney CCD,Z5,S
+WY,56,035,Sublette County,90385,01939690,Boulder CCD,Z5,S
+WY,56,035,Sublette County,92475,01939728,Pinedale CCD,Z5,S
+WY,56,037,Sweetwater County,91485,01939710,Green River North CCD,Z5,S
+WY,56,037,Sweetwater County,91540,01939711,Green River South CCD,Z5,S
+WY,56,037,Sweetwater County,92750,01939733,Rock Springs North CCD,Z5,S
+WY,56,037,Sweetwater County,92805,01939734,Rock Springs South CCD,Z5,S
+WY,56,037,Sweetwater County,93575,01939748,Wamsutter CCD,Z5,S
+WY,56,039,Teton County,90110,01939685,Alta CCD,Z5,S
+WY,56,039,Teton County,91815,01939716,Jackson Hole CCD,Z5,S
+WY,56,039,Teton County,93905,01939754,Yellowstone National Park CCD,Z5,S
+WY,56,041,Uinta County,90440,01939691,Bridger Valley CCD,Z5,S
+WY,56,041,Uinta County,91155,01939704,Evanston CCD,Z5,S
+WY,56,043,Washakie County,93300,01939743,Ten Sleep CCD,Z5,S
+WY,56,043,Washakie County,93795,01939752,Worland CCD,Z5,S
+WY,56,045,Weston County,92255,01939724,Newcastle CCD,Z5,S
+WY,56,045,Weston County,93520,01939747,Upton CCD,Z5,S

data/lib/fips_lookup/county.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# County related section of FipsLookup module
+module FipsLookup
+  class << self
+    def county(state_param:, county_param:, return_nil: false)
+      state_code = find_state_code(state_param: state_param, return_nil: return_nil)
+      return {} if state_code.nil?
+
+      lookup = [state_code, county_param.upcase]
+      @county_fips ||= {}
+      @county_fips[lookup] ||= county_lookup(state_code, county_param, return_nil)
+    end
+
+    def fips_county(fips:, return_nil: false)
+      unless fips.is_a?(String) && fips.length == 5
+        return_nil ? (return nil) : (raise StandardError, "FIPS input must be 5 digit string")
+      end
+
+      state_code = find_state_code(state_param: fips[0..1], return_nil: return_nil)
+      return nil if state_code.nil?
+
+      CSV.foreach(county_file(state_code: state_code)) do |county_row|
+        # state_code (AL), state fips (01), county fips (001), name (Augtauga County), county gnis(00161526), class code (H1), status (A)
+        return [county_row[3], state_code] if county_row[2] == fips[2..4]
+      end
+
+      raise StandardError, "Could not find county with fips: #{fips[2..4]}, in: #{state_code}" unless return_nil
+    end
+
+    def county_file(state_code:)
+      file_path = "#{File.expand_path("..", __dir__)}/data/county/#{state_code}.csv"
+      file_path if File.exist?(file_path)
+    end
+
+    private
+
+    def county_lookup(state_code, county_param, return_nil)
+      upcase_param = county_param.upcase
+      CSV.foreach(county_file(state_code: state_code)) do |row|
+        return formatted_county(row) if match_county?(row, upcase_param)
+
+        # keep? Memoize as file is being read but match isn't found ~ loses lookup flexiblity in county param + increases performacne?
+        @county_fips[[row[0], row[3].upcase]] = formatted_county(row) unless @county_fips.key?([row[0], row[3].upcase])
+      end
+      return_nil ? (return {}) : (raise StandardError, "No county found matching: #{county_param}" unless return_nil)
+    end
+
+    def match_county?(row, param)
+      # row => state (AL), state fips (01), county fips (001), name (Augtauga County), county gnis (00161526),  class code (H1), status (A)
+      row[3].upcase == param || row[4] == param || row[2] == param || "#{row[1]}#{row[2]}" == param
+    end
+
+    def formatted_county(row)
+      {
+        state_code: row[0],
+        fips: (row[1] + row[2]),
+        gnis: row[4],
+        name: row[3],
+        class_code: row[5],
+        status: row[6]
+      }
+    end
+  end
+end

data/lib/fips_lookup/state.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# State related section of FipsLookup module
+module FipsLookup
+  class << self
+    def state(state_param:, return_nil: false)
+      @state_fips ||= {}
+      @state_fips[state_param] ||= state_lookup(state_param, return_nil)
+    end
+
+    def find_state_code(state_param:, return_nil: false)
+      return state_param.upcase if STATE_CODES.key?(state_param.upcase)
+      return STATE_CODES.key(state_param) if STATE_CODES.value?(state_param)
+
+      state(state_param: state_param, return_nil: return_nil)[:code]
+    end
+
+    def state_file
+      "#{File.expand_path("..", __dir__)}/data/state.csv"
+    end
+
+    private
+
+    def state_lookup(state_param, return_nil = false)
+      upstate_param = state_param.upcase
+      CSV.foreach(state_file) do |state_row|
+        return formatted_state(state_row) if state_match_row?(state_row, upstate_param)
+      end
+      return_nil ? (return {}) : (raise StandardError, "No state found matching: #{state_param}")
+    end
+
+    def state_match_row?(row, param)
+      # row => state fips (01), state code (AL), state name (Alabama), ansi (01779775)
+      row[0] == param || row[1] == param || row[2].upcase == param || row[3] == param
+    end
+
+    def formatted_state(row)
+      {
+        fips: row[0],
+        code: row[1],
+        name: row[2],
+        ansi: row[3]
+      }
+    end
+  end
+end

data/lib/fips_lookup/subdivision.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Subdivision related section of FIPS module
+module FipsLookup
+  class << self
+    def subdivision(state_param:, subdivision_param:, return_nil: false)
+      state_code = find_state_code(state_param: state_param, return_nil: return_nil)
+      return {} if state_code.nil?
+
+      lookup = [state_code, subdivision_param.upcase]
+      @subdivision_fips ||= {}
+      @subdivision_fips[lookup] ||= subdivision_lookup(state_code, subdivision_param, return_nil)
+    end
+
+    def subdivision_file(state_code:)
+      file_path = "#{File.expand_path("..", __dir__)}/data/subdivision/#{state_code}.csv"
+      file_path if File.exist?(file_path)
+    end
+
+    private
+
+    def subdivision_lookup(state_code, subdivision_param, return_nil)
+      upcase_param = subdivision_param.upcase
+      CSV.foreach(subdivision_file(state_code: state_code)) do |subdivision_row|
+        return formatted_subdivision(subdivision_row) if match_subdivision?(subdivision_row, upcase_param)
+      end
+      return_nil ? (return {}) : (raise StandardError, "No subdivision found matching: #{subdivision_param}" unless return_nil)
+    end
+
+    def match_subdivision?(row, param)
+      # row => state_code (AL), state fips (01), county fips (001), county name (Augtauga County)
+      #   row => subdivision name(Autaugaville CCD), class code (Z5), status (S)
+      row[6].upcase == param || row[4] == param || row[5] == param
+    end
+
+    def formatted_subdivision(row)
+      {
+        state_code: row[0],
+        fips: row[1] + row[2] + row[4],
+        county_name: row[3],
+        gnis: row[5],
+        name: row[6],
+        class_code: row[7],
+        status: row[8]
+      }
+    end
+  end
+end

data/lib/fips_lookup/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FipsLookup
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/fips_lookup.rb

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 
-require_relative "fips_lookup/version"
 require "csv"
+require_relative "fips_lookup/version"
+require_relative "fips_lookup/subdivision"
+require_relative "fips_lookup/county"
+require_relative "fips_lookup/state"
 
-# worker for county, state, fips lookups
+# parent section of module defining constants, requiring relative worker methods
 module FipsLookup
   STATE_CODES = { "AL" => "01", "AK" => "02", "AZ" => "04", "AR" => "05", "CA" => "06", "CO" => "08",
                   "CT" => "09", "DE" => "10", "DC" => "11", "FL" => "12", "GA" => "13", "HI" => "15",
@@ -14,78 +17,9 @@ module FipsLookup
                   "OK" => "40", "OR" => "41", "PA" => "42", "RI" => "44", "SC" => "45", "SD" => "46",
                   "TN" => "47", "TX" => "48", "UT" => "49", "VT" => "50", "VA" => "51", "WA" => "53",
                   "WV" => "54", "WI" => "55", "WY" => "56", "AS" => "60", "GU" => "66", "MP" => "69",
-                  "PR" => "72", "UM" => "74", "VI" => "78"
-                }.freeze
+                  "PR" => "72", "UM" => "74", "VI" => "78" }.freeze
 
   class << self
-    attr_accessor :county_fips, :state_fips
-
-    def county(state_param:, county_name:, return_nil: false)
-      state_code = find_state_code(state_param: state_param, return_nil: return_nil)
-      return {} if state_code.nil?
-
-      lookup = [state_code, county_name.upcase]
-      @county_fips ||= {}
-      @county_fips[lookup] ||= county_lookup(state_code, county_name, return_nil)
-    end
-
-    def state(state_param:, return_nil: false)
-      @state_fips ||= {}
-      @state_fips[state_param] ||= state_lookup(state_param, return_nil)
-    end
-
-    def fips_county(fips:, return_nil: false)
-      unless fips.is_a?(String) && fips.length == 5
-        return_nil ? (return nil) : (raise StandardError, "FIPS input must be 5 digit string")
-      end
-
-      state_code = find_state_code(state_param: fips[0..1], return_nil: return_nil)
-      return nil if state_code.nil?
-
-      CSV.foreach(county_file(state_code: state_code)) do |county_row|
-        return [county_row[3], state_code] if county_row[2] == fips[2..4]
-      end
-
-      raise StandardError, "Could not find county with fips: #{fips[2..4]}, in: #{state_code}" unless return_nil
-    end
-
-    def find_state_code(state_param:, return_nil: false)
-      return state_param.upcase if STATE_CODES.key?(state_param.upcase)
-      return STATE_CODES.key(state_param) if STATE_CODES.value?(state_param)
-
-      state(state_param: state_param, return_nil: return_nil)[:code]
-    end
-
-    def county_file(state_code:)
-      file_path = "#{File.expand_path(__dir__)}/data/county/#{state_code}.csv"
-      file_path if File.exist?(file_path)
-    end
-
-    def state_file
-      "#{File.expand_path(__dir__)}/data/state.csv"
-    end
-
-    private
-
-    def county_lookup(state_code, county_name_param, return_nil)
-      CSV.foreach(county_file(state_code: state_code)) do |county_row|
-        # county_row => state_code (AL), state fips (01), county fips (001), name (Augtauga County), class code (H1)
-        if county_row[3].upcase == county_name_param.upcase
-          return {state_code: county_row[0], fips: (county_row[1] + county_row[2]), name: county_row[3], class_code: county_row[4] }
-        end
-      end
-      return_nil ? (return {}) : (raise StandardError, "No county found matching: #{county_name_param}" unless return_nil)
-    end
-
-    def state_lookup(state_param, return_nil = false)
-      CSV.foreach(state_file) do |state_row|
-        # state_row => state fips (01), state code (AL), state name (Alabama), ansi (01779775)
-        if state_row[0] == state_param || state_row[1] == state_param.upcase ||
-           state_row[2].upcase == state_param.upcase || state_row[3] == state_param
-          return { fips: state_row[0], code: state_row[1], name: state_row[2], ansi: state_row[3] }
-        end
-      end
-      return_nil ? (return {}) : (raise StandardError, "No state found matching: #{state_param}")
-    end
+    attr_accessor :county_fips, :state_fips, :subdivision_fips
   end
 end