kittyverse 0.3.0 → 0.4.0

data/lib/kittyverse/{purrstige.rb → config/purrstiges.rb}

@@ -5,7 +5,7 @@
 
 
 ## note: totesbasic has three traits / genes
-TOTESBASIC = ['totesbasic 1', 'totesbasic 2', 'totesbasic 3']    ## was: ['PA14', 'PA15', 'PA23']
+TOTESBASIC = ['Totesbasic 1', 'Totesbasic 2', 'Totesbasic 3']    ## was: ['PA14', 'PA15', 'PA23']
 ANY_TOTESBASIC = ALL_TOTESBASIC = TOTESBASIC
 
 

data/lib/kittyverse/config/traits.rb

@@ -0,0 +1,377 @@
+# encoding: utf-8
+
+###
+#  trais / kaittributes
+#   see https://cryptokittydex.com/kaittributes
+#       https://docs.google.com/spreadsheets/d/1ShiBKSglFAB2vJe4Uow3iF09FBVq6ZAaOzTCIECf4iA
+#       http://www.rolldice.club/cryptokitties/wkt_tree.php
+#       https://www.cryptokitties.co/cattributes (official cattributes list)
+#
+#
+#  for latest updates on new cattributes see:
+#      https://updates.cryptokitties.co   (official latest updates/timeline)
+
+## ordered by gene position (0,1,3.4,5,... etc.)
+##  12 traits (4 genes each)
+TRAITS =
+{
+  body: {
+    genes: '0-3',
+    name:  'Fur',  code: 'FU',
+    kai: {
+    '1' => 'Savannah',
+    '2' => 'Selkirk',
+    '3' => 'Chantilly',
+    '4' => 'Birman',
+    '5' => 'Koladiviya',
+    '6' => 'Bobtail',
+    '7' => 'Manul',
+    '8' => 'Pixiebob',
+    '9' => 'Siberian',
+    'a' => 'Cymric',
+    'b' => 'Chartreux',
+    'c' => 'Himalayan',
+    'd' => 'Munchkin',
+    'e' => 'Sphynx',
+    'f' => 'Ragamuffin',
+    'g' => 'Ragdoll',
+    'h' => 'Norwegianforest',
+    'i' => 'Mekong',
+    'j' => 'Highlander',
+    'k' => 'Balinese',
+    'm' => 'Lynx',
+    'n' => 'Mainecoon',
+    'o' => 'Laperm',
+    'p' => 'Persian',
+    'q' => 'Fox',
+    'r' => 'Kurilian',
+    's' => 'Toyger',
+    't' => 'Manx',
+    'u' => 'Lykoi',
+    'v' => 'Burmilla',
+    'w' => 'Liger',
+    'x' => ''
+    }
+  },
+  pattern: {
+    genes: '4-7',
+    name: 'Pattern', code: 'PA',
+    kai: {
+    '1' => 'Vigilante',
+    '2' => 'Tiger',
+    '3' => 'Rascal',
+    '4' => 'Ganado',
+    '5' => 'Leopard',
+    '6' => 'Camo',
+    '7' => 'Rorschach',
+    '8' => 'Spangled',
+    '9' => 'Calicool',
+    'a' => 'Luckystripe',
+    'b' => 'Amur',
+    'c' => 'Jaguar',
+    'd' => 'Spock',
+    'e' => 'Mittens',
+    'f' => 'Totesbasic 1',   ## use totesbasic_f or totesbasic (14) - why? why not?
+    'g' => 'Totesbasic 2',   ## use totesbasic_g or totesbasic (15)
+    'h' => 'Splat',
+    'i' => 'Thunderstruck',
+    'j' => 'Dippedcone',
+    'k' => 'Highsociety',
+    'm' => 'Tigerpunk',
+    'n' => 'Henna',
+    'o' => 'Arcreactor',
+    'p' => 'Totesbasic 3',   ## use totesbasic_p or totesbasic (23) - why? why not?
+    'q' => 'Scorpius',
+    'r' => 'Razzledazzle',
+    's' => 'Hotrod',
+    't' => 'Allyouneed',
+    'u' => 'Avatar',
+    'v' => 'Gyre',
+    'w' => 'Moonrise',
+    'x' => ''
+    }
+  },
+  coloreyes: {
+    genes: '8-11',
+    name:  'Eye Color', code: 'EC',
+    kai: {
+    '1' => 'Hundergrey',
+    '2' => 'Gold',
+    '3' => 'Topaz',
+    '4' => 'Mintgreen',
+    '5' => 'Isotope',
+    '6' => 'Sizzurp',
+    '7' => 'Chestnut',
+    '8' => 'Strawberry',
+    '9' => 'Sapphire',
+    'a' => 'Forgetmenot',
+    'b' => 'Dahlia',
+    'c' => 'Coralsunrise',
+    'd' => 'Olive',
+    'e' => 'Doridnudibranch',
+    'f' => 'Parakeet',
+    'g' => 'Cyan',
+    'h' => 'Pumpkin',
+    'i' => 'Limegreen',
+    'j' => 'Bridesmaid',
+    'k' => 'Bubblegum',
+    'm' => 'Twilightsparkle',
+    'n' => 'Palejade',
+    'o' => 'Pinefresh',
+    'p' => 'Eclipse',
+    'q' => 'Babypuke',
+    'r' => 'Downbythebay',
+    's' => 'Autumnmoon',
+    't' => 'Oasis',
+    'u' => 'Gemini',
+    'v' => 'Dioscuri',
+    'w' => 'Kaleidoscope',
+    'x' => ''
+    }
+  },
+  eyes: {
+    genes: '12-15',
+    name: 'Eye Shape', code: 'ES',     ##  eye type
+    kai: {
+    '1' => 'Swarley',
+    '2' => 'Wonky',
+    '3' => 'Serpent',
+    '4' => 'Googly',
+    '5' => 'Otaku',
+    '6' => 'Simple',
+    '7' => 'Crazy',
+    '8' => 'Thicccbrowz',
+    '9' => 'Caffeine',
+    'a' => 'Wowza',
+    'b' => 'Baddate',
+    'c' => 'Asif',
+    'd' => 'Chronic',
+    'e' => 'Slyboots',
+    'f' => 'Wiley',
+    'g' => 'Stunned',
+    'h' => 'Chameleon',
+    'i' => 'Alien',
+    'j' => 'Fabulous',
+    'k' => 'Raisedbrow',
+    'm' => 'Tendertears',
+    'n' => 'Hacker',
+    'o' => 'Sass',
+    'p' => 'Sweetmeloncakes',
+    'q' => 'Oceanid',
+    'r' => 'Wingtips',
+    's' => 'Firedup',
+    't' => 'Buzzed',
+    'u' => 'Bornwithit',
+    'v' => 'Candyshoppe',
+    'w' => 'Drama',
+    'x' => ''
+    }
+  },
+  colorprimary: {
+    genes: '16-19',
+    name: 'Base Color', code: 'BC',   ##  color1 / colorprimary / body color
+    kai: {
+    '1' => 'Shadowgrey',
+    '2' => 'Salmon',
+    '3' => 'Meowgarine',
+    '4' => 'Orangesoda',
+    '5' => 'Cottoncandy',
+    '6' => 'Mauveover',
+    '7' => 'Aquamarine',
+    '8' => 'Nachocheez',
+    '9' => 'Harbourfog',
+    'a' => 'Cinderella',
+    'b' => 'Greymatter',
+    'c' => 'Tundra',
+    'd' => 'Brownies',
+    'e' => 'Dragonfruit',
+    'f' => 'Hintomint',
+    'g' => 'Bananacream',
+    'h' => 'Cloudwhite',
+    'i' => 'Cornflower',
+    'j' => 'Oldlace',
+    'k' => 'Koala',
+    'm' => 'Lavender',
+    'n' => 'Glacier',
+    'o' => 'Redvelvet',
+    'p' => 'Verdigris',
+    'q' => 'Icicle',
+    'r' => 'Onyx',
+    's' => 'Hyacinth',
+    't' => 'Martian',
+    'u' => 'Hotcocoa',
+    'v' => 'Shamrock',
+    'w' => 'Firstblush',
+    'x' => ''
+    }
+  },
+  colorsecondary: {
+    genes: '20-23',
+    name:  'Highlight Color', code: 'HC',    ## color2 / colorsecondary / sec color / pattern color
+    kai: {
+    '1' => 'Cyborg',
+    '2' => 'Springcrocus',
+    '3' => 'Egyptiankohl',
+    '4' => 'Poisonberry',
+    '5' => 'Lilac',
+    '6' => 'Apricot',
+    '7' => 'Royalpurple',
+    '8' => 'Padparadscha',
+    '9' => 'Swampgreen',
+    'a' => 'Violet',
+    'b' => 'Scarlet',
+    'c' => 'Barkbrown',
+    'd' => 'Coffee',
+    'e' => 'Lemonade',
+    'f' => 'Chocolate',
+    'g' => 'Butterscotch',
+    'h' => 'Ooze',
+    'i' => 'Safetyvest',
+    'j' => 'Turtleback',
+    'k' => 'Rosequartz',
+    'm' => 'Wolfgrey',
+    'n' => 'Cerulian',
+    'o' => 'Skyblue',
+    'p' => 'Garnet',
+    'q' => 'Peppermint',
+    'r' => 'Universe',
+    's' => 'Royalblue',
+    't' => 'Mertail',
+    'u' => 'Inflatablepool',
+    'v' => 'Pearl',
+    'w' => 'Prairierose',
+    'x' => ''
+    }
+  },
+  colortertiary: {
+    genes: '24-27',
+    name: 'Accent Color', code: 'AC',   ## color3 / colortertiary
+    kai: {
+    '1' => 'Belleblue',
+    '2' => 'Sandalwood',
+    '3' => 'Peach',
+    '4' => 'Icy',
+    '5' => 'Granitegrey',
+    '6' => 'Cashewmilk',
+    '7' => 'Kittencream',
+    '8' => 'Emeraldgreen',
+    '9' => 'Kalahari',
+    'a' => 'Shale',
+    'b' => 'Purplehaze',
+    'c' => 'Hanauma',
+    'd' => 'Azaleablush',
+    'e' => 'Missmuffett',
+    'f' => 'Morningglory',
+    'g' => 'Frosting',
+    'h' => 'Daffodil',
+    'i' => 'Flamingo',
+    'j' => 'Buttercup',
+    'k' => 'Bloodred',
+    'm' => 'Atlantis',
+    'n' => 'Summerbonnet',
+    'o' => 'Periwinkle',
+    'p' => 'Patrickstarfish',
+    'q' => 'Seafoam',
+    'r' => 'Cobalt',
+    's' => 'Mallowflower',
+    't' => 'Mintmacaron',
+    'u' => 'Sully',
+    'v' => 'Fallspice',
+    'w' => 'Dreamboat',
+    'x' => ''
+    }
+  },
+  wild: {
+    genes: '28-31',
+    name: 'Wild Element', code: 'WE',
+    kai: {
+    'h' => 'Littlefoot',
+    'i' => 'Elk',
+    'j' => 'Ducky',
+    'k' => 'Trioculus',
+    'm' => 'Daemonwings',
+    'n' => 'Featherbrain',
+    'o' => 'Flapflap',
+    'p' => 'Daemonhorns',
+    'q' => 'Dragontail',
+    'r' => 'Aflutter',
+    's' => 'Foghornpawhorn',
+    't' => 'Unicorn',
+    'u' => 'Dragonwings',
+    'v' => 'Alicorn',
+    'w' => 'Wyrm',
+    'x' => ''
+    }
+  },
+  mouth: {
+    genes: '32-35',
+    name:  'Mouth', code: 'MO',
+    kai: {
+    '1' => 'Whixtensions',
+    '2' => 'Wasntme',
+    '3' => 'Wuvme',
+    '4' => 'Gerbil',
+    '5' => 'Confuzzled',
+    '6' => 'Impish',
+    '7' => 'Belch',
+    '8' => 'Rollercoaster',
+    '9' => 'Beard',
+    'a' => 'Pouty',
+    'b' => 'Saycheese',
+    'c' => 'Grim',
+    'd' => 'Fangtastic',
+    'e' => 'Moue',
+    'f' => 'Happygokitty',
+    'g' => 'Soserious',
+    'h' => 'Cheeky',
+    'i' => 'Starstruck',
+    'j' => 'Samwise',
+    'k' => 'Ruhroh',
+    'm' => 'Dali',
+    'n' => 'Grimace',
+    'o' => 'Majestic',
+    'p' => 'Tongue',
+    'q' => 'Yokel',
+    'r' => 'Topoftheworld',
+    's' => 'Neckbeard',
+    't' => 'Satiated',
+    'u' => 'Walrus',
+    'v' => 'Struck',
+    'w' => 'Delite',
+    'x' => ''
+   }
+  },
+  environment: {
+      genes: '36-39',
+      name: 'Environment', code: 'EN',
+      kai: {
+        'h' => 'Salty',
+        'i' => 'Dune',
+        'j' => 'Juju',
+        'k' => 'Tinybox',
+        'm' => 'Myparade',
+        'n' => 'Finalfrontier',
+        'o' => 'Metime',
+        'p' => 'Drift',
+        'q' => 'Secretgarden',
+        'r' => 'Frozen',
+        's' => 'Roadtogold',
+        't' => 'Jacked',
+        'u' => 'Floorislava',
+        'v' => 'Prism',
+        'w' => 'Junglebook',
+        'x' => ''
+      }
+  },
+  secret: {
+      genes: '40-43',
+      name: 'Secret Y Gene', code: 'SE',   ## todo: change to Y Gene or Y (see https://guide.cryptokitties.co/guide/cat-features/genes)
+      kai: { }
+  },
+  prestige: {
+      genes: '44-47',
+      name: 'Purrstige', code: 'PU',
+      kai: { }
+      ##  prune, furball, duckduckcat, or thatsawrap - more like fancies (not really traits)
+  }
+}

data/lib/kittyverse/fancies.rb

@@ -1,550 +1,158 @@
-# encoding: utf-8
-
-###
-#
-#  for latest updates on new fancies/exclusives see:
-#      https://updates.cryptokitties.co   (official latest updates/timeline)
-#
-#  or see
-#      https://blog.kotobaza.co/timeline/
-
-
-##
-## todo/fix:
-##    use count:   for time-limited fancies  do NOT use limit!!!  change limit to count!!!
-
-##
-## note:
-##  for time limits for fancies use:
-##     e.g. time: { end: '2018-12-07' }   # until dec/7
-##
-##  for overflows for limited edition use:
-##     e.g. overflow: 1      #   888+1  (=889)
-
-
-### todo/fix:
-##    split into EXCLUSIVES
-##       and into SPECIAL_EDITIONS   (SPECIALS?)  - why? why not?
-
-
-
-FANCIES =
-{
-  # Apr 27, 2019
-  # Krakitten Fancy Cat is discovered. Fancy Cat
-  krakitten: { name: 'Krakitten',
-               recipe: {
-                 time: { start: '2019-04-27', end: '2019-05-06' },
-                 traits: ['cobalt', 'ducky', 'salty', 'splat']}
-             },
-  # Apr 13, 2019
-  # Furbeard Fancy Cat is discovered. Fancy Cat
-  furbeard: { name: 'Furbeard', date: '2019-04-13',
-              recipe: {
-                limit: 3733,  ### todo -check if furbear was time windowed???
-                traits: ['inflatablepool', 'hanauma', 'neckbeard']}
-            },
-
-  # Apr 10, 2019
-  # Sparkles Special Edition Cat is released.Special Edition Cat
-  sparkles: { name: 'Sparkles', date: '2019-04-10',
-              specialedition: {
-                limit: 100 },
-              desc: 'Freebie for CryptoKitties Community Events'
-            },
-
-  papacatuanuku: { name: 'Papacatuanuku', date: '2019-03-31',
-                   exclusive: {
-                     limit: 1, ids: [1500000] },
-                   desc: 'Kitty #1500000'
-                 },
-
-  # Mar 30, 2019
-  # Glitter Fancy Cat is discovered. Fancy Cat
-  glitter: { name: 'Glitter',
-             recipe: {
-               time: { start: '2019-03-30', end: '2019-11-30'},
-               traits: ['rorschach', 'juju', 'unicorn', 'hyacinth'] }
-           },
-
-
-  # Mar 26, 2019
-  # Sir Meowsalot Exclusive Cat is released. Exclusive Cat
-  sirmeowsalot: { name: 'Sir Meowsalot', date: '2019-03-26',
-                  exclusive: {
-                    limit: 21, ids: (201..221).to_a }
-                },
-
-  # Mar 16, 2019
-  # Clover Fancy Cat is discovered. Fancy Cat
-  clover: { name: 'Clover', date: '2019-03-16',
-            recipe: {
-              limit: 2506,
-              traits: ['shamrock', 'emeraldgreen', 'roadtogold', 'PU27'] },
-            desc: "Celebrating St. Patrick's Day 2019 (March/19th)"
-          },
-
-  # Mar 2, 2019
-  # Glasswalker Fancy Cat is discovered. Fancy Cat
-  glasswalker: { name: 'Glasswalker', date: '2019-03-02',
-                 recipe: {
-                   limit: 1230,
-                   traits: ['cloudwhite', 'henna', 'pearl', 'firedup'] },
-                 desc: "Ninja Fancy Cat"
-                },
-
-  cyberberry: { name: 'Cyber Berry', date: '2019-03-02',
-                exclusive: {
-                  limit: 1, ids: [282] },
-                desc: "Winner of the NFTme Sweetstakes"
-              },
-
-  # Mar 1, 2019
-  # Hinecatone Exclusive Cat is discovered. Exclusive Cat
-  hinecatone: { name: 'Hinecatone', date: '2019-03-01',
-                exclusive: {
-                  limit: 15, ids: [1423547, 1433380, 1433486, 1440835, 1453366, 1456935, 1456973, 1459319, 1463197, 1466118, 1474082, 1484593, 1484982, 1492154, 1498885]}
-              },
-
-
-  # Feb 21, 2019
-  # Ande Fancy Cat is discovered. Fancy Cat
-  ande: { name: 'Ande', date: '2019-02-21',
-          recipe: {
-            limit: 440,
-            traits: ['munchkin', 'cashewmilk', 'moue', 'PU30', 'WE10'] }
-        },
-  # Feb 17, 2019
-  # Al Fancy Cat is discovered. Fancy Cat
-  al: { name: 'Al',
-        recipe: {
-          time: { start: '2019-02-17', end: '2019-12-01'},
-          traits: ['munchkin','moue','cashewmilk','brownies'] }
-      },
-  # Feb 16, 2019
-  # Pizzazz Fancy Cat is discovered.Fancy Cat
-  pizzazz: { name: 'Pizzazz',
-             recipe: {
-               time: { start: '2019-02-16', end: '2019-12-01'},
-               traits: ['mekong', 'scarlet', 'spangled', 'wonky'] }
-           },
-
-  # Feb 15, 2019
-  # Felono Exclusive Cat is discovered. Exclusive Cat
-  felono: { name: 'Felono', date: '2019-02-15',
-            exclusive: {
-              limit: 30, ids: [1394641, 1404595, 1406021, 1413065, 1414375, 1420553, 1421315, 1421864, 1424104 ,1425433, 1431823, 1435517, 1436333, 1449860, 1451482, 1455458, 1459320, 1462952, 1463069, 1476999, 1483225, 1487210, 1487551, 1489681, 1490345, 1491632, 1492206, 1492739, 1492817, 1498778]}
-          },
-
-  # Feb 9, 2019
-  # Miss Purrfect Fancy Cat is discovered.Fancy Cat
-  misspurrfect: { name: 'Miss Purrfect', date: '2019-02-09',
-                  recipe: {
-                    limit: 1298,
-                    traits: ['allyouneed', 'butterscotch', 'asif', 'satiated', 'flapflap']},
-                  desc: "Celebrating St. Valentine's Day 2019 (Feb/14th)"
-                },
-
-  ## 2019
-  ## January
-
-  # Jan 26, 2019
-  # Squib Fancy Cat is discovered. Fancy Cat
-  squib: { name: 'Squib', date: '2019-01-26',
-           recipe: {
-             limit: 1443,
-             traits: ['oldlace', 'razzledazzle', 'buzzed', 'rollercoaster']},
-           desc: 'Celebrating American Football Super Bowl LIII in 2019'
-         },
-
-  tallythepurrocious: { name: 'Tally The Purrocious',
-                        recipe: {
-                          time: { start: '2019-01-10', end: '2019-01-21' }, count: 3992,
-                          traits: ['selkirk', 'koala', 'arcreactor', 'sully'] },
-                        desc: 'Gods Unchained Promotion - Mystical Cat Talisman'
-                      },
-  ## date: '2019-01-10 ???  -- use for date "announced" or something - why? why not?
-  aeoncat: { name: 'Aeoncat',
-              specialedition: {
-                time: { start: '2019-01-17', end: '2019-01-28' },
-                limit: 380 },    ## Don't sleep - there's only 380 up for grabs!
-              desc: 'Goddess Aeona - Goddess of Nature - Gods Unchained Promotion'
-           },
-  hypurrion: { name: 'Hypurrion', date: '2019-01-10',
-               exclusive: {
-                 limit: 1, ids: [269]},
-               desc: 'Hyperion - Mythic Titan of Light - Gods Unchained Promotion'
-             },
-
-  ## 2018
-  ## December
-  catzy: { name: 'Catzy', date: '2018-12-31',
-           specialedition: {
-             limit: 10, ids: (1137653..1137662).to_a },
-           desc: 'Changpeng "CZ" Zhao - CEO of Binance - Top 10 Blockchain Influencer of the Year 2018 by CoinDesk'
-         },
-  purremyallaire: { name: 'Purremy Allaire', date: '2018-12-31',
-                    specialedition: {
-                      limit: 10, ids: (1137663..1137672).to_a },
-                    desc: 'Jeremy Allaire - Top 10 Blockchain Influencer of the Year 2018 by CoinDesk'
-                  },
-  genedough: { name: 'Gene Dough',
-               recipe: {
-                 time: { start: '2018-12-23', end: '2019-01-07' }, count: 1376,
-                 traits: ['hotcocoa', 'mittens', 'frosting'] }
-            },
-  pawrula:  { name: 'Pawrula the Bright',
-              recipe: {
-                 time: { start: '2018-12-15', end: '2019-11-30' },
-                 traits: ['camo', 'butterscotch', 'fox'] },
-              desc: 'Neha Narula - Director of the Digital Currency Initiative at the MIT Media Lab'
-            },
-
-  ## November
-  draco:                { name: 'Draco',
-                          recipe: {
-                            time: { start: '2018-11-30', end: '2018-12-07' }, count: 1115,
-                            traits: ['toyger', 'martian', 'peppermint', 'dragonwings', 'SE03'] }
-                        },
-  dracothemagnificent:  { name: 'Draco The Magnificent', date: '2018-11-27',
-                          exclusive: {
-                            limit: 12, ids:	(270..281).to_a }
-                        },
-  bugcatv2:             { name: 'Bug Cat V2', date: '2018-11-27',
-                          exclusive: {
-                            limit: 20, ids: (167..186).to_a },
-                          desc: 'Bug Bounty II (Offers Contract) Kitty'
-                        },
-  dracojunior: { name: 'Draco Junior',
-                 recipe: {
-                   time: { start: '2018-11-26', end: '2018-12-07' }, count: 1398,
-                   traits: ['lynx', 'verdigris', 'dragontail', 'SE03']}
-               },
-  dreggo:      { name: 'Dreggo',
-                 recipe: {
-                   time: { start: '2018-11-21', end: '2018-12-07' }, count: 3624,
-                   traits: ['siberian', 'bananacream', 'SE03'] }
-               },
-  pickles:     { name: 'Pickles', date: '2018-11-14',
-                 recipe: {
-                   limit: 303,
-                   traits: ['lynx', 'martian', 'highsociety', 'emeraldgreen']}
-               },
-  lilbub:      { name: 'Lil Bub Ub Bub (BUB)', date: '2018-11-13',
-                 specialedition: {
-                   limit: 468 }
-               },
-
-  lilbubthemagicalspacecat: { name: 'Lil Bub Ub Bub (BUB) The Magical Space Cat', date: '2018-11-13',
-                              exclusive: {
-                                limit: 3, ids: [266,267,268]}
-                            },
-
-  ## October
-  dukecat:       { name: 'Dukecat', date: '2018-10-18',
-                   recipe: {
-                     limit: 1366,
-                     traits: ['cymric', 'periwinkle', 'simple', 'tongue']}
-                 },
-  sheilapurren:  { name: 'Sheila Purren', date: '2018-10-04',
-                   recipe: {
-                     limit: 1971,
-                     traits: ['mauveover', 'icy', 'wingtips', 'fangtastic']},
-                   desc: 'Sheila Warren Kitty-fied - Head of Blockchain and Distributed Ledger Technology at the World Economic Forum (WEF)'
-                 },
-
-  ## September
-  pawzilla: { name: 'Pawzilla', date: '2018-09-22',
-              recipe: {
-                limit: 1185,
-                traits: ['jaguar', 'universe', 'atlantis', 'littlefoot']}
-            },
-  vulcat:   { name: 'Vulcat', date: '2018-09-12',
-              exclusive: {
-                limit: 1, ids: [1000000] },
-              desc: '1 000 000th Kitty'
-            },
-  meowstro: { name: 'Meowstro', date: '2018-09-09',
-              recipe: {
-                limit: 1698,
-                traits: ['onyx', 'wowza', 'eclipse']}
-            },
-  atlas:    { name: 'Atlas', date: '2018-09-07',
-              recipe: {
-                limit: 998,
-                traits: ['highlander', 'kittencream', 'swarley', 'topoftheworld']}
-            },
-
-  ## August
-  vulcant:        { name: 'Vulcant', date: '2018-08-31',
-                    exclusive: {
-                      limit: 20, ids: [932914,937360,938299,946526,948925,949058,950617,952280,952981,956374,956908,958570,964205,967234,983046,984451,990713,992861,995745,997469] }
-                  },
-  purrity:        { name: 'Purrity', date: '2018-08-23',
-                    recipe: {
-                      limit: 5984,
-                      traits: ['selkirk', 'chronic', 'cloudwhite', 'cheeky'] }
-                  },
-  rabbidkitty:    { name: 'Rabbid Kitty', date: '2018-08-23',
-                    exclusive: {
-                       limit: 6, ids: (260..265).to_a },
-                    desc: 'Ubisoft Blockchain Heroes Hackathon'
-                  },
-  squiddlesworth: { name: 'Squiddlesworth', date: '2018-08-16',
-                    recipe: {
-                      limit: 1510,
-                      traits: ['sphynx', 'redvelvet', 'patrickstarfish', 'dragontail'] },
-                    desc: 'Lava Squid Cat'
-                   },
-
-  ## July
-  purrspero:      { name: 'Purrspero', date: '2018-07-27',
-                    recipe: {
-                      limit: 4448,
-                      traits: ['dippedcone', 'googly', 'royalpurple', 'beard']}
-                  },
-  catbury:        { name: 'Catbury', date: '2018-07-25',
-                    recipe: {
-                      limit: 76,
-                      traits: ['ragdoll', 'crazy', 'chocolate', 'mintmacaron', 'yokel', 'WE02']}
-                  },
-  honu:           { name: 'Honu', date: '2018-07-20',
-                    exclusive: {
-                      limit: 1, ids: [251] },
-                    desc: 'Kitties for Good - Save Turtle Habitats'
-                  },
-  victoire:       { name: 'Victoire', date: '2018-07-18',
-                    exclusive: {
-                      limit: 1, ids: [402] },
-                    desc: 'France Football World Cup Champion'
-                  },
-  lulu:           { name: 'Lulu', date: '2018-07-13',
-                    recipe: {
-                      limit: 999,
-                      traits: ['cyan', 'verdigris', 'turtleback', 'salty']}
-                  },
-  boot:           { name: 'Boot', date: '2018-07-05',
-                    recipe: {
-                      limit: 1440,
-                      traits: ['ganado', 'wiley', 'cerulian', 'rollercoaster'],
-                      variants: {
-                        belgium: { name: 'Belgium', count: 97,   traits: [['orangesoda','onyx']]},                    ## Base Color: Orangesoda / Onyx
-                        brazil:  { name: 'Brazil',  count: 195,  traits: [['hintomint','bananacream','verdigris']]},  ## Base Color: Hintomint / Bananacream / Verdigris
-                        croatia: { name: 'Croatia', count: 253,  traits: [['cottoncandy','mauveover','oldlace']]},    ## Base Color: Cottoncandy / Mauveover / Oldlace
-                        england: { name: 'England', count: 168,  traits: [['greymatter','martian']]},                 ## Base Color: Greymatter / Martian
-                        france:  { name: 'France',  count: 317,  traits: [['harbourfog','cinderella','lavender']]},   ## Base Color: Harbourfog / Cinderella / Lavender
-                        russia:  { name: 'Russia',  count: 94,   traits: [['shadowgrey','salmon','cloudwhite']]},     ## Base Color: Shadowgrey / Salmon/ Cloudwhite
-                        sweden:  { name: 'Sweden',  count: 123,  traits: [['brownies','dragonfruit','redvelvet']]},   ## Base Color: Brownies / Dragonfruit / Redvelvet
-                        uruguay: { name: 'Uruguay', count: 193,  traits: [['aquamarine','nachocheez','koala']]},      ## Base Color: Aquamarine / Nachocheez / Koala
-                      }},
-                    desc: 'Football World Cup',
-                  },
-  ## note: boot - different variants for world cup teams
-  ##  Although there are 8 unique Fancies, they're actually each a variant on the same Fancy - Boot.
-  ##  Their colours are different, and you can collect all 8 as a set
-
-  ## June
-  raspoutine:    { name: 'Raspoutine', date: '2018-06-28',
-                   recipe: {
-                     limit: 1867,
-                     traits: ['buzzed', 'nachocheez', 'sandalwood', 'belch']}
-                },
-  furlin:        { name: 'Furlin', date: '2018-06-26',
-                   exclusive: {
-                     limit: 52, ids: (115..126).to_a + (128..166).to_a }
-                 },
-  kittypride:    { name: 'Kitty Pride', date: '2018-06-21',
-                   recipe: {
-                     limit: 1316,
-                     traits: ['fabulous','cinderella','garnet']}
-                 },
-  furrmingo:     { name: 'Furrmingo', date: '2018-06-14',
-                   recipe: {
-                     limit: 333,
-                     traits: ['bobtail', 'egyptiankohl', 'flamingo', 'whixtensions']}
-                },
-
-  ## May
-  page:              { name: 'Page', date: '2018-05-31',
-                       recipe: {
-                         limit: 50_000,
-                         traits: ['rascal', 'peach', 'wasntme' ]}
-                     },
-  "schrödingerscat": { name: "Schrödinger's Cat", date: '2018-05-20',
-                       recipe: {
-                         limit: 73,
-                         traits: ['forgetmenot','tinybox','PU20','SE25']}
-                     },
-  chatplongeur:      { name: 'Chat Plongeur', date: '2018-05-19',
-                       recipe: {
-                         limit: 1910,
-                         traits: ['aquamarine', 'skyblue', 'seafoam'] }
-                     },
-  docpurr:             { name: 'Doc Purr', date: '2018-05-16',
-                         recipe: {
-                           limit: 250,
-                           traits: ['persian','spock','raisedbrow','violet','tongue'] }
-                       },
-  celestialcyberdimension: { name: 'Celestial Cyber Dimension', date: '2018-05-12',
-                             exclusive: {
-                               limit: 1, ids: [127] }
-                           },
-  swish:               { name: 'Swish', date: '2018-05-08',
-                         recipe: {
-                           limit: 2880,
-                           traits: ['norwegianforest', 'luckystripe', 'thicccbrowz', 'orangesoda'] }
-                       },
-
-  ## April
-  flutterbee:  { name: 'Flutterbee', date: '2018-04-28',
-                 recipe: {
-                   limit: 275,
-                   traits: ['cloudwhite','jaguar','lemonade','azaleablush','WE14'] }
-               },
-  vernon:      { name: 'Vernon', date: '2018-04-16',
-                 recipe: {
-                   limit: 320,
-                   traits: ['amur','fabulous','cottoncandy','springcrocus','belleblue','soserious']},
-                 desc: 'Spring Equinox Kitty'  ## first, see https://www.cryptokitties.co/kitty/696398
-                },
-
-  ## March
-  berry:           { name: 'Berry', date: '2018-03-16',
-                     recipe: {
-                       limit: 200,
-                       traits: ['dragonfruit','thunderstruck','emeraldgreen','apricot','simple'] }
-                   },
-  pussforprogress: { name: 'Puss For Progress', date: '2018-03-08',
-                     recipe: {
-                       limit: 1920,
-                       traits: ['himalayan','peach','safetyvest','gerbil'] },
-                     desc: "Women's Day"
-                   },
-  fortunecat:      { name: 'Fortune Cat', name_cn: '红包喵', date: '2018-03-08',
-                     recipe: {
-                       limit: 888,
-                       traits: ['harbourfog','calicool','swampgreen','sapphire','beard']}
-                    },  ## todo: check date for china launch specials!!!
-  goldendragoncat: { name: 'Golden Dragon Cat', name_cn: '帝龙喵', date: '2018-03-08',
-                     exclusive: {
-                       limit: 1, ids: [888] },
-                     desc: 'China Launch'
-                   }, ## todo: check date for china launch specials!!!
-  goldendogcat:    { name: 'Golden Dog Cat', name_cn: '旺财汪', date: '2018-03-08',
-                     exclusive: {
-                       limit: 11, ids: [1802,1803,1805,1806,1808,1809,1812,1816]+(1825..1828).to_a },
-                     desc: 'China Launch'
-                   },  ## todo: check date for china launch specials!!!
-  liondance:    { name: 'Lion Dance', name_cn: '咚咚锵', date: '2018-03-07',
-                  recipe: {
-                    limit: 888, overflow: 1,  ## use count 889 ?? - why? why not?
-                    traits: ['manx','royalblue','googly','starstruck']}
-                },
-  dogcat:       { name: 'Dog Cat',    name_cn: '汪星爷', date: '2018-03-02',
-                  recipe: {
-                    limit: 88,
-                    traits: ['tigerpunk','periwinkle','barkbrown','sweetmeloncakes','yokel']},
-                  desc: 'Year of the Dog (Greater China)'
-                },
-  knightkitty:  { name: 'Knight Kitty',  date: '2018-03-01',
-                  exclusive: {
-                    limit: 11, ids: (104..114).to_a }
-                },
-
-  ## February
-  tabby:           { name: 'Tabby', date: '2018-02-26',
-                     recipe: {
-                       limit: 250,
-                       traits: ['ragamuffin','morningglory','otaku','cheeky'] }
-                   },
-  yuricatsuki:     { name: 'Yuri Catsuki',  date: '2018-02-20',
-                     recipe: {
-                       limit: 250,
-                       traits: ['cymric','tiger','neckbeard','elk'] },
-                     desc: 'Figure Scating Kitty - Winter Olympics (Korea)'
-                  },
-  misterpurrfect:  { name: 'Mister Purrfect', date: '2018-02-14',
-                     recipe: {
-                       limit: 1000,
-                       traits: ['chocolate','baddate','strawberry','wuvme'] },
-                     desc: "Valentine's Day"
-                   },
-  earnie:          { name: 'Earnie', date: '2018-02-13',
-                     recipe: {
-                       limit: 500,
-                       traits: ['birman','orangesoda','hotrod','grim'] },
-                     desc: 'Earn.com - Golden Kitty Award (Product Hunt)'
-                   },
-  cathena:         { name: 'Cathena',  date: '2018-02-06',
-                     exclusive: {
-                       limit: 1, ids: [500000] },
-                     desc: '500 000th Kitty'
-                   },
-
-  ## January
-  'momo-chan':     { name: 'Momo-chan', date: '2018-01-31',
-                     recipe: {
-                       limit: 500,
-                       traits: ['onyx','henna','bloodred','wolfgrey','sass'] },
-                      desc: 'Ninja Kitty'
-                   },
-  negato:          { name: 'Negato', date: '2018-01-29',
-                     recipe: {
-                       limit: 500,
-                       traits: ['onyx','henna','wolfgrey','slyboots'] },
-                     desc: 'Ninja Kitty'
-                   },
-  stitches:        { name: 'Stitches', date: '2018-01-10',
-                     recipe: {
-                       limit: 500,
-                       traits: ['hintomint','seafoam','swampgreen','saycheese'] },
-                     desc: 'Zombie Kitty'
-                   },
-
-  ## 2017
-  ## December
-  phuziqaat:    { name: 'Phu Ziqaat', date: '2017-12-31',
-                  recipe: {
-                    limit: 1000,
-                    traits: ['chartreux','spock','alien','pouty'] },
-                  desc: 'Alien Kitty'
-                },
-  santaclaws:   { name: 'Santa Claws', date: '2017-12-12',
-                  recipe: {
-                    limit: 1000, overflow: 2,
-                    traits: ['cloudwhite','scarlet','beard','wild_d'] },
-                  desc: 'Ho Ho Ho - Santa Claus Kitty'
-                },
-  mistletoe:    { name: 'Mistletoe', date: '2017-12-09',
-                  recipe: {
-                    limit: 2000,
-                    traits: ['oldlace','crazy','gerbil'] },
-                  desc: "XMas Kitty"
-                },
-  dracula:      { name: 'Dracula', date: '2017-12-01',
-                  recipe: {
-                    limit: 2000,
-                    traits: ['laperm','spock','strawberry','WE01'] }
-                },
-
-  ## November
-  ducat:        { name: 'Du Cat', date: '2017-11-29',
-                  recipe: {
-                    limit: 10_000,
-                    traits: ['cymric','tongue']}
-                },
-  genesis:      { name: 'Genesis', date: '2017-11-24',
-                  exclusive: {
-                    limit: 1, ids: [1] },
-                  desc: '1st Kitty'
-                },
-  shipcat:      { name: 'Ship Cat', date: '2017-11-23',
-                  recipe: {
-                    limit: 2000,
-                    traits: ['sphynx','orangesoda','luckystripe','crazy']}
-                },
-  bugcat:       { name: 'Bug Cat', date: '2017-11-23',
-                  exclusive: {
-                    limit: 3, ids: [101,102,103] },
-                  desc: 'Bug Bounty Kitty' }
-}
+# encoding: utf-8
+
+
+class Fancy
+
+  def self.special_editions()  @@special_editions  ||= []; end  # special edition fancies
+  def self.exclusives()        @@exclusives        ||= []; end  # exclusive fancies
+  def self.fancies()           @@fancies           ||= []; end  # "normal" fancies
+
+
+
+  def self.fancies_by_key()  @@fancies_by_key  ||= {}; end
+  def self.fancies_by_name() @@fancies_by_name ||= {}; end
+
+  def self.find_by_key( key )
+    ## note: use (always) a **symbol** for key lookup for now
+    @@fancies_by_key[ key.downcase.to_sym ]
+  end
+
+  def self.find_by_name( name )
+    ## note: allow string AND symbols (thus, use .to_s !!!)
+    ##       allow spaces e.g. Bug Cat is the same as BugCat
+    ## note: downcase name e.g. allow BugCat too (not just Bug Cat)
+    @@fancies_by_name[ name.gsub( / /, '' ).downcase.to_s ]
+  end
+
+  ## add "generic" convenience find helper
+  def self.find_by( **kwargs )
+    if kwargs[ :key ]
+       find_by_key( kwargs[ :key ] )
+    elsif kwargs[ :name ]
+      find_by_name( kwargs[ :name] )
+    else
+      ## todo/fix: throw argument except!!!
+      nil
+    end
+  end
+
+  def self.[]( key )
+    if key.is_a? Symbol    ## e.g. :genesis, :bugcat, etc.
+        f = find_by_key( key )
+        f = find_by_name( key )   if f.nil?  ## try fancy name next - why? why not?
+        f
+    else ## assume string
+        f = find_by_name( key )   ## search by key next - why? why not?
+        f
+    end
+  end
+
+
+  def self.each
+    @@fancies_by_key.each do |(key,fancy)|
+      yield( fancy )
+    end
+  end
+
+  def self.size() @@fancies_by_key.size; end  ## todo: add length alias too? why? why not?
+
+
+
+
+
+  attr_accessor :key,
+                :name,
+                :name_cn,
+                :date,
+                :desc,
+                :exclusive,
+                :specialedition,
+                :recipe,
+                :count,
+                :limit,
+                :ids
+
+  def initialize( **kwargs )
+    update( kwargs )
+  end
+
+  def update( **kwargs )
+    kwargs.each do |name,value|
+      send( "#{name}=", value ) ## use "regular" plain/classic attribute setter
+    end
+    self   ## return self for chaining
+  end
+
+  def exclusive?()        @exclusive.nil? == false; end
+  def specialedition?()   @specialedition.nil? == false; end
+  alias_method :special_edition?, :specialedition?
+  def recipe?()           @recipe.nil? == false; end
+
+
+
+  ## auto-fill
+  FANCIES.each do |key,h|
+
+    date_str = h[:date]
+    date_str = h[:recipe][:time][:start]         if date_str.nil? && h[:recipe]
+    date_str = h[:specialedition][:time][:start] if date_str.nil? && h[:specialedition]
+
+    date = Date.strptime( date_str, '%Y-%m-%d' )
+
+
+    name =    h[:name]
+    name_cn = h[:name_cn]   # add chinese name if present
+    desc    = h[:desc]
+
+    exclusive      = h[:exclusive]
+    specialedition = h[:specialedition]
+    recipe         = h[:recipe]
+
+    attribs = {
+      key:       key,
+      date:      date,
+      name:      name,
+      name_cn:   name_cn,
+      desc:      desc,
+      exclusive: exclusive,
+      specialedition: specialedition,
+      recipe:    recipe,
+    }
+
+
+    ## todo: check for overflow  - if overflow use limit+overflow = count
+    ##   add traits and time windows
+    if exclusive
+      attribs = attribs.merge( limit: h[:exclusive][:limit],
+                               count: h[:exclusive][:count],
+                               ids:   h[:exclusive][:ids] )
+    elsif specialedition
+      attribs = attribs.merge( limit: h[:specialedition][:limit],
+                               count: h[:specialedition][:count] )
+    else  ## assume "normal/regular" fancy with recipes
+      attribs = attribs.merge( limit: h[:recipe][:limit],
+                               count: h[:recipe][:count] )
+    end
+
+
+    fancy = Fancy.new( **attribs )
+    pp fancy
+
+    if fancy.exclusive?
+      exclusives << fancy
+    elsif fancy.special_edition?
+      special_editions << fancy
+    else  ## assume "normal/regular" fancy (with recipe)
+      fancies << fancy
+    end
+
+
+    ## note: key MUST be a symbol (NOT a string)
+    fancies_by_key[key] = fancy
+
+    ## note: downcase name and remove all spaces e.g. Bug Cat => bugcat
+    fancies_by_name[name.gsub( / /, '' ).downcase] = fancy
+    fancies_by_name[name_cn] = fancy if name_cn   ## add chinese name too if present
+  end
+
+end # class Fancy