Metadata-Version: 2.1
Name: openwrt-luci-rpc
Version: 0.4.12
Summary: Module for interacting with OpenWRT Luci RPC interface
Home-page: https://github.com/fbradyirl/openwrt-luci-rpc
Author: Finbarr Brady
Author-email: fbradyirl@github.io
License: Apache Software License 2.0
Keywords: openwrt-luci-rpc
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: Click (>=6.0)
Requires-Dist: requests (==2.21.0)


================
openwrt-luci-rpc
================


.. image:: https://img.shields.io/pypi/v/openwrt_luci_rpc.svg
        :target: https://pypi.python.org/pypi/openwrt_luci_rpc

.. image:: https://img.shields.io/travis/fbradyirl/openwrt-luci-rpc.svg
        :target: https://travis-ci.org/fbradyirl/openwrt-luci-rpc/

.. image:: https://readthedocs.org/projects/openwrt-luci-rpc/badge/?version=latest
        :target: https://openwrt-luci-rpc.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


Python3 module for interacting with the OpenWRT Luci RPC interface

-  Free software: Apache Software License 2.0
-  Documentation: `https://openwrt-luci-rpc.readthedocs.io`_.

Features
--------

-  Allows you to use the Luci RPC interface to fetch connected devices
   on your OpenWrt based router.
-  Supports 17.X & 18.X or newer releases of OpenWrt.

Usage
-----

You will first need to install the package ``luci-mod-rpc`` on your
OpenWrt router.

::

   opkg update
   opkg install luci-mod-rpc

Once that is done, you can use this module to interact with the RPC
interface.

Install
~~~~~~~

.. code:: bash

   pip install openwrt-luci-rpc

Use
~~~

.. code:: python

   from openwrt_luci_rpc import OpenWrtRpc

   router = OpenWrtRpc('http://192.168.1.1', 'root', 'mypassword')

   result = router.get_all_connected_devices(only_reachable=True)

   for device in result:
      mac = device['macaddress']
      name = device['hostname']


Development
~~~~~~~~~~~

See `contributing guide`_.

.. _contributing guide: CONTRIBUTING.rst


=======
History
=======

0.1.0 (2019-02-19)
------------------

* Initial release. Not working. Do not use.

0.2.0 (2019-02-19)
------------------

* Initial release. Not working. Do not use.

0.3.0 (2019-02-19)
------------------

* First working release on PyPI.

0.4.8 (2019-02-20)
------------------

* Fix travis deploy repo, once more.

0.4.9 (2019-02-20)
------------------

* Fix README formatting for docs.

0.4.10 (2019-02-20)
------------------

* Fix links to github repo

0.4.11 (2019-02-20)
------------------

* Updated usage in README.

0.4.12 (2019-02-20)
------------------

* Fix typo in README.


