LeanSearchClient

LeanSearchClient provides syntax for search using the leansearch API, the Moogle API, and the LeanStateSearch API from within Lean. It allows you to search for Lean tactics and theorems using natural language. It also allows searches on Loogle from within Lean.

We provide syntax to make a query and generate TryThis options to click or use a code action to use the results. The queries are of four forms:

  • Command syntax: #search "search query" as a command.
  • Term syntax: #search "search query" as a term.
  • Tactic syntax: #search "search query" as a tactic.
  • Tactic syntax based on state: #search.

In all cases results are displayed in the Lean Infoview and clicking these replaces the query text. In the cases of a query for tactics only valid tactics are displayed.

Which backend is used is determined by the leansearchclient.backend option.

Examples

The following are examples of using the leansearch API. The search is triggered when the sentence ends with a full stop (period) or a question mark.

Query Command

The common command for all backends:

#search "If a natural number n is less than m, then the successor of n is less than the successor of m."

We also have commands for specific backends. For leansearch:

#leansearch "If a natural number n is less than m, then the successor of n is less than the successor of m."

For moogle:

#moogle "If a natural number n is less than m, then the successor of n is less than the successor of m."

Query Term

The general command:

example := #search "If a natural number n is less than m, then the successor of n is less than the successor of m."

For leansearch:

example := #leansearch "If a natural number n is less than m, then the successor of n is less than the successor of m."

For moogle:

example := #moogle "If a natural number n is less than m, then the successor of n is less than the successor of m."

Query Tactic

Note that only valid tactics are displayed.

The general command has two variants. With a string, calling either LeanSearch or Moogle:

example : 35 := by
  #search "If a natural number n is less than m, then the successor of n is less than the successor of m."
  sorry

Without a string, calling LeanStateSearch

example : 35 := by
  #search
  sorry

There are also specific commands for the different backends.

For leansearch:

example : 35 := by
  #leansearch "If a natural number n is less than m, then the successor of n is less than the successor of m."
  sorry

For moogle:

example : 35 := by
  #moogle "If a natural number n is less than m, then the successor of n is less than the successor of m."
  sorry

For LeanStateSearch:

example : 35 := by
  #statesearch
  sorry

The #loogle command can also be used in all three modes. The syntax in this case is #loogle <search query> as in the following examples.

#loogle List ?a → ?a

example := #loogle List ?a → ?a

example : 35 := by
  #loogle Nat.succ_le_succ
  sorry