Я недавно начал изучать Clojure, и я испытываю немного затруднений при обертывании моей головы вокруг пространств имен. Как создатель Clojure сказал, вновь прибывшие часто изо всех сил пытаются разобраться в понятии. Я ясно не понимаю различия между (use ...)
и (require ...)
. Например, играя вокруг в REPL, если я говорю (use 'clojure.contrib.str-utils2)
Я получаю предупреждения о функциях в clojure.core пространстве имен, заменяемом теми в clojure.contrib.str-utils2, но этого не происходит, когда я использую (require 'clojure.contrib.str-utils2)
. Я не уверен, что буду всегда хотеть заменить то, что находится в clojure.core, таким образом, кто-то может указать на некоторые лучшие практики для импорта внешнего материала и руководящих пространств имен в Clojure?
О, и также, когда должен, я использую :use
и :require
? Только внутри (ns ....)
?
Заранее спасибо.
Ответ лежит в docstrings:
user> (doc use)
-------------------------
clojure.core/use
([& args])
Like 'require, but also refers to each lib's namespace using
clojure.core/refer. Use :use in the ns macro in preference to calling
this directly.
'use accepts additional options in libspecs: :exclude, :only, :rename.
The arguments and semantics for :exclude, :only, and :rename are the same
as those documented for clojure.core/refer.
nil
И длинный для require:
user> (doc require)
-------------------------
clojure.core/require
([& args])
Loads libs, skipping any that are already loaded. Each argument is
either a libspec that identifies a lib, a prefix list that identifies
multiple libs whose names share a common prefix, or a flag that modifies
how all the identified libs are loaded. Use :require in the ns macro
in preference to calling this directly.
Libs
A 'lib' is a named set of resources in classpath whose contents define a
library of Clojure code. Lib names are symbols and each lib is associated
with a Clojure namespace and a Java package that share its name. A lib's
name also locates its root directory within classpath using Java's
package name to classpath-relative path mapping. All resources in a lib
should be contained in the directory structure under its root directory.
All definitions a lib makes should be in its associated namespace.
'require loads a lib by loading its root resource. The root resource path
is derived from the lib name in the following manner:
Consider a lib named by the symbol 'x.y.z; it has the root directory
<classpath>/x/y/, and its root resource is <classpath>/x/y/z.clj. The root
resource should contain code to create the lib's namespace (usually by using
the ns macro) and load any additional lib resources.
Libspecs
A libspec is a lib name or a vector containing a lib name followed by
options expressed as sequential keywords and arguments.
Recognized options: :as
:as takes a symbol as its argument and makes that symbol an alias to the
lib's namespace in the current namespace.
Prefix Lists
It's common for Clojure code to depend on several libs whose names have
the same prefix. When specifying libs, prefix lists can be used to reduce
repetition. A prefix list contains the shared prefix followed by libspecs
with the shared prefix removed from the lib names. After removing the
prefix, the names that remain must not contain any periods.
Flags
A flag is a keyword.
Recognized flags: :reload, :reload-all, :verbose
:reload forces loading of all the identified libs even if they are
already loaded
:reload-all implies :reload and also forces loading of all libs that the
identified libs directly or indirectly load via require or use
:verbose triggers printing information about each load, alias, and refer
Example:
The following would load the libraries clojure.zip and clojure.set
abbreviated as 's'.
(require '(clojure zip [set :as s]))
nil
Они оба делают одно и то же, но use
делает дополнительный шаг и создает отображения для вещей в require'd namespace в текущем namespace. Таким образом, вместо того чтобы делать some.namespace/name
, вы просто ссылаетесь на него как на name
. Хотя иногда это удобно, лучше использовать require или выбирать отдельные переменные, которые вам нужны, а не тянуть все пространство имен. В противном случае могут возникнуть проблемы с shadowing (когда один var предпочтительнее другого с таким же именем).
Если вы не хотите использовать require, но знаете, какие var вам нужны из пространства имен, вы можете поступить следующим образом:
(ns whatever
(:use [some.namespace :only [vars you want]]))
Если вы не знаете, какие vars вам понадобятся, или если вам нужно много var, лучше использовать require. Даже если вы используете require, не всегда нужно вводить полностью квалифицированное имя. Вы можете сделать так:
(ns whatever
(:require [some.namespace :as sn]))
и затем вы можете использовать переменные из некоторого пространства имен, например: (sn/somefunction arg1 arg2)
И чтобы ответить на ваш последний вопрос: старайтесь использовать :require и :use только внутри (ns ...). Так будет намного чище. Не use
и require
вне (ns ...), если у вас нет на то веских причин.