diff --git a/ara/__main__.py b/ara/__main__.py new file mode 100644 index 00000000..8f1575a2 --- /dev/null +++ b/ara/__main__.py @@ -0,0 +1,23 @@ +#!/usr/bin/env python +# Copyright (c) 2018 Red Hat, Inc. +# +# This file is part of ARA Records Ansible. +# +# ARA is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# ARA is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with ARA. If not, see . +from ara.shell import main +import sys + + +if __name__ == '__main__': + sys.exit(main(sys.argv[1:])) diff --git a/doc/source/installation.rst b/doc/source/installation.rst index 31948ec4..b8f3ebeb 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -54,4 +54,13 @@ Installing ARA from latest release on PyPi :: - pip install ara + pip install [--user] ara + +When installing ARA using ``--user``, command line scripts will be installed +inside ``~/.local/bin`` folder which may not be in ``PATH``. You may want to +assure that this folder is in PATH or to use the alternative calling method +``pyhton -m ara`` which calls Ansible module directly. + +The alternative calling method has the advantage that allows user to control +which python interpreter would be used. For example you could install ARA in +both python2 and python3 and call the one you want.