Skip to content
No description or website provided.
Branch: master
Clone or download
Latest commit 827e74f Nov 4, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
myusps added support for firefox headless Apr 21, 2018
tests fix lint and test Feb 12, 2018
.gitignore initial code commit Jan 4, 2017
.travis.yml bump requests Nov 4, 2018
LICENSE Initial commit Jan 3, 2017
Makefile initial code commit Jan 4, 2017
README.md Update README.md Feb 14, 2018
pylintrc initial code commit Jan 4, 2017
setup.py bump requests Nov 4, 2018
tox.ini Update tox.ini Feb 14, 2018

README.md

Build Status PyPI version

python-myusps

Python 3 API for USPS Informed Delivery, a way to track packages and mail.

Prerequisites

USPS

Sign up for Informed Delivery and verify your address.

Chrome

Install Google Chrome and Chromedriver. These are dependencies for the Selenium webdriver, which is used internally to this module to facilitate the login process.

Instructions (adapt as necessary for your OS):

Note that installing Selenium Server is not required.

Install

pip install myusps

Usage

import myusps

# Establish a session.
# Use the login credentials you use to login to My USPS via the web.
# A login failure raises a `USPSError`.
session = myusps.get_session("username", "password")

# Get your profile information as a dict. Includes name, address, phone, etc.
profile = myusps.get_profile(session)

# Get all packages that My UPS knows about.
packages = myusps.get_packages(session)

# Get mail delivered on a given day.
import datetime
mail = myusps.get_mail(session, datetime.datetime.now().date())

Caching

Session cookies are cached by default in ./usps_cookies.pickle and will be used if available instead of logging in. If the cookies expire, a new session will be established automatically.

HTTP requests are cached by default in ./usps_cache.sqlite. HTTP caching defaults to 5 minutes and can be turned off by passing cache=False to get_session. The cache expiry can be adjusted with the keyword argument cache_expiry.

Development

Lint

tox

Release

make release

Contributions

Contributions are welcome. Please submit a PR that passes tox.

Disclaimer

Not affiliated with USPS. Does not use USPS Web Tools API. Use at your own risk.

You can’t perform that action at this time.