BFB Delivery: A Cruft Cutter

Library and CLI for Bellingham Food Bank Delivery.

Use this package to cut some cruft around creating delivery route manifests for the Bellingham Food Bank. There is one main tool Build, Optimize, and Distribute Circuit Routes from Chunked Routes Sheet, which is a CLI tool to take a spreadsheet of stops assigned to drivers (“chunked” routes, as staff call it) and upload to Circuit to build, optimize, and distribute routes to drivers, producing also a final manifest spreadsheet to print for each driver.

Now that staff have adopted this tool, they estimate it saves about five paid staff hours per week, and reduces the room for error in the process.

This is a Crickets and Comb solution.

Contents

• Getting Started
  • Setting up your machine
    • First-time setup: Installing the package
    • First-time setup: File setup
    • Using the package once installed
  • Usage examples
    • CLI
    • Library
  • Your workflow
  • See Also
• The Delivery-Planning Workflow
  • Activate your env
  • Route all stops with Circuit
  • Chunk the stops by driver
  • Build and distribute the routes
  • Review the console output to confirm success
  • Review and print manifests
  • See Also
• Build, Optimize, and Distribute Circuit Routes from Chunked Routes Sheet
  • Usage
    • Examining output
    • Reviewing final manifests
    • Optional arguments
  • Note on tools this tool wraps
  • See Also
• Intro to Command Line and Bash
  • The “command prompt” or “terminal”
  • Navigating your file system
    • Present working directory
    • Listing files and directories
    • Changing directories
  • Manipulating files and directories
    • Making a directory
    • Creating a file
    • Copying files and directories
    • Moving files and directories
    • Removing files and directories
  • Wildcards
  • Reading files
    • Displaying the contents of a file
  • Writing to files
    • Displaying a string in the terminal
    • Appending a string to a file
    • Overwriting a file with a string
    • Using nano
• CLI
  • build_routes_from_chunked
  • split_chunked_route
  • create_manifests_from_circuit
  • create_manifests
  • format_combined_routes
  • See Also
• bfb_delivery
  • bfb_delivery package
    • Subpackages
    • Module contents
• Developer Resources
  • Circuit API
    • Data structure
  • See Also

Installation

Run the following to install the package:

pip install bfb_delivery

See Getting Started for more information.

See Also

BFB Delivery GitHub repository

bfb-delivery PyPi distribution