Skip to main content

Plowshare Wrapper

Build Status Coverage Status PyPI version

Python wrapper for managing multi-host uploads and downloads using plowshare. After uploading it returns an object with links to the file it uploaded. This wrapper contains both a Python module and a command line tool.

Installation

Check INSTALL.rst for installation instructions.

Module Usage

Upload

This module is composed of a single class, which can be used to upload a file to multiple hosts at once. Example:

import plowshare

p = plowshare.Plowshare()
p.upload('/home/jessie/documents/README.rst', 3)

The above example uploads the given file to three different hosts, chosen at random from a predefined list. This list is a subset of the available plowshare modules, limited to the ones that allow anonymous access. You can check it in plowshare/hosts.py

You can also specify a list of hosts (plowshare module names) to use:

import plowshare

p = plowshare.Plowshare(['turbobit', 'multiupload', 'exoshare', 'rghost', 'bayfiles'])
p.upload('/home/jessie/documents/README.rst', 3)

The upload method returns an array of objects with the hosts and URLs to which it uploaded the file. If some of the uploads fail, it doesn’t return an URL, but an error flag instead.

Here’s an example:

[
    { "host_name": "mediafire",  "url":   "http://www.mediafire.com/?qorncpzfe74s9" },
    { "host_name": "rapidshare", "url":   "http://rapidshare.com/files/130403982" },
    { "host_name": "anonfiles",  "error": true }
]

Download

You can also download uploaded files, by providing the object that the upload method generated, and the directory and filename where to download the file. This method returns an object that contains the path where the file was downloaded, or an object with the error message. Example:

import plowshare

uploads = [
    { 'host_name': 'mediafire',  'url':'http://www.mediafire.com/?qorncpzfe74s9' },
    { 'host_name': 'rapidshare', 'url':'http://rapidshare.com/files/130403982' },
    { 'host_name': 'anonfiles',  'error':true }
]

p = plowshare.Plowshare()
p.download(info, '/tmp/', 'readme_copy.rst')

If multiple sources are provided, they are used as failovers for downloading the file. If at least one source is successful, the others won’t be attempted and download() will return an object with the full path filename and the first host it successfuly downloaded it from:

{ "host_name": "mediafire", "filename": "/tmp/readme_copy.rst" }

There are multiple errors that can occur. Here’s a list of the currently supported errors:

{ "error": "no valid sources" }

Metadata

Release files for plowshare 0.3.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plowshare 0.3.6
File Size Uploaded Provenance Actions
plowshare-0.3.6.tar.gz 6.4 kB Without provenance Details for plowshare-0.3.6.tar.gz

Release files / plowshare-0.3.6.tar.gz

Download URL plowshare-0.3.6.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
1e7e5dc7d5a9ca1d89be8e67da27e74bf65bb2f0a6b98bd8bea5d4308d1e5e2d
BLAKE2b-256 checksum
How to use checksums
18c7652d2f7e6ad282b4babaceb541b803fcc72b9132385f5197946e9456f52d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for plowshare 0.3.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page