Skip to main content

Concise layer on top of subprocess, similar to sh project

Project description

lagoon

Concise layer on top of subprocess, similar to sh project.

This README is auto-generated, see project wiki for details.

Commands

dirpile

Using OverlayFS create a merged view of the given (read only) dirs plus a (writable) temporary dir, print its path, and stay running until stdin is closed. The first given directory is the lowest in the pile (this is unlike the lowerdir mount option). This program requires root and is designed to be invoked via sudo.

API

dkrcache

NORMAL

Accept normal outcomes.

ABRUPT

Accept abrupt outcomes.

ALWAYS

Accept all outcomes.

NEVER

Do not accept any outcome.

ExpensiveTask Objects

class ExpensiveTask()

Arbitrary task accelerated by Docker cache.

__init__
def __init__(context, discriminator, task)

Create a task keyed by context directory and discriminator string.

run
def run(force=NEVER, cache=NORMAL)

Run the task, where force can be used to ignore a cached outcome, and cache can be used to deny caching an outcome.

dkrcache.util

ContextStream Objects

class ContextStream()

Fully customisable docker build context.

open
@classmethod
@contextmanager
def open(cls, dockerstdin)

Attach to the given stdin of docker build, which should have been given - as context.

put
def put(name, path)

Add the given path as the given archive name.

putstream
def putstream(name, stream)

Add the given stream as the given archive name.

mkdir
def mkdir(name)

Create a directory in the context.

iidfile
@contextmanager
def iidfile()

Context manager yielding an object with args to pass to docker build, and a read function to get the image ID.

lagoon.binary

Like lagoon.text module but ProgramHandle objects are in binary mode.

lagoon.program

Program Objects

class Program()

Normally import an instance from lagoon.text or lagoon.binary module instead of instantiating manually.

text
@classmethod
def text(cls, path)

Return text mode ProgramHandle for the executable at the given path.

binary
@classmethod
def binary(cls, path)

Return binary mode ProgramHandle for executable at given path.

ProgramHandle Objects

class ProgramHandle(Parabject)

__getattr__
def __getattr__(name)

Add argument, where underscore means dash.

__getitem__
def __getitem__(key)

Apply a style, e.g. partial to suppress execution or print to send stdout to console.

__call__
def __call__(*args, **kwargs)

Run program in foreground with additional args. Accepts many subprocess kwargs. Use partial style to suppress execution, e.g. before running in background. Otherwise return CompletedProcess, or one of its fields if the rest are redirected, or None if all fields redirected.

__enter__
def __enter__()

Start program in background yielding the Popen object, or one of its fields if the rest are redirected.

NOEOL Objects

@singleton
class NOEOL()

Style to strip trailing newlines from stdout, in the same way as shell does.

ONELINE
def ONELINE(text)

Style to assert exactly one line of output, using splitlines.

lagoon.sic.binary

Commands with an underscore already in their name, binary mode.

lagoon.sic.text

Commands with an underscore already in their name, text mode.

lagoon.terminal

lagoon.text

Text mode instances of ProgramHandle for every executable, with dash translated to underscore e.g. from lagoon.text import pkg_config for pkg-config.

lagoon.url

lagoon.util

atomic
@contextmanager
def atomic(path)

Context manager yielding a temporary Path for atomic write to the given path. Parent directories are created automatically. Also suitable for making a symlink atomically. Leaves the given path unchanged if an exception happens.

threadlocalproperty Objects

class threadlocalproperty()

Like property but each thread has its own per-object values.

__init__
def __init__(defaultfactory)

The defaultfactory should return the initial value per object (per thread).

mapcm
@contextmanager
def mapcm(f, obj)

Invoke obj as a context manager, apply f to its yielded value, and yield that. For example apply Path to the string yielded by TemporaryDirectory().

stripansi
def stripansi(text)

Remove ANSI control sequences from the given text, to make it black and white.

HarnessCase Objects

class HarnessCase(TestCase)

Enter context managers in setUp and exit them in tearDown.

harness
def harness()

Must yield exactly once.

wrappercli
def wrappercli()

Same as sys.argv[1:] if -- is present there, otherwise -- is prepended. This is for sending all options to a wrapped command by default.

multifork

screen

GNU Screen interface, smoothing over its many gotchas.

stuffablescreen
def stuffablescreen(doublequotekey)

Return text mode ProgramHandle for screen, with the given environment variable set to double quote.

Stuff Objects

class Stuff()

__init__
def __init__(session, window, doublequotekey)

Target the given screen session and window, using the given environment variable for double quote.

__call__
def __call__(text)

Send the given text so that it is received literally.

eof
def eof()

Send EOF, may have no effect if not at the start of a line.

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

lagoon-61.tar.gz (18.0 kB view details)

Uploaded Source

Built Distribution

lagoon-61-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

Details for the file lagoon-61.tar.gz.

File metadata

  • Download URL: lagoon-61.tar.gz
  • Upload date:
  • Size: 18.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for lagoon-61.tar.gz
Algorithm Hash digest
SHA256 e585e00a48e7fee316f73f46319bb0bcba1773ccffad84af46ada713593cd461
MD5 108479eff71ba9b94a88d3954f2f0ba1
BLAKE2b-256 6c529ecea4628117eddc01bbede4c84272b7da9c8aa12809d02d01a079bc44c0

See more details on using hashes here.

File details

Details for the file lagoon-61-py3-none-any.whl.

File metadata

  • Download URL: lagoon-61-py3-none-any.whl
  • Upload date:
  • Size: 19.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.12

File hashes

Hashes for lagoon-61-py3-none-any.whl
Algorithm Hash digest
SHA256 852207ee070c797734093d8031ea2663ecd749ecd541063d6544ed39e0cc993d
MD5 05a57f423e4cdf2fb3a847112b204648
BLAKE2b-256 c3f2c4a47e092f6c5f31f279aa6aa87ae3b0c36021ea1356dfa86d9404d6bb2c

See more details on using hashes here.

Supported by

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