Package: duct-tape
Duct TapeDuct Tape is a Python interface for downloading data, uploading data, and controlling supported Ed-Tech software.
It is built on top of Requests and Selenium and is intended to help K-12 school system data and IT teams save
time and use "better" code to automate their work flows.Currently Supported ProductsThe following products are currently supported, some have more functionality that others.SchoolMintGoogle SheetsLexiaCleverInformed K12MealtimeTyping AgentSummit LearningSEISInstalling / Getting startedTo use this project, complete the following steps (note: we are currently running out of master and
have not cut a release yet):Set up a Chrome + Selenium environment on your computer. Instructionshere.Download or clone the project to your computer.Navigate to the rootducttapedirectory in your command line/terminal (the one with the setup.py file in it). Runpip install ./.Check out the SchoolMint example in theexamplesfolder to see how easy it can be to grab your data.DocumentationA good number of functions have strong doc strings describing their purpose, parameters, and return types.
For now, this along with a couple ofexamplesare the primary sources of documentation.FeaturesDownloading data from ed-tech Web UIs without human interactionUploading data to ed-tech through web UIs without human interaction (coming soon)Controlling ed-tech web UIs through Python (limited implementation)The original development purpose of this project was to automate data extraction from ed-tech
products in Python and return them as Pandas dataframes for analysis. Therefore, the biggest
feature set is around downloading flat files from different ed-tech products that don't provide
API and SQL access at all the data you might need to get to. Some work is in progress around
uploading data and controlling other portions of ed-tech platforms, but it is still in
private development.DevelopingThe vision for this project is to have contributors from across different school systems help build
out a centralized, well-coded, tested library for interacting with ed-tech products that don't provide
adequate customer-facing APIs. This will be most successful if contributors come on board as developers
from different school systems; iron will sharpen iron and we will get better coverage of ed-tech products.If you are interested in developing (and especially if you are interested in adding in support for a new
product), please reach out topyoho@summitps.org.Ideas for Future DevelopmentAdd the ability to download data from a new productAdd a missing feature to a currently supported product.Fully automating unit testingUnit TestsUnit tests have been written for much of the functionality within this package. These are run
before any commits are made to master. However, they are context specific (in that you need
to use live instances to do the testing) and are not all fully automated (there are still cases
where a human needs to check that the downloaded data meets expected conditions since it is
being tested off of production systems).A future area of development would be to figure out how to properly mock interacting with
these ed-tech platforms so that we could fully automate unit testing and have better coverage.ContributingIf you'd like to contribute new functionality, please reach out topatrick@innovateedunyc.org. If you have
a bug fix or a code clean-up suggestion, feel free to fork us and submit a pull request.LicensingPlease see the license file.