14fddbe6c3
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
59 lines
1.2 KiB
ReStructuredText
59 lines
1.2 KiB
ReStructuredText
==========
|
|
Flow
|
|
==========
|
|
|
|
.. versionadded:: 0.10.1
|
|
|
|
The ``flow`` macros allow directing the flow of a program with greater ease.
|
|
|
|
|
|
Macros
|
|
======
|
|
|
|
.. _case:
|
|
.. _switch:
|
|
|
|
case
|
|
-----
|
|
|
|
``case`` allows you to decide based on the value of a variable.
|
|
|
|
|
|
Usage: `(case variable val1 (body1) val2 (body2) ...)`
|
|
|
|
Example:
|
|
|
|
.. code-block:: hy
|
|
|
|
(require [hy.contrib.flow [case]])
|
|
|
|
(defn temp-commenter [temp]
|
|
(case temp
|
|
-10 (print "It's freezing. Turn up the thermostat!")
|
|
15 (print "Sounds about average.")
|
|
45 (print "Holy smokes. It's hot in here!")
|
|
(print "I don't even know.")))
|
|
|
|
|
|
switch
|
|
-----
|
|
|
|
``switch`` allows you to run code based on the value of a variable.
|
|
A final extra body allows for a default case.
|
|
|
|
|
|
Usage: `(switch var (cond1) (body1) (cond2) (body2) ... )`
|
|
|
|
Example:
|
|
|
|
.. code-block:: hy
|
|
|
|
(require [hy.contrib.flow [switch]])
|
|
|
|
(defn temp-commenter [temp]
|
|
(switch temp
|
|
(<= 10.0) (print "Better wear a jacket!")
|
|
(<= 25.0) (print "Brace yourselves. Summer is coming!")
|
|
(<= 30.0) (print "Time to get some ice cream.")
|
|
(print "Sounds like a heat wave")))
|