Skip to main content

Blocks provides a simple interface to read, organize, and manipulate structured data in files on local and cloud storage

Project description


Blocks provides a simple interface to read, organize, and manipulate structured data in files on local and cloud storage. See the documentation for more information.

pip install sq-blocks




To install all dependencies for local development and testing, you can do

pip install -e .[dev]


  • pytest runs the unit tests

To run them locally:


Continuous Integrations

CI is handled through travis, and will run non-GCS tests on 3.6, 3.7, 3.8. We may add cloud storage tests to travis soon, but for now tests should also be run locally to confirm that functionality works as well.

Versions and Tags

Use bumpversion to update the version of the package

bumpversion [major|minor|patch]

This will increment the version and update it both in and blocks/ It will also automatically commit a tag with the corresponding version. You can push this to the repo with

git push --tags


We use pre-commit to ensure consistent formatting, to make sure you run the hooks:

pre-commit install


The docs are generated from the code with sphinx, and can be tested locally:

cd docs
make html


Copyright 2018 Square, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details

Download files

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

Files for sq-blocks, version 0.9.1
Filename, size File type Python version Upload date Hashes
Filename, size sq_blocks-0.9.1-py3-none-any.whl (21.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size sq-blocks-0.9.1.tar.gz (14.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page