wayfarer 0.0.3 → 0.4.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (339) hide show
  1. checksums.yaml +5 -5
  2. data/.github/workflows/ci.yaml +32 -0
  3. data/.gitignore +3 -4
  4. data/.rubocop.yml +25 -9
  5. data/.ruby-version +1 -1
  6. data/Dockerfile +5 -0
  7. data/Gemfile +1 -7
  8. data/Gemfile.lock +212 -0
  9. data/RELEASING.md +17 -0
  10. data/Rakefile +38 -90
  11. data/bin/wayfarer +1 -111
  12. data/docker-compose.yml +32 -0
  13. data/docs/cookbook/querying_html.md +42 -0
  14. data/docs/cookbook/screenshots.md +27 -0
  15. data/docs/cookbook/user_agent.md +7 -0
  16. data/docs/guides/browser_automation/capybara.md +3 -0
  17. data/docs/guides/browser_automation/ferrum.md +37 -0
  18. data/docs/guides/browser_automation/selenium.md +59 -0
  19. data/docs/guides/callbacks.md +27 -34
  20. data/docs/guides/configuration.md +20 -171
  21. data/docs/guides/error_handling.md +18 -33
  22. data/docs/guides/jobs.md +75 -0
  23. data/docs/guides/networking.md +20 -0
  24. data/docs/guides/pages.md +52 -0
  25. data/docs/guides/performance.md +22 -0
  26. data/docs/guides/tasks.md +38 -0
  27. data/docs/index.md +34 -68
  28. data/docs/reference/api/base.md +162 -0
  29. data/docs/reference/api/route.md +182 -0
  30. data/docs/reference/cli.md +139 -0
  31. data/docs/reference/environment_variables.md +85 -0
  32. data/lib/wayfarer/base.rb +60 -0
  33. data/lib/wayfarer/cli/base.rb +23 -0
  34. data/lib/wayfarer/cli/generate.rb +17 -0
  35. data/lib/wayfarer/cli/job.rb +58 -0
  36. data/lib/wayfarer/cli/route.rb +27 -0
  37. data/lib/wayfarer/cli/route_printer.rb +116 -0
  38. data/lib/wayfarer/cli/runner.rb +34 -0
  39. data/lib/wayfarer/cli/templates/Gemfile.tt +5 -0
  40. data/lib/wayfarer/cli/templates/job.rb.tt +8 -0
  41. data/lib/wayfarer/config.rb +67 -0
  42. data/lib/wayfarer/gc.rb +19 -0
  43. data/lib/wayfarer/middleware/chain.rb +19 -0
  44. data/lib/wayfarer/middleware/dedup.rb +25 -0
  45. data/lib/wayfarer/middleware/fetch.rb +32 -0
  46. data/lib/wayfarer/middleware/normalize.rb +25 -0
  47. data/lib/wayfarer/middleware/router.rb +21 -0
  48. data/lib/wayfarer/middleware/stage.rb +23 -0
  49. data/lib/wayfarer/middleware/worker.rb +47 -0
  50. data/lib/wayfarer/networking/ferrum.rb +70 -0
  51. data/lib/wayfarer/networking/healer.rb +21 -0
  52. data/lib/wayfarer/networking/net_http.rb +52 -0
  53. data/lib/wayfarer/networking/pool.rb +34 -0
  54. data/lib/wayfarer/networking/result.rb +18 -0
  55. data/lib/wayfarer/networking/selenium.rb +70 -0
  56. data/lib/wayfarer/page.rb +15 -71
  57. data/lib/wayfarer/parsing/json.rb +17 -0
  58. data/lib/wayfarer/parsing/xml.rb +17 -0
  59. data/lib/wayfarer/redis/barrier.rb +36 -0
  60. data/lib/wayfarer/redis/connection.rb +13 -0
  61. data/lib/wayfarer/redis/counter.rb +29 -0
  62. data/lib/wayfarer/redis/pool.rb +18 -0
  63. data/lib/wayfarer/redis/version.rb +19 -0
  64. data/lib/wayfarer/routing/custom_matcher.rb +21 -0
  65. data/lib/wayfarer/routing/dsl.rb +57 -0
  66. data/lib/wayfarer/routing/host_matcher.rb +23 -0
  67. data/lib/wayfarer/routing/path_finder.rb +46 -0
  68. data/lib/wayfarer/routing/path_matcher.rb +46 -0
  69. data/lib/wayfarer/routing/{query_rule.rb → query_matcher.rb} +24 -16
  70. data/lib/wayfarer/routing/result.rb +15 -0
  71. data/lib/wayfarer/routing/root_route.rb +7 -0
  72. data/lib/wayfarer/routing/route.rb +41 -0
  73. data/lib/wayfarer/routing/scheme_matcher.rb +21 -0
  74. data/lib/wayfarer/routing/suffix_matcher.rb +21 -0
  75. data/lib/wayfarer/routing/target_route.rb +7 -0
  76. data/lib/wayfarer/routing/url_matcher.rb +21 -0
  77. data/lib/wayfarer/serializer.rb +17 -0
  78. data/lib/wayfarer/stringify.rb +41 -0
  79. data/lib/wayfarer/task.rb +34 -0
  80. data/lib/wayfarer.rb +47 -58
  81. data/mkdocs.yml +47 -0
  82. data/requirements.txt +1 -0
  83. data/spec/base_spec.rb +219 -0
  84. data/spec/cli/generate_spec.rb +39 -0
  85. data/spec/cli/job_spec.rb +74 -0
  86. data/spec/cli/version_spec.rb +13 -0
  87. data/spec/config_spec.rb +144 -0
  88. data/spec/factories/queue/chain.rb +11 -0
  89. data/spec/factories/queue/middleware.rb +15 -0
  90. data/spec/factories/queue/page.rb +78 -0
  91. data/spec/factories/queue/task.rb +12 -0
  92. data/spec/fixtures/dummy_job.rb +7 -0
  93. data/spec/gc_spec.rb +61 -0
  94. data/spec/middleware/chain_spec.rb +96 -0
  95. data/spec/middleware/dedup_spec.rb +76 -0
  96. data/spec/middleware/fetch_spec.rb +72 -0
  97. data/spec/middleware/normalize_spec.rb +28 -0
  98. data/spec/middleware/router_spec.rb +46 -0
  99. data/spec/middleware/stage_spec.rb +39 -0
  100. data/spec/middleware/worker_spec.rb +90 -0
  101. data/spec/networking/adapter.rb +135 -0
  102. data/spec/networking/ferrum_spec.rb +28 -0
  103. data/spec/networking/healer_spec.rb +46 -0
  104. data/spec/networking/net_http_spec.rb +37 -0
  105. data/spec/networking/pool_spec.rb +42 -0
  106. data/spec/networking/selenium_spec.rb +28 -0
  107. data/spec/page_spec.rb +21 -12
  108. data/spec/{parsers/json_parser_spec.rb → parsing/json_spec.rb} +5 -4
  109. data/spec/{parsers/xml_parser_spec.rb → parsing/xml_spec.rb} +3 -2
  110. data/spec/redis/barrier_spec.rb +78 -0
  111. data/spec/redis/counter_spec.rb +32 -0
  112. data/spec/redis/pool_spec.rb +18 -0
  113. data/spec/redis/version_spec.rb +13 -0
  114. data/spec/routing/custom_matcher_spec.rb +31 -0
  115. data/spec/routing/dsl_spec.rb +98 -0
  116. data/spec/routing/host_matcher_spec.rb +49 -0
  117. data/spec/routing/integration_spec.rb +110 -0
  118. data/spec/routing/path_finder_spec.rb +33 -0
  119. data/spec/routing/path_matcher_spec.rb +43 -0
  120. data/spec/routing/{query_rule_spec.rb → query_matcher_spec.rb} +39 -26
  121. data/spec/routing/root_route_spec.rb +29 -0
  122. data/spec/routing/route_spec.rb +43 -0
  123. data/spec/routing/scheme_matcher_spec.rb +25 -0
  124. data/spec/routing/{filetypes_rule_spec.rb → suffix_matcher_spec.rb} +14 -13
  125. data/spec/routing/uri_matcher_spec.rb +27 -0
  126. data/spec/spec_helpers.rb +65 -38
  127. data/spec/stringify_spec.rb +23 -0
  128. data/{support → spec/support}/static/finders.html +0 -0
  129. data/{support → spec/support}/static/graph/details/a.html +0 -0
  130. data/{support → spec/support}/static/graph/details/b.html +0 -0
  131. data/{support → spec/support}/static/graph/index.html +0 -0
  132. data/{support → spec/support}/static/json/dummy.json +0 -0
  133. data/{support → spec/support}/static/links/links.html +0 -0
  134. data/{support → spec/support}/static/xml/dummy.xml +0 -0
  135. data/{support → spec/support}/test_app.rb +9 -2
  136. data/spec/task_spec.rb +27 -0
  137. data/spec/wayfarer_spec.rb +2 -13
  138. data/wayfarer.gemspec +39 -42
  139. metadata +191 -368
  140. data/.travis.yml +0 -5
  141. data/Changelog.md +0 -10
  142. data/README.md +0 -21
  143. data/benchmark/frontiers.rb +0 -143
  144. data/docs/.gitignore +0 -2
  145. data/docs/_config.yml +0 -15
  146. data/docs/_includes/base.html +0 -7
  147. data/docs/_includes/head.html +0 -10
  148. data/docs/_includes/navigation.html +0 -187
  149. data/docs/_layouts/default.html +0 -42
  150. data/docs/_sass/base.scss +0 -439
  151. data/docs/_sass/variables.scss +0 -24
  152. data/docs/_sass/vendor/bourbon/_bourbon-deprecate.scss +0 -19
  153. data/docs/_sass/vendor/bourbon/_bourbon-deprecated-upcoming.scss +0 -425
  154. data/docs/_sass/vendor/bourbon/_bourbon.scss +0 -90
  155. data/docs/_sass/vendor/bourbon/addons/_border-color.scss +0 -29
  156. data/docs/_sass/vendor/bourbon/addons/_border-radius.scss +0 -48
  157. data/docs/_sass/vendor/bourbon/addons/_border-style.scss +0 -28
  158. data/docs/_sass/vendor/bourbon/addons/_border-width.scss +0 -28
  159. data/docs/_sass/vendor/bourbon/addons/_buttons.scss +0 -69
  160. data/docs/_sass/vendor/bourbon/addons/_clearfix.scss +0 -25
  161. data/docs/_sass/vendor/bourbon/addons/_ellipsis.scss +0 -30
  162. data/docs/_sass/vendor/bourbon/addons/_font-stacks.scss +0 -31
  163. data/docs/_sass/vendor/bourbon/addons/_hide-text.scss +0 -27
  164. data/docs/_sass/vendor/bourbon/addons/_margin.scss +0 -29
  165. data/docs/_sass/vendor/bourbon/addons/_padding.scss +0 -29
  166. data/docs/_sass/vendor/bourbon/addons/_position.scss +0 -51
  167. data/docs/_sass/vendor/bourbon/addons/_prefixer.scss +0 -66
  168. data/docs/_sass/vendor/bourbon/addons/_retina-image.scss +0 -27
  169. data/docs/_sass/vendor/bourbon/addons/_size.scss +0 -56
  170. data/docs/_sass/vendor/bourbon/addons/_text-inputs.scss +0 -118
  171. data/docs/_sass/vendor/bourbon/addons/_timing-functions.scss +0 -34
  172. data/docs/_sass/vendor/bourbon/addons/_triangle.scss +0 -63
  173. data/docs/_sass/vendor/bourbon/addons/_word-wrap.scss +0 -29
  174. data/docs/_sass/vendor/bourbon/css3/_animation.scss +0 -61
  175. data/docs/_sass/vendor/bourbon/css3/_appearance.scss +0 -5
  176. data/docs/_sass/vendor/bourbon/css3/_backface-visibility.scss +0 -5
  177. data/docs/_sass/vendor/bourbon/css3/_background-image.scss +0 -44
  178. data/docs/_sass/vendor/bourbon/css3/_background.scss +0 -57
  179. data/docs/_sass/vendor/bourbon/css3/_border-image.scss +0 -61
  180. data/docs/_sass/vendor/bourbon/css3/_calc.scss +0 -6
  181. data/docs/_sass/vendor/bourbon/css3/_columns.scss +0 -67
  182. data/docs/_sass/vendor/bourbon/css3/_filter.scss +0 -6
  183. data/docs/_sass/vendor/bourbon/css3/_flex-box.scss +0 -327
  184. data/docs/_sass/vendor/bourbon/css3/_font-face.scss +0 -29
  185. data/docs/_sass/vendor/bourbon/css3/_font-feature-settings.scss +0 -6
  186. data/docs/_sass/vendor/bourbon/css3/_hidpi-media-query.scss +0 -12
  187. data/docs/_sass/vendor/bourbon/css3/_hyphens.scss +0 -6
  188. data/docs/_sass/vendor/bourbon/css3/_image-rendering.scss +0 -15
  189. data/docs/_sass/vendor/bourbon/css3/_keyframes.scss +0 -38
  190. data/docs/_sass/vendor/bourbon/css3/_linear-gradient.scss +0 -40
  191. data/docs/_sass/vendor/bourbon/css3/_perspective.scss +0 -12
  192. data/docs/_sass/vendor/bourbon/css3/_placeholder.scss +0 -10
  193. data/docs/_sass/vendor/bourbon/css3/_radial-gradient.scss +0 -40
  194. data/docs/_sass/vendor/bourbon/css3/_selection.scss +0 -44
  195. data/docs/_sass/vendor/bourbon/css3/_text-decoration.scss +0 -27
  196. data/docs/_sass/vendor/bourbon/css3/_transform.scss +0 -21
  197. data/docs/_sass/vendor/bourbon/css3/_transition.scss +0 -81
  198. data/docs/_sass/vendor/bourbon/css3/_user-select.scss +0 -5
  199. data/docs/_sass/vendor/bourbon/functions/_assign-inputs.scss +0 -16
  200. data/docs/_sass/vendor/bourbon/functions/_contains-falsy.scss +0 -25
  201. data/docs/_sass/vendor/bourbon/functions/_contains.scss +0 -31
  202. data/docs/_sass/vendor/bourbon/functions/_is-length.scss +0 -16
  203. data/docs/_sass/vendor/bourbon/functions/_is-light.scss +0 -26
  204. data/docs/_sass/vendor/bourbon/functions/_is-number.scss +0 -16
  205. data/docs/_sass/vendor/bourbon/functions/_is-size.scss +0 -23
  206. data/docs/_sass/vendor/bourbon/functions/_modular-scale.scss +0 -74
  207. data/docs/_sass/vendor/bourbon/functions/_px-to-em.scss +0 -24
  208. data/docs/_sass/vendor/bourbon/functions/_px-to-rem.scss +0 -26
  209. data/docs/_sass/vendor/bourbon/functions/_shade.scss +0 -24
  210. data/docs/_sass/vendor/bourbon/functions/_strip-units.scss +0 -22
  211. data/docs/_sass/vendor/bourbon/functions/_tint.scss +0 -24
  212. data/docs/_sass/vendor/bourbon/functions/_transition-property-name.scss +0 -37
  213. data/docs/_sass/vendor/bourbon/functions/_unpack.scss +0 -32
  214. data/docs/_sass/vendor/bourbon/helpers/_convert-units.scss +0 -26
  215. data/docs/_sass/vendor/bourbon/helpers/_directional-values.scss +0 -108
  216. data/docs/_sass/vendor/bourbon/helpers/_font-source-declaration.scss +0 -53
  217. data/docs/_sass/vendor/bourbon/helpers/_gradient-positions-parser.scss +0 -24
  218. data/docs/_sass/vendor/bourbon/helpers/_linear-angle-parser.scss +0 -35
  219. data/docs/_sass/vendor/bourbon/helpers/_linear-gradient-parser.scss +0 -51
  220. data/docs/_sass/vendor/bourbon/helpers/_linear-positions-parser.scss +0 -77
  221. data/docs/_sass/vendor/bourbon/helpers/_linear-side-corner-parser.scss +0 -41
  222. data/docs/_sass/vendor/bourbon/helpers/_radial-arg-parser.scss +0 -74
  223. data/docs/_sass/vendor/bourbon/helpers/_radial-gradient-parser.scss +0 -55
  224. data/docs/_sass/vendor/bourbon/helpers/_radial-positions-parser.scss +0 -28
  225. data/docs/_sass/vendor/bourbon/helpers/_render-gradients.scss +0 -31
  226. data/docs/_sass/vendor/bourbon/helpers/_shape-size-stripper.scss +0 -15
  227. data/docs/_sass/vendor/bourbon/helpers/_str-to-num.scss +0 -55
  228. data/docs/_sass/vendor/bourbon/settings/_asset-pipeline.scss +0 -7
  229. data/docs/_sass/vendor/bourbon/settings/_deprecation-warnings.scss +0 -8
  230. data/docs/_sass/vendor/bourbon/settings/_prefixer.scss +0 -9
  231. data/docs/_sass/vendor/bourbon/settings/_px-to-em.scss +0 -1
  232. data/docs/_sass/vendor/neat/_neat-helpers.scss +0 -11
  233. data/docs/_sass/vendor/neat/_neat.scss +0 -23
  234. data/docs/_sass/vendor/neat/functions/_new-breakpoint.scss +0 -49
  235. data/docs/_sass/vendor/neat/functions/_private.scss +0 -114
  236. data/docs/_sass/vendor/neat/grid/_box-sizing.scss +0 -15
  237. data/docs/_sass/vendor/neat/grid/_direction-context.scss +0 -33
  238. data/docs/_sass/vendor/neat/grid/_display-context.scss +0 -28
  239. data/docs/_sass/vendor/neat/grid/_fill-parent.scss +0 -22
  240. data/docs/_sass/vendor/neat/grid/_media.scss +0 -92
  241. data/docs/_sass/vendor/neat/grid/_omega.scss +0 -87
  242. data/docs/_sass/vendor/neat/grid/_outer-container.scss +0 -34
  243. data/docs/_sass/vendor/neat/grid/_pad.scss +0 -25
  244. data/docs/_sass/vendor/neat/grid/_private.scss +0 -35
  245. data/docs/_sass/vendor/neat/grid/_row.scss +0 -52
  246. data/docs/_sass/vendor/neat/grid/_shift.scss +0 -50
  247. data/docs/_sass/vendor/neat/grid/_span-columns.scss +0 -94
  248. data/docs/_sass/vendor/neat/grid/_to-deprecate.scss +0 -97
  249. data/docs/_sass/vendor/neat/grid/_visual-grid.scss +0 -42
  250. data/docs/_sass/vendor/neat/mixins/_clearfix.scss +0 -25
  251. data/docs/_sass/vendor/neat/settings/_disable-warnings.scss +0 -13
  252. data/docs/_sass/vendor/neat/settings/_grid.scss +0 -51
  253. data/docs/_sass/vendor/neat/settings/_visual-grid.scss +0 -27
  254. data/docs/_sass/vendor/normalize-3.0.2.scss +0 -427
  255. data/docs/_sass/vendor/pygments.scss +0 -356
  256. data/docs/automating_browsers/capybara.md +0 -70
  257. data/docs/css/screen.scss +0 -7
  258. data/docs/guides/cli.md +0 -52
  259. data/docs/guides/frontiers.md +0 -93
  260. data/docs/guides/halting.md +0 -23
  261. data/docs/guides/job_queues.md +0 -26
  262. data/docs/guides/locals.md +0 -36
  263. data/docs/guides/logging.md +0 -22
  264. data/docs/guides/page_objects.md +0 -67
  265. data/docs/guides/peeking.md +0 -46
  266. data/docs/guides/selenium_capybara.md +0 -100
  267. data/docs/guides/tutorial.md +0 -452
  268. data/docs/js/navigation.js +0 -11
  269. data/docs/misc/contributing.md +0 -20
  270. data/docs/misc/testing.md +0 -11
  271. data/docs/recipes/authentication.md +0 -23
  272. data/docs/recipes/csv.md +0 -29
  273. data/docs/recipes/javascript.md +0 -20
  274. data/docs/recipes/multiple_uris.md +0 -18
  275. data/docs/recipes/screenshots.md +0 -20
  276. data/docs/routing/custom_rules.md +0 -16
  277. data/docs/routing/filetypes_rules.md +0 -21
  278. data/docs/routing/host_rules.md +0 -24
  279. data/docs/routing/path_rules.md +0 -33
  280. data/docs/routing/protocol_rules.md +0 -17
  281. data/docs/routing/query_rules.md +0 -69
  282. data/docs/routing/routes.md +0 -96
  283. data/docs/routing/uri_rules.md +0 -18
  284. data/examples/collect_github_issues.rb +0 -65
  285. data/examples/find_foobar_on_wikipedia.rb +0 -23
  286. data/lib/wayfarer/configuration.rb +0 -86
  287. data/lib/wayfarer/crawl.rb +0 -79
  288. data/lib/wayfarer/crawl_observer.rb +0 -103
  289. data/lib/wayfarer/dispatcher.rb +0 -104
  290. data/lib/wayfarer/finders.rb +0 -61
  291. data/lib/wayfarer/frontiers/frontier.rb +0 -79
  292. data/lib/wayfarer/frontiers/memory_bloomfilter.rb +0 -32
  293. data/lib/wayfarer/frontiers/memory_frontier.rb +0 -76
  294. data/lib/wayfarer/frontiers/memory_trie_frontier.rb +0 -39
  295. data/lib/wayfarer/frontiers/normalize_uris.rb +0 -48
  296. data/lib/wayfarer/frontiers/redis_bloomfilter.rb +0 -34
  297. data/lib/wayfarer/frontiers/redis_frontier.rb +0 -83
  298. data/lib/wayfarer/http_adapters/adapter_pool.rb +0 -62
  299. data/lib/wayfarer/http_adapters/net_http_adapter.rb +0 -77
  300. data/lib/wayfarer/http_adapters/selenium_adapter.rb +0 -80
  301. data/lib/wayfarer/job.rb +0 -211
  302. data/lib/wayfarer/locals.rb +0 -40
  303. data/lib/wayfarer/parsers/json_parser.rb +0 -20
  304. data/lib/wayfarer/parsers/xml_parser.rb +0 -27
  305. data/lib/wayfarer/processor.rb +0 -103
  306. data/lib/wayfarer/routing/custom_rule.rb +0 -21
  307. data/lib/wayfarer/routing/filetypes_rule.rb +0 -20
  308. data/lib/wayfarer/routing/host_rule.rb +0 -19
  309. data/lib/wayfarer/routing/path_rule.rb +0 -54
  310. data/lib/wayfarer/routing/protocol_rule.rb +0 -21
  311. data/lib/wayfarer/routing/router.rb +0 -71
  312. data/lib/wayfarer/routing/rule.rb +0 -114
  313. data/lib/wayfarer/routing/uri_rule.rb +0 -21
  314. data/spec/configuration_spec.rb +0 -26
  315. data/spec/crawl_spec.rb +0 -48
  316. data/spec/finders_spec.rb +0 -49
  317. data/spec/frontiers/memory_bloomfilter_spec.rb +0 -6
  318. data/spec/frontiers/memory_frontier_spec.rb +0 -6
  319. data/spec/frontiers/memory_trie_frontier_spec.rb +0 -6
  320. data/spec/frontiers/normalize_uris_spec.rb +0 -59
  321. data/spec/frontiers/redis_bloomfilter_spec.rb +0 -6
  322. data/spec/frontiers/redis_frontier_spec.rb +0 -6
  323. data/spec/http_adapters/adapter_pool_spec.rb +0 -33
  324. data/spec/http_adapters/net_http_adapter_spec.rb +0 -83
  325. data/spec/http_adapters/selenium_adapter_spec.rb +0 -53
  326. data/spec/integration/callbacks_spec.rb +0 -42
  327. data/spec/integration/locals_spec.rb +0 -106
  328. data/spec/integration/peeking_spec.rb +0 -61
  329. data/spec/job_spec.rb +0 -122
  330. data/spec/processor_spec.rb +0 -31
  331. data/spec/routing/custom_rule_spec.rb +0 -26
  332. data/spec/routing/host_rule_spec.rb +0 -48
  333. data/spec/routing/path_rule_spec.rb +0 -66
  334. data/spec/routing/protocol_rule_spec.rb +0 -26
  335. data/spec/routing/router_spec.rb +0 -67
  336. data/spec/routing/rule_spec.rb +0 -251
  337. data/spec/routing/uri_rule_spec.rb +0 -24
  338. data/spec/shared/frontier.rb +0 -96
  339. data/wayfarer-jruby.gemspec +0 -49
@@ -1,29 +0,0 @@
1
- @charset "UTF-8";
2
-
3
- /// Provides an easy way to change the `word-wrap` property.
4
- ///
5
- /// @param {String} $wrap [break-word]
6
- /// Value for the `word-break` property.
7
- ///
8
- /// @example scss - Usage
9
- /// .wrapper {
10
- /// @include word-wrap(break-word);
11
- /// }
12
- ///
13
- /// @example css - CSS Output
14
- /// .wrapper {
15
- /// overflow-wrap: break-word;
16
- /// word-break: break-all;
17
- /// word-wrap: break-word;
18
- /// }
19
-
20
- @mixin word-wrap($wrap: break-word) {
21
- overflow-wrap: $wrap;
22
- word-wrap: $wrap;
23
-
24
- @if $wrap == break-word {
25
- word-break: break-all;
26
- } @else {
27
- word-break: $wrap;
28
- }
29
- }
@@ -1,61 +0,0 @@
1
- // http://www.w3.org/TR/css3-animations/#the-animation-name-property-
2
- // Each of these mixins support comma separated lists of values, which allows different transitions for individual properties to be described in a single style rule. Each value in the list corresponds to the value at that same position in the other properties.
3
-
4
- @mixin animation($animations...) {
5
- @include _bourbon-deprecate-for-prefixing("animation");
6
-
7
- @include prefixer(animation, $animations, webkit moz spec);
8
- }
9
-
10
- @mixin animation-name($names...) {
11
- @include _bourbon-deprecate-for-prefixing("animation-name");
12
-
13
- @include prefixer(animation-name, $names, webkit moz spec);
14
- }
15
-
16
- @mixin animation-duration($times...) {
17
- @include _bourbon-deprecate-for-prefixing("animation-duration");
18
-
19
- @include prefixer(animation-duration, $times, webkit moz spec);
20
- }
21
-
22
- @mixin animation-timing-function($motions...) {
23
- @include _bourbon-deprecate-for-prefixing("animation-timing-function");
24
-
25
- // ease | linear | ease-in | ease-out | ease-in-out
26
- @include prefixer(animation-timing-function, $motions, webkit moz spec);
27
- }
28
-
29
- @mixin animation-iteration-count($values...) {
30
- @include _bourbon-deprecate-for-prefixing("animation-iteration-count");
31
-
32
- // infinite | <number>
33
- @include prefixer(animation-iteration-count, $values, webkit moz spec);
34
- }
35
-
36
- @mixin animation-direction($directions...) {
37
- @include _bourbon-deprecate-for-prefixing("animation-direction");
38
-
39
- // normal | alternate
40
- @include prefixer(animation-direction, $directions, webkit moz spec);
41
- }
42
-
43
- @mixin animation-play-state($states...) {
44
- @include _bourbon-deprecate-for-prefixing("animation-play-state");
45
-
46
- // running | paused
47
- @include prefixer(animation-play-state, $states, webkit moz spec);
48
- }
49
-
50
- @mixin animation-delay($times...) {
51
- @include _bourbon-deprecate-for-prefixing("animation-delay");
52
-
53
- @include prefixer(animation-delay, $times, webkit moz spec);
54
- }
55
-
56
- @mixin animation-fill-mode($modes...) {
57
- @include _bourbon-deprecate-for-prefixing("animation-fill-mode");
58
-
59
- // none | forwards | backwards | both
60
- @include prefixer(animation-fill-mode, $modes, webkit moz spec);
61
- }
@@ -1,5 +0,0 @@
1
- @mixin appearance($value) {
2
- @include _bourbon-deprecate-for-prefixing("appearance");
3
-
4
- @include prefixer(appearance, $value, webkit moz ms o spec);
5
- }
@@ -1,5 +0,0 @@
1
- @mixin backface-visibility($visibility) {
2
- @include _bourbon-deprecate-for-prefixing("backface-visibility");
3
-
4
- @include prefixer(backface-visibility, $visibility, webkit spec);
5
- }
@@ -1,44 +0,0 @@
1
- //************************************************************************//
2
- // Background-image property for adding multiple background images with
3
- // gradients, or for stringing multiple gradients together.
4
- //************************************************************************//
5
-
6
- @mixin background-image($images...) {
7
- @include _bourbon-deprecate-for-prefixing("background-image");
8
-
9
- $webkit-images: ();
10
- $spec-images: ();
11
-
12
- @each $image in $images {
13
- $webkit-image: ();
14
- $spec-image: ();
15
-
16
- @if (type-of($image) == string) {
17
- $url-str: str-slice($image, 1, 3);
18
- $gradient-type: str-slice($image, 1, 6);
19
-
20
- @if $url-str == "url" {
21
- $webkit-image: $image;
22
- $spec-image: $image;
23
- }
24
-
25
- @else if $gradient-type == "linear" {
26
- $gradients: _linear-gradient-parser($image);
27
- $webkit-image: map-get($gradients, webkit-image);
28
- $spec-image: map-get($gradients, spec-image);
29
- }
30
-
31
- @else if $gradient-type == "radial" {
32
- $gradients: _radial-gradient-parser($image);
33
- $webkit-image: map-get($gradients, webkit-image);
34
- $spec-image: map-get($gradients, spec-image);
35
- }
36
- }
37
-
38
- $webkit-images: append($webkit-images, $webkit-image, comma);
39
- $spec-images: append($spec-images, $spec-image, comma);
40
- }
41
-
42
- background-image: $webkit-images;
43
- background-image: $spec-images;
44
- }
@@ -1,57 +0,0 @@
1
- //************************************************************************//
2
- // Background property for adding multiple backgrounds using shorthand
3
- // notation.
4
- //************************************************************************//
5
-
6
- @mixin background($backgrounds...) {
7
- @include _bourbon-deprecate-for-prefixing("background");
8
-
9
- $webkit-backgrounds: ();
10
- $spec-backgrounds: ();
11
-
12
- @each $background in $backgrounds {
13
- $webkit-background: ();
14
- $spec-background: ();
15
- $background-type: type-of($background);
16
-
17
- @if $background-type == string or $background-type == list {
18
- $background-str: if($background-type == list, nth($background, 1), $background);
19
-
20
- $url-str: str-slice($background-str, 1, 3);
21
- $gradient-type: str-slice($background-str, 1, 6);
22
-
23
- @if $url-str == "url" {
24
- $webkit-background: $background;
25
- $spec-background: $background;
26
- }
27
-
28
- @else if $gradient-type == "linear" {
29
- $gradients: _linear-gradient-parser("#{$background}");
30
- $webkit-background: map-get($gradients, webkit-image);
31
- $spec-background: map-get($gradients, spec-image);
32
- }
33
-
34
- @else if $gradient-type == "radial" {
35
- $gradients: _radial-gradient-parser("#{$background}");
36
- $webkit-background: map-get($gradients, webkit-image);
37
- $spec-background: map-get($gradients, spec-image);
38
- }
39
-
40
- @else {
41
- $webkit-background: $background;
42
- $spec-background: $background;
43
- }
44
- }
45
-
46
- @else {
47
- $webkit-background: $background;
48
- $spec-background: $background;
49
- }
50
-
51
- $webkit-backgrounds: append($webkit-backgrounds, $webkit-background, comma);
52
- $spec-backgrounds: append($spec-backgrounds, $spec-background, comma);
53
- }
54
-
55
- background: $webkit-backgrounds;
56
- background: $spec-backgrounds;
57
- }
@@ -1,61 +0,0 @@
1
- @mixin border-image($borders...) {
2
- @include _bourbon-deprecate-for-prefixing("border-image");
3
-
4
- $webkit-borders: ();
5
- $spec-borders: ();
6
-
7
- @each $border in $borders {
8
- $webkit-border: ();
9
- $spec-border: ();
10
- $border-type: type-of($border);
11
-
12
- @if $border-type == string or list {
13
- $border-str: if($border-type == list, nth($border, 1), $border);
14
-
15
- $url-str: str-slice($border-str, 1, 3);
16
- $gradient-type: str-slice($border-str, 1, 6);
17
-
18
- @if $url-str == "url" {
19
- $webkit-border: $border;
20
- $spec-border: $border;
21
- }
22
-
23
- @else if $gradient-type == "linear" {
24
- $gradients: _linear-gradient-parser("#{$border}");
25
- $webkit-border: map-get($gradients, webkit-image);
26
- $spec-border: map-get($gradients, spec-image);
27
- }
28
-
29
- @else if $gradient-type == "radial" {
30
- $gradients: _radial-gradient-parser("#{$border}");
31
- $webkit-border: map-get($gradients, webkit-image);
32
- $spec-border: map-get($gradients, spec-image);
33
- }
34
-
35
- @else {
36
- $webkit-border: $border;
37
- $spec-border: $border;
38
- }
39
- }
40
-
41
- @else {
42
- $webkit-border: $border;
43
- $spec-border: $border;
44
- }
45
-
46
- $webkit-borders: append($webkit-borders, $webkit-border, comma);
47
- $spec-borders: append($spec-borders, $spec-border, comma);
48
- }
49
-
50
- -webkit-border-image: $webkit-borders;
51
- border-image: $spec-borders;
52
- border-style: solid;
53
- }
54
-
55
- //Examples:
56
- // @include border-image(url("image.png"));
57
- // @include border-image(url("image.png") 20 stretch);
58
- // @include border-image(linear-gradient(45deg, orange, yellow));
59
- // @include border-image(linear-gradient(45deg, orange, yellow) stretch);
60
- // @include border-image(linear-gradient(45deg, orange, yellow) 20 30 40 50 stretch round);
61
- // @include border-image(radial-gradient(top, cover, orange, yellow, orange));
@@ -1,6 +0,0 @@
1
- @mixin calc($property, $value) {
2
- @include _bourbon-deprecate-for-prefixing("calc");
3
-
4
- #{$property}: -webkit-calc(#{$value});
5
- #{$property}: calc(#{$value});
6
- }
@@ -1,67 +0,0 @@
1
- @mixin columns($arg: auto) {
2
- @include _bourbon-deprecate-for-prefixing("columns");
3
-
4
- // <column-count> || <column-width>
5
- @include prefixer(columns, $arg, webkit moz spec);
6
- }
7
-
8
- @mixin column-count($int: auto) {
9
- @include _bourbon-deprecate-for-prefixing("column-count");
10
-
11
- // auto || integer
12
- @include prefixer(column-count, $int, webkit moz spec);
13
- }
14
-
15
- @mixin column-gap($length: normal) {
16
- @include _bourbon-deprecate-for-prefixing("column-gap");
17
-
18
- // normal || length
19
- @include prefixer(column-gap, $length, webkit moz spec);
20
- }
21
-
22
- @mixin column-fill($arg: auto) {
23
- @include _bourbon-deprecate-for-prefixing("column-fill");
24
-
25
- // auto || length
26
- @include prefixer(column-fill, $arg, webkit moz spec);
27
- }
28
-
29
- @mixin column-rule($arg) {
30
- @include _bourbon-deprecate-for-prefixing("column-rule");
31
-
32
- // <border-width> || <border-style> || <color>
33
- @include prefixer(column-rule, $arg, webkit moz spec);
34
- }
35
-
36
- @mixin column-rule-color($color) {
37
- @include _bourbon-deprecate-for-prefixing("column-rule-color");
38
-
39
- @include prefixer(column-rule-color, $color, webkit moz spec);
40
- }
41
-
42
- @mixin column-rule-style($style: none) {
43
- @include _bourbon-deprecate-for-prefixing("column-rule-style");
44
-
45
- // none | hidden | dashed | dotted | double | groove | inset | inset | outset | ridge | solid
46
- @include prefixer(column-rule-style, $style, webkit moz spec);
47
- }
48
-
49
- @mixin column-rule-width($width: none) {
50
- @include _bourbon-deprecate-for-prefixing("column-rule-width");
51
-
52
- @include prefixer(column-rule-width, $width, webkit moz spec);
53
- }
54
-
55
- @mixin column-span($arg: none) {
56
- @include _bourbon-deprecate-for-prefixing("column-span");
57
-
58
- // none || all
59
- @include prefixer(column-span, $arg, webkit moz spec);
60
- }
61
-
62
- @mixin column-width($length: auto) {
63
- @include _bourbon-deprecate-for-prefixing("column-width");
64
-
65
- // auto || length
66
- @include prefixer(column-width, $length, webkit moz spec);
67
- }
@@ -1,6 +0,0 @@
1
- @mixin filter($function: none) {
2
- @include _bourbon-deprecate-for-prefixing("filter");
3
-
4
- // <filter-function> [<filter-function]* | none
5
- @include prefixer(filter, $function, webkit spec);
6
- }
@@ -1,327 +0,0 @@
1
- // CSS3 Flexible Box Model and property defaults
2
-
3
- // Custom shorthand notation for flexbox
4
- @mixin box($orient: inline-axis, $pack: start, $align: stretch) {
5
- @include _bourbon-deprecate-for-prefixing("box");
6
-
7
- @include display-box;
8
- @include box-orient($orient);
9
- @include box-pack($pack);
10
- @include box-align($align);
11
- }
12
-
13
- @mixin display-box {
14
- @include _bourbon-deprecate-for-prefixing("display-box");
15
-
16
- display: -webkit-box;
17
- display: -moz-box;
18
- display: -ms-flexbox; // IE 10
19
- display: box;
20
- }
21
-
22
- @mixin box-orient($orient: inline-axis) {
23
- @include _bourbon-deprecate-for-prefixing("box-orient");
24
-
25
- // horizontal|vertical|inline-axis|block-axis|inherit
26
- @include prefixer(box-orient, $orient, webkit moz spec);
27
- }
28
-
29
- @mixin box-pack($pack: start) {
30
- @include _bourbon-deprecate-for-prefixing("box-pack");
31
-
32
- // start|end|center|justify
33
- @include prefixer(box-pack, $pack, webkit moz spec);
34
- -ms-flex-pack: $pack; // IE 10
35
- }
36
-
37
- @mixin box-align($align: stretch) {
38
- @include _bourbon-deprecate-for-prefixing("box-align");
39
-
40
- // start|end|center|baseline|stretch
41
- @include prefixer(box-align, $align, webkit moz spec);
42
- -ms-flex-align: $align; // IE 10
43
- }
44
-
45
- @mixin box-direction($direction: normal) {
46
- @include _bourbon-deprecate-for-prefixing("box-direction");
47
-
48
- // normal|reverse|inherit
49
- @include prefixer(box-direction, $direction, webkit moz spec);
50
- -ms-flex-direction: $direction; // IE 10
51
- }
52
-
53
- @mixin box-lines($lines: single) {
54
- @include _bourbon-deprecate-for-prefixing("box-lines");
55
-
56
- // single|multiple
57
- @include prefixer(box-lines, $lines, webkit moz spec);
58
- }
59
-
60
- @mixin box-ordinal-group($int: 1) {
61
- @include _bourbon-deprecate-for-prefixing("box-ordinal-group");
62
-
63
- @include prefixer(box-ordinal-group, $int, webkit moz spec);
64
- -ms-flex-order: $int; // IE 10
65
- }
66
-
67
- @mixin box-flex($value: 0) {
68
- @include _bourbon-deprecate-for-prefixing("box-flex");
69
-
70
- @include prefixer(box-flex, $value, webkit moz spec);
71
- -ms-flex: $value; // IE 10
72
- }
73
-
74
- @mixin box-flex-group($int: 1) {
75
- @include _bourbon-deprecate-for-prefixing("box-flex-group");
76
-
77
- @include prefixer(box-flex-group, $int, webkit moz spec);
78
- }
79
-
80
- // CSS3 Flexible Box Model and property defaults
81
- // Unified attributes for 2009, 2011, and 2012 flavours.
82
-
83
- // 2009 - display (box | inline-box)
84
- // 2011 - display (flexbox | inline-flexbox)
85
- // 2012 - display (flex | inline-flex)
86
- @mixin display($value) {
87
- @include _bourbon-deprecate-for-prefixing("display");
88
-
89
- // flex | inline-flex
90
- @if $value == "flex" {
91
- // 2009
92
- display: -webkit-box;
93
- display: -moz-box;
94
- display: box;
95
-
96
- // 2012
97
- display: -webkit-flex;
98
- display: -moz-flex;
99
- display: -ms-flexbox; // 2011 (IE 10)
100
- display: flex;
101
- } @else if $value == "inline-flex" {
102
- display: -webkit-inline-box;
103
- display: -moz-inline-box;
104
- display: inline-box;
105
-
106
- display: -webkit-inline-flex;
107
- display: -moz-inline-flex;
108
- display: -ms-inline-flexbox;
109
- display: inline-flex;
110
- } @else {
111
- display: $value;
112
- }
113
- }
114
-
115
- // 2009 - box-flex (integer)
116
- // 2011 - flex (decimal | width decimal)
117
- // 2012 - flex (integer integer width)
118
- @mixin flex($value) {
119
- @include _bourbon-deprecate-for-prefixing("flex");
120
-
121
- // Grab flex-grow for older browsers.
122
- $flex-grow: nth($value, 1);
123
-
124
- // 2009
125
- @include prefixer(box-flex, $flex-grow, webkit moz spec);
126
-
127
- // 2011 (IE 10), 2012
128
- @include prefixer(flex, $value, webkit moz ms spec);
129
- }
130
-
131
- // 2009 - box-orient ( horizontal | vertical | inline-axis | block-axis)
132
- // - box-direction (normal | reverse)
133
- // 2011 - flex-direction (row | row-reverse | column | column-reverse)
134
- // 2012 - flex-direction (row | row-reverse | column | column-reverse)
135
- @mixin flex-direction($value: row) {
136
- @include _bourbon-deprecate-for-prefixing("flex-direction");
137
-
138
- // Alt values.
139
- $value-2009: $value;
140
- $value-2011: $value;
141
- $direction: normal;
142
-
143
- @if $value == row {
144
- $value-2009: horizontal;
145
- } @else if $value == "row-reverse" {
146
- $value-2009: horizontal;
147
- $direction: reverse;
148
- } @else if $value == column {
149
- $value-2009: vertical;
150
- } @else if $value == "column-reverse" {
151
- $value-2009: vertical;
152
- $direction: reverse;
153
- }
154
-
155
- // 2009
156
- @include prefixer(box-orient, $value-2009, webkit moz spec);
157
- @include prefixer(box-direction, $direction, webkit moz spec);
158
-
159
- // 2012
160
- @include prefixer(flex-direction, $value, webkit moz spec);
161
-
162
- // 2011 (IE 10)
163
- -ms-flex-direction: $value;
164
- }
165
-
166
- // 2009 - box-lines (single | multiple)
167
- // 2011 - flex-wrap (nowrap | wrap | wrap-reverse)
168
- // 2012 - flex-wrap (nowrap | wrap | wrap-reverse)
169
- @mixin flex-wrap($value: nowrap) {
170
- @include _bourbon-deprecate-for-prefixing("flex-wrap");
171
-
172
- // Alt values
173
- $alt-value: $value;
174
- @if $value == nowrap {
175
- $alt-value: single;
176
- } @else if $value == wrap {
177
- $alt-value: multiple;
178
- } @else if $value == "wrap-reverse" {
179
- $alt-value: multiple;
180
- }
181
-
182
- @include prefixer(box-lines, $alt-value, webkit moz spec);
183
- @include prefixer(flex-wrap, $value, webkit moz ms spec);
184
- }
185
-
186
- // 2009 - TODO: parse values into flex-direction/flex-wrap
187
- // 2011 - TODO: parse values into flex-direction/flex-wrap
188
- // 2012 - flex-flow (flex-direction || flex-wrap)
189
- @mixin flex-flow($value) {
190
- @include _bourbon-deprecate-for-prefixing("flex-flow");
191
-
192
- @include prefixer(flex-flow, $value, webkit moz spec);
193
- }
194
-
195
- // 2009 - box-ordinal-group (integer)
196
- // 2011 - flex-order (integer)
197
- // 2012 - order (integer)
198
- @mixin order($int: 0) {
199
- @include _bourbon-deprecate-for-prefixing("order");
200
-
201
- // 2009
202
- @include prefixer(box-ordinal-group, $int, webkit moz spec);
203
-
204
- // 2012
205
- @include prefixer(order, $int, webkit moz spec);
206
-
207
- // 2011 (IE 10)
208
- -ms-flex-order: $int;
209
- }
210
-
211
- // 2012 - flex-grow (number)
212
- @mixin flex-grow($number: 0) {
213
- @include _bourbon-deprecate-for-prefixing("flex-grow");
214
-
215
- @include prefixer(flex-grow, $number, webkit moz spec);
216
- -ms-flex-positive: $number;
217
- }
218
-
219
- // 2012 - flex-shrink (number)
220
- @mixin flex-shrink($number: 1) {
221
- @include _bourbon-deprecate-for-prefixing("flex-shrink");
222
-
223
- @include prefixer(flex-shrink, $number, webkit moz spec);
224
- -ms-flex-negative: $number;
225
- }
226
-
227
- // 2012 - flex-basis (number)
228
- @mixin flex-basis($width: auto) {
229
- @include _bourbon-deprecate-for-prefixing("flex-basis");
230
-
231
- @include prefixer(flex-basis, $width, webkit moz spec);
232
- -ms-flex-preferred-size: $width;
233
- }
234
-
235
- // 2009 - box-pack (start | end | center | justify)
236
- // 2011 - flex-pack (start | end | center | justify)
237
- // 2012 - justify-content (flex-start | flex-end | center | space-between | space-around)
238
- @mixin justify-content($value: flex-start) {
239
- @include _bourbon-deprecate-for-prefixing("justify-content");
240
-
241
- // Alt values.
242
- $alt-value: $value;
243
- @if $value == "flex-start" {
244
- $alt-value: start;
245
- } @else if $value == "flex-end" {
246
- $alt-value: end;
247
- } @else if $value == "space-between" {
248
- $alt-value: justify;
249
- } @else if $value == "space-around" {
250
- $alt-value: distribute;
251
- }
252
-
253
- // 2009
254
- @include prefixer(box-pack, $alt-value, webkit moz spec);
255
-
256
- // 2012
257
- @include prefixer(justify-content, $value, webkit moz ms o spec);
258
-
259
- // 2011 (IE 10)
260
- -ms-flex-pack: $alt-value;
261
- }
262
-
263
- // 2009 - box-align (start | end | center | baseline | stretch)
264
- // 2011 - flex-align (start | end | center | baseline | stretch)
265
- // 2012 - align-items (flex-start | flex-end | center | baseline | stretch)
266
- @mixin align-items($value: stretch) {
267
- @include _bourbon-deprecate-for-prefixing("align-items");
268
-
269
- $alt-value: $value;
270
-
271
- @if $value == "flex-start" {
272
- $alt-value: start;
273
- } @else if $value == "flex-end" {
274
- $alt-value: end;
275
- }
276
-
277
- // 2009
278
- @include prefixer(box-align, $alt-value, webkit moz spec);
279
-
280
- // 2012
281
- @include prefixer(align-items, $value, webkit moz ms o spec);
282
-
283
- // 2011 (IE 10)
284
- -ms-flex-align: $alt-value;
285
- }
286
-
287
- // 2011 - flex-item-align (auto | start | end | center | baseline | stretch)
288
- // 2012 - align-self (auto | flex-start | flex-end | center | baseline | stretch)
289
- @mixin align-self($value: auto) {
290
- @include _bourbon-deprecate-for-prefixing("align-self");
291
-
292
- $value-2011: $value;
293
- @if $value == "flex-start" {
294
- $value-2011: start;
295
- } @else if $value == "flex-end" {
296
- $value-2011: end;
297
- }
298
-
299
- // 2012
300
- @include prefixer(align-self, $value, webkit moz spec);
301
-
302
- // 2011 (IE 10)
303
- -ms-flex-item-align: $value-2011;
304
- }
305
-
306
- // 2011 - flex-line-pack (start | end | center | justify | distribute | stretch)
307
- // 2012 - align-content (flex-start | flex-end | center | space-between | space-around | stretch)
308
- @mixin align-content($value: stretch) {
309
- @include _bourbon-deprecate-for-prefixing("align-content");
310
-
311
- $value-2011: $value;
312
- @if $value == "flex-start" {
313
- $value-2011: start;
314
- } @else if $value == "flex-end" {
315
- $value-2011: end;
316
- } @else if $value == "space-between" {
317
- $value-2011: justify;
318
- } @else if $value == "space-around" {
319
- $value-2011: distribute;
320
- }
321
-
322
- // 2012
323
- @include prefixer(align-content, $value, webkit moz spec);
324
-
325
- // 2011 (IE 10)
326
- -ms-flex-line-pack: $value-2011;
327
- }