138 lines
3.9 KiB
Python
138 lines
3.9 KiB
Python
# -*- test-case-name: twisted.application.runner.test.test_exit -*-
|
|
# Copyright (c) Twisted Matrix Laboratories.
|
|
# See LICENSE for details.
|
|
|
|
"""
|
|
System exit support.
|
|
"""
|
|
|
|
from sys import stdout, stderr, exit as sysexit
|
|
|
|
from constantly import Values, ValueConstant
|
|
|
|
|
|
|
|
def exit(status, message=None):
|
|
"""
|
|
Exit the python interpreter with the given status and an optional message.
|
|
|
|
@param status: An exit status.
|
|
@type status: L{int} or L{ValueConstant} from L{ExitStatus}.
|
|
|
|
@param message: An options message to print.
|
|
@type status: L{str}
|
|
"""
|
|
if isinstance(status, ValueConstant):
|
|
code = status.value
|
|
else:
|
|
code = int(status)
|
|
|
|
if message:
|
|
if code == 0:
|
|
out = stdout
|
|
else:
|
|
out = stderr
|
|
out.write(message)
|
|
out.write("\n")
|
|
|
|
sysexit(code)
|
|
|
|
|
|
|
|
try:
|
|
import posix as Status
|
|
except ImportError:
|
|
class Status(object):
|
|
"""
|
|
Object to hang C{EX_*} values off of as a substitute for L{posix}.
|
|
"""
|
|
EX__BASE = 64
|
|
|
|
EX_OK = 0
|
|
EX_USAGE = EX__BASE
|
|
EX_DATAERR = EX__BASE + 1
|
|
EX_NOINPUT = EX__BASE + 2
|
|
EX_NOUSER = EX__BASE + 3
|
|
EX_NOHOST = EX__BASE + 4
|
|
EX_UNAVAILABLE = EX__BASE + 5
|
|
EX_SOFTWARE = EX__BASE + 6
|
|
EX_OSERR = EX__BASE + 7
|
|
EX_OSFILE = EX__BASE + 8
|
|
EX_CANTCREAT = EX__BASE + 9
|
|
EX_IOERR = EX__BASE + 10
|
|
EX_TEMPFAIL = EX__BASE + 11
|
|
EX_PROTOCOL = EX__BASE + 12
|
|
EX_NOPERM = EX__BASE + 13
|
|
EX_CONFIG = EX__BASE + 14
|
|
|
|
|
|
|
|
class ExitStatus(Values):
|
|
"""
|
|
Standard exit status codes for system programs.
|
|
|
|
@cvar EX_OK: Successful termination.
|
|
@type EX_OK: L{ValueConstant}
|
|
|
|
@cvar EX_USAGE: Command line usage error.
|
|
@type EX_USAGE: L{ValueConstant}
|
|
|
|
@cvar EX_DATAERR: Data format error.
|
|
@type EX_DATAERR: L{ValueConstant}
|
|
|
|
@cvar EX_NOINPUT: Cannot open input.
|
|
@type EX_NOINPUT: L{ValueConstant}
|
|
|
|
@cvar EX_NOUSER: Addressee unknown.
|
|
@type EX_NOUSER: L{ValueConstant}
|
|
|
|
@cvar EX_NOHOST: Host name unknown.
|
|
@type EX_NOHOST: L{ValueConstant}
|
|
|
|
@cvar EX_UNAVAILABLE: Service unavailable.
|
|
@type EX_UNAVAILABLE: L{ValueConstant}
|
|
|
|
@cvar EX_SOFTWARE: Internal software error.
|
|
@type EX_SOFTWARE: L{ValueConstant}
|
|
|
|
@cvar EX_OSERR: System error (e.g., can't fork).
|
|
@type EX_OSERR: L{ValueConstant}
|
|
|
|
@cvar EX_OSFILE: Critical OS file missing.
|
|
@type EX_OSFILE: L{ValueConstant}
|
|
|
|
@cvar EX_CANTCREAT: Can't create (user) output file.
|
|
@type EX_CANTCREAT: L{ValueConstant}
|
|
|
|
@cvar EX_IOERR: Input/output error.
|
|
@type EX_IOERR: L{ValueConstant}
|
|
|
|
@cvar EX_TEMPFAIL: Temporary failure; the user is invited to retry.
|
|
@type EX_TEMPFAIL: L{ValueConstant}
|
|
|
|
@cvar EX_PROTOCOL: Remote error in protocol.
|
|
@type EX_PROTOCOL: L{ValueConstant}
|
|
|
|
@cvar EX_NOPERM: Permission denied.
|
|
@type EX_NOPERM: L{ValueConstant}
|
|
|
|
@cvar EX_CONFIG: Configuration error.
|
|
@type EX_CONFIG: L{ValueConstant}
|
|
"""
|
|
|
|
EX_OK = ValueConstant(Status.EX_OK)
|
|
EX_USAGE = ValueConstant(Status.EX_USAGE)
|
|
EX_DATAERR = ValueConstant(Status.EX_DATAERR)
|
|
EX_NOINPUT = ValueConstant(Status.EX_NOINPUT)
|
|
EX_NOUSER = ValueConstant(Status.EX_NOUSER)
|
|
EX_NOHOST = ValueConstant(Status.EX_NOHOST)
|
|
EX_UNAVAILABLE = ValueConstant(Status.EX_UNAVAILABLE)
|
|
EX_SOFTWARE = ValueConstant(Status.EX_SOFTWARE)
|
|
EX_OSERR = ValueConstant(Status.EX_OSERR)
|
|
EX_OSFILE = ValueConstant(Status.EX_OSFILE)
|
|
EX_CANTCREAT = ValueConstant(Status.EX_CANTCREAT)
|
|
EX_IOERR = ValueConstant(Status.EX_IOERR)
|
|
EX_TEMPFAIL = ValueConstant(Status.EX_TEMPFAIL)
|
|
EX_PROTOCOL = ValueConstant(Status.EX_PROTOCOL)
|
|
EX_NOPERM = ValueConstant(Status.EX_NOPERM)
|
|
EX_CONFIG = ValueConstant(Status.EX_CONFIG)
|