yellow-brick-road 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.rst +148 -0
- data/Rakefile +37 -0
- data/lib/tasks/yellow-brick-road_tasks.rake +4 -0
- data/lib/yellow-brick-road.rb +6 -0
- data/lib/yellow-brick-road/config.rb +15 -0
- data/lib/yellow-brick-road/directive_processor.rb +68 -0
- data/lib/yellow-brick-road/engine.rb +22 -0
- data/lib/yellow-brick-road/soy_processor.rb +56 -0
- data/lib/yellow-brick-road/utils.rb +38 -0
- data/lib/yellow-brick-road/version.rb +3 -0
- data/test/dummy/Rakefile +7 -0
- data/test/dummy/app/assets/javascripts/application.js +12 -0
- data/test/dummy/app/assets/javascripts/closure-deps.js +4 -0
- data/test/dummy/app/assets/javascripts/my-closure/simple.js.soy +14 -0
- data/test/dummy/app/assets/javascripts/my-closure/start.js +25 -0
- data/test/dummy/app/assets/stylesheets/application.css +7 -0
- data/test/dummy/app/controllers/application_controller.rb +7 -0
- data/test/dummy/app/helpers/application_helper.rb +2 -0
- data/test/dummy/app/views/application/index.html.erb +0 -0
- data/test/dummy/app/views/layouts/application.html.erb +18 -0
- data/test/dummy/config.ru +4 -0
- data/test/dummy/config/application.rb +51 -0
- data/test/dummy/config/boot.rb +10 -0
- data/test/dummy/config/environment.rb +5 -0
- data/test/dummy/config/environments/development.rb +30 -0
- data/test/dummy/config/environments/production.rb +60 -0
- data/test/dummy/config/environments/test.rb +39 -0
- data/test/dummy/config/initializers/backtrace_silencers.rb +7 -0
- data/test/dummy/config/initializers/inflections.rb +10 -0
- data/test/dummy/config/initializers/mime_types.rb +5 -0
- data/test/dummy/config/initializers/secret_token.rb +7 -0
- data/test/dummy/config/initializers/session_store.rb +8 -0
- data/test/dummy/config/initializers/wrap_parameters.rb +10 -0
- data/test/dummy/config/initializers/yellow_brick_road.rb +2 -0
- data/test/dummy/config/locales/en.yml +5 -0
- data/test/dummy/config/routes.rb +58 -0
- data/test/dummy/log/development.log +13924 -0
- data/test/dummy/log/test.log +0 -0
- data/test/dummy/public/404.html +26 -0
- data/test/dummy/public/422.html +26 -0
- data/test/dummy/public/500.html +26 -0
- data/test/dummy/public/favicon.ico +0 -0
- data/test/dummy/script/rails +6 -0
- data/test/dummy/tmp/cache/assets/BE0/120/sprockets%2F751842b8c6750008c7310d182600d173 +142 -0
- data/test/dummy/tmp/cache/assets/C19/950/sprockets%2F142437f1d8d9424007b4a882a5429333 +1372 -0
- data/test/dummy/tmp/cache/assets/C4B/D00/sprockets%2F400f22c081529179ce3d079457de3009 +806 -0
- data/test/dummy/tmp/cache/assets/C5A/EE0/sprockets%2Fb711429ed948c503b718d077037780f8 +0 -0
- data/test/dummy/tmp/cache/assets/C5B/A80/sprockets%2F508569b474262724c61a461f7777dab7 +1118 -0
- data/test/dummy/tmp/cache/assets/C6C/660/sprockets%2F2c298b3b02232a21527680685a3efc30 +9289 -0
- data/test/dummy/tmp/cache/assets/C72/8A0/sprockets%2F167b265129e30d87d253c406db305c60 +293 -0
- data/test/dummy/tmp/cache/assets/C7E/9F0/sprockets%2F89862076204c62c4593ac20de32da909 +9 -0
- data/test/dummy/tmp/cache/assets/C8B/5F0/sprockets%2Fc6a4470b5c21e285e829a99365839b24 +0 -0
- data/test/dummy/tmp/cache/assets/C92/D20/sprockets%2F2e618f7805f445889aec94885a500f03 +457 -0
- data/test/dummy/tmp/cache/assets/C98/FD0/sprockets%2Fb11442af041f96e87a43a1dc11231745 +283 -0
- data/test/dummy/tmp/cache/assets/CA3/520/sprockets%2F5379d7143c6c52b11b88dc0ab5436133 +277 -0
- data/test/dummy/tmp/cache/assets/CA5/450/sprockets%2F6bb727c9312a749134ad67323a317f0d +73 -0
- data/test/dummy/tmp/cache/assets/CA5/4F0/sprockets%2Feeb7de7771527700af194c0441d29101 +709 -0
- data/test/dummy/tmp/cache/assets/CA6/E90/sprockets%2F611f68180f43c4181f06ae5c5f8201e2 +1546 -0
- data/test/dummy/tmp/cache/assets/CA7/310/sprockets%2F45664cf816315200b574e029fde6f10a +0 -0
- data/test/dummy/tmp/cache/assets/CA9/9D0/sprockets%2F2672e32464cf7267c4ba3d028f54b153 +224 -0
- data/test/dummy/tmp/cache/assets/CAB/5A0/sprockets%2F7f50e0289f150c8636ac9253129bc13c +2556 -0
- data/test/dummy/tmp/cache/assets/CB5/7E0/sprockets%2F42ff6672683b2029233a800e7539eeee +474 -0
- data/test/dummy/tmp/cache/assets/CB6/DC0/sprockets%2F2f9882155bb2d4d3ab5d708951857c60 +494 -0
- data/test/dummy/tmp/cache/assets/CBB/680/sprockets%2F1dc336d96fb52df34b458185559922b5 +1018 -0
- data/test/dummy/tmp/cache/assets/CBC/640/sprockets%2F67d2e0d9e5129d237e575d2780c64b47 +1260 -0
- data/test/dummy/tmp/cache/assets/CBE/550/sprockets%2Fd680cac830e0b3408ba910f0b0421147 +25 -0
- data/test/dummy/tmp/cache/assets/CC7/790/sprockets%2F69941f32a12e4f99d4a57f65386d870d +608 -0
- data/test/dummy/tmp/cache/assets/CCB/F80/sprockets%2Fa865701ef2ec41155e524772c31a1a2b +1088 -0
- data/test/dummy/tmp/cache/assets/CCE/580/sprockets%2F879411ed27ed1c557d57853d8f579b56 +0 -0
- data/test/dummy/tmp/cache/assets/CD0/070/sprockets%2F6748fe8481965f260d9c56b7f9f508a2 +1530 -0
- data/test/dummy/tmp/cache/assets/CD4/750/sprockets%2Faf3505141ecb3169ce41ce519d136924 +0 -0
- data/test/dummy/tmp/cache/assets/CD6/A90/sprockets%2F3f55ac75b9fb8426312116bcb940a580 +2539 -0
- data/test/dummy/tmp/cache/assets/CD9/6C0/sprockets%2F5e2458bc52da90ba349a66035e3b6752 +0 -0
- data/test/dummy/tmp/cache/assets/CD9/F50/sprockets%2F9008bf696500cfae1d61f045f209181e +256 -0
- data/test/dummy/tmp/cache/assets/CDB/B40/sprockets%2F53529a22c994570a0df4742c0bfe61f4 +0 -0
- data/test/dummy/tmp/cache/assets/CDC/D10/sprockets%2F1e775b4ff06b4401c07503ce95a839b5 +75 -0
- data/test/dummy/tmp/cache/assets/CDE/CD0/sprockets%2F141066798b4acf07053f7e3a6cb4e555 +1613 -0
- data/test/dummy/tmp/cache/assets/CE1/760/sprockets%2F245fe11803630fe30d0cf8a869886ab5 +357 -0
- data/test/dummy/tmp/cache/assets/CE1/FA0/sprockets%2F863d1650ef066e4a2168bc57c7c0e096 +0 -0
- data/test/dummy/tmp/cache/assets/CE2/310/sprockets%2Fd38075d5592ecaf82e43526c03b467c4 +1545 -0
- data/test/dummy/tmp/cache/assets/CE2/420/sprockets%2F30f2e8f30477e80cf6416dfe27307c07 +204 -0
- data/test/dummy/tmp/cache/assets/CE2/D70/sprockets%2F467c44b63644e0f44dd06a585f36f1a6 +522 -0
- data/test/dummy/tmp/cache/assets/CE3/670/sprockets%2Fddd11860b444cd0f9996be0c46762318 +796 -0
- data/test/dummy/tmp/cache/assets/CE4/0B0/sprockets%2Ff11535d785c0d34349c64d673bd4b28f +1105 -0
- data/test/dummy/tmp/cache/assets/CE4/590/sprockets%2Fd68edcc87a4ae302794093081b45b819 +10 -0
- data/test/dummy/tmp/cache/assets/CE4/D60/sprockets%2F61772e4a60b616f74da91b838a2f4f82 +0 -0
- data/test/dummy/tmp/cache/assets/CE6/DD0/sprockets%2F2fe073024a2bf26bd98458388b57af37 +1355 -0
- data/test/dummy/tmp/cache/assets/CE7/160/sprockets%2Fba1f9939f031b4356ec1869d40fc2747 +1261 -0
- data/test/dummy/tmp/cache/assets/CE8/C70/sprockets%2Fc6c9ba3c677b5e2af8520395192c9445 +173 -0
- data/test/dummy/tmp/cache/assets/CEA/8B0/sprockets%2Ff77e549cb6d37604105f35d4e67d8c21 +511 -0
- data/test/dummy/tmp/cache/assets/CEA/AA0/sprockets%2F5f816982c86d2e6b72b2f5f65c51d070 +1529 -0
- data/test/dummy/tmp/cache/assets/CEA/C10/sprockets%2F9dcd541e67c299ab076a44a2183872f8 +0 -0
- data/test/dummy/tmp/cache/assets/CF1/5A0/sprockets%2F1a697695edf2bb7b49a2896904218bc7 +115 -0
- data/test/dummy/tmp/cache/assets/CF4/480/sprockets%2F5e99c77e93f4a522c84357e62b25e0f7 +43 -0
- data/test/dummy/tmp/cache/assets/CF7/460/sprockets%2Fd12ea9733fe3c92456f57f9145569b9c +0 -0
- data/test/dummy/tmp/cache/assets/CF7/470/sprockets%2F2897897a166ca3369fecb88f83f211b5 +435 -0
- data/test/dummy/tmp/cache/assets/CFA/760/sprockets%2Fa9024adba14091e0635c6874d1db4e22 +0 -0
- data/test/dummy/tmp/cache/assets/D01/F30/sprockets%2Fe639a15b6e0cca37d12443b408e1166f +25 -0
- data/test/dummy/tmp/cache/assets/D02/9F0/sprockets%2Fb99eae308897fe88cb9414b96824098b +0 -0
- data/test/dummy/tmp/cache/assets/D03/330/sprockets%2F1e003cdb3e7dcc9307e84090ad457127 +454 -0
- data/test/dummy/tmp/cache/assets/D03/8B0/sprockets%2Ff74632bddf2c0b2018ca7b736309380e +365 -0
- data/test/dummy/tmp/cache/assets/D05/0A0/sprockets%2Fe57658220260db13eb5577aef42cb61b +257 -0
- data/test/dummy/tmp/cache/assets/D05/920/sprockets%2F909507434dcc270db4853e4c147f0aac +31 -0
- data/test/dummy/tmp/cache/assets/D08/510/sprockets%2Fa567be6cb6d7310096f1739b25a5a3f0 +50 -0
- data/test/dummy/tmp/cache/assets/D08/9F0/sprockets%2F1d61d2c89ca50957066bacc5b69011f5 +1424 -0
- data/test/dummy/tmp/cache/assets/D0A/790/sprockets%2Feb16913e6504c9b0d3be431de39e4751 +300 -0
- data/test/dummy/tmp/cache/assets/D0C/C50/sprockets%2Fd6613bee8b40d50459af6b52a7084f34 +796 -0
- data/test/dummy/tmp/cache/assets/D0D/030/sprockets%2Fba3f13b4a444679e8bc2549226ec743b +21 -0
- data/test/dummy/tmp/cache/assets/D0D/350/sprockets%2F2670bce036d485e15d059c0f1e98f24a +207 -0
- data/test/dummy/tmp/cache/assets/D13/270/sprockets%2F497cb163e6317e3fc1565d832f406cfb +348 -0
- data/test/dummy/tmp/cache/assets/D13/380/sprockets%2F786d003c9c7fb759dd26c1030c087cf6 +813 -0
- data/test/dummy/tmp/cache/assets/D13/7C0/sprockets%2F528d22310a9ab8e6fba08d82844ce795 +0 -0
- data/test/dummy/tmp/cache/assets/D15/F60/sprockets%2Fa28394e3f80365b5bc86794dd46daa22 +0 -0
- data/test/dummy/tmp/cache/assets/D18/500/sprockets%2Fd22c2d97d1db2154f2f7592906e957ea +1001 -0
- data/test/dummy/tmp/cache/assets/D1B/C70/sprockets%2F1c04848b1e1d6e8e33b8581f8c8128ff +223 -0
- data/test/dummy/tmp/cache/assets/D1C/600/sprockets%2Fa0601f99147f59ddd6266e6aff077e14 +0 -0
- data/test/dummy/tmp/cache/assets/D1E/470/sprockets%2Fb3933e694547b78bf6fb15f44a4623fe +53 -0
- data/test/dummy/tmp/cache/assets/D1F/480/sprockets%2F545164168becf42b289efc8708f1db68 +1278 -0
- data/test/dummy/tmp/cache/assets/D21/630/sprockets%2F0a14114729c14637f2e8f122acabd1ab +823 -0
- data/test/dummy/tmp/cache/assets/D24/A90/sprockets%2F21c8a0d48c51b8585ba03bc112ecd153 +692 -0
- data/test/dummy/tmp/cache/assets/D25/D30/sprockets%2F3b937f4c16d2aa0a28fc02a0e922712b +1441 -0
- data/test/dummy/tmp/cache/assets/D25/F30/sprockets%2Fe251527c0c018f4b4ad44b2ad7064fb0 +2255 -0
- data/test/dummy/tmp/cache/assets/D26/DE0/sprockets%2F761ac1bdb0739cc56fa0c1224b137b09 +0 -0
- data/test/dummy/tmp/cache/assets/D2A/C30/sprockets%2F978fe7268754f451c59b9ccb323ffa56 +0 -0
- data/test/dummy/tmp/cache/assets/D2B/0F0/sprockets%2Fbf223af03335cfc08a71e549e10c0e27 +2539 -0
- data/test/dummy/tmp/cache/assets/D2E/6D0/sprockets%2F9e7fda3affb389313cc50223f01c0324 +0 -0
- data/test/dummy/tmp/cache/assets/D2F/110/sprockets%2F3730ffe2ed34c1219d580bd1615ea7b0 +2239 -0
- data/test/dummy/tmp/cache/assets/D2F/F10/sprockets%2F9cac242f0bf5ec00079ea3a463e26552 +153 -0
- data/test/dummy/tmp/cache/assets/D30/1D0/sprockets%2Fd690a26a0b0ae138c1c48d257a7674bc +589 -0
- data/test/dummy/tmp/cache/assets/D32/A10/sprockets%2F13fe41fee1fe35b49d145bcc06610705 +0 -0
- data/test/dummy/tmp/cache/assets/D36/940/sprockets%2Fb4ba462ac9f4aac561c36e60367c1378 +572 -0
- data/test/dummy/tmp/cache/assets/D37/090/sprockets%2F2f2e71ebbc240014ebf648f0917e854a +798 -0
- data/test/dummy/tmp/cache/assets/D3A/440/sprockets%2F6d332243647c841dea36ed822cdfc23e +165 -0
- data/test/dummy/tmp/cache/assets/D3B/5A0/sprockets%2F82e05cf8c88ba8cb1c87e50d51372a03 +0 -0
- data/test/dummy/tmp/cache/assets/D41/B30/sprockets%2Fba1b93913dd01d83ac9a96df334456f8 +0 -0
- data/test/dummy/tmp/cache/assets/D43/D90/sprockets%2F04f3a5926d5a7672456dc7afa73d0c7f +38 -0
- data/test/dummy/tmp/cache/assets/D45/1F0/sprockets%2F1bfa855d9c10ff2431a9a548958cc5e4 +83 -0
- data/test/dummy/tmp/cache/assets/D45/B10/sprockets%2F643f3d9b216e48df952b7f150a46a7ec +60 -0
- data/test/dummy/tmp/cache/assets/D46/040/sprockets%2F199546844e5939721a5afcbcce4ea43a +143 -0
- data/test/dummy/tmp/cache/assets/D49/320/sprockets%2Fd8123eb229e34c9f507f7b1876f1c4ee +506 -0
- data/test/dummy/tmp/cache/assets/D49/750/sprockets%2Ff41ef1c0832b7294fb15588ff5c783cb +0 -0
- data/test/dummy/tmp/cache/assets/D49/930/sprockets%2F1071926698fa55abc71e1b6fd966dfe1 +72 -0
- data/test/dummy/tmp/cache/assets/D49/D10/sprockets%2Fb67b8d7cc7579352a91694f9ae10cdb0 +127 -0
- data/test/dummy/tmp/cache/assets/D4A/160/sprockets%2Fcbd8988b5e18d153eff6230d72e9046a +516 -0
- data/test/dummy/tmp/cache/assets/D4A/2B0/sprockets%2Ffcdf002d38fd938bf7226b46b76706c8 +1101 -0
- data/test/dummy/tmp/cache/assets/D4E/2F0/sprockets%2F77cb87ae57f0d8c25cdaa74181a64997 +1441 -0
- data/test/dummy/tmp/cache/assets/D4F/060/sprockets%2Fa9e66b39ada7394a29bf44f3a682f665 +511 -0
- data/test/dummy/tmp/cache/assets/D50/BD0/sprockets%2F88650dd57ef64075462e6dae757dbe2c +0 -0
- data/test/dummy/tmp/cache/assets/D53/CA0/sprockets%2Fa85032e82709a043fbb2ec00e04f2bbd +0 -0
- data/test/dummy/tmp/cache/assets/D54/BF0/sprockets%2F91970514ff528e8d2bfd81f1ec83c9c8 +240 -0
- data/test/dummy/tmp/cache/assets/D54/ED0/sprockets%2F71c9fa01091d432b131da3bb73faf3d4 +10 -0
- data/test/dummy/tmp/cache/assets/D56/500/sprockets%2F75ebadd035f1324b194034af92eac3a0 +0 -0
- data/test/dummy/tmp/cache/assets/D5A/900/sprockets%2F5729f77d97fdee53b1942cf17f6f05e4 +474 -0
- data/test/dummy/tmp/cache/assets/D5A/D50/sprockets%2F81bace3db2c2f1241175ff3c5009d08c +0 -0
- data/test/dummy/tmp/cache/assets/D5B/C70/sprockets%2Fe64119a9db7017b7ab3b0da1b6076f0d +44 -0
- data/test/dummy/tmp/cache/assets/D5E/4D0/sprockets%2F756f25e4ad861a050cdc41bb8414e4ab +126 -0
- data/test/dummy/tmp/cache/assets/D5E/730/sprockets%2Fd30caf70b387c4604326bdda32aeb549 +0 -0
- data/test/dummy/tmp/cache/assets/D5E/AA0/sprockets%2F790dd07caaaacb30ceb0174664e90817 +136 -0
- data/test/dummy/tmp/cache/assets/D64/D30/sprockets%2Fe4bd8f60a3a446274c3cb2f5d16563ac +590 -0
- data/test/dummy/tmp/cache/assets/D66/400/sprockets%2Fecb7401d20daf25605a7afad3a793778 +0 -0
- data/test/dummy/tmp/cache/assets/D67/250/sprockets%2F8422eb26855ca9c953a3bf1aeade8004 +0 -0
- data/test/dummy/tmp/cache/assets/D69/900/sprockets%2F28ae64f52cb18f77b1a1bd9c51293da4 +0 -0
- data/test/dummy/tmp/cache/assets/D6A/870/sprockets%2F1ece6a51b42f9280f4cee9020c94b72e +197 -0
- data/test/dummy/tmp/cache/assets/D6B/DD0/sprockets%2F9a0abc735e27fc61dab019788518eba4 +164 -0
- data/test/dummy/tmp/cache/assets/D6E/CC0/sprockets%2F8b4fbcec2475e7203b8859baf8e310a3 +0 -0
- data/test/dummy/tmp/cache/assets/D72/470/sprockets%2Fbc0c6d850e7c769e83d58eb3e6061b2a +2556 -0
- data/test/dummy/tmp/cache/assets/D72/9D0/sprockets%2F9402daf6da6f7eed331a9d78216cb761 +0 -0
- data/test/dummy/tmp/cache/assets/D74/070/sprockets%2F91ae68f698a39bd7d0d11150fc46e4cd +418 -0
- data/test/dummy/tmp/cache/assets/D74/7F0/sprockets%2F22dad1069ea6a8f29ae757c44e18ec83 +0 -0
- data/test/dummy/tmp/cache/assets/D75/3C0/sprockets%2F44e2ae51b97853d8ecda7b264a267c7d +1630 -0
- data/test/dummy/tmp/cache/assets/D77/780/sprockets%2Ffa2abdfb0b62867c346f79187b8e42d5 +823 -0
- data/test/dummy/tmp/cache/assets/D79/850/sprockets%2F4d540586ed379fd9a70fa0b7ce4f5b27 +306 -0
- data/test/dummy/tmp/cache/assets/D7A/B60/sprockets%2F5925c92f48caff053d08853dc69e5bba +0 -0
- data/test/dummy/tmp/cache/assets/D81/C90/sprockets%2F19aca5c835efce74878c23e581e2a89e +2239 -0
- data/test/dummy/tmp/cache/assets/D84/210/sprockets%2Fabd0103ccec2b428ac62c94e4c40b384 +11228 -0
- data/test/dummy/tmp/cache/assets/D8B/B10/sprockets%2Fbb7a2305a8f2832631863bbababb67be +301 -0
- data/test/dummy/tmp/cache/assets/D92/3B0/sprockets%2F93dc71f411faf72ec8ef0b5d217b51a0 +505 -0
- data/test/dummy/tmp/cache/assets/D92/EE0/sprockets%2Ffd051ea0abf6be6970754aa732e40c8b +289 -0
- data/test/dummy/tmp/cache/assets/D93/810/sprockets%2F7dc1ac5e1b83ba5144e34cf156d48a8a +471 -0
- data/test/dummy/tmp/cache/assets/D94/020/sprockets%2F35cb4ce22488fb5bdd260508ca47a3fb +239 -0
- data/test/dummy/tmp/cache/assets/D94/EC0/sprockets%2F8b900fba18f8e046f5f12e6d1f0ac15b +74 -0
- data/test/dummy/tmp/cache/assets/D95/470/sprockets%2F5be5d361a52575c433831b5e8cccbace +9273 -0
- data/test/dummy/tmp/cache/assets/D97/9D0/sprockets%2F524a2a94a88c1d392dabcba654e365fc +103 -0
- data/test/dummy/tmp/cache/assets/D9D/800/sprockets%2Ff8387220eb4dda9b29a37b5deb9f2a40 +54 -0
- data/test/dummy/tmp/cache/assets/D9E/DD0/sprockets%2Fb6b4ffad6485eda046b327a196e8c44a +0 -0
- data/test/dummy/tmp/cache/assets/DA1/0A0/sprockets%2F359c94aee6ba2e15fc9666aa4de311c8 +166 -0
- data/test/dummy/tmp/cache/assets/DA1/0D0/sprockets%2F798de3c28452e164a7fc1a3a6e8cdb4b +652 -0
- data/test/dummy/tmp/cache/assets/DA3/CB0/sprockets%2Fdfad6bb1857a8af91f98ba137c18504e +815 -0
- data/test/dummy/tmp/cache/assets/DA4/E10/sprockets%2Fbda7705734ace95f12a7d79df9c14af2 +1354 -0
- data/test/dummy/tmp/cache/assets/DA5/E30/sprockets%2F2e6707a119e94a784efbadca18d7e8d1 +129 -0
- data/test/dummy/tmp/cache/assets/DA6/4B0/sprockets%2F4f7a708b6aa2d42eb577493dea7cef55 +115 -0
- data/test/dummy/tmp/cache/assets/DA8/A10/sprockets%2F0ae5bbb4ca200e74db3b64d72c2be120 +0 -0
- data/test/dummy/tmp/cache/assets/DA9/3F0/sprockets%2Fdd0af9cfd65fb7d02fe778c8f6015361 +499 -0
- data/test/dummy/tmp/cache/assets/DA9/780/sprockets%2Fe3559a635e8f92dec7727a3db2ae7b4c +813 -0
- data/test/dummy/tmp/cache/assets/DAC/0E0/sprockets%2F04cef8243a9ef7321846debc977ea8db +607 -0
- data/test/dummy/tmp/cache/assets/DB1/260/sprockets%2Fb879ff7530bf8cc175e0c7e70dc4e79b +0 -0
- data/test/dummy/tmp/cache/assets/DB4/4C0/sprockets%2F30a76cbd98dedb56742cd8ecaf858757 +0 -0
- data/test/dummy/tmp/cache/assets/DBD/7E0/sprockets%2F236fb1ac5ed9f2e3fe32203acc3a842d +0 -0
- data/test/dummy/tmp/cache/assets/DC2/DF0/sprockets%2Fe233bcaba8beff15626c35cb5e0e0936 +845 -0
- data/test/dummy/tmp/cache/assets/DC4/600/sprockets%2F59c96aa6c1cbebc61bff6c050a5351d7 +225 -0
- data/test/dummy/tmp/cache/assets/DC5/030/sprockets%2Fcb2fe864a0177eec19017c43ce9aa4ad +187 -0
- data/test/dummy/tmp/cache/assets/DC8/A60/sprockets%2F9fcb9f5c3f679ce749ee4c3f93869ba6 +74 -0
- data/test/dummy/tmp/cache/assets/DCB/D40/sprockets%2Ffd5542bfb7660a8d8cac3a2e46fb01f8 +828 -0
- data/test/dummy/tmp/cache/assets/DCC/020/sprockets%2F0c129c5f2784c96fa1dc3da6c19c1efc +128 -0
- data/test/dummy/tmp/cache/assets/DCF/520/sprockets%2F975162fb97a3ec7033db5f2fdba4fcd3 +70 -0
- data/test/dummy/tmp/cache/assets/DD0/000/sprockets%2F0d5d631cce6f0b078bb29cf98b3d78bb +276 -0
- data/test/dummy/tmp/cache/assets/DD0/C90/sprockets%2F84eeca4ef8f5eb29b13f7e1ea3c71324 +591 -0
- data/test/dummy/tmp/cache/assets/DD6/710/sprockets%2F9e83f2ebbe3e349efca2de390e15d635 +204 -0
- data/test/dummy/tmp/cache/assets/DE1/830/sprockets%2Fd23d3cafef2e2a9055bc103dffc1a023 +208 -0
- data/test/dummy/tmp/cache/assets/DEB/470/sprockets%2Fae2de0fcbc2214b71d3f2a875d2bc8c3 +2255 -0
- data/test/dummy/tmp/cache/assets/DEE/690/sprockets%2F5d824bcadef29060cc13eed71af4b4d0 +550 -0
- data/test/dummy/tmp/cache/assets/DF0/5D0/sprockets%2F25a875eb0a5d4c49bcc3fa39ea0adb26 +567 -0
- data/test/dummy/tmp/cache/assets/DF3/E20/sprockets%2Fada770c49a5d6b38d1cc43ed4d51c1fc +0 -0
- data/test/dummy/tmp/cache/assets/DF5/C80/sprockets%2F03ad7d7b3a8feba9ed9be82ae2083b20 +340 -0
- data/test/dummy/tmp/cache/assets/DF6/560/sprockets%2Fafceb2b55eb108efe4446dfb02b519b8 +0 -0
- data/test/dummy/tmp/cache/assets/DFC/030/sprockets%2Fcbdd3679eaba219b4e1ff20677af1c6f +1371 -0
- data/test/dummy/tmp/cache/assets/E00/970/sprockets%2F8bc6dde8d05c382dd07cbcec70f54e09 +378 -0
- data/test/dummy/tmp/cache/assets/E04/890/sprockets%2F2f5173deea6c795b8fdde723bb4b63af +0 -0
- data/test/dummy/tmp/cache/assets/E12/2F0/sprockets%2F5c45062ecfbe512dcba176ba6ddacc00 +523 -0
- data/test/dummy/tmp/cache/assets/E21/5D0/sprockets%2Fd4fe6d611bfb0e63c04de5dbfb128a8a +0 -0
- data/test/dummy/tmp/cache/assets/E22/770/sprockets%2F2ccebcabfbb9b59159e4b73b3b30a74d +208 -0
- data/test/dummy/tmp/cache/assets/E31/A90/sprockets%2F26b98bbbc15eee9b370c7dcde88d16aa +394 -0
- data/test/dummy/tmp/cache/assets/E31/E30/sprockets%2Ffbdafcc4e2f44bb9fc653bcf9625b750 +284 -0
- data/test/dummy/tmp/cache/assets/E37/1C0/sprockets%2Fa5eb45fc86dafe2bee4e4fa3f53c4785 +0 -0
- data/test/dummy/tmp/cache/assets/E4C/960/sprockets%2F13fd6e4bfdf031acb3dedca8d0f407b4 +1277 -0
- data/test/dummy/tmp/cache/assets/E88/330/sprockets%2Fe02d0adb5529ffafcea1b9e5ccf69a5b +669 -0
- data/test/dummy/tmp/pids/server.pid +1 -0
- data/test/dummy/tmp/simple.js.js +20 -0
- data/test/dummy/tmp/soy-1325274421.js +20 -0
- data/test/dummy/tmp/soy-1325286267.js +20 -0
- data/test/test_helper.rb +10 -0
- data/test/yellow-brick-road_test.rb +7 -0
- metadata +538 -0
|
@@ -0,0 +1,284 @@
|
|
|
1
|
+
o: ActiveSupport::Cache::Entry :@compressedF:@expires_in0:@created_atf1325183043.308044:@value{ I"length:EFiB)I"digest;
|
|
2
|
+
F"%24bd8b84fa9e4c4b28771c66e2b3ead5I"source;
|
|
3
|
+
FI"B)// Copyright 2008 The Closure Library Authors. All Rights Reserved.
|
|
4
|
+
//
|
|
5
|
+
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
6
|
+
// you may not use this file except in compliance with the License.
|
|
7
|
+
// You may obtain a copy of the License at
|
|
8
|
+
//
|
|
9
|
+
// http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
//
|
|
11
|
+
// Unless required by applicable law or agreed to in writing, software
|
|
12
|
+
// distributed under the License is distributed on an "AS-IS" BASIS,
|
|
13
|
+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
14
|
+
// See the License for the specific language governing permissions and
|
|
15
|
+
// limitations under the License.
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* @fileoverview Utilities to check the preconditions, postconditions and
|
|
19
|
+
* invariants runtime.
|
|
20
|
+
*
|
|
21
|
+
* Methods in this package should be given special treatment by the compiler
|
|
22
|
+
* for type-inference. For example, <code>goog.asserts.assert(foo)</code>
|
|
23
|
+
* will restrict <code>foo</code> to a truthy value.
|
|
24
|
+
*
|
|
25
|
+
* The compiler has an option to disable asserts. So code like:
|
|
26
|
+
* <code>
|
|
27
|
+
* var x = goog.asserts.assert(foo()); goog.asserts.assert(bar());
|
|
28
|
+
* </code>
|
|
29
|
+
* will be transformed into:
|
|
30
|
+
* <code>
|
|
31
|
+
* var x = foo();
|
|
32
|
+
* </code>
|
|
33
|
+
* The compiler will leave in foo() (because its return value is used),
|
|
34
|
+
* but it will remove bar() because it assumes it does not have side-effects.
|
|
35
|
+
*
|
|
36
|
+
*/
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
goog.provide('goog.asserts');
|
|
41
|
+
goog.provide('goog.asserts.AssertionError');
|
|
42
|
+
|
|
43
|
+
goog.require('goog.debug.Error');
|
|
44
|
+
goog.require('goog.string');
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* @define {boolean} Whether to strip out asserts or to leave them in.
|
|
49
|
+
*/
|
|
50
|
+
goog.asserts.ENABLE_ASSERTS = goog.DEBUG;
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Error object for failed assertions.
|
|
56
|
+
* @param {string} messagePattern The pattern that was used to form message.
|
|
57
|
+
* @param {!Array.<*>} messageArgs The items to substitute into the pattern.
|
|
58
|
+
* @constructor
|
|
59
|
+
* @extends {goog.debug.Error}
|
|
60
|
+
*/
|
|
61
|
+
goog.asserts.AssertionError = function(messagePattern, messageArgs) {
|
|
62
|
+
messageArgs.unshift(messagePattern);
|
|
63
|
+
goog.debug.Error.call(this, goog.string.subs.apply(null, messageArgs));
|
|
64
|
+
// Remove the messagePattern afterwards to avoid permenantly modifying the
|
|
65
|
+
// passed in array.
|
|
66
|
+
messageArgs.shift();
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* The message pattern used to format the error message. Error handlers can
|
|
70
|
+
* use this to uniquely identify the assertion.
|
|
71
|
+
* @type {string}
|
|
72
|
+
*/
|
|
73
|
+
this.messagePattern = messagePattern;
|
|
74
|
+
};
|
|
75
|
+
goog.inherits(goog.asserts.AssertionError, goog.debug.Error);
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
/** @override */
|
|
79
|
+
goog.asserts.AssertionError.prototype.name = 'AssertionError';
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Throws an exception with the given message and "Assertion failed" prefixed
|
|
84
|
+
* onto it.
|
|
85
|
+
* @param {string} defaultMessage The message to use if givenMessage is empty.
|
|
86
|
+
* @param {Array.<*>} defaultArgs The substitution arguments for defaultMessage.
|
|
87
|
+
* @param {string|undefined} givenMessage Message supplied by the caller.
|
|
88
|
+
* @param {Array.<*>} givenArgs The substitution arguments for givenMessage.
|
|
89
|
+
* @throws {goog.asserts.AssertionError} When the value is not a number.
|
|
90
|
+
* @private
|
|
91
|
+
*/
|
|
92
|
+
goog.asserts.doAssertFailure_ =
|
|
93
|
+
function(defaultMessage, defaultArgs, givenMessage, givenArgs) {
|
|
94
|
+
var message = 'Assertion failed';
|
|
95
|
+
if (givenMessage) {
|
|
96
|
+
message += ': ' + givenMessage;
|
|
97
|
+
var args = givenArgs;
|
|
98
|
+
} else if (defaultMessage) {
|
|
99
|
+
message += ': ' + defaultMessage;
|
|
100
|
+
args = defaultArgs;
|
|
101
|
+
}
|
|
102
|
+
// The '' + works around an Opera 10 bug in the unit tests. Without it,
|
|
103
|
+
// a stack trace is added to var message above. With this, a stack trace is
|
|
104
|
+
// not added until this line (it causes the extra garbage to be added after
|
|
105
|
+
// the assertion message instead of in the middle of it).
|
|
106
|
+
throw new goog.asserts.AssertionError('' + message, args || []);
|
|
107
|
+
};
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is
|
|
112
|
+
* true.
|
|
113
|
+
* @param {*} condition The condition to check.
|
|
114
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
115
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
116
|
+
* @return {*} The value of the condition.
|
|
117
|
+
* @throws {goog.asserts.AssertionError} When the condition evaluates to false.
|
|
118
|
+
*/
|
|
119
|
+
goog.asserts.assert = function(condition, opt_message, var_args) {
|
|
120
|
+
if (goog.asserts.ENABLE_ASSERTS && !condition) {
|
|
121
|
+
goog.asserts.doAssertFailure_('', null, opt_message,
|
|
122
|
+
Array.prototype.slice.call(arguments, 2));
|
|
123
|
+
}
|
|
124
|
+
return condition;
|
|
125
|
+
};
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* Fails if goog.asserts.ENABLE_ASSERTS is true. This function is useful in case
|
|
130
|
+
* when we want to add a check in the unreachable area like switch-case
|
|
131
|
+
* statement:
|
|
132
|
+
*
|
|
133
|
+
* <pre>
|
|
134
|
+
* switch(type) {
|
|
135
|
+
* case FOO: doSomething(); break;
|
|
136
|
+
* case BAR: doSomethingElse(); break;
|
|
137
|
+
* default: goog.assert.fail('Unrecognized type: ' + type);
|
|
138
|
+
* // We have only 2 types - "default:" section is unreachable code.
|
|
139
|
+
* }
|
|
140
|
+
* </pre>
|
|
141
|
+
*
|
|
142
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
143
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
144
|
+
* @throws {goog.asserts.AssertionError} Failure.
|
|
145
|
+
*/
|
|
146
|
+
goog.asserts.fail = function(opt_message, var_args) {
|
|
147
|
+
if (goog.asserts.ENABLE_ASSERTS) {
|
|
148
|
+
throw new goog.asserts.AssertionError(
|
|
149
|
+
'Failure' + (opt_message ? ': ' + opt_message : ''),
|
|
150
|
+
Array.prototype.slice.call(arguments, 1));
|
|
151
|
+
}
|
|
152
|
+
};
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
/**
|
|
156
|
+
* Checks if the value is a number if goog.asserts.ENABLE_ASSERTS is true.
|
|
157
|
+
* @param {*} value The value to check.
|
|
158
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
159
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
160
|
+
* @return {number} The value, guaranteed to be a number when asserts enabled.
|
|
161
|
+
* @throws {goog.asserts.AssertionError} When the value is not a number.
|
|
162
|
+
*/
|
|
163
|
+
goog.asserts.assertNumber = function(value, opt_message, var_args) {
|
|
164
|
+
if (goog.asserts.ENABLE_ASSERTS && !goog.isNumber(value)) {
|
|
165
|
+
goog.asserts.doAssertFailure_('Expected number but got %s: %s.',
|
|
166
|
+
[goog.typeOf(value), value], opt_message,
|
|
167
|
+
Array.prototype.slice.call(arguments, 2));
|
|
168
|
+
}
|
|
169
|
+
return /** @type {number} */ (value);
|
|
170
|
+
};
|
|
171
|
+
|
|
172
|
+
|
|
173
|
+
/**
|
|
174
|
+
* Checks if the value is a string if goog.asserts.ENABLE_ASSERTS is true.
|
|
175
|
+
* @param {*} value The value to check.
|
|
176
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
177
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
178
|
+
* @return {string} The value, guaranteed to be a string when asserts enabled.
|
|
179
|
+
* @throws {goog.asserts.AssertionError} When the value is not a string.
|
|
180
|
+
*/
|
|
181
|
+
goog.asserts.assertString = function(value, opt_message, var_args) {
|
|
182
|
+
if (goog.asserts.ENABLE_ASSERTS && !goog.isString(value)) {
|
|
183
|
+
goog.asserts.doAssertFailure_('Expected string but got %s: %s.',
|
|
184
|
+
[goog.typeOf(value), value], opt_message,
|
|
185
|
+
Array.prototype.slice.call(arguments, 2));
|
|
186
|
+
}
|
|
187
|
+
return /** @type {string} */ (value);
|
|
188
|
+
};
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Checks if the value is a function if goog.asserts.ENABLE_ASSERTS is true.
|
|
193
|
+
* @param {*} value The value to check.
|
|
194
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
195
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
196
|
+
* @return {!Function} The value, guaranteed to be a function when asserts
|
|
197
|
+
* enabled.
|
|
198
|
+
* @throws {goog.asserts.AssertionError} When the value is not a function.
|
|
199
|
+
*/
|
|
200
|
+
goog.asserts.assertFunction = function(value, opt_message, var_args) {
|
|
201
|
+
if (goog.asserts.ENABLE_ASSERTS && !goog.isFunction(value)) {
|
|
202
|
+
goog.asserts.doAssertFailure_('Expected function but got %s: %s.',
|
|
203
|
+
[goog.typeOf(value), value], opt_message,
|
|
204
|
+
Array.prototype.slice.call(arguments, 2));
|
|
205
|
+
}
|
|
206
|
+
return /** @type {!Function} */ (value);
|
|
207
|
+
};
|
|
208
|
+
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* Checks if the value is an Object if goog.asserts.ENABLE_ASSERTS is true.
|
|
212
|
+
* @param {*} value The value to check.
|
|
213
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
214
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
215
|
+
* @return {!Object} The value, guaranteed to be a non-null object.
|
|
216
|
+
* @throws {goog.asserts.AssertionError} When the value is not an object.
|
|
217
|
+
*/
|
|
218
|
+
goog.asserts.assertObject = function(value, opt_message, var_args) {
|
|
219
|
+
if (goog.asserts.ENABLE_ASSERTS && !goog.isObject(value)) {
|
|
220
|
+
goog.asserts.doAssertFailure_('Expected object but got %s: %s.',
|
|
221
|
+
[goog.typeOf(value), value],
|
|
222
|
+
opt_message, Array.prototype.slice.call(arguments, 2));
|
|
223
|
+
}
|
|
224
|
+
return /** @type {!Object} */ (value);
|
|
225
|
+
};
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* Checks if the value is an Array if goog.asserts.ENABLE_ASSERTS is true.
|
|
230
|
+
* @param {*} value The value to check.
|
|
231
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
232
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
233
|
+
* @return {!Array} The value, guaranteed to be a non-null array.
|
|
234
|
+
* @throws {goog.asserts.AssertionError} When the value is not an array.
|
|
235
|
+
*/
|
|
236
|
+
goog.asserts.assertArray = function(value, opt_message, var_args) {
|
|
237
|
+
if (goog.asserts.ENABLE_ASSERTS && !goog.isArray(value)) {
|
|
238
|
+
goog.asserts.doAssertFailure_('Expected array but got %s: %s.',
|
|
239
|
+
[goog.typeOf(value), value], opt_message,
|
|
240
|
+
Array.prototype.slice.call(arguments, 2));
|
|
241
|
+
}
|
|
242
|
+
return /** @type {!Array} */ (value);
|
|
243
|
+
};
|
|
244
|
+
|
|
245
|
+
|
|
246
|
+
/**
|
|
247
|
+
* Checks if the value is a boolean if goog.asserts.ENABLE_ASSERTS is true.
|
|
248
|
+
* @param {*} value The value to check.
|
|
249
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
250
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
251
|
+
* @return {boolean} The value, guaranteed to be a boolean when asserts are
|
|
252
|
+
* enabled.
|
|
253
|
+
* @throws {goog.asserts.AssertionError} When the value is not a boolean.
|
|
254
|
+
*/
|
|
255
|
+
goog.asserts.assertBoolean = function(value, opt_message, var_args) {
|
|
256
|
+
if (goog.asserts.ENABLE_ASSERTS && !goog.isBoolean(value)) {
|
|
257
|
+
goog.asserts.doAssertFailure_('Expected boolean but got %s: %s.',
|
|
258
|
+
[goog.typeOf(value), value], opt_message,
|
|
259
|
+
Array.prototype.slice.call(arguments, 2));
|
|
260
|
+
}
|
|
261
|
+
return /** @type {boolean} */ (value);
|
|
262
|
+
};
|
|
263
|
+
|
|
264
|
+
|
|
265
|
+
/**
|
|
266
|
+
* Checks if the value is an instance of the user-defined type if
|
|
267
|
+
* goog.asserts.ENABLE_ASSERTS is true.
|
|
268
|
+
* @param {*} value The value to check.
|
|
269
|
+
* @param {!Function} type A user-defined constructor.
|
|
270
|
+
* @param {string=} opt_message Error message in case of failure.
|
|
271
|
+
* @param {...*} var_args The items to substitute into the failure message.
|
|
272
|
+
* @throws {goog.asserts.AssertionError} When the value is not an instance of
|
|
273
|
+
* type.
|
|
274
|
+
*/
|
|
275
|
+
goog.asserts.assertInstanceof = function(value, type, opt_message, var_args) {
|
|
276
|
+
if (goog.asserts.ENABLE_ASSERTS && !(value instanceof type)) {
|
|
277
|
+
goog.asserts.doAssertFailure_('instanceof check failed.', null,
|
|
278
|
+
opt_message, Array.prototype.slice.call(arguments, 3));
|
|
279
|
+
}
|
|
280
|
+
};
|
|
281
|
+
|
|
282
|
+
;
|
|
283
|
+
FI"
|
|
284
|
+
F"%3d6e70326dc713a3e52cfc9b4611fd7b
|
|
Binary file
|
|
@@ -0,0 +1,1277 @@
|
|
|
1
|
+
o: ActiveSupport::Cache::Entry :@compressedF:@expires_in0:@created_atf1325458072.3808992:@value{I"
|
|
2
|
+
class:EFI"BundledAsset;
|
|
3
|
+
FI"id;
|
|
4
|
+
F"%a035d995f352af6af7c184d629c75409I"logical_path;
|
|
5
|
+
FI""closure/goog/string/string.js;
|
|
6
|
+
TI"
|
|
7
|
+
F"h/Volumes/Development/dev-web/yellow-brick-road/vendor/closure-library/closure/goog/string/string.jsI"content_type;
|
|
8
|
+
FI"application/javascript;
|
|
9
|
+
FI"
|
|
10
|
+
mtime;
|
|
11
|
+
FI"2011-12-30T02:16:24+00:00;
|
|
12
|
+
FI" body;
|
|
13
|
+
FI"o�// Copyright 2006 The Closure Library Authors. All Rights Reserved.
|
|
14
|
+
//
|
|
15
|
+
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
16
|
+
// you may not use this file except in compliance with the License.
|
|
17
|
+
// You may obtain a copy of the License at
|
|
18
|
+
//
|
|
19
|
+
// http://www.apache.org/licenses/LICENSE-2.0
|
|
20
|
+
//
|
|
21
|
+
// Unless required by applicable law or agreed to in writing, software
|
|
22
|
+
// distributed under the License is distributed on an "AS-IS" BASIS,
|
|
23
|
+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
24
|
+
// See the License for the specific language governing permissions and
|
|
25
|
+
// limitations under the License.
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* @fileoverview Utilities for string manipulation.
|
|
29
|
+
*/
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Namespace for string utilities
|
|
34
|
+
*/
|
|
35
|
+
|
|
36
|
+
goog.provide('goog.string');
|
|
37
|
+
goog.provide('goog.string.Unicode');
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Common Unicode string characters.
|
|
42
|
+
* @enum {string}
|
|
43
|
+
*/
|
|
44
|
+
goog.string.Unicode = {
|
|
45
|
+
NBSP: '\xa0'
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Fast prefix-checker.
|
|
51
|
+
* @param {string} str The string to check.
|
|
52
|
+
* @param {string} prefix A string to look for at the start of {@code str}.
|
|
53
|
+
* @return {boolean} True if {@code str} begins with {@code prefix}.
|
|
54
|
+
*/
|
|
55
|
+
goog.string.startsWith = function(str, prefix) {
|
|
56
|
+
return str.lastIndexOf(prefix, 0) == 0;
|
|
57
|
+
};
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Fast suffix-checker.
|
|
62
|
+
* @param {string} str The string to check.
|
|
63
|
+
* @param {string} suffix A string to look for at the end of {@code str}.
|
|
64
|
+
* @return {boolean} True if {@code str} ends with {@code suffix}.
|
|
65
|
+
*/
|
|
66
|
+
goog.string.endsWith = function(str, suffix) {
|
|
67
|
+
var l = str.length - suffix.length;
|
|
68
|
+
return l >= 0 && str.indexOf(suffix, l) == l;
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* Case-insensitive prefix-checker.
|
|
74
|
+
* @param {string} str The string to check.
|
|
75
|
+
* @param {string} prefix A string to look for at the end of {@code str}.
|
|
76
|
+
* @return {boolean} True if {@code str} begins with {@code prefix} (ignoring
|
|
77
|
+
* case).
|
|
78
|
+
*/
|
|
79
|
+
goog.string.caseInsensitiveStartsWith = function(str, prefix) {
|
|
80
|
+
return goog.string.caseInsensitiveCompare(
|
|
81
|
+
prefix, str.substr(0, prefix.length)) == 0;
|
|
82
|
+
};
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Case-insensitive suffix-checker.
|
|
87
|
+
* @param {string} str The string to check.
|
|
88
|
+
* @param {string} suffix A string to look for at the end of {@code str}.
|
|
89
|
+
* @return {boolean} True if {@code str} ends with {@code suffix} (ignoring
|
|
90
|
+
* case).
|
|
91
|
+
*/
|
|
92
|
+
goog.string.caseInsensitiveEndsWith = function(str, suffix) {
|
|
93
|
+
return goog.string.caseInsensitiveCompare(
|
|
94
|
+
suffix, str.substr(str.length - suffix.length, suffix.length)) == 0;
|
|
95
|
+
};
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Does simple python-style string substitution.
|
|
100
|
+
* subs("foo%s hot%s", "bar", "dog") becomes "foobar hotdog".
|
|
101
|
+
* @param {string} str The string containing the pattern.
|
|
102
|
+
* @param {...*} var_args The items to substitute into the pattern.
|
|
103
|
+
* @return {string} A copy of {@code str} in which each occurrence of
|
|
104
|
+
* {@code %s} has been replaced an argument from {@code var_args}.
|
|
105
|
+
*/
|
|
106
|
+
goog.string.subs = function(str, var_args) {
|
|
107
|
+
// This appears to be slow, but testing shows it compares more or less
|
|
108
|
+
// equivalent to the regex.exec method.
|
|
109
|
+
for (var i = 1; i < arguments.length; i++) {
|
|
110
|
+
// We cast to String in case an argument is a Function. Replacing $&, for
|
|
111
|
+
// example, with $$$& stops the replace from subsituting the whole match
|
|
112
|
+
// into the resultant string. $$$& in the first replace becomes $$& in the
|
|
113
|
+
// second, which leaves $& in the resultant string. Also:
|
|
114
|
+
// $$, $`, $', $n $nn
|
|
115
|
+
var replacement = String(arguments[i]).replace(/\$/g, '$$$$');
|
|
116
|
+
str = str.replace(/\%s/, replacement);
|
|
117
|
+
}
|
|
118
|
+
return str;
|
|
119
|
+
};
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Converts multiple whitespace chars (spaces, non-breaking-spaces, new lines
|
|
124
|
+
* and tabs) to a single space, and strips leading and trailing whitespace.
|
|
125
|
+
* @param {string} str Input string.
|
|
126
|
+
* @return {string} A copy of {@code str} with collapsed whitespace.
|
|
127
|
+
*/
|
|
128
|
+
goog.string.collapseWhitespace = function(str) {
|
|
129
|
+
// Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
|
130
|
+
// class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
|
131
|
+
// include it in the regexp to enforce consistent cross-browser behavior.
|
|
132
|
+
return str.replace(/[\s\xa0]+/g, ' ').replace(/^\s+|\s+$/g, '');
|
|
133
|
+
};
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* Checks if a string is empty or contains only whitespaces.
|
|
138
|
+
* @param {string} str The string to check.
|
|
139
|
+
* @return {boolean} True if {@code str} is empty or whitespace only.
|
|
140
|
+
*/
|
|
141
|
+
goog.string.isEmpty = function(str) {
|
|
142
|
+
// testing length == 0 first is actually slower in all browsers (about the
|
|
143
|
+
// same in Opera).
|
|
144
|
+
// Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
|
145
|
+
// class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
|
146
|
+
// include it in the regexp to enforce consistent cross-browser behavior.
|
|
147
|
+
return /^[\s\xa0]*$/.test(str);
|
|
148
|
+
};
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Checks if a string is null, empty or contains only whitespaces.
|
|
153
|
+
* @param {*} str The string to check.
|
|
154
|
+
* @return {boolean} True if{@code str} is null, empty, or whitespace only.
|
|
155
|
+
*/
|
|
156
|
+
goog.string.isEmptySafe = function(str) {
|
|
157
|
+
return goog.string.isEmpty(goog.string.makeSafe(str));
|
|
158
|
+
};
|
|
159
|
+
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* Checks if a string is all breaking whitespace.
|
|
163
|
+
* @param {string} str The string to check.
|
|
164
|
+
* @return {boolean} Whether the string is all breaking whitespace.
|
|
165
|
+
*/
|
|
166
|
+
goog.string.isBreakingWhitespace = function(str) {
|
|
167
|
+
return !/[^\t\n\r ]/.test(str);
|
|
168
|
+
};
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
/**
|
|
172
|
+
* Checks if a string contains all letters.
|
|
173
|
+
* @param {string} str string to check.
|
|
174
|
+
* @return {boolean} True if {@code str} consists entirely of letters.
|
|
175
|
+
*/
|
|
176
|
+
goog.string.isAlpha = function(str) {
|
|
177
|
+
return !/[^a-zA-Z]/.test(str);
|
|
178
|
+
};
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
/**
|
|
182
|
+
* Checks if a string contains only numbers.
|
|
183
|
+
* @param {*} str string to check. If not a string, it will be
|
|
184
|
+
* casted to one.
|
|
185
|
+
* @return {boolean} True if {@code str} is numeric.
|
|
186
|
+
*/
|
|
187
|
+
goog.string.isNumeric = function(str) {
|
|
188
|
+
return !/[^0-9]/.test(str);
|
|
189
|
+
};
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* Checks if a string contains only numbers or letters.
|
|
194
|
+
* @param {string} str string to check.
|
|
195
|
+
* @return {boolean} True if {@code str} is alphanumeric.
|
|
196
|
+
*/
|
|
197
|
+
goog.string.isAlphaNumeric = function(str) {
|
|
198
|
+
return !/[^a-zA-Z0-9]/.test(str);
|
|
199
|
+
};
|
|
200
|
+
|
|
201
|
+
|
|
202
|
+
/**
|
|
203
|
+
* Checks if a character is a space character.
|
|
204
|
+
* @param {string} ch Character to check.
|
|
205
|
+
* @return {boolean} True if {code ch} is a space.
|
|
206
|
+
*/
|
|
207
|
+
goog.string.isSpace = function(ch) {
|
|
208
|
+
return ch == ' ';
|
|
209
|
+
};
|
|
210
|
+
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* Checks if a character is a valid unicode character.
|
|
214
|
+
* @param {string} ch Character to check.
|
|
215
|
+
* @return {boolean} True if {code ch} is a valid unicode character.
|
|
216
|
+
*/
|
|
217
|
+
goog.string.isUnicodeChar = function(ch) {
|
|
218
|
+
return ch.length == 1 && ch >= ' ' && ch <= '~' ||
|
|
219
|
+
ch >= '\u0080' && ch <= '\uFFFD';
|
|
220
|
+
};
|
|
221
|
+
|
|
222
|
+
|
|
223
|
+
/**
|
|
224
|
+
* Takes a string and replaces newlines with a space. Multiple lines are
|
|
225
|
+
* replaced with a single space.
|
|
226
|
+
* @param {string} str The string from which to strip newlines.
|
|
227
|
+
* @return {string} A copy of {@code str} stripped of newlines.
|
|
228
|
+
*/
|
|
229
|
+
goog.string.stripNewlines = function(str) {
|
|
230
|
+
return str.replace(/(\r\n|\r|\n)+/g, ' ');
|
|
231
|
+
};
|
|
232
|
+
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* Replaces Windows and Mac new lines with unix style: \r or \r\n with \n.
|
|
236
|
+
* @param {string} str The string to in which to canonicalize newlines.
|
|
237
|
+
* @return {string} {@code str} A copy of {@code} with canonicalized newlines.
|
|
238
|
+
*/
|
|
239
|
+
goog.string.canonicalizeNewlines = function(str) {
|
|
240
|
+
return str.replace(/(\r\n|\r|\n)/g, '\n');
|
|
241
|
+
};
|
|
242
|
+
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Normalizes whitespace in a string, replacing all whitespace chars with
|
|
246
|
+
* a space.
|
|
247
|
+
* @param {string} str The string in which to normalize whitespace.
|
|
248
|
+
* @return {string} A copy of {@code str} with all whitespace normalized.
|
|
249
|
+
*/
|
|
250
|
+
goog.string.normalizeWhitespace = function(str) {
|
|
251
|
+
return str.replace(/\xa0|\s/g, ' ');
|
|
252
|
+
};
|
|
253
|
+
|
|
254
|
+
|
|
255
|
+
/**
|
|
256
|
+
* Normalizes spaces in a string, replacing all consecutive spaces and tabs
|
|
257
|
+
* with a single space. Replaces non-breaking space with a space.
|
|
258
|
+
* @param {string} str The string in which to normalize spaces.
|
|
259
|
+
* @return {string} A copy of {@code str} with all consecutive spaces and tabs
|
|
260
|
+
* replaced with a single space.
|
|
261
|
+
*/
|
|
262
|
+
goog.string.normalizeSpaces = function(str) {
|
|
263
|
+
return str.replace(/\xa0|[ \t]+/g, ' ');
|
|
264
|
+
};
|
|
265
|
+
|
|
266
|
+
|
|
267
|
+
/**
|
|
268
|
+
* Removes the breaking spaces from the left and right of the string and
|
|
269
|
+
* collapses the sequences of breaking spaces in the middle into single spaces.
|
|
270
|
+
* The original and the result strings render the same way in HTML.
|
|
271
|
+
* @param {string} str A string in which to collapse spaces.
|
|
272
|
+
* @return {string} Copy of the string with normalized breaking spaces.
|
|
273
|
+
*/
|
|
274
|
+
goog.string.collapseBreakingSpaces = function(str) {
|
|
275
|
+
return str.replace(/[\t\r\n ]+/g, ' ').replace(
|
|
276
|
+
/^[\t\r\n ]+|[\t\r\n ]+$/g, '');
|
|
277
|
+
};
|
|
278
|
+
|
|
279
|
+
|
|
280
|
+
/**
|
|
281
|
+
* Trims white spaces to the left and right of a string.
|
|
282
|
+
* @param {string} str The string to trim.
|
|
283
|
+
* @return {string} A trimmed copy of {@code str}.
|
|
284
|
+
*/
|
|
285
|
+
goog.string.trim = function(str) {
|
|
286
|
+
// Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
|
287
|
+
// class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
|
288
|
+
// include it in the regexp to enforce consistent cross-browser behavior.
|
|
289
|
+
return str.replace(/^[\s\xa0]+|[\s\xa0]+$/g, '');
|
|
290
|
+
};
|
|
291
|
+
|
|
292
|
+
|
|
293
|
+
/**
|
|
294
|
+
* Trims whitespaces at the left end of a string.
|
|
295
|
+
* @param {string} str The string to left trim.
|
|
296
|
+
* @return {string} A trimmed copy of {@code str}.
|
|
297
|
+
*/
|
|
298
|
+
goog.string.trimLeft = function(str) {
|
|
299
|
+
// Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
|
300
|
+
// class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
|
301
|
+
// include it in the regexp to enforce consistent cross-browser behavior.
|
|
302
|
+
return str.replace(/^[\s\xa0]+/, '');
|
|
303
|
+
};
|
|
304
|
+
|
|
305
|
+
|
|
306
|
+
/**
|
|
307
|
+
* Trims whitespaces at the right end of a string.
|
|
308
|
+
* @param {string} str The string to right trim.
|
|
309
|
+
* @return {string} A trimmed copy of {@code str}.
|
|
310
|
+
*/
|
|
311
|
+
goog.string.trimRight = function(str) {
|
|
312
|
+
// Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
|
313
|
+
// class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
|
314
|
+
// include it in the regexp to enforce consistent cross-browser behavior.
|
|
315
|
+
return str.replace(/[\s\xa0]+$/, '');
|
|
316
|
+
};
|
|
317
|
+
|
|
318
|
+
|
|
319
|
+
/**
|
|
320
|
+
* A string comparator that ignores case.
|
|
321
|
+
* -1 = str1 less than str2
|
|
322
|
+
* 0 = str1 equals str2
|
|
323
|
+
* 1 = str1 greater than str2
|
|
324
|
+
*
|
|
325
|
+
* @param {string} str1 The string to compare.
|
|
326
|
+
* @param {string} str2 The string to compare {@code str1} to.
|
|
327
|
+
* @return {number} The comparator result, as described above.
|
|
328
|
+
*/
|
|
329
|
+
goog.string.caseInsensitiveCompare = function(str1, str2) {
|
|
330
|
+
var test1 = String(str1).toLowerCase();
|
|
331
|
+
var test2 = String(str2).toLowerCase();
|
|
332
|
+
|
|
333
|
+
if (test1 < test2) {
|
|
334
|
+
return -1;
|
|
335
|
+
} else if (test1 == test2) {
|
|
336
|
+
return 0;
|
|
337
|
+
} else {
|
|
338
|
+
return 1;
|
|
339
|
+
}
|
|
340
|
+
};
|
|
341
|
+
|
|
342
|
+
|
|
343
|
+
/**
|
|
344
|
+
* Regular expression used for splitting a string into substrings of fractional
|
|
345
|
+
* numbers, integers, and non-numeric characters.
|
|
346
|
+
* @type {RegExp}
|
|
347
|
+
* @private
|
|
348
|
+
*/
|
|
349
|
+
goog.string.numerateCompareRegExp_ = /(\.\d+)|(\d+)|(\D+)/g;
|
|
350
|
+
|
|
351
|
+
|
|
352
|
+
/**
|
|
353
|
+
* String comparison function that handles numbers in a way humans might expect.
|
|
354
|
+
* Using this function, the string "File 2.jpg" sorts before "File 10.jpg". The
|
|
355
|
+
* comparison is mostly case-insensitive, though strings that are identical
|
|
356
|
+
* except for case are sorted with the upper-case strings before lower-case.
|
|
357
|
+
*
|
|
358
|
+
* This comparison function is significantly slower (about 500x) than either
|
|
359
|
+
* the default or the case-insensitive compare. It should not be used in
|
|
360
|
+
* time-critical code, but should be fast enough to sort several hundred short
|
|
361
|
+
* strings (like filenames) with a reasonable delay.
|
|
362
|
+
*
|
|
363
|
+
* @param {string} str1 The string to compare in a numerically sensitive way.
|
|
364
|
+
* @param {string} str2 The string to compare {@code str1} to.
|
|
365
|
+
* @return {number} less than 0 if str1 < str2, 0 if str1 == str2, greater than
|
|
366
|
+
* 0 if str1 > str2.
|
|
367
|
+
*/
|
|
368
|
+
goog.string.numerateCompare = function(str1, str2) {
|
|
369
|
+
if (str1 == str2) {
|
|
370
|
+
return 0;
|
|
371
|
+
}
|
|
372
|
+
if (!str1) {
|
|
373
|
+
return -1;
|
|
374
|
+
}
|
|
375
|
+
if (!str2) {
|
|
376
|
+
return 1;
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
// Using match to split the entire string ahead of time turns out to be faster
|
|
380
|
+
// for most inputs than using RegExp.exec or iterating over each character.
|
|
381
|
+
var tokens1 = str1.toLowerCase().match(goog.string.numerateCompareRegExp_);
|
|
382
|
+
var tokens2 = str2.toLowerCase().match(goog.string.numerateCompareRegExp_);
|
|
383
|
+
|
|
384
|
+
var count = Math.min(tokens1.length, tokens2.length);
|
|
385
|
+
|
|
386
|
+
for (var i = 0; i < count; i++) {
|
|
387
|
+
var a = tokens1[i];
|
|
388
|
+
var b = tokens2[i];
|
|
389
|
+
|
|
390
|
+
// Compare pairs of tokens, returning if one token sorts before the other.
|
|
391
|
+
if (a != b) {
|
|
392
|
+
|
|
393
|
+
// Only if both tokens are integers is a special comparison required.
|
|
394
|
+
// Decimal numbers are sorted as strings (e.g., '.09' < '.1').
|
|
395
|
+
var num1 = parseInt(a, 10);
|
|
396
|
+
if (!isNaN(num1)) {
|
|
397
|
+
var num2 = parseInt(b, 10);
|
|
398
|
+
if (!isNaN(num2) && num1 - num2) {
|
|
399
|
+
return num1 - num2;
|
|
400
|
+
}
|
|
401
|
+
}
|
|
402
|
+
return a < b ? -1 : 1;
|
|
403
|
+
}
|
|
404
|
+
}
|
|
405
|
+
|
|
406
|
+
// If one string is a substring of the other, the shorter string sorts first.
|
|
407
|
+
if (tokens1.length != tokens2.length) {
|
|
408
|
+
return tokens1.length - tokens2.length;
|
|
409
|
+
}
|
|
410
|
+
|
|
411
|
+
// The two strings must be equivalent except for case (perfect equality is
|
|
412
|
+
// tested at the head of the function.) Revert to default ASCII-betical string
|
|
413
|
+
// comparison to stablize the sort.
|
|
414
|
+
return str1 < str2 ? -1 : 1;
|
|
415
|
+
};
|
|
416
|
+
|
|
417
|
+
|
|
418
|
+
/**
|
|
419
|
+
* Regular expression used for determining if a string needs to be encoded.
|
|
420
|
+
* @type {RegExp}
|
|
421
|
+
* @private
|
|
422
|
+
*/
|
|
423
|
+
goog.string.encodeUriRegExp_ = /^[a-zA-Z0-9\-_.!~*'()]*$/;
|
|
424
|
+
|
|
425
|
+
|
|
426
|
+
/**
|
|
427
|
+
* URL-encodes a string
|
|
428
|
+
* @param {*} str The string to url-encode.
|
|
429
|
+
* @return {string} An encoded copy of {@code str} that is safe for urls.
|
|
430
|
+
* Note that '#', ':', and other characters used to delimit portions
|
|
431
|
+
* of URLs *will* be encoded.
|
|
432
|
+
*/
|
|
433
|
+
goog.string.urlEncode = function(str) {
|
|
434
|
+
str = String(str);
|
|
435
|
+
// Checking if the search matches before calling encodeURIComponent avoids an
|
|
436
|
+
// extra allocation in IE6. This adds about 10us time in FF and a similiar
|
|
437
|
+
// over head in IE6 for lower working set apps, but for large working set
|
|
438
|
+
// apps like Gmail, it saves about 70us per call.
|
|
439
|
+
if (!goog.string.encodeUriRegExp_.test(str)) {
|
|
440
|
+
return encodeURIComponent(str);
|
|
441
|
+
}
|
|
442
|
+
return str;
|
|
443
|
+
};
|
|
444
|
+
|
|
445
|
+
|
|
446
|
+
/**
|
|
447
|
+
* URL-decodes the string. We need to specially handle '+'s because
|
|
448
|
+
* the javascript library doesn't convert them to spaces.
|
|
449
|
+
* @param {string} str The string to url decode.
|
|
450
|
+
* @return {string} The decoded {@code str}.
|
|
451
|
+
*/
|
|
452
|
+
goog.string.urlDecode = function(str) {
|
|
453
|
+
return decodeURIComponent(str.replace(/\+/g, ' '));
|
|
454
|
+
};
|
|
455
|
+
|
|
456
|
+
|
|
457
|
+
/**
|
|
458
|
+
* Converts \n to <br>s or <br />s.
|
|
459
|
+
* @param {string} str The string in which to convert newlines.
|
|
460
|
+
* @param {boolean=} opt_xml Whether to use XML compatible tags.
|
|
461
|
+
* @return {string} A copy of {@code str} with converted newlines.
|
|
462
|
+
*/
|
|
463
|
+
goog.string.newLineToBr = function(str, opt_xml) {
|
|
464
|
+
return str.replace(/(\r\n|\r|\n)/g, opt_xml ? '<br />' : '<br>');
|
|
465
|
+
};
|
|
466
|
+
|
|
467
|
+
|
|
468
|
+
/**
|
|
469
|
+
* Escape double quote '"' characters in addition to '&', '<', and '>' so that a
|
|
470
|
+
* string can be included in an HTML tag attribute value within double quotes.
|
|
471
|
+
*
|
|
472
|
+
* It should be noted that > doesn't need to be escaped for the HTML or XML to
|
|
473
|
+
* be valid, but it has been decided to escape it for consistency with other
|
|
474
|
+
* implementations.
|
|
475
|
+
*
|
|
476
|
+
* NOTE(user):
|
|
477
|
+
* HtmlEscape is often called during the generation of large blocks of HTML.
|
|
478
|
+
* Using statics for the regular expressions and strings is an optimization
|
|
479
|
+
* that can more than half the amount of time IE spends in this function for
|
|
480
|
+
* large apps, since strings and regexes both contribute to GC allocations.
|
|
481
|
+
*
|
|
482
|
+
* Testing for the presence of a character before escaping increases the number
|
|
483
|
+
* of function calls, but actually provides a speed increase for the average
|
|
484
|
+
* case -- since the average case often doesn't require the escaping of all 4
|
|
485
|
+
* characters and indexOf() is much cheaper than replace().
|
|
486
|
+
* The worst case does suffer slightly from the additional calls, therefore the
|
|
487
|
+
* opt_isLikelyToContainHtmlChars option has been included for situations
|
|
488
|
+
* where all 4 HTML entities are very likely to be present and need escaping.
|
|
489
|
+
*
|
|
490
|
+
* Some benchmarks (times tended to fluctuate +-0.05ms):
|
|
491
|
+
* FireFox IE6
|
|
492
|
+
* (no chars / average (mix of cases) / all 4 chars)
|
|
493
|
+
* no checks 0.13 / 0.22 / 0.22 0.23 / 0.53 / 0.80
|
|
494
|
+
* indexOf 0.08 / 0.17 / 0.26 0.22 / 0.54 / 0.84
|
|
495
|
+
* indexOf + re test 0.07 / 0.17 / 0.28 0.19 / 0.50 / 0.85
|
|
496
|
+
*
|
|
497
|
+
* An additional advantage of checking if replace actually needs to be called
|
|
498
|
+
* is a reduction in the number of object allocations, so as the size of the
|
|
499
|
+
* application grows the difference between the various methods would increase.
|
|
500
|
+
*
|
|
501
|
+
* @param {string} str string to be escaped.
|
|
502
|
+
* @param {boolean=} opt_isLikelyToContainHtmlChars Don't perform a check to see
|
|
503
|
+
* if the character needs replacing - use this option if you expect each of
|
|
504
|
+
* the characters to appear often. Leave false if you expect few html
|
|
505
|
+
* characters to occur in your strings, such as if you are escaping HTML.
|
|
506
|
+
* @return {string} An escaped copy of {@code str}.
|
|
507
|
+
*/
|
|
508
|
+
goog.string.htmlEscape = function(str, opt_isLikelyToContainHtmlChars) {
|
|
509
|
+
|
|
510
|
+
if (opt_isLikelyToContainHtmlChars) {
|
|
511
|
+
return str.replace(goog.string.amperRe_, '&')
|
|
512
|
+
.replace(goog.string.ltRe_, '<')
|
|
513
|
+
.replace(goog.string.gtRe_, '>')
|
|
514
|
+
.replace(goog.string.quotRe_, '"');
|
|
515
|
+
|
|
516
|
+
} else {
|
|
517
|
+
// quick test helps in the case when there are no chars to replace, in
|
|
518
|
+
// worst case this makes barely a difference to the time taken
|
|
519
|
+
if (!goog.string.allRe_.test(str)) return str;
|
|
520
|
+
|
|
521
|
+
// str.indexOf is faster than regex.test in this case
|
|
522
|
+
if (str.indexOf('&') != -1) {
|
|
523
|
+
str = str.replace(goog.string.amperRe_, '&');
|
|
524
|
+
}
|
|
525
|
+
if (str.indexOf('<') != -1) {
|
|
526
|
+
str = str.replace(goog.string.ltRe_, '<');
|
|
527
|
+
}
|
|
528
|
+
if (str.indexOf('>') != -1) {
|
|
529
|
+
str = str.replace(goog.string.gtRe_, '>');
|
|
530
|
+
}
|
|
531
|
+
if (str.indexOf('"') != -1) {
|
|
532
|
+
str = str.replace(goog.string.quotRe_, '"');
|
|
533
|
+
}
|
|
534
|
+
return str;
|
|
535
|
+
}
|
|
536
|
+
};
|
|
537
|
+
|
|
538
|
+
|
|
539
|
+
/**
|
|
540
|
+
* Regular expression that matches an ampersand, for use in escaping.
|
|
541
|
+
* @type {RegExp}
|
|
542
|
+
* @private
|
|
543
|
+
*/
|
|
544
|
+
goog.string.amperRe_ = /&/g;
|
|
545
|
+
|
|
546
|
+
|
|
547
|
+
/**
|
|
548
|
+
* Regular expression that matches a less than sign, for use in escaping.
|
|
549
|
+
* @type {RegExp}
|
|
550
|
+
* @private
|
|
551
|
+
*/
|
|
552
|
+
goog.string.ltRe_ = /</g;
|
|
553
|
+
|
|
554
|
+
|
|
555
|
+
/**
|
|
556
|
+
* Regular expression that matches a greater than sign, for use in escaping.
|
|
557
|
+
* @type {RegExp}
|
|
558
|
+
* @private
|
|
559
|
+
*/
|
|
560
|
+
goog.string.gtRe_ = />/g;
|
|
561
|
+
|
|
562
|
+
|
|
563
|
+
/**
|
|
564
|
+
* Regular expression that matches a double quote, for use in escaping.
|
|
565
|
+
* @type {RegExp}
|
|
566
|
+
* @private
|
|
567
|
+
*/
|
|
568
|
+
goog.string.quotRe_ = /\"/g;
|
|
569
|
+
|
|
570
|
+
|
|
571
|
+
/**
|
|
572
|
+
* Regular expression that matches any character that needs to be escaped.
|
|
573
|
+
* @type {RegExp}
|
|
574
|
+
* @private
|
|
575
|
+
*/
|
|
576
|
+
goog.string.allRe_ = /[&<>\"]/;
|
|
577
|
+
|
|
578
|
+
|
|
579
|
+
/**
|
|
580
|
+
* Unescapes an HTML string.
|
|
581
|
+
*
|
|
582
|
+
* @param {string} str The string to unescape.
|
|
583
|
+
* @return {string} An unescaped copy of {@code str}.
|
|
584
|
+
*/
|
|
585
|
+
goog.string.unescapeEntities = function(str) {
|
|
586
|
+
if (goog.string.contains(str, '&')) {
|
|
587
|
+
// We are careful not to use a DOM if we do not have one. We use the []
|
|
588
|
+
// notation so that the JSCompiler will not complain about these objects and
|
|
589
|
+
// fields in the case where we have no DOM.
|
|
590
|
+
if ('document' in goog.global) {
|
|
591
|
+
return goog.string.unescapeEntitiesUsingDom_(str);
|
|
592
|
+
} else {
|
|
593
|
+
// Fall back on pure XML entities
|
|
594
|
+
return goog.string.unescapePureXmlEntities_(str);
|
|
595
|
+
}
|
|
596
|
+
}
|
|
597
|
+
return str;
|
|
598
|
+
};
|
|
599
|
+
|
|
600
|
+
|
|
601
|
+
/**
|
|
602
|
+
* Unescapes an HTML string using a DOM to resolve non-XML, non-numeric
|
|
603
|
+
* entities. This function is XSS-safe and whitespace-preserving.
|
|
604
|
+
* @private
|
|
605
|
+
* @param {string} str The string to unescape.
|
|
606
|
+
* @return {string} The unescaped {@code str} string.
|
|
607
|
+
*/
|
|
608
|
+
goog.string.unescapeEntitiesUsingDom_ = function(str) {
|
|
609
|
+
var seen = {'&': '&', '<': '<', '>': '>', '"': '"'};
|
|
610
|
+
var div = document.createElement('div');
|
|
611
|
+
// Match as many valid entity characters as possible. If the actual entity
|
|
612
|
+
// happens to be shorter, it will still work as innerHTML will return the
|
|
613
|
+
// trailing characters unchanged. Since the entity characters do not include
|
|
614
|
+
// open angle bracket, there is no chance of XSS from the innerHTML use.
|
|
615
|
+
// Since no whitespace is passed to innerHTML, whitespace is preserved.
|
|
616
|
+
return str.replace(goog.string.HTML_ENTITY_PATTERN_, function(s, entity) {
|
|
617
|
+
// Check for cached entity.
|
|
618
|
+
var value = seen[s];
|
|
619
|
+
if (value) {
|
|
620
|
+
return value;
|
|
621
|
+
}
|
|
622
|
+
// Check for numeric entity.
|
|
623
|
+
if (entity.charAt(0) == '#') {
|
|
624
|
+
// Prefix with 0 so that hex entities (e.g. ) parse as hex numbers.
|
|
625
|
+
var n = Number('0' + entity.substr(1));
|
|
626
|
+
if (!isNaN(n)) {
|
|
627
|
+
value = String.fromCharCode(n);
|
|
628
|
+
}
|
|
629
|
+
}
|
|
630
|
+
// Fall back to innerHTML otherwise.
|
|
631
|
+
if (!value) {
|
|
632
|
+
// Append a non-entity character to avoid a bug in Webkit that parses
|
|
633
|
+
// an invalid entity at the end of innerHTML text as the empty string.
|
|
634
|
+
div.innerHTML = s + ' ';
|
|
635
|
+
// Then remove the trailing character from the result.
|
|
636
|
+
value = div.firstChild.nodeValue.slice(0, -1);
|
|
637
|
+
}
|
|
638
|
+
// Cache and return.
|
|
639
|
+
return seen[s] = value;
|
|
640
|
+
});
|
|
641
|
+
};
|
|
642
|
+
|
|
643
|
+
|
|
644
|
+
/**
|
|
645
|
+
* Unescapes XML entities.
|
|
646
|
+
* @private
|
|
647
|
+
* @param {string} str The string to unescape.
|
|
648
|
+
* @return {string} An unescaped copy of {@code str}.
|
|
649
|
+
*/
|
|
650
|
+
goog.string.unescapePureXmlEntities_ = function(str) {
|
|
651
|
+
return str.replace(/&([^;]+);/g, function(s, entity) {
|
|
652
|
+
switch (entity) {
|
|
653
|
+
case 'amp':
|
|
654
|
+
return '&';
|
|
655
|
+
case 'lt':
|
|
656
|
+
return '<';
|
|
657
|
+
case 'gt':
|
|
658
|
+
return '>';
|
|
659
|
+
case 'quot':
|
|
660
|
+
return '"';
|
|
661
|
+
default:
|
|
662
|
+
if (entity.charAt(0) == '#') {
|
|
663
|
+
// Prefix with 0 so that hex entities (e.g. ) parse as hex.
|
|
664
|
+
var n = Number('0' + entity.substr(1));
|
|
665
|
+
if (!isNaN(n)) {
|
|
666
|
+
return String.fromCharCode(n);
|
|
667
|
+
}
|
|
668
|
+
}
|
|
669
|
+
// For invalid entities we just return the entity
|
|
670
|
+
return s;
|
|
671
|
+
}
|
|
672
|
+
});
|
|
673
|
+
};
|
|
674
|
+
|
|
675
|
+
|
|
676
|
+
/**
|
|
677
|
+
* Regular expression that matches an HTML entity.
|
|
678
|
+
* See also HTML5: Tokenization / Tokenizing character references.
|
|
679
|
+
* @private
|
|
680
|
+
* @type {!RegExp}
|
|
681
|
+
*/
|
|
682
|
+
goog.string.HTML_ENTITY_PATTERN_ = /&([^;\s<&]+);?/g;
|
|
683
|
+
|
|
684
|
+
|
|
685
|
+
/**
|
|
686
|
+
* Do escaping of whitespace to preserve spatial formatting. We use character
|
|
687
|
+
* entity #160 to make it safer for xml.
|
|
688
|
+
* @param {string} str The string in which to escape whitespace.
|
|
689
|
+
* @param {boolean=} opt_xml Whether to use XML compatible tags.
|
|
690
|
+
* @return {string} An escaped copy of {@code str}.
|
|
691
|
+
*/
|
|
692
|
+
goog.string.whitespaceEscape = function(str, opt_xml) {
|
|
693
|
+
return goog.string.newLineToBr(str.replace(/ /g, '  '), opt_xml);
|
|
694
|
+
};
|
|
695
|
+
|
|
696
|
+
|
|
697
|
+
/**
|
|
698
|
+
* Strip quote characters around a string. The second argument is a string of
|
|
699
|
+
* characters to treat as quotes. This can be a single character or a string of
|
|
700
|
+
* multiple character and in that case each of those are treated as possible
|
|
701
|
+
* quote characters. For example:
|
|
702
|
+
*
|
|
703
|
+
* <pre>
|
|
704
|
+
* goog.string.stripQuotes('"abc"', '"`') --> 'abc'
|
|
705
|
+
* goog.string.stripQuotes('`abc`', '"`') --> 'abc'
|
|
706
|
+
* </pre>
|
|
707
|
+
*
|
|
708
|
+
* @param {string} str The string to strip.
|
|
709
|
+
* @param {string} quoteChars The quote characters to strip.
|
|
710
|
+
* @return {string} A copy of {@code str} without the quotes.
|
|
711
|
+
*/
|
|
712
|
+
goog.string.stripQuotes = function(str, quoteChars) {
|
|
713
|
+
var length = quoteChars.length;
|
|
714
|
+
for (var i = 0; i < length; i++) {
|
|
715
|
+
var quoteChar = length == 1 ? quoteChars : quoteChars.charAt(i);
|
|
716
|
+
if (str.charAt(0) == quoteChar && str.charAt(str.length - 1) == quoteChar) {
|
|
717
|
+
return str.substring(1, str.length - 1);
|
|
718
|
+
}
|
|
719
|
+
}
|
|
720
|
+
return str;
|
|
721
|
+
};
|
|
722
|
+
|
|
723
|
+
|
|
724
|
+
/**
|
|
725
|
+
* Truncates a string to a certain length and adds '...' if necessary. The
|
|
726
|
+
* length also accounts for the ellipsis, so a maximum length of 10 and a string
|
|
727
|
+
* 'Hello World!' produces 'Hello W...'.
|
|
728
|
+
* @param {string} str The string to truncate.
|
|
729
|
+
* @param {number} chars Max number of characters.
|
|
730
|
+
* @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped
|
|
731
|
+
* characters from being cut off in the middle.
|
|
732
|
+
* @return {string} The truncated {@code str} string.
|
|
733
|
+
*/
|
|
734
|
+
goog.string.truncate = function(str, chars, opt_protectEscapedCharacters) {
|
|
735
|
+
if (opt_protectEscapedCharacters) {
|
|
736
|
+
str = goog.string.unescapeEntities(str);
|
|
737
|
+
}
|
|
738
|
+
|
|
739
|
+
if (str.length > chars) {
|
|
740
|
+
str = str.substring(0, chars - 3) + '...';
|
|
741
|
+
}
|
|
742
|
+
|
|
743
|
+
if (opt_protectEscapedCharacters) {
|
|
744
|
+
str = goog.string.htmlEscape(str);
|
|
745
|
+
}
|
|
746
|
+
|
|
747
|
+
return str;
|
|
748
|
+
};
|
|
749
|
+
|
|
750
|
+
|
|
751
|
+
/**
|
|
752
|
+
* Truncate a string in the middle, adding "..." if necessary,
|
|
753
|
+
* and favoring the beginning of the string.
|
|
754
|
+
* @param {string} str The string to truncate the middle of.
|
|
755
|
+
* @param {number} chars Max number of characters.
|
|
756
|
+
* @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped
|
|
757
|
+
* characters from being cutoff in the middle.
|
|
758
|
+
* @param {number=} opt_trailingChars Optional number of trailing characters to
|
|
759
|
+
* leave at the end of the string, instead of truncating as close to the
|
|
760
|
+
* middle as possible.
|
|
761
|
+
* @return {string} A truncated copy of {@code str}.
|
|
762
|
+
*/
|
|
763
|
+
goog.string.truncateMiddle = function(str, chars,
|
|
764
|
+
opt_protectEscapedCharacters, opt_trailingChars) {
|
|
765
|
+
if (opt_protectEscapedCharacters) {
|
|
766
|
+
str = goog.string.unescapeEntities(str);
|
|
767
|
+
}
|
|
768
|
+
|
|
769
|
+
if (opt_trailingChars && str.length > chars) {
|
|
770
|
+
if (opt_trailingChars > chars) {
|
|
771
|
+
opt_trailingChars = chars;
|
|
772
|
+
}
|
|
773
|
+
var endPoint = str.length - opt_trailingChars;
|
|
774
|
+
var startPoint = chars - opt_trailingChars;
|
|
775
|
+
str = str.substring(0, startPoint) + '...' + str.substring(endPoint);
|
|
776
|
+
} else if (str.length > chars) {
|
|
777
|
+
// Favor the beginning of the string:
|
|
778
|
+
var half = Math.floor(chars / 2);
|
|
779
|
+
var endPos = str.length - half;
|
|
780
|
+
half += chars % 2;
|
|
781
|
+
str = str.substring(0, half) + '...' + str.substring(endPos);
|
|
782
|
+
}
|
|
783
|
+
|
|
784
|
+
if (opt_protectEscapedCharacters) {
|
|
785
|
+
str = goog.string.htmlEscape(str);
|
|
786
|
+
}
|
|
787
|
+
|
|
788
|
+
return str;
|
|
789
|
+
};
|
|
790
|
+
|
|
791
|
+
|
|
792
|
+
/**
|
|
793
|
+
* Special chars that need to be escaped for goog.string.quote.
|
|
794
|
+
* @private
|
|
795
|
+
* @type {Object}
|
|
796
|
+
*/
|
|
797
|
+
goog.string.specialEscapeChars_ = {
|
|
798
|
+
'\0': '\\0',
|
|
799
|
+
'\b': '\\b',
|
|
800
|
+
'\f': '\\f',
|
|
801
|
+
'\n': '\\n',
|
|
802
|
+
'\r': '\\r',
|
|
803
|
+
'\t': '\\t',
|
|
804
|
+
'\x0B': '\\x0B', // '\v' is not supported in JScript
|
|
805
|
+
'"': '\\"',
|
|
806
|
+
'\\': '\\\\'
|
|
807
|
+
};
|
|
808
|
+
|
|
809
|
+
|
|
810
|
+
/**
|
|
811
|
+
* Character mappings used internally for goog.string.escapeChar.
|
|
812
|
+
* @private
|
|
813
|
+
* @type {Object}
|
|
814
|
+
*/
|
|
815
|
+
goog.string.jsEscapeCache_ = {
|
|
816
|
+
'\'': '\\\''
|
|
817
|
+
};
|
|
818
|
+
|
|
819
|
+
|
|
820
|
+
/**
|
|
821
|
+
* Encloses a string in double quotes and escapes characters so that the
|
|
822
|
+
* string is a valid JS string.
|
|
823
|
+
* @param {string} s The string to quote.
|
|
824
|
+
* @return {string} A copy of {@code s} surrounded by double quotes.
|
|
825
|
+
*/
|
|
826
|
+
goog.string.quote = function(s) {
|
|
827
|
+
s = String(s);
|
|
828
|
+
if (s.quote) {
|
|
829
|
+
return s.quote();
|
|
830
|
+
} else {
|
|
831
|
+
var sb = ['"'];
|
|
832
|
+
for (var i = 0; i < s.length; i++) {
|
|
833
|
+
var ch = s.charAt(i);
|
|
834
|
+
var cc = ch.charCodeAt(0);
|
|
835
|
+
sb[i + 1] = goog.string.specialEscapeChars_[ch] ||
|
|
836
|
+
((cc > 31 && cc < 127) ? ch : goog.string.escapeChar(ch));
|
|
837
|
+
}
|
|
838
|
+
sb.push('"');
|
|
839
|
+
return sb.join('');
|
|
840
|
+
}
|
|
841
|
+
};
|
|
842
|
+
|
|
843
|
+
|
|
844
|
+
/**
|
|
845
|
+
* Takes a string and returns the escaped string for that character.
|
|
846
|
+
* @param {string} str The string to escape.
|
|
847
|
+
* @return {string} An escaped string representing {@code str}.
|
|
848
|
+
*/
|
|
849
|
+
goog.string.escapeString = function(str) {
|
|
850
|
+
var sb = [];
|
|
851
|
+
for (var i = 0; i < str.length; i++) {
|
|
852
|
+
sb[i] = goog.string.escapeChar(str.charAt(i));
|
|
853
|
+
}
|
|
854
|
+
return sb.join('');
|
|
855
|
+
};
|
|
856
|
+
|
|
857
|
+
|
|
858
|
+
/**
|
|
859
|
+
* Takes a character and returns the escaped string for that character. For
|
|
860
|
+
* example escapeChar(String.fromCharCode(15)) -> "\\x0E".
|
|
861
|
+
* @param {string} c The character to escape.
|
|
862
|
+
* @return {string} An escaped string representing {@code c}.
|
|
863
|
+
*/
|
|
864
|
+
goog.string.escapeChar = function(c) {
|
|
865
|
+
if (c in goog.string.jsEscapeCache_) {
|
|
866
|
+
return goog.string.jsEscapeCache_[c];
|
|
867
|
+
}
|
|
868
|
+
|
|
869
|
+
if (c in goog.string.specialEscapeChars_) {
|
|
870
|
+
return goog.string.jsEscapeCache_[c] = goog.string.specialEscapeChars_[c];
|
|
871
|
+
}
|
|
872
|
+
|
|
873
|
+
var rv = c;
|
|
874
|
+
var cc = c.charCodeAt(0);
|
|
875
|
+
if (cc > 31 && cc < 127) {
|
|
876
|
+
rv = c;
|
|
877
|
+
} else {
|
|
878
|
+
// tab is 9 but handled above
|
|
879
|
+
if (cc < 256) {
|
|
880
|
+
rv = '\\x';
|
|
881
|
+
if (cc < 16 || cc > 256) {
|
|
882
|
+
rv += '0';
|
|
883
|
+
}
|
|
884
|
+
} else {
|
|
885
|
+
rv = '\\u';
|
|
886
|
+
if (cc < 4096) { // \u1000
|
|
887
|
+
rv += '0';
|
|
888
|
+
}
|
|
889
|
+
}
|
|
890
|
+
rv += cc.toString(16).toUpperCase();
|
|
891
|
+
}
|
|
892
|
+
|
|
893
|
+
return goog.string.jsEscapeCache_[c] = rv;
|
|
894
|
+
};
|
|
895
|
+
|
|
896
|
+
|
|
897
|
+
/**
|
|
898
|
+
* Takes a string and creates a map (Object) in which the keys are the
|
|
899
|
+
* characters in the string. The value for the key is set to true. You can
|
|
900
|
+
* then use goog.object.map or goog.array.map to change the values.
|
|
901
|
+
* @param {string} s The string to build the map from.
|
|
902
|
+
* @return {Object} The map of characters used.
|
|
903
|
+
*/
|
|
904
|
+
// TODO(arv): It seems like we should have a generic goog.array.toMap. But do
|
|
905
|
+
// we want a dependency on goog.array in goog.string?
|
|
906
|
+
goog.string.toMap = function(s) {
|
|
907
|
+
var rv = {};
|
|
908
|
+
for (var i = 0; i < s.length; i++) {
|
|
909
|
+
rv[s.charAt(i)] = true;
|
|
910
|
+
}
|
|
911
|
+
return rv;
|
|
912
|
+
};
|
|
913
|
+
|
|
914
|
+
|
|
915
|
+
/**
|
|
916
|
+
* Checks whether a string contains a given character.
|
|
917
|
+
* @param {string} s The string to test.
|
|
918
|
+
* @param {string} ss The substring to test for.
|
|
919
|
+
* @return {boolean} True if {@code s} contains {@code ss}.
|
|
920
|
+
*/
|
|
921
|
+
goog.string.contains = function(s, ss) {
|
|
922
|
+
return s.indexOf(ss) != -1;
|
|
923
|
+
};
|
|
924
|
+
|
|
925
|
+
|
|
926
|
+
/**
|
|
927
|
+
* Returns the non-overlapping occurrences of ss in s.
|
|
928
|
+
* If either s or ss evalutes to false, then returns zero.
|
|
929
|
+
* @param {string} s The string to look in.
|
|
930
|
+
* @param {string} ss The string to look for.
|
|
931
|
+
* @return {number} Number of occurrences of ss in s.
|
|
932
|
+
*/
|
|
933
|
+
goog.string.countOf = function(s, ss) {
|
|
934
|
+
return s && ss ? s.split(ss).length - 1 : 0;
|
|
935
|
+
};
|
|
936
|
+
|
|
937
|
+
|
|
938
|
+
/**
|
|
939
|
+
* Removes a substring of a specified length at a specific
|
|
940
|
+
* index in a string.
|
|
941
|
+
* @param {string} s The base string from which to remove.
|
|
942
|
+
* @param {number} index The index at which to remove the substring.
|
|
943
|
+
* @param {number} stringLength The length of the substring to remove.
|
|
944
|
+
* @return {string} A copy of {@code s} with the substring removed or the full
|
|
945
|
+
* string if nothing is removed or the input is invalid.
|
|
946
|
+
*/
|
|
947
|
+
goog.string.removeAt = function(s, index, stringLength) {
|
|
948
|
+
var resultStr = s;
|
|
949
|
+
// If the index is greater or equal to 0 then remove substring
|
|
950
|
+
if (index >= 0 && index < s.length && stringLength > 0) {
|
|
951
|
+
resultStr = s.substr(0, index) +
|
|
952
|
+
s.substr(index + stringLength, s.length - index - stringLength);
|
|
953
|
+
}
|
|
954
|
+
return resultStr;
|
|
955
|
+
};
|
|
956
|
+
|
|
957
|
+
|
|
958
|
+
/**
|
|
959
|
+
* Removes the first occurrence of a substring from a string.
|
|
960
|
+
* @param {string} s The base string from which to remove.
|
|
961
|
+
* @param {string} ss The string to remove.
|
|
962
|
+
* @return {string} A copy of {@code s} with {@code ss} removed or the full
|
|
963
|
+
* string if nothing is removed.
|
|
964
|
+
*/
|
|
965
|
+
goog.string.remove = function(s, ss) {
|
|
966
|
+
var re = new RegExp(goog.string.regExpEscape(ss), '');
|
|
967
|
+
return s.replace(re, '');
|
|
968
|
+
};
|
|
969
|
+
|
|
970
|
+
|
|
971
|
+
/**
|
|
972
|
+
* Removes all occurrences of a substring from a string.
|
|
973
|
+
* @param {string} s The base string from which to remove.
|
|
974
|
+
* @param {string} ss The string to remove.
|
|
975
|
+
* @return {string} A copy of {@code s} with {@code ss} removed or the full
|
|
976
|
+
* string if nothing is removed.
|
|
977
|
+
*/
|
|
978
|
+
goog.string.removeAll = function(s, ss) {
|
|
979
|
+
var re = new RegExp(goog.string.regExpEscape(ss), 'g');
|
|
980
|
+
return s.replace(re, '');
|
|
981
|
+
};
|
|
982
|
+
|
|
983
|
+
|
|
984
|
+
/**
|
|
985
|
+
* Escapes characters in the string that are not safe to use in a RegExp.
|
|
986
|
+
* @param {*} s The string to escape. If not a string, it will be casted
|
|
987
|
+
* to one.
|
|
988
|
+
* @return {string} A RegExp safe, escaped copy of {@code s}.
|
|
989
|
+
*/
|
|
990
|
+
goog.string.regExpEscape = function(s) {
|
|
991
|
+
return String(s).replace(/([-()\[\]{}+?*.$\^|,:#<!\\])/g, '\\$1').
|
|
992
|
+
replace(/\x08/g, '\\x08');
|
|
993
|
+
};
|
|
994
|
+
|
|
995
|
+
|
|
996
|
+
/**
|
|
997
|
+
* Repeats a string n times.
|
|
998
|
+
* @param {string} string The string to repeat.
|
|
999
|
+
* @param {number} length The number of times to repeat.
|
|
1000
|
+
* @return {string} A string containing {@code length} repetitions of
|
|
1001
|
+
* {@code string}.
|
|
1002
|
+
*/
|
|
1003
|
+
goog.string.repeat = function(string, length) {
|
|
1004
|
+
return new Array(length + 1).join(string);
|
|
1005
|
+
};
|
|
1006
|
+
|
|
1007
|
+
|
|
1008
|
+
/**
|
|
1009
|
+
* Pads number to given length and optionally rounds it to a given precision.
|
|
1010
|
+
* For example:
|
|
1011
|
+
* <pre>padNumber(1.25, 2, 3) -> '01.250'
|
|
1012
|
+
* padNumber(1.25, 2) -> '01.25'
|
|
1013
|
+
* padNumber(1.25, 2, 1) -> '01.3'
|
|
1014
|
+
* padNumber(1.25, 0) -> '1.25'</pre>
|
|
1015
|
+
*
|
|
1016
|
+
* @param {number} num The number to pad.
|
|
1017
|
+
* @param {number} length The desired length.
|
|
1018
|
+
* @param {number=} opt_precision The desired precision.
|
|
1019
|
+
* @return {string} {@code num} as a string with the given options.
|
|
1020
|
+
*/
|
|
1021
|
+
goog.string.padNumber = function(num, length, opt_precision) {
|
|
1022
|
+
var s = goog.isDef(opt_precision) ? num.toFixed(opt_precision) : String(num);
|
|
1023
|
+
var index = s.indexOf('.');
|
|
1024
|
+
if (index == -1) {
|
|
1025
|
+
index = s.length;
|
|
1026
|
+
}
|
|
1027
|
+
return goog.string.repeat('0', Math.max(0, length - index)) + s;
|
|
1028
|
+
};
|
|
1029
|
+
|
|
1030
|
+
|
|
1031
|
+
/**
|
|
1032
|
+
* Returns a string representation of the given object, with
|
|
1033
|
+
* null and undefined being returned as the empty string.
|
|
1034
|
+
*
|
|
1035
|
+
* @param {*} obj The object to convert.
|
|
1036
|
+
* @return {string} A string representation of the {@code obj}.
|
|
1037
|
+
*/
|
|
1038
|
+
goog.string.makeSafe = function(obj) {
|
|
1039
|
+
return obj == null ? '' : String(obj);
|
|
1040
|
+
};
|
|
1041
|
+
|
|
1042
|
+
|
|
1043
|
+
/**
|
|
1044
|
+
* Concatenates string expressions. This is useful
|
|
1045
|
+
* since some browsers are very inefficient when it comes to using plus to
|
|
1046
|
+
* concat strings. Be careful when using null and undefined here since
|
|
1047
|
+
* these will not be included in the result. If you need to represent these
|
|
1048
|
+
* be sure to cast the argument to a String first.
|
|
1049
|
+
* For example:
|
|
1050
|
+
* <pre>buildString('a', 'b', 'c', 'd') -> 'abcd'
|
|
1051
|
+
* buildString(null, undefined) -> ''
|
|
1052
|
+
* </pre>
|
|
1053
|
+
* @param {...*} var_args A list of strings to concatenate. If not a string,
|
|
1054
|
+
* it will be casted to one.
|
|
1055
|
+
* @return {string} The concatenation of {@code var_args}.
|
|
1056
|
+
*/
|
|
1057
|
+
goog.string.buildString = function(var_args) {
|
|
1058
|
+
return Array.prototype.join.call(arguments, '');
|
|
1059
|
+
};
|
|
1060
|
+
|
|
1061
|
+
|
|
1062
|
+
/**
|
|
1063
|
+
* Returns a string with at least 64-bits of randomness.
|
|
1064
|
+
*
|
|
1065
|
+
* Doesn't trust Javascript's random function entirely. Uses a combination of
|
|
1066
|
+
* random and current timestamp, and then encodes the string in base-36 to
|
|
1067
|
+
* make it shorter.
|
|
1068
|
+
*
|
|
1069
|
+
* @return {string} A random string, e.g. sn1s7vb4gcic.
|
|
1070
|
+
*/
|
|
1071
|
+
goog.string.getRandomString = function() {
|
|
1072
|
+
var x = 2147483648;
|
|
1073
|
+
return Math.floor(Math.random() * x).toString(36) +
|
|
1074
|
+
Math.abs(Math.floor(Math.random() * x) ^ goog.now()).toString(36);
|
|
1075
|
+
};
|
|
1076
|
+
|
|
1077
|
+
|
|
1078
|
+
/**
|
|
1079
|
+
* Compares two version numbers.
|
|
1080
|
+
*
|
|
1081
|
+
* @param {string|number} version1 Version of first item.
|
|
1082
|
+
* @param {string|number} version2 Version of second item.
|
|
1083
|
+
*
|
|
1084
|
+
* @return {number} 1 if {@code version1} is higher.
|
|
1085
|
+
* 0 if arguments are equal.
|
|
1086
|
+
* -1 if {@code version2} is higher.
|
|
1087
|
+
*/
|
|
1088
|
+
goog.string.compareVersions = function(version1, version2) {
|
|
1089
|
+
var order = 0;
|
|
1090
|
+
// Trim leading and trailing whitespace and split the versions into
|
|
1091
|
+
// subversions.
|
|
1092
|
+
var v1Subs = goog.string.trim(String(version1)).split('.');
|
|
1093
|
+
var v2Subs = goog.string.trim(String(version2)).split('.');
|
|
1094
|
+
var subCount = Math.max(v1Subs.length, v2Subs.length);
|
|
1095
|
+
|
|
1096
|
+
// Iterate over the subversions, as long as they appear to be equivalent.
|
|
1097
|
+
for (var subIdx = 0; order == 0 && subIdx < subCount; subIdx++) {
|
|
1098
|
+
var v1Sub = v1Subs[subIdx] || '';
|
|
1099
|
+
var v2Sub = v2Subs[subIdx] || '';
|
|
1100
|
+
|
|
1101
|
+
// Split the subversions into pairs of numbers and qualifiers (like 'b').
|
|
1102
|
+
// Two different RegExp objects are needed because they are both using
|
|
1103
|
+
// the 'g' flag.
|
|
1104
|
+
var v1CompParser = new RegExp('(\\d*)(\\D*)', 'g');
|
|
1105
|
+
var v2CompParser = new RegExp('(\\d*)(\\D*)', 'g');
|
|
1106
|
+
do {
|
|
1107
|
+
var v1Comp = v1CompParser.exec(v1Sub) || ['', '', ''];
|
|
1108
|
+
var v2Comp = v2CompParser.exec(v2Sub) || ['', '', ''];
|
|
1109
|
+
// Break if there are no more matches.
|
|
1110
|
+
if (v1Comp[0].length == 0 && v2Comp[0].length == 0) {
|
|
1111
|
+
break;
|
|
1112
|
+
}
|
|
1113
|
+
|
|
1114
|
+
// Parse the numeric part of the subversion. A missing number is
|
|
1115
|
+
// equivalent to 0.
|
|
1116
|
+
var v1CompNum = v1Comp[1].length == 0 ? 0 : parseInt(v1Comp[1], 10);
|
|
1117
|
+
var v2CompNum = v2Comp[1].length == 0 ? 0 : parseInt(v2Comp[1], 10);
|
|
1118
|
+
|
|
1119
|
+
// Compare the subversion components. The number has the highest
|
|
1120
|
+
// precedence. Next, if the numbers are equal, a subversion without any
|
|
1121
|
+
// qualifier is always higher than a subversion with any qualifier. Next,
|
|
1122
|
+
// the qualifiers are compared as strings.
|
|
1123
|
+
order = goog.string.compareElements_(v1CompNum, v2CompNum) ||
|
|
1124
|
+
goog.string.compareElements_(v1Comp[2].length == 0,
|
|
1125
|
+
v2Comp[2].length == 0) ||
|
|
1126
|
+
goog.string.compareElements_(v1Comp[2], v2Comp[2]);
|
|
1127
|
+
// Stop as soon as an inequality is discovered.
|
|
1128
|
+
} while (order == 0);
|
|
1129
|
+
}
|
|
1130
|
+
|
|
1131
|
+
return order;
|
|
1132
|
+
};
|
|
1133
|
+
|
|
1134
|
+
|
|
1135
|
+
/**
|
|
1136
|
+
* Compares elements of a version number.
|
|
1137
|
+
*
|
|
1138
|
+
* @param {string|number|boolean} left An element from a version number.
|
|
1139
|
+
* @param {string|number|boolean} right An element from a version number.
|
|
1140
|
+
*
|
|
1141
|
+
* @return {number} 1 if {@code left} is higher.
|
|
1142
|
+
* 0 if arguments are equal.
|
|
1143
|
+
* -1 if {@code right} is higher.
|
|
1144
|
+
* @private
|
|
1145
|
+
*/
|
|
1146
|
+
goog.string.compareElements_ = function(left, right) {
|
|
1147
|
+
if (left < right) {
|
|
1148
|
+
return -1;
|
|
1149
|
+
} else if (left > right) {
|
|
1150
|
+
return 1;
|
|
1151
|
+
}
|
|
1152
|
+
return 0;
|
|
1153
|
+
};
|
|
1154
|
+
|
|
1155
|
+
|
|
1156
|
+
/**
|
|
1157
|
+
* Maximum value of #goog.string.hashCode, exclusive. 2^32.
|
|
1158
|
+
* @type {number}
|
|
1159
|
+
* @private
|
|
1160
|
+
*/
|
|
1161
|
+
goog.string.HASHCODE_MAX_ = 0x100000000;
|
|
1162
|
+
|
|
1163
|
+
|
|
1164
|
+
/**
|
|
1165
|
+
* String hash function similar to java.lang.String.hashCode().
|
|
1166
|
+
* The hash code for a string is computed as
|
|
1167
|
+
* s[0] * 31 ^ (n - 1) + s[1] * 31 ^ (n - 2) + ... + s[n - 1],
|
|
1168
|
+
* where s[i] is the ith character of the string and n is the length of
|
|
1169
|
+
* the string. We mod the result to make it between 0 (inclusive) and 2^32
|
|
1170
|
+
* (exclusive).
|
|
1171
|
+
* @param {string} str A string.
|
|
1172
|
+
* @return {number} Hash value for {@code str}, between 0 (inclusive) and 2^32
|
|
1173
|
+
* (exclusive). The empty string returns 0.
|
|
1174
|
+
*/
|
|
1175
|
+
goog.string.hashCode = function(str) {
|
|
1176
|
+
var result = 0;
|
|
1177
|
+
for (var i = 0; i < str.length; ++i) {
|
|
1178
|
+
result = 31 * result + str.charCodeAt(i);
|
|
1179
|
+
// Normalize to 4 byte range, 0 ... 2^32.
|
|
1180
|
+
result %= goog.string.HASHCODE_MAX_;
|
|
1181
|
+
}
|
|
1182
|
+
return result;
|
|
1183
|
+
};
|
|
1184
|
+
|
|
1185
|
+
|
|
1186
|
+
/**
|
|
1187
|
+
* The most recent unique ID. |0 is equivalent to Math.floor in this case.
|
|
1188
|
+
* @type {number}
|
|
1189
|
+
* @private
|
|
1190
|
+
*/
|
|
1191
|
+
goog.string.uniqueStringCounter_ = Math.random() * 0x80000000 | 0;
|
|
1192
|
+
|
|
1193
|
+
|
|
1194
|
+
/**
|
|
1195
|
+
* Generates and returns a string which is unique in the current document.
|
|
1196
|
+
* This is useful, for example, to create unique IDs for DOM elements.
|
|
1197
|
+
* @return {string} A unique id.
|
|
1198
|
+
*/
|
|
1199
|
+
goog.string.createUniqueString = function() {
|
|
1200
|
+
return 'goog_' + goog.string.uniqueStringCounter_++;
|
|
1201
|
+
};
|
|
1202
|
+
|
|
1203
|
+
|
|
1204
|
+
/**
|
|
1205
|
+
* Converts the supplied string to a number, which may be Ininity or NaN.
|
|
1206
|
+
* This function strips whitespace: (toNumber(' 123') === 123)
|
|
1207
|
+
* This function accepts scientific notation: (toNumber('1e1') === 10)
|
|
1208
|
+
*
|
|
1209
|
+
* This is better than Javascript's built-in conversions because, sadly:
|
|
1210
|
+
* (Number(' ') === 0) and (parseFloat('123a') === 123)
|
|
1211
|
+
*
|
|
1212
|
+
* @param {string} str The string to convert.
|
|
1213
|
+
* @return {number} The number the supplied string represents, or NaN.
|
|
1214
|
+
*/
|
|
1215
|
+
goog.string.toNumber = function(str) {
|
|
1216
|
+
var num = Number(str);
|
|
1217
|
+
if (num == 0 && goog.string.isEmpty(str)) {
|
|
1218
|
+
return NaN;
|
|
1219
|
+
}
|
|
1220
|
+
return num;
|
|
1221
|
+
};
|
|
1222
|
+
|
|
1223
|
+
|
|
1224
|
+
/**
|
|
1225
|
+
* A memoized cache for goog.string.toCamelCase.
|
|
1226
|
+
* @type {Object.<string>}
|
|
1227
|
+
* @private
|
|
1228
|
+
*/
|
|
1229
|
+
goog.string.toCamelCaseCache_ = {};
|
|
1230
|
+
|
|
1231
|
+
|
|
1232
|
+
/**
|
|
1233
|
+
* Converts a string from selector-case to camelCase (e.g. from
|
|
1234
|
+
* "multi-part-string" to "multiPartString"), useful for converting
|
|
1235
|
+
* CSS selectors and HTML dataset keys to their equivalent JS properties.
|
|
1236
|
+
* @param {string} str The string in selector-case form.
|
|
1237
|
+
* @return {string} The string in camelCase form.
|
|
1238
|
+
*/
|
|
1239
|
+
goog.string.toCamelCase = function(str) {
|
|
1240
|
+
return goog.string.toCamelCaseCache_[str] ||
|
|
1241
|
+
(goog.string.toCamelCaseCache_[str] =
|
|
1242
|
+
String(str).replace(/\-([a-z])/g, function(all, match) {
|
|
1243
|
+
return match.toUpperCase();
|
|
1244
|
+
}));
|
|
1245
|
+
};
|
|
1246
|
+
|
|
1247
|
+
|
|
1248
|
+
/**
|
|
1249
|
+
* A memoized cache for goog.string.toSelectorCase.
|
|
1250
|
+
* @type {Object.<string>}
|
|
1251
|
+
* @private
|
|
1252
|
+
*/
|
|
1253
|
+
goog.string.toSelectorCaseCache_ = {};
|
|
1254
|
+
|
|
1255
|
+
|
|
1256
|
+
/**
|
|
1257
|
+
* Converts a string from camelCase to selector-case (e.g. from
|
|
1258
|
+
* "multiPartString" to "multi-part-string"), useful for converting JS
|
|
1259
|
+
* style and dataset properties to equivalent CSS selectors and HTML keys.
|
|
1260
|
+
* @param {string} str The string in camelCase form.
|
|
1261
|
+
* @return {string} The string in selector-case form.
|
|
1262
|
+
*/
|
|
1263
|
+
goog.string.toSelectorCase = function(str) {
|
|
1264
|
+
return goog.string.toSelectorCaseCache_[str] ||
|
|
1265
|
+
(goog.string.toSelectorCaseCache_[str] =
|
|
1266
|
+
String(str).replace(/([A-Z])/g, '-$1').toLowerCase());
|
|
1267
|
+
};
|
|
1268
|
+
;
|
|
1269
|
+
FI"asset_paths;
|
|
1270
|
+
F["h/Volumes/Development/dev-web/yellow-brick-road/vendor/closure-library/closure/goog/string/string.jsI"dependency_paths;
|
|
1271
|
+
F[{I" path;
|
|
1272
|
+
F"h/Volumes/Development/dev-web/yellow-brick-road/vendor/closure-library/closure/goog/string/string.jsI"
|
|
1273
|
+
mtime;
|
|
1274
|
+
FIu: Time
|
|
1275
|
+
T:offsetiI"hexdigest;
|
|
1276
|
+
F"%0ff21dc4a73f6afee61652a225b63dc9I"
|
|
1277
|
+
F"%46dde6621c301f4928e3b34efee9e3b5
|