pappardelle 0.4

No project description provided

Pappardelle

Pappardelle is a Python module that provides helper functions for lists and dates.

Change Log

• Version 0.4
  • Added a function decorator for measuring the function execution time
• Version 0.3
  • Use date as the default type for day/week/month/year relative functions, and datetime as the default type for hour/minute/second relative functions
• Version 0.2
  • compare_lists returns a dictionary with keys: =, +, - (instead of: matched, + -)
  • Added relative date functions
• Version 0.1
  • First release with compare_lists and lookup_lists functions

Author

My name is Katkam Nitin Reddy. I am a former software developer living (mostly) in Dubai. I created this library for functionality that I find myself re-writing for a Terraform-style project.

Acknowledgement

I would like to thank my mom, Katkam Nita Reddy, and my dad, Katkam Narsing Reddy, who have always motivated me to learn and contribute to the open-source community.

Getting Started

Install the Python module with

python3 -m pip install pappardelle

Then, within your Python (.py) source code, like in this example:

from pappardelle import compare_lists

Call the imported function:

>>> compare_lists(
    [1, 2, 3],
    [2, 3, 5]
)

# Returns the following
{
    '=': [2, 3],
    '+': [1],
    '-': [5]
}

References

List Functions

compare_lists(list1, list2, optional lambda comparator)

lookup_lists(list1, list2, optional lambda comparator)

Date Functions

days_before(num_of_days, from_date)

days_ago(num_of_days)

days_after(num_of_days, from_date)

days_since(num_of_days, from_date)

tomorrow()

yesterday()

hours_before(num_of_hours, from_date)

hours_ago(num_of_hours)

hours_after(num_of_hours, from_date)

hours_since(num_of_hours, from_date)

minutes_before(num_of_minutes, from_date)

minutes_ago(num_of_minutes)

minutes_after(num_of_minutes, from_datee)

minutes_since(num_of_minutes, from_date)

seconds_before(num_of_seconds, from_date)

seconds_ago(num_of_seconds)

seconds_after(num_of_seconds, from_date)

seconds_since(num_of_seconds, from_date)

weeks_before(num_of_weeks, from_date)

weeks_ago(num_of_weeks)

weeks_after(num_of_weeks, from_date)

weeks_since(num_of_weeks, from_date)

months_before(num_of_months, from_date)

months_ago(num_of_months)

months_after(num_of_months, from_date)

months_since(num_of_months, from_date)

years_before(num_of_years, from_date)

years_ago(num_of_years)

years_after(num_of_years, from_date)

years_since(num_of_years, from_date)

Function Decorators

exec_time

Examples

Example 1. Within a Server State Management application

from pappardelle import compare_lists
from pprint import pprint

desired_state = [
  {"package_name": "net-tools"},
  {"package_name": "build-essential"},
  {"package_name": "bind9-dnsutils"}
]

current_state = [
  {"package_name": "build-essential"},
  {"package_name": "squid"}
]

change_plan = compare_lists(
  desired_state,
  current_state,
  lambda x, y: x['package_name'] == y['package_name']
)

pprint(change_plan)

# Output
# {'+': [{'package_name': 'net-tools'}, {'package_name': 'bind9-dnsutils'}],
# '-': [{'package_name': 'squid'}],
# '=': [{'package_name': 'build-essential'}]}