Skip to main content

Packets in Python made Simple

Project description

Build Status Codacy Badge Coverage Status Documentation Status


Packets in Python Simplified.

This python package is everything you need to "transmorgrify" your packets:

Calvin and Hobbes Strip

This package is intended to make creating and/or parsing packets (structured bytecode) on the fly quick and easy. This is a wrapper around the ctypes module built-in to python. This package is designed with influence from Django's modeling and will look familiar to those that have used it.

A quick explanation of Packets and how to use them

Packets are structured bytecode used for passing information from one place to another. The most common example is that of a TCP/IP Packet, but isn't necessarily limited to networking packets. Here's a quick example. Let's say we want to make a "smart" washing machine by attaching a Raspberry Pi that then talks to your other smart devices and alerts you when a load of laundry is done and how many loads of laundry you've done that day.

Example Diagram

One way to communicate between the Raspberry Pi and your other devices is to send status "packets" or byte data across a network. Let's say we want to know the following in our packet:

  • Status - a Boolean that represents whether the Washing Machine is running or stopped
  • Number of Loads - an Integer that represents the number of loads done that day

To create this packet in CalPack is simple:

from calpack import models

class MachineStatus(models.Packet):
    Status = models.BooleanField()
    Num_Loads = models.IntField()

On our monitoring device (the Raspberry Pi), we can easily create the byte data for the packet by using our new packet:

status_pkt = MachineStatus(

# Send the byte data using an assumed custom `send` funcion

And converting the recieved byte data is simple as well:

# assuming a `receive` function and returns the byte data of the sent packet
received_data = MachineSatus.from_bytes(receive())


This package is maintained in GitHub and packaged for deployment on PyPi.

Simply using pip install calpack will get this installed.


Documentation is host on read the docs

Python 2 and 3

Currently this module is designed to work for both Python 2.7+ and 3.3+, however, with the term of life for Python 2 nearing, this package will eventually port entirely over to Python 3.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

calpack-2018.6.0.tar.gz (10.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page