https://github.com/nficano/yakutils

Yet another toolbox of Python 3 helper functions.
https://github.com/nficano/yakutils

boilerplate helpers pypi python3 toolbox

Last synced: about 1 month ago
JSON representation

Yet another toolbox of Python 3 helper functions.

• Host: GitHub
• URL: https://github.com/nficano/yakutils
• Owner: nficano
• License: unlicense
• Created: 2020-01-16T13:00:05.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-05-27T23:00:40.000Z (over 2 years ago)
• Last Synced: 2024-05-01T14:58:20.981Z (9 months ago)
• Topics: boilerplate, helpers, pypi, python3, toolbox
• Language: Python
• Homepage: https://yakutils.readthedocs.io
• Size: 188 KB
• Stars: 108
• Watchers: 5
• Forks: 6
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  


    

  



  

  

    

  





# 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/.