Metadata-Version: 2.1
Name: yakutils
Version: 1.7.0
Summary: A really lazy package
Home-page: https://github.com/nficano/yakutils
Author: Nick Ficano
Author-email: nficano@gmail.com
License: MIT
Description: 
        <div align="center">
          <p>
            <img src="https://assets.nickficano.com/gh-yakutils.min.svg" width="270" height="135" alt="yakutils logo" />
          </p>
        <p align="center">
          <img src="https://img.shields.io/pypi/v/yakutils.svg" alt="pypi">
          <a href="https://pypi.org/project/yakutils/">
            <img src="https://img.shields.io/pypi/dm/yakutils.svg" alt="pypi">
          </a>
          <a href="https://pypi.python.org/pypi/yakutils/">
            <img src="https://img.shields.io/pypi/pyversions/yakutils.svg" />
          </a>
        </p>
        </div>
        
        # yakutils
        
        Yakutils is yet another toolbox of Python helper functions.
        
        This package is available on PyPi, but its primary purpose is to allow one (me) to copy these into projects or to prevent one (me as well) from needing to Google how to write them (I'm looking at you ``csv.DictReader`` and ``csv.DictWriter``).
        
        This project is a continuous work-in-progress, and while its contents are specific to stuff that I use, pull requests are certainly welcome.
        
        ## Installation
        
        To download using pip via PyPi:
        
        ```bash
        $ pip install yakutils
        ```
        
        ## Usage Examples:
        
        ```python
        >>> from yakutils import read_csv
        >>> read_csv('/path/to/data.csv')
        [
          {
            'name': 'Tomatillo',
            'age': 27
          },
          # ...
        ]
        
        >>> import datetime as dt
        >>> from yakutils import date_to_iso8601
        >>> date_to_iso8601(dt.date.today())
        '2020-01-26T00:00:00Z'
        
        >>> from yakutils import datetime_to_iso8601
        >>> datetime_to_iso8601(dt.datetime.utcnow())
        '2020-01-26T19:04:40.219668Z'
        
        >>> from yakutils import datetime_to_unixtimestamp
        >>> datetime_to_unixtimestamp(dt.datetime.utcnow())
        1580065524
        
        >>> from yakutils import iso8601_to_datetime
        >>> iso8601_to_datetime('2020-01-26T19:04:40.219668Z')
        datetime.datetime(2020, 1, 26, 19, 4, 40, 219668)
        
        >>> import json
        >>> from decimal import Decimal
        >>> from yakutils import json_defaults
        >>> json.dumps({
        ...   'now': dt.datetime.utcnow(),
        ...   'today': dt.date.today(),
        ...   'time': dt.time(1,2,3),
        ...   'num': Decimal(2.777),
        ...}, default=json_defaults)
        '{"now": "2020-01-28T01:10:37.599281Z", "today": "2020-01-27", "time": "01:02:03", "num": 2.777}'
        
        >>> from yakutils import random_string
        >>> random_string(20)
        'k4a9ue7TDjOC3p3oN0dl'
        
        >>> from yakutils import update_qs
        >>> update_qs('https://nickficano.com.com/?q=asdf&pi=3.14', pi=6.28)
        'https://nickficano.com.com/?q=asdf&pi=6.28'
        ```
        
        For complete list of utility functions, see: https://yakutils.readthedocs.io/en/latest/.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Description-Content-Type: text/markdown
