Metadata-Version: 2.1
Name: xautic
Version: 1.0.1
Summary: xautic: live reloading with Python.
Home-page: https://github.com/xames3/xautic/
Author: Akshay Mestry (XAMES3)
Author-email: xa@mes3.in
License: MIT
Project-URL: Changelog, https://github.com/xames3/xautic
Project-URL: Source, https://github.com/xames3/xautic
Project-URL: Tracker, https://github.com/xames3/xautic/issues
Keywords: debugging,live-reloading
Platform: unix
Platform: linux
Platform: osx
Platform: cygwin
Platform: win32
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
License-File: LICENSE

xautic
======

Live reloading with Python!

According to `this`_ widely accepted StackOverflow answer,
Live reloading reloads or refreshes the entire app when a file changes. For example,
if you were four links deep into your navigation and saved a change, live reloading would
restart the app and load the app back to the initial route. And that's what this module does!

The inspiration behind writing this module comes the python based web frameworks, `Flask`_ and `Django`_.
These beast of a packages provide not only the best and easiest public APIs for creating and deploying
websites but also provide one nifty feature of **live reloading**. The feature is subtle but effective
and mostly productive. Ability to quickly reload and execute the code comes handy when you are trying
to meet the deadlines. One just needs to write, modify and save files as they wish and voila! You have
the latest execution.

The usage of this module is as simple and intuitive as it gets. Just slap a decorator on your target
function and let `xautic` do its work.

.. _this: https://stackoverflow.com/a/41429055/14316408/
.. _Flask: https://flask.palletsprojects.com/en/2.0.x/
.. _Django: https://www.djangoproject.com/

Installation
------------

Install and update using `pip`_:

.. code-block:: bash

    $ pip install -U xautic

.. _pip: https://pip.pypa.io/en/stable/getting-started/

Example
-------

.. code-block:: python

    # Save this file as example.py
    from xautic import debug

    @debug
    def func():
        return "Hello World"

.. code-block:: bash

    $ python3 example.py
    Starting xautic v1.0.1 live reloading (/home/example.py) on Thu May 04, 2021 - 13:23:00, press CTRL+C to quit


