Metadata-Version: 2.1
Name: capslock
Version: 1.0.3
Summary: A utility python library for writing certain tasks in python easily & elegantly.
Home-page: https://github.com/faruk-ahmad/capslock
Author: Faruk Ahmad
Author-email: faruk.csebrur@gmail.com
License: MIT
Description: # CAPSLOCK
        ----------------------------------------------
        #### A utility python library for writing certain tasks in python easily & elegantly.
        -----------------------------------------------
        [The library is still in development. The doc is not completed yet. You can contribute to improve the library.]
        ## Background
        <p align= "justify">
        
        ```capslock``` is a high level utility library written in python for writing certain frequently needed task in faster & efficient way. For example, if you want to keep track of the execution time of one of your method while optimizing it, witing code for tracking execution time can be done easily using capslock.
        </p>
        
        --------------------------------------------------
        
        
        ## Installation
        Install using the following command - 
        ```bash
        pip install capslock
        ```
        
        Uninstall using the following command - 
        ```bash
        pip uninstall capslock
        ```
        
        ## Getting Started
        
        ### How to use decorators from capslock
        
        Capslock defines different decorators that can be used out of the box for certain frequent tasks. E.g. getting the run time of certain function over the period of optimization in development phase.
        
        #### Timing Decorator
        
        To keep track of the execution time of a function in your project for optimizing it over the time, just put the "timing" decorator in your desired function. Capslock will keep track of different run of that function and will plot a well visualized graph for last five execution time of that function.
        
        ```python
        from capslock import timing
        
        @timing
        def say_hello():
            print("Hello World")
        
        if __name__ == '__main__':
            say_hello()
        ```
        This will generate output like bellow: 
        
        ![Output of Capslock Timing Decorator](https://github.com/faruk-ahmad/capslock/blob/main/docs/output_1.png)
        
        And it will also keep track of runtime for different runs of the ```say_hello()``` function. and will plot a graph in the same directory of your python script.
        
        ![Runtime tracking using Capslock Timing Decorator](https://github.com/faruk-ahmad/capslock/blob/main/docs/say_hello.png)
        
        
        #### Debug Decorator
        
        To get debug information of anyof your function, follow the bellow instruction-
        
        ```python
        from capslock import debug
        
        @debug
        def add(number1, number2):
            return number1 + number2
        
        if __name__ == '__main__':
            print(add(20, 30))
        ```
        
        will provide you the following output with some debug information-
        
        ![Debug Information using Capslock Debug Decorator](https://github.com/faruk-ahmad/capslock/blob/main/docs/debug.png)
        ## How to Contribute
        
        You can contribute in different ways. You can add more decorators for frequently used tasks in day to day development works.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
