Skip to main content

Simple module for easily isolating temporary file I/O

Project description

Latest Version Travis-ci build status Coveralls test coverage

A simple module for easily isolating temporary file I/O to a directory. Ever developed a command-line tool which required a lot of file manipulation? Caching, perhaps? You don’t want to use the cwd and keeping all of your paths straight if you’re working outside of it can be a pain. This tool may be the pain-reliever you need!

A tale of sin and woe

Well, not really. I’ve just developed a bunch of tools that rely on various bits of temporary or isolated file I/O, and found myself implementing this pattern over and over again. Eventually, I got tired of doing it and decided to develop this handy module. Now I’m passing the savings on to you!

Compatibility

As far as I know, workdir is compatible with every version of Python from 2.6 through 3.5. It should also be compatible with all major platforms including Linux, OSX, and Windows. If not, let me know!

Installation

pip install workdir

Examples

Use it as a staging area for downloaded archives:

import workdir
import shutil
workdir.options.path = '~/.myfilecache'
with workdir.as_cwd():
    download_remote_archive('somefile')
    unpack_archive('somefile', 'somedir')
shutil.copy(workdir.path_to_file('somedir', 'unpackedfilefromarchive'),
            os.path.join('otherdir', 'unpackedfilefromarchive'))

Use it as a working directory in your git repo (added to .gitignore, of course):

import workdir
workdir.options.path = '.gitrepo.work'
workdir.sync()
with workdir.as_cwd():
    futz_with_source_tree()
    more_futzing()

Project details


Download files

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

Source Distribution

workdir-0.3.5.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

workdir-0.3.5-py2.py3-none-any.whl (3.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file workdir-0.3.5.tar.gz.

File metadata

  • Download URL: workdir-0.3.5.tar.gz
  • Upload date:
  • Size: 3.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for workdir-0.3.5.tar.gz
Algorithm Hash digest
SHA256 5629ad5907932e349922c75d93c5a985438837bebc5447eafc5d27b4db187118
MD5 33a326e1811c4a32a9e9ff6213530b5a
BLAKE2b-256 91744f2fe2c850a5fb503f57a39f4254be4c71c950648050980d51d1ae72177f

See more details on using hashes here.

File details

Details for the file workdir-0.3.5-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for workdir-0.3.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e92e13b6d91620139f7207ae867ad9537ade75dc09f642455ef55f97ac60f62a
MD5 e7f200ae4776f0d8d4d2bf5feb52ed13
BLAKE2b-256 8e8fe6d551b9075c2cd4bfe499fe78d3a157059b4fb7970583102a23a026a3d9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page