hissp package

Submodules

• hissp.__main__ module
  • main()
• hissp.macros module
  • _macro_
    • BQzHASH_()
    • HQzHASH_()
    • MQzHASH_()
    • OQzHASH_()
    • QQzHASH_()
    • QzAT_()
    • QzAT_QzHASH_()
    • QzAT_sQzHASH_()
    • QzBANG_QzHASH_()
    • QzBANG_sQzHASH_()
    • QzCOLON_QzAT_QzHASH_()
    • QzET_QzHASH_()
    • QzHASH_()
    • QzH_QzGT_()
    • QzH_QzLT_QzGT_QzGT_()
    • QzLSQB_QzHASH_()
    • QzLT_QzHASH_()
    • QzPCENT_()
    • QzSOL_QzHASH_()
    • QzSOL_XYQzHASH_()
    • XQzHASH_()
    • XYQzHASH_()
    • XYZQzHASH_()
    • XYZWQzHASH_()
    • alias()
    • ands()
    • anyQzH_map()
    • anyQzSTAR_map()
    • assure()
    • attach()
    • avow()
    • bQzHASH_()
    • binding()
    • bnQzHASH_()
    • case()
    • chainQzHASH_()
    • colQzHASH_()
    • cond()
    • cxvQzHASH_()
    • define()
    • defmacro()
    • defonce()
    • deftupleonce()
    • deftypeonce()
    • defun()
    • defvar()
    • destructQzH_QzGT_()
    • doto()
    • dtQzHASH_()
    • enQzHASH_()
    • fiQzHASH_()
    • ftQzHASH_()
    • fun()
    • hshQzHASH_()
    • iQzHASH_()
    • ifQzH_else()
    • impQzDOT_rQzHASH_()
    • impQzHASH_()
    • instQzHASH_()
    • let()
    • letQzH_from()
    • letQzSTAR_from()
    • loopQzH_from()
    • mix()
    • mkQzHASH_()
    • mpQzDOT_smQzHASH_()
    • mpQzHASH_()
    • myQzHASH_()
    • nilQzHASH_()
    • nspQzHASH_()
    • opQzHASH_()
    • ors()
    • plQzHASH_()
    • posQzHASH_()
    • prelude()
    • prog1()
    • progn()
    • proxyQzHASH_()
    • sentinelQzHASH_()
    • setQzAT_()
    • setQzBANG_()
    • setQzLSQB_QzHASH_()
    • spQzHASH_()
    • spyQzHASH_()
    • tbQzHASH_()
    • tfQzHASH_()
    • thrQzHASH_()
    • throw()
    • throwQzH_from()
    • throwQzSTAR_()
    • timeQzHASH_()
    • twQzHASH_()
    • unless()
    • utQzHASH_()
    • uuidQzHASH_()
    • when()
    • wrnQzHASH_()
    • zapQzAT_()
    • zapQzBANG_()
    • zapQzLSQB_QzHASH_()
• hissp.compiler module
  • ENV
  • MAX_PROTOCOL
  • macro_context()
  • CompileError
  • PostCompileWarning
  • Compiler
    • Compiler.new_env()
    • Compiler.compile()
    • Compiler.compile_form()
    • Compiler.tuple_()
    • Compiler.special()
    • Compiler.lambda_()
    • Compiler.parameters()
    • Compiler.body()
    • Compiler.invocation()
    • Compiler.expand_macro()
    • Compiler.get_macro()
    • Compiler.call()
    • Compiler.fragment()
    • Compiler.qualified_identifier()
    • Compiler.module_identifier()
    • Compiler.atomic()
    • Compiler.pickle()
    • Compiler.linenos()
    • Compiler.eval()
  • readerless()
  • evaluate()
  • execute()
  • is_str()
  • is_node()
  • is_symbol()
  • is_import()
  • is_control()
  • macroexpand1()
  • macroexpand()
  • macroexpand_all()
  • parse_params()
• hissp.munger module
  • munge()
  • QUOTEZ
  • FIND_QUOTEZ
  • TO_NAME
  • qz_encode()
  • force_qz_encode()
  • LOOKUP_NAME
  • demunge()
• hissp.reader module
  • GENSYM_BYTES
  • SoftSyntaxError
  • Lexer
    • Lexer.position()
  • Comment
    • Comment.contents()
  • Kwarg
    • Kwarg.k
    • Kwarg.v
  • Lissp
    • Lissp.template_count()
    • Lissp.env
    • Lissp.compile()
    • Lissp.reads()
    • Lissp.parse()
  • Parser
    • Parser.position()
    • Parser.gensym_context()
    • Parser.unquote_context()
    • Parser.qualify()
    • Parser.escape()
    • Parser.bare()
  • is_hissp_string()
  • is_lissp_unicode()
  • is_string_literal()
  • is_qualifiable()
  • transpile()
  • transpile_packaged()
  • transpile_file()
• hissp.repl module
  • ps1
  • ps2
  • LisspREPL
    • LisspREPL.interact()
  • interact()
  • main()

Module contents

It’s Python with a Lissp.

See the GitHub project for complete documentation and tests.

https://github.com/gilch/hissp

__init__.py defines a few functions meant for use as fully-qualified tags and imports several utilities for convenience, including,

• from hissp.compiler:

  • Compiler

  • evaluate

  • execute

  • is_control

  • is_import

  • is_node

  • is_str

  • is_symbol

  • macroexpand

  • macroexpand1

  • macroexpand_all

  • readerless

• from hissp.munger:

  • demunge

  • munge

• from hissp.reader:

  • transpile

  • is_hissp_string

  • is_lissp_unicode

  • is_string_literal

• and hissp.repl.interact

as well as the hissp.macros._macro_ namespace, making all the bundled macros available with the shorter hissp.._macro_ qualifier.

hissp.prelude(env)

Lissp prelude shorthand tag.

Usage: hissp..prelude#env, which expands to

(hissp.macros.._macro_.prelude env)

(A || or : argument makes exec default to the global env.)

See hissp.macros._macro_.prelude.

hissp.alias(abbreviation, qualifier)

Lissp alias shorthand tag.

Usage: hissp..alias## abbreviation qualifier, which expands to

(hissp.macros.._macro_.alias abbreviation qualifier)

See hissp.macros._macro_.alias.

hissp.refresh(module_name)

REPL convenience tag to recompile and reload a module.

Usage: hissp..refresh#'foo where foo is the __name__.

An empty argument (|| or :) means the current module.

There must be a corresponding .lissp file present to recompile.

Refreshing the main module (which would have side effects) is not supported. Send the REPL updated top-level definitions individually, or restart the REPL instead. (A corresponding compiled Python file is not required for a .lissp file run as the main module.)

While potentially confusing, Python can import the .py file used as main again using its name. These are considered separate modules by the runtime.

See also: subrepl, hissp.reader.transpile, importlib.reload.

hissp.subrepl(module)

Convenience tag to start a Lissp subREPL in the given module.

Usage: hissp..subrepl#foo. where foo. evaluates to a module.

Won’t re-enter current module. Prints __name__ on subREPL exit. (Exit a subREPL using EOF.)

See also: refresh, hissp.repl.interact, REPL.