Metadata-Version: 2.1
Name: jblib
Version: 1.6.37
Summary: JustBard's Python Utilities
Home-page: http://justbard.com
Author: Justin Bard
Author-email: JustinBard@gmail.com
License: UNKNOWN
Description: # jblib
        ## Author: Justin Bard
        
        This module was written to minimize the need to write the functions I use often.
        
        INSTALL:  ` python3 -m pip install jblib `
        
        ---
        The source code can be viewed here: [https://github.com/ANamelessDrake/jblib](https://github.com/ANamelessDrake/jblib)
        
        More of my projects can be found here: [http://justbard.com](http://justbard.com)
        
        ---
        ` from jblib import cd `
        ```
            class cd()
                    
                Example: 
                    with cd(directory):
                        print (os.getcwd()) 
        
                    print (os.getcwd()) ## Back at the originating directory on exit
        ```
        
        ---
        ` from jblib import hilight `
        ```
            class hilight(string).color(highlight=True, bold=True)
        
                Example:
                    print (hilight("Hello World").red(bold=True))
        
                    Or you could make an object:
                        text = hilight("Bar")
        
                        print ("Foo "+text.blue())
        
                    To return the original string:
                        print (text.string)
                
                Available Colors:
                    red
                    green
                    yellow
                    blue
                    purple
                    teal
                    white
        ```
        
        ---
        ` from jblib import convert_module `
        ```
            Module to convert various data
                    
                    def convert_time_from_seconds(seconds_given)
                        Converts a seconds into minutes, hours and days. 
                    
                    def IP2Int(ip)
                        Converts a IPv4 address to a interger - This is useful to store IP addresses in databases
                    
                    def Int2IP(ipnum)
                        Converts a interger back to an IPv4 address
        
                    def urlcode(url, encode=False)
                        Wrapper for urllib.parse.quote and urllib.parse.unquote.
                        From urllib docs - Replace special characters in string using the %xx escape. Letters, digits, and the characters '_.-' are never quoted. By default, this function is intended for quoting the path section of URL. 
                        - https://docs.python.org/3.1/library/urllib.parse.html?highlight=urllib#urllib.parse.quote
        ```
        
        ---
        ` from jblib import HTMLgen `
        ```
                Basic HTML generator
                02/09/2019
        
                class HTMLgen(head=False, tail=False, lang="en", docType="html")
        
                FUNCTIONS:
                    title(self, title, scripts=None, css=None)
                    body.add(content)
                    tag(tag, content=False, close=True, cssclass=None)
                    image(src, alt=None, srcset=None, height=None, width=None, style=None, cssclass=None)
                    br() <-- Returns a </ br> tag
                    div(cssclass) <-- Not yet implemented 
                
                TODO: 
                    Add a Table Class to allow dynamically built tables (cols and rows to be programmatically built)
                    Add a Div Builder
        
                EXAMPLE:
                    page = HTMLgen(True, True)
                    page.title("This is the page Title", scripts="foo.js bar.js", css="styles.css nav.css")
                    page.body.add(HTMLgen.image("images/frontpage.jpg", width="100%"))
                    page.body.add(HTMLgen.tag("h1", "This is a header line"))
                    page.body.add("This is another line")
        
        
                    page.return_html()
        
                    ```
                        <!DOCTYPE html>
                        <html lang="en">
                            <head>
                                <title>This is the page Title</title>
                                <link rel="stylesheet" href="styles.css">
                                <link rel="stylesheet" href="nav.css">
                                <script src="foo.js"></script>
                                <script src="bar.js"></script>
                            </head>
                        <body>
                            <img src="images/frontpage.jpg" width="100%">
                            <h1>This is a header line</h1>
                            This is another line
                        </body>
                        </html>
                    ```
        ```
        
        ` from jblib import progress_bar `
        ```
            Progress Bar
            02/25/2019
            
            FUNCTIONS:
                progress_bar(progress, barLength=50, text_field="Progress")
        
            EXAMPLE:
                counter = 0
                for i in range(100):
                    counter += 1
                    i = counter/100
                    progress_bar(i, 50)
                    sleep(0.1)
        
            Progress: [#########################-------------------------] 50.0%
        ```
        
        ` from jblib import build_date_array `
        
        ```
            Build Date Arrays
            02/27/2019
        
            FUNCTIONS:
                build_date_array(days=1, start_date=str(datetime.date.today()), date_format='%Y-%m-%d', mon=True, tues=True, wed=True, thur=True, fri=True, sat=True, sun=True, weekend=True):
        
            EXAMPLE:
                dates = build_date_array(days=7, weekend=False)
                dates
                    ['2019-02-27', '2019-02-28', '2019-03-01', '2019-03-02', '2019-03-03', '2019-03-05', '2019-03-06']
        ```
        
        ` from jblib import mean_deviation `
        
        '''
            DESCRIPTION:
                This function takes a Pandas DataFrame column in and then returns a series of calculated mean deviations
        
            FUNCTION:
                mean_deviation(data, mean=None)
        
            EXAMPLE:
                data["MeanDeviation"] = pd.Series(mean_deviation(data['column']), index=data.index)
        '''
        
        
        ` from jblib import standard_deviation `
        
        '''
            DESCRIPTION:
                This function takes a Pandas DataFrame column in and then returns the calculated standard deviation
        
            FUNCTION:
                standard_deviation(data, mean=None)
        
            EXAMPLE:
                standard_dev = standard_deviation(data['column'])
        '''
        
        ` from jblib import StreamToLogger `
        
        ```
            DESCRIPTION:
                Fake file-like stream object that redirects writes to a logger instance.
                
            CLASS:
                StreamToLogger(object)
            EXAMPLE:
                if log_enabled: ## If true, all standard output and standard error to the console will be disabled
                    # create logger
                    logging.basicConfig(format='%(asctime)s - %(message)s', datefmt='%Y%m%d %H:%M:%S', filename=log_file)
                    logger = logging.getLogger(__name__)
                    logger.setLevel(logging.DEBUG)
        
                    logger.propagate = False
                    fh = logging.FileHandler(log_file, "a")
                    fh.setLevel(logging.DEBUG)
                    formatter = logging.Formatter(fmt='%(asctime)s - %(message)s', datefmt='%Y%m%d %H:%M:%S')
                    fh.setFormatter(formatter)
                    logger.addHandler(fh)
                    keep_fds = [fh.stream.fileno()]
        
                    stdout_logger = logging.getLogger('STDOUT')
                    sl = StreamToLogger(stdout_logger, logging.INFO)
                    sys.stdout = sl
        
                    stderr_logger = logging.getLogger('STDERR')
                    sle = StreamToLogger(stderr_logger, logging.ERROR)
                    sys.stderr = sle
        ```
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Description-Content-Type: text/markdown
