1# (c) Stefan Countryman, 2019 

2 

3""" 

4A unified interface for accessing LLAMA functionality. Call the available 

5sub-commands to see their capabilities; for example, to list the file-related 

6commands available, run ``llama files --help``; to see available event 

7listeners, run ``llama listen --help``, and to activate the GCN Notice 

8listener, run ``llama listen gcn``. 

9 

10By default, all warnings about missing optional feature warnings (specified 

11using ``llama.classes.OptionalFeatureWarning``) are supressed. If you'd like to 

12see which features are missing, set ``LLAMA_OPTIONAL_FEATURE_WARNINGS=true`` 

13when calling this script. This will inform you of which features are missing 

14and which workarounds are active based on the limitations of your LLAMA 

15installation, but for most everyday work, these warnings are excessive and 

16useless. 

17 

18Examples 

19-------- 

20 

21Show warnings about optional LLAMA features that may not work on your current 

22installation: 

23 

24.. code:: 

25 

26 LLAMA_OPTIONAL_FEATURE_WARNINGS=true llama -h 

27 

28""" 

29 

30from llama.cli import RecursiveCli 

31 

32cli = RecursiveCli.from_module('llama', description=__doc__) 

33main = cli.main # pylint: disable=invalid-name 

34get_parser = cli.get_parser 

35 

36 

37if __name__ == '__main__': 

38 main()