hy/docs/contrib
Kodi Arfer 14fddbe6c3 Give require the same features as import (#1142)
Give `require` the same features as `import`

You can now do (require foo), (require [foo [a b c]]), (require [foo [*]]), and (require [foo :as bar]). The first and last forms get you macros named foo.a, foo.b, etc. or bar.a, bar.b, etc., respectively. The second form only gets the macros in the list.

Implements #1118 and perhaps partly addresses #277.

N.B. The new meaning of (require foo) will cause all existing code that uses macros to break. Simply replace these forms with (require [foo [*]]) to get your code working again.

There's a bit of a hack involved in the forms (require foo) or (require [foo :as bar]). When you call (foo.a ...) or (bar.a ...), Hy doesn't actually look inside modules. Instead, these (require ...) forms give the macros names that have periods in them, which happens to work fine with the way Hy finds and interprets macro calls.

* Make `require` syntax stricter and add tests

* Update documentation for `require`

* Documentation wording improvements

* Allow :as in `require` name lists
2016-11-03 09:35:58 +02:00
..
alias.rst docs: Minor corrections, related to the alias removals 2015-08-10 09:33:23 +02:00
anaphoric.rst Give require the same features as import (#1142) 2016-11-03 09:35:58 +02:00
flow.rst Give require the same features as import (#1142) 2016-11-03 09:35:58 +02:00
index.rst Added documentation for walk, postwalk and prewalk 2016-08-20 02:35:02 -06:00
loop.rst Give require the same features as import (#1142) 2016-11-03 09:35:58 +02:00
multi.rst Give require the same features as import (#1142) 2016-11-03 09:35:58 +02:00
walk.rst Added documentation for walk, postwalk and prewalk 2016-08-20 02:35:02 -06:00