mirror of
https://github.com/python/cpython
synced 2024-11-02 12:22:35 +00:00
3372 lines
94 KiB
C
3372 lines
94 KiB
C
|
|
/* System module */
|
|
|
|
/*
|
|
Various bits of information used by the interpreter are collected in
|
|
module 'sys'.
|
|
Function member:
|
|
- exit(sts): raise SystemExit
|
|
Data members:
|
|
- stdin, stdout, stderr: standard file objects
|
|
- modules: the table of modules (dictionary)
|
|
- path: module search path (list of strings)
|
|
- argv: script arguments (list of strings)
|
|
- ps1, ps2: optional primary and secondary prompts (strings)
|
|
*/
|
|
|
|
#include "Python.h"
|
|
#include "pycore_ceval.h" // _Py_RecursionLimitLowerWaterMark()
|
|
#include "pycore_initconfig.h" // _PyStatus_EXCEPTION()
|
|
#include "pycore_object.h" // _PyObject_IS_GC()
|
|
#include "pycore_pathconfig.h" // _PyPathConfig_ComputeSysPath0()
|
|
#include "pycore_pyerrors.h" // _PyErr_Fetch()
|
|
#include "pycore_pylifecycle.h" // _PyErr_WriteUnraisableDefaultHook()
|
|
#include "pycore_pymem.h" // _PyMem_SetDefaultAllocator()
|
|
#include "pycore_pystate.h" // _PyThreadState_GET()
|
|
#include "pycore_tuple.h" // _PyTuple_FromArray()
|
|
|
|
#include "code.h"
|
|
#include "frameobject.h" // PyFrame_GetBack()
|
|
#include "pydtrace.h"
|
|
#include "osdefs.h" // DELIM
|
|
#include "stdlib_module_names.h" // _Py_stdlib_module_names
|
|
#include <locale.h>
|
|
|
|
#ifdef MS_WINDOWS
|
|
#define WIN32_LEAN_AND_MEAN
|
|
#include <windows.h>
|
|
#endif /* MS_WINDOWS */
|
|
|
|
#ifdef MS_COREDLL
|
|
extern void *PyWin_DLLhModule;
|
|
/* A string loaded from the DLL at startup: */
|
|
extern const char *PyWin_DLLVersionString;
|
|
#endif
|
|
|
|
/*[clinic input]
|
|
module sys
|
|
[clinic start generated code]*/
|
|
/*[clinic end generated code: output=da39a3ee5e6b4b0d input=3726b388feee8cea]*/
|
|
|
|
#include "clinic/sysmodule.c.h"
|
|
|
|
_Py_IDENTIFIER(_);
|
|
_Py_IDENTIFIER(__sizeof__);
|
|
_Py_IDENTIFIER(_xoptions);
|
|
_Py_IDENTIFIER(buffer);
|
|
_Py_IDENTIFIER(builtins);
|
|
_Py_IDENTIFIER(encoding);
|
|
_Py_IDENTIFIER(path);
|
|
_Py_IDENTIFIER(stdout);
|
|
_Py_IDENTIFIER(stderr);
|
|
_Py_IDENTIFIER(warnoptions);
|
|
_Py_IDENTIFIER(write);
|
|
|
|
static PyObject *
|
|
sys_get_object_id(PyThreadState *tstate, _Py_Identifier *key)
|
|
{
|
|
PyObject *sd = tstate->interp->sysdict;
|
|
if (sd == NULL) {
|
|
return NULL;
|
|
}
|
|
PyObject *exc_type, *exc_value, *exc_tb;
|
|
_PyErr_Fetch(tstate, &exc_type, &exc_value, &exc_tb);
|
|
PyObject *value = _PyDict_GetItemIdWithError(sd, key);
|
|
/* XXX Suppress a new exception if it was raised and restore
|
|
* the old one. */
|
|
_PyErr_Restore(tstate, exc_type, exc_value, exc_tb);
|
|
return value;
|
|
}
|
|
|
|
PyObject *
|
|
_PySys_GetObjectId(_Py_Identifier *key)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
return sys_get_object_id(tstate, key);
|
|
}
|
|
|
|
static PyObject *
|
|
_PySys_GetObject(PyInterpreterState *interp, const char *name)
|
|
{
|
|
PyObject *sysdict = interp->sysdict;
|
|
if (sysdict == NULL) {
|
|
return NULL;
|
|
}
|
|
return _PyDict_GetItemStringWithError(sysdict, name);
|
|
}
|
|
|
|
PyObject *
|
|
PySys_GetObject(const char *name)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
PyObject *exc_type, *exc_value, *exc_tb;
|
|
_PyErr_Fetch(tstate, &exc_type, &exc_value, &exc_tb);
|
|
PyObject *value = _PySys_GetObject(tstate->interp, name);
|
|
/* XXX Suppress a new exception if it was raised and restore
|
|
* the old one. */
|
|
_PyErr_Restore(tstate, exc_type, exc_value, exc_tb);
|
|
return value;
|
|
}
|
|
|
|
static int
|
|
sys_set_object(PyInterpreterState *interp, PyObject *key, PyObject *v)
|
|
{
|
|
if (key == NULL) {
|
|
return -1;
|
|
}
|
|
PyObject *sd = interp->sysdict;
|
|
if (v == NULL) {
|
|
v = _PyDict_Pop(sd, key, Py_None);
|
|
if (v == NULL) {
|
|
return -1;
|
|
}
|
|
Py_DECREF(v);
|
|
return 0;
|
|
}
|
|
else {
|
|
return PyDict_SetItem(sd, key, v);
|
|
}
|
|
}
|
|
|
|
static int
|
|
sys_set_object_id(PyInterpreterState *interp, _Py_Identifier *key, PyObject *v)
|
|
{
|
|
return sys_set_object(interp, _PyUnicode_FromId(key), v);
|
|
}
|
|
|
|
int
|
|
_PySys_SetObjectId(_Py_Identifier *key, PyObject *v)
|
|
{
|
|
PyInterpreterState *interp = _PyInterpreterState_GET();
|
|
return sys_set_object_id(interp, key, v);
|
|
}
|
|
|
|
static int
|
|
sys_set_object_str(PyInterpreterState *interp, const char *name, PyObject *v)
|
|
{
|
|
PyObject *key = v ? PyUnicode_InternFromString(name)
|
|
: PyUnicode_FromString(name);
|
|
int r = sys_set_object(interp, key, v);
|
|
Py_XDECREF(key);
|
|
return r;
|
|
}
|
|
|
|
int
|
|
PySys_SetObject(const char *name, PyObject *v)
|
|
{
|
|
PyInterpreterState *interp = _PyInterpreterState_GET();
|
|
return sys_set_object_str(interp, name, v);
|
|
}
|
|
|
|
|
|
static int
|
|
should_audit(PyInterpreterState *interp)
|
|
{
|
|
/* interp must not be NULL, but test it just in case for extra safety */
|
|
assert(interp != NULL);
|
|
if (!interp) {
|
|
return 0;
|
|
}
|
|
return (interp->runtime->audit_hook_head
|
|
|| interp->audit_hooks
|
|
|| PyDTrace_AUDIT_ENABLED());
|
|
}
|
|
|
|
|
|
static int
|
|
sys_audit_tstate(PyThreadState *ts, const char *event,
|
|
const char *argFormat, va_list vargs)
|
|
{
|
|
/* N format is inappropriate, because you do not know
|
|
whether the reference is consumed by the call.
|
|
Assert rather than exception for perf reasons */
|
|
assert(!argFormat || !strchr(argFormat, 'N'));
|
|
|
|
if (!ts) {
|
|
/* Audit hooks cannot be called with a NULL thread state */
|
|
return 0;
|
|
}
|
|
|
|
/* The current implementation cannot be called if tstate is not
|
|
the current Python thread state. */
|
|
assert(ts == _PyThreadState_GET());
|
|
|
|
/* Early exit when no hooks are registered */
|
|
PyInterpreterState *is = ts->interp;
|
|
if (!should_audit(is)) {
|
|
return 0;
|
|
}
|
|
|
|
PyObject *eventName = NULL;
|
|
PyObject *eventArgs = NULL;
|
|
PyObject *hooks = NULL;
|
|
PyObject *hook = NULL;
|
|
int res = -1;
|
|
|
|
int dtrace = PyDTrace_AUDIT_ENABLED();
|
|
|
|
PyObject *exc_type, *exc_value, *exc_tb;
|
|
_PyErr_Fetch(ts, &exc_type, &exc_value, &exc_tb);
|
|
|
|
/* Initialize event args now */
|
|
if (argFormat && argFormat[0]) {
|
|
eventArgs = _Py_VaBuildValue_SizeT(argFormat, vargs);
|
|
if (eventArgs && !PyTuple_Check(eventArgs)) {
|
|
PyObject *argTuple = PyTuple_Pack(1, eventArgs);
|
|
Py_DECREF(eventArgs);
|
|
eventArgs = argTuple;
|
|
}
|
|
}
|
|
else {
|
|
eventArgs = PyTuple_New(0);
|
|
}
|
|
if (!eventArgs) {
|
|
goto exit;
|
|
}
|
|
|
|
/* Call global hooks */
|
|
_Py_AuditHookEntry *e = is->runtime->audit_hook_head;
|
|
for (; e; e = e->next) {
|
|
if (e->hookCFunction(event, eventArgs, e->userData) < 0) {
|
|
goto exit;
|
|
}
|
|
}
|
|
|
|
/* Dtrace USDT point */
|
|
if (dtrace) {
|
|
PyDTrace_AUDIT(event, (void *)eventArgs);
|
|
}
|
|
|
|
/* Call interpreter hooks */
|
|
if (is->audit_hooks) {
|
|
eventName = PyUnicode_FromString(event);
|
|
if (!eventName) {
|
|
goto exit;
|
|
}
|
|
|
|
hooks = PyObject_GetIter(is->audit_hooks);
|
|
if (!hooks) {
|
|
goto exit;
|
|
}
|
|
|
|
/* Disallow tracing in hooks unless explicitly enabled */
|
|
ts->tracing++;
|
|
ts->cframe->use_tracing = 0;
|
|
while ((hook = PyIter_Next(hooks)) != NULL) {
|
|
_Py_IDENTIFIER(__cantrace__);
|
|
PyObject *o;
|
|
int canTrace = _PyObject_LookupAttrId(hook, &PyId___cantrace__, &o);
|
|
if (o) {
|
|
canTrace = PyObject_IsTrue(o);
|
|
Py_DECREF(o);
|
|
}
|
|
if (canTrace < 0) {
|
|
break;
|
|
}
|
|
if (canTrace) {
|
|
ts->cframe->use_tracing = (ts->c_tracefunc || ts->c_profilefunc);
|
|
ts->tracing--;
|
|
}
|
|
PyObject* args[2] = {eventName, eventArgs};
|
|
o = _PyObject_FastCallTstate(ts, hook, args, 2);
|
|
if (canTrace) {
|
|
ts->tracing++;
|
|
ts->cframe->use_tracing = 0;
|
|
}
|
|
if (!o) {
|
|
break;
|
|
}
|
|
Py_DECREF(o);
|
|
Py_CLEAR(hook);
|
|
}
|
|
ts->cframe->use_tracing = (ts->c_tracefunc || ts->c_profilefunc);
|
|
ts->tracing--;
|
|
if (_PyErr_Occurred(ts)) {
|
|
goto exit;
|
|
}
|
|
}
|
|
|
|
res = 0;
|
|
|
|
exit:
|
|
Py_XDECREF(hook);
|
|
Py_XDECREF(hooks);
|
|
Py_XDECREF(eventName);
|
|
Py_XDECREF(eventArgs);
|
|
|
|
if (!res) {
|
|
_PyErr_Restore(ts, exc_type, exc_value, exc_tb);
|
|
}
|
|
else {
|
|
assert(_PyErr_Occurred(ts));
|
|
Py_XDECREF(exc_type);
|
|
Py_XDECREF(exc_value);
|
|
Py_XDECREF(exc_tb);
|
|
}
|
|
|
|
return res;
|
|
}
|
|
|
|
int
|
|
_PySys_Audit(PyThreadState *tstate, const char *event,
|
|
const char *argFormat, ...)
|
|
{
|
|
va_list vargs;
|
|
#ifdef HAVE_STDARG_PROTOTYPES
|
|
va_start(vargs, argFormat);
|
|
#else
|
|
va_start(vargs);
|
|
#endif
|
|
int res = sys_audit_tstate(tstate, event, argFormat, vargs);
|
|
va_end(vargs);
|
|
return res;
|
|
}
|
|
|
|
int
|
|
PySys_Audit(const char *event, const char *argFormat, ...)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
va_list vargs;
|
|
#ifdef HAVE_STDARG_PROTOTYPES
|
|
va_start(vargs, argFormat);
|
|
#else
|
|
va_start(vargs);
|
|
#endif
|
|
int res = sys_audit_tstate(tstate, event, argFormat, vargs);
|
|
va_end(vargs);
|
|
return res;
|
|
}
|
|
|
|
/* We expose this function primarily for our own cleanup during
|
|
* finalization. In general, it should not need to be called,
|
|
* and as such the function is not exported.
|
|
*
|
|
* Must be finalizing to clear hooks */
|
|
void
|
|
_PySys_ClearAuditHooks(PyThreadState *ts)
|
|
{
|
|
assert(ts != NULL);
|
|
if (!ts) {
|
|
return;
|
|
}
|
|
|
|
_PyRuntimeState *runtime = ts->interp->runtime;
|
|
PyThreadState *finalizing = _PyRuntimeState_GetFinalizing(runtime);
|
|
assert(finalizing == ts);
|
|
if (finalizing != ts) {
|
|
return;
|
|
}
|
|
|
|
const PyConfig *config = _PyInterpreterState_GetConfig(ts->interp);
|
|
if (config->verbose) {
|
|
PySys_WriteStderr("# clear sys.audit hooks\n");
|
|
}
|
|
|
|
/* Hooks can abort later hooks for this event, but cannot
|
|
abort the clear operation itself. */
|
|
_PySys_Audit(ts, "cpython._PySys_ClearAuditHooks", NULL);
|
|
_PyErr_Clear(ts);
|
|
|
|
_Py_AuditHookEntry *e = runtime->audit_hook_head, *n;
|
|
runtime->audit_hook_head = NULL;
|
|
while (e) {
|
|
n = e->next;
|
|
PyMem_RawFree(e);
|
|
e = n;
|
|
}
|
|
}
|
|
|
|
int
|
|
PySys_AddAuditHook(Py_AuditHookFunction hook, void *userData)
|
|
{
|
|
/* tstate can be NULL, so access directly _PyRuntime:
|
|
PySys_AddAuditHook() can be called before Python is initialized. */
|
|
_PyRuntimeState *runtime = &_PyRuntime;
|
|
PyThreadState *tstate;
|
|
if (runtime->initialized) {
|
|
tstate = _PyRuntimeState_GetThreadState(runtime);
|
|
}
|
|
else {
|
|
tstate = NULL;
|
|
}
|
|
|
|
/* Invoke existing audit hooks to allow them an opportunity to abort. */
|
|
/* Cannot invoke hooks until we are initialized */
|
|
if (tstate != NULL) {
|
|
if (_PySys_Audit(tstate, "sys.addaudithook", NULL) < 0) {
|
|
if (_PyErr_ExceptionMatches(tstate, PyExc_RuntimeError)) {
|
|
/* We do not report errors derived from RuntimeError */
|
|
_PyErr_Clear(tstate);
|
|
return 0;
|
|
}
|
|
return -1;
|
|
}
|
|
}
|
|
|
|
_Py_AuditHookEntry *e = runtime->audit_hook_head;
|
|
if (!e) {
|
|
e = (_Py_AuditHookEntry*)PyMem_RawMalloc(sizeof(_Py_AuditHookEntry));
|
|
runtime->audit_hook_head = e;
|
|
} else {
|
|
while (e->next) {
|
|
e = e->next;
|
|
}
|
|
e = e->next = (_Py_AuditHookEntry*)PyMem_RawMalloc(
|
|
sizeof(_Py_AuditHookEntry));
|
|
}
|
|
|
|
if (!e) {
|
|
if (tstate != NULL) {
|
|
_PyErr_NoMemory(tstate);
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
e->next = NULL;
|
|
e->hookCFunction = (Py_AuditHookFunction)hook;
|
|
e->userData = userData;
|
|
|
|
return 0;
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.addaudithook
|
|
|
|
hook: object
|
|
|
|
Adds a new audit hook callback.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_addaudithook_impl(PyObject *module, PyObject *hook)
|
|
/*[clinic end generated code: output=4f9c17aaeb02f44e input=0f3e191217a45e34]*/
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
/* Invoke existing audit hooks to allow them an opportunity to abort. */
|
|
if (_PySys_Audit(tstate, "sys.addaudithook", NULL) < 0) {
|
|
if (_PyErr_ExceptionMatches(tstate, PyExc_Exception)) {
|
|
/* We do not report errors derived from Exception */
|
|
_PyErr_Clear(tstate);
|
|
Py_RETURN_NONE;
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
PyInterpreterState *interp = tstate->interp;
|
|
if (interp->audit_hooks == NULL) {
|
|
interp->audit_hooks = PyList_New(0);
|
|
if (interp->audit_hooks == NULL) {
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
if (PyList_Append(interp->audit_hooks, hook) < 0) {
|
|
return NULL;
|
|
}
|
|
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(audit_doc,
|
|
"audit(event, *args)\n\
|
|
\n\
|
|
Passes the event to any audit hooks that are attached.");
|
|
|
|
static PyObject *
|
|
sys_audit(PyObject *self, PyObject *const *args, Py_ssize_t argc)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
_Py_EnsureTstateNotNULL(tstate);
|
|
|
|
if (argc == 0) {
|
|
_PyErr_SetString(tstate, PyExc_TypeError,
|
|
"audit() missing 1 required positional argument: "
|
|
"'event'");
|
|
return NULL;
|
|
}
|
|
|
|
if (!should_audit(tstate->interp)) {
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyObject *auditEvent = args[0];
|
|
if (!auditEvent) {
|
|
_PyErr_SetString(tstate, PyExc_TypeError,
|
|
"expected str for argument 'event'");
|
|
return NULL;
|
|
}
|
|
if (!PyUnicode_Check(auditEvent)) {
|
|
_PyErr_Format(tstate, PyExc_TypeError,
|
|
"expected str for argument 'event', not %.200s",
|
|
Py_TYPE(auditEvent)->tp_name);
|
|
return NULL;
|
|
}
|
|
const char *event = PyUnicode_AsUTF8(auditEvent);
|
|
if (!event) {
|
|
return NULL;
|
|
}
|
|
|
|
PyObject *auditArgs = _PyTuple_FromArray(args + 1, argc - 1);
|
|
if (!auditArgs) {
|
|
return NULL;
|
|
}
|
|
|
|
int res = _PySys_Audit(tstate, event, "O", auditArgs);
|
|
Py_DECREF(auditArgs);
|
|
|
|
if (res < 0) {
|
|
return NULL;
|
|
}
|
|
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
|
|
static PyObject *
|
|
sys_breakpointhook(PyObject *self, PyObject *const *args, Py_ssize_t nargs, PyObject *keywords)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
assert(!_PyErr_Occurred(tstate));
|
|
char *envar = Py_GETENV("PYTHONBREAKPOINT");
|
|
|
|
if (envar == NULL || strlen(envar) == 0) {
|
|
envar = "pdb.set_trace";
|
|
}
|
|
else if (!strcmp(envar, "0")) {
|
|
/* The breakpoint is explicitly no-op'd. */
|
|
Py_RETURN_NONE;
|
|
}
|
|
/* According to POSIX the string returned by getenv() might be invalidated
|
|
* or the string content might be overwritten by a subsequent call to
|
|
* getenv(). Since importing a module can performs the getenv() calls,
|
|
* we need to save a copy of envar. */
|
|
envar = _PyMem_RawStrdup(envar);
|
|
if (envar == NULL) {
|
|
_PyErr_NoMemory(tstate);
|
|
return NULL;
|
|
}
|
|
const char *last_dot = strrchr(envar, '.');
|
|
const char *attrname = NULL;
|
|
PyObject *modulepath = NULL;
|
|
|
|
if (last_dot == NULL) {
|
|
/* The breakpoint is a built-in, e.g. PYTHONBREAKPOINT=int */
|
|
modulepath = PyUnicode_FromString("builtins");
|
|
attrname = envar;
|
|
}
|
|
else if (last_dot != envar) {
|
|
/* Split on the last dot; */
|
|
modulepath = PyUnicode_FromStringAndSize(envar, last_dot - envar);
|
|
attrname = last_dot + 1;
|
|
}
|
|
else {
|
|
goto warn;
|
|
}
|
|
if (modulepath == NULL) {
|
|
PyMem_RawFree(envar);
|
|
return NULL;
|
|
}
|
|
|
|
PyObject *module = PyImport_Import(modulepath);
|
|
Py_DECREF(modulepath);
|
|
|
|
if (module == NULL) {
|
|
if (_PyErr_ExceptionMatches(tstate, PyExc_ImportError)) {
|
|
goto warn;
|
|
}
|
|
PyMem_RawFree(envar);
|
|
return NULL;
|
|
}
|
|
|
|
PyObject *hook = PyObject_GetAttrString(module, attrname);
|
|
Py_DECREF(module);
|
|
|
|
if (hook == NULL) {
|
|
if (_PyErr_ExceptionMatches(tstate, PyExc_AttributeError)) {
|
|
goto warn;
|
|
}
|
|
PyMem_RawFree(envar);
|
|
return NULL;
|
|
}
|
|
PyMem_RawFree(envar);
|
|
PyObject *retval = PyObject_Vectorcall(hook, args, nargs, keywords);
|
|
Py_DECREF(hook);
|
|
return retval;
|
|
|
|
warn:
|
|
/* If any of the imports went wrong, then warn and ignore. */
|
|
_PyErr_Clear(tstate);
|
|
int status = PyErr_WarnFormat(
|
|
PyExc_RuntimeWarning, 0,
|
|
"Ignoring unimportable $PYTHONBREAKPOINT: \"%s\"", envar);
|
|
PyMem_RawFree(envar);
|
|
if (status < 0) {
|
|
/* Printing the warning raised an exception. */
|
|
return NULL;
|
|
}
|
|
/* The warning was (probably) issued. */
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(breakpointhook_doc,
|
|
"breakpointhook(*args, **kws)\n"
|
|
"\n"
|
|
"This hook function is called by built-in breakpoint().\n"
|
|
);
|
|
|
|
/* Write repr(o) to sys.stdout using sys.stdout.encoding and 'backslashreplace'
|
|
error handler. If sys.stdout has a buffer attribute, use
|
|
sys.stdout.buffer.write(encoded), otherwise redecode the string and use
|
|
sys.stdout.write(redecoded).
|
|
|
|
Helper function for sys_displayhook(). */
|
|
static int
|
|
sys_displayhook_unencodable(PyObject *outf, PyObject *o)
|
|
{
|
|
PyObject *stdout_encoding = NULL;
|
|
PyObject *encoded, *escaped_str, *repr_str, *buffer, *result;
|
|
const char *stdout_encoding_str;
|
|
int ret;
|
|
|
|
stdout_encoding = _PyObject_GetAttrId(outf, &PyId_encoding);
|
|
if (stdout_encoding == NULL)
|
|
goto error;
|
|
stdout_encoding_str = PyUnicode_AsUTF8(stdout_encoding);
|
|
if (stdout_encoding_str == NULL)
|
|
goto error;
|
|
|
|
repr_str = PyObject_Repr(o);
|
|
if (repr_str == NULL)
|
|
goto error;
|
|
encoded = PyUnicode_AsEncodedString(repr_str,
|
|
stdout_encoding_str,
|
|
"backslashreplace");
|
|
Py_DECREF(repr_str);
|
|
if (encoded == NULL)
|
|
goto error;
|
|
|
|
if (_PyObject_LookupAttrId(outf, &PyId_buffer, &buffer) < 0) {
|
|
Py_DECREF(encoded);
|
|
goto error;
|
|
}
|
|
if (buffer) {
|
|
result = _PyObject_CallMethodIdOneArg(buffer, &PyId_write, encoded);
|
|
Py_DECREF(buffer);
|
|
Py_DECREF(encoded);
|
|
if (result == NULL)
|
|
goto error;
|
|
Py_DECREF(result);
|
|
}
|
|
else {
|
|
escaped_str = PyUnicode_FromEncodedObject(encoded,
|
|
stdout_encoding_str,
|
|
"strict");
|
|
Py_DECREF(encoded);
|
|
if (PyFile_WriteObject(escaped_str, outf, Py_PRINT_RAW) != 0) {
|
|
Py_DECREF(escaped_str);
|
|
goto error;
|
|
}
|
|
Py_DECREF(escaped_str);
|
|
}
|
|
ret = 0;
|
|
goto finally;
|
|
|
|
error:
|
|
ret = -1;
|
|
finally:
|
|
Py_XDECREF(stdout_encoding);
|
|
return ret;
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.displayhook
|
|
|
|
object as o: object
|
|
/
|
|
|
|
Print an object to sys.stdout and also save it in builtins._
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_displayhook(PyObject *module, PyObject *o)
|
|
/*[clinic end generated code: output=347477d006df92ed input=08ba730166d7ef72]*/
|
|
{
|
|
PyObject *outf;
|
|
PyObject *builtins;
|
|
static PyObject *newline = NULL;
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
builtins = _PyImport_GetModuleId(&PyId_builtins);
|
|
if (builtins == NULL) {
|
|
if (!_PyErr_Occurred(tstate)) {
|
|
_PyErr_SetString(tstate, PyExc_RuntimeError,
|
|
"lost builtins module");
|
|
}
|
|
return NULL;
|
|
}
|
|
Py_DECREF(builtins);
|
|
|
|
/* Print value except if None */
|
|
/* After printing, also assign to '_' */
|
|
/* Before, set '_' to None to avoid recursion */
|
|
if (o == Py_None) {
|
|
Py_RETURN_NONE;
|
|
}
|
|
if (_PyObject_SetAttrId(builtins, &PyId__, Py_None) != 0)
|
|
return NULL;
|
|
outf = sys_get_object_id(tstate, &PyId_stdout);
|
|
if (outf == NULL || outf == Py_None) {
|
|
_PyErr_SetString(tstate, PyExc_RuntimeError, "lost sys.stdout");
|
|
return NULL;
|
|
}
|
|
if (PyFile_WriteObject(o, outf, 0) != 0) {
|
|
if (_PyErr_ExceptionMatches(tstate, PyExc_UnicodeEncodeError)) {
|
|
int err;
|
|
/* repr(o) is not encodable to sys.stdout.encoding with
|
|
* sys.stdout.errors error handler (which is probably 'strict') */
|
|
_PyErr_Clear(tstate);
|
|
err = sys_displayhook_unencodable(outf, o);
|
|
if (err) {
|
|
return NULL;
|
|
}
|
|
}
|
|
else {
|
|
return NULL;
|
|
}
|
|
}
|
|
if (newline == NULL) {
|
|
newline = PyUnicode_FromString("\n");
|
|
if (newline == NULL)
|
|
return NULL;
|
|
}
|
|
if (PyFile_WriteObject(newline, outf, Py_PRINT_RAW) != 0)
|
|
return NULL;
|
|
if (_PyObject_SetAttrId(builtins, &PyId__, o) != 0)
|
|
return NULL;
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys.excepthook
|
|
|
|
exctype: object
|
|
value: object
|
|
traceback: object
|
|
/
|
|
|
|
Handle an exception by displaying it with a traceback on sys.stderr.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_excepthook_impl(PyObject *module, PyObject *exctype, PyObject *value,
|
|
PyObject *traceback)
|
|
/*[clinic end generated code: output=18d99fdda21b6b5e input=ecf606fa826f19d9]*/
|
|
{
|
|
PyErr_Display(exctype, value, traceback);
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys.exc_info
|
|
|
|
Return current exception information: (type, value, traceback).
|
|
|
|
Return information about the most recent exception caught by an except
|
|
clause in the current stack frame or in an older stack frame.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_exc_info_impl(PyObject *module)
|
|
/*[clinic end generated code: output=3afd0940cf3a4d30 input=b5c5bf077788a3e5]*/
|
|
{
|
|
_PyErr_StackItem *err_info = _PyErr_GetTopmostException(_PyThreadState_GET());
|
|
return Py_BuildValue(
|
|
"(OOO)",
|
|
err_info->exc_type != NULL ? err_info->exc_type : Py_None,
|
|
err_info->exc_value != NULL ? err_info->exc_value : Py_None,
|
|
err_info->exc_traceback != NULL ?
|
|
err_info->exc_traceback : Py_None);
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys.unraisablehook
|
|
|
|
unraisable: object
|
|
/
|
|
|
|
Handle an unraisable exception.
|
|
|
|
The unraisable argument has the following attributes:
|
|
|
|
* exc_type: Exception type.
|
|
* exc_value: Exception value, can be None.
|
|
* exc_traceback: Exception traceback, can be None.
|
|
* err_msg: Error message, can be None.
|
|
* object: Object causing the exception, can be None.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_unraisablehook(PyObject *module, PyObject *unraisable)
|
|
/*[clinic end generated code: output=bb92838b32abaa14 input=ec3af148294af8d3]*/
|
|
{
|
|
return _PyErr_WriteUnraisableDefaultHook(unraisable);
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys.exit
|
|
|
|
status: object = None
|
|
/
|
|
|
|
Exit the interpreter by raising SystemExit(status).
|
|
|
|
If the status is omitted or None, it defaults to zero (i.e., success).
|
|
If the status is an integer, it will be used as the system exit status.
|
|
If it is another kind of object, it will be printed and the system
|
|
exit status will be one (i.e., failure).
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_exit_impl(PyObject *module, PyObject *status)
|
|
/*[clinic end generated code: output=13870986c1ab2ec0 input=b86ca9497baa94f2]*/
|
|
{
|
|
/* Raise SystemExit so callers may catch it or clean up. */
|
|
PyErr_SetObject(PyExc_SystemExit, status);
|
|
return NULL;
|
|
}
|
|
|
|
|
|
|
|
/*[clinic input]
|
|
sys.getdefaultencoding
|
|
|
|
Return the current default encoding used by the Unicode implementation.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getdefaultencoding_impl(PyObject *module)
|
|
/*[clinic end generated code: output=256d19dfcc0711e6 input=d416856ddbef6909]*/
|
|
{
|
|
return PyUnicode_FromString(PyUnicode_GetDefaultEncoding());
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.getfilesystemencoding
|
|
|
|
Return the encoding used to convert Unicode filenames to OS filenames.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getfilesystemencoding_impl(PyObject *module)
|
|
/*[clinic end generated code: output=1dc4bdbe9be44aa7 input=8475f8649b8c7d8c]*/
|
|
{
|
|
PyInterpreterState *interp = _PyInterpreterState_GET();
|
|
const PyConfig *config = _PyInterpreterState_GetConfig(interp);
|
|
return PyUnicode_FromWideChar(config->filesystem_encoding, -1);
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.getfilesystemencodeerrors
|
|
|
|
Return the error mode used Unicode to OS filename conversion.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getfilesystemencodeerrors_impl(PyObject *module)
|
|
/*[clinic end generated code: output=ba77b36bbf7c96f5 input=22a1e8365566f1e5]*/
|
|
{
|
|
PyInterpreterState *interp = _PyInterpreterState_GET();
|
|
const PyConfig *config = _PyInterpreterState_GetConfig(interp);
|
|
return PyUnicode_FromWideChar(config->filesystem_errors, -1);
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.intern
|
|
|
|
string as s: unicode
|
|
/
|
|
|
|
``Intern'' the given string.
|
|
|
|
This enters the string in the (global) table of interned strings whose
|
|
purpose is to speed up dictionary lookups. Return the string itself or
|
|
the previously interned string object with the same value.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_intern_impl(PyObject *module, PyObject *s)
|
|
/*[clinic end generated code: output=be680c24f5c9e5d6 input=849483c006924e2f]*/
|
|
{
|
|
if (PyUnicode_CheckExact(s)) {
|
|
Py_INCREF(s);
|
|
PyUnicode_InternInPlace(&s);
|
|
return s;
|
|
}
|
|
else {
|
|
PyErr_Format(PyExc_TypeError,
|
|
"can't intern %.400s", Py_TYPE(s)->tp_name);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
|
|
/*
|
|
* Cached interned string objects used for calling the profile and
|
|
* trace functions. Initialized by trace_init().
|
|
*/
|
|
static PyObject *whatstrings[8] = {NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL};
|
|
|
|
static int
|
|
trace_init(void)
|
|
{
|
|
static const char * const whatnames[8] = {
|
|
"call", "exception", "line", "return",
|
|
"c_call", "c_exception", "c_return",
|
|
"opcode"
|
|
};
|
|
PyObject *name;
|
|
int i;
|
|
for (i = 0; i < 8; ++i) {
|
|
if (whatstrings[i] == NULL) {
|
|
name = PyUnicode_InternFromString(whatnames[i]);
|
|
if (name == NULL)
|
|
return -1;
|
|
whatstrings[i] = name;
|
|
}
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
|
|
static PyObject *
|
|
call_trampoline(PyThreadState *tstate, PyObject* callback,
|
|
PyFrameObject *frame, int what, PyObject *arg)
|
|
{
|
|
if (PyFrame_FastToLocalsWithError(frame) < 0) {
|
|
return NULL;
|
|
}
|
|
|
|
PyObject *stack[3];
|
|
stack[0] = (PyObject *)frame;
|
|
stack[1] = whatstrings[what];
|
|
stack[2] = (arg != NULL) ? arg : Py_None;
|
|
|
|
/* call the Python-level function */
|
|
PyObject *result = _PyObject_FastCallTstate(tstate, callback, stack, 3);
|
|
|
|
PyFrame_LocalsToFast(frame, 1);
|
|
if (result == NULL) {
|
|
PyTraceBack_Here(frame);
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
static int
|
|
profile_trampoline(PyObject *self, PyFrameObject *frame,
|
|
int what, PyObject *arg)
|
|
{
|
|
if (arg == NULL) {
|
|
arg = Py_None;
|
|
}
|
|
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
PyObject *result = call_trampoline(tstate, self, frame, what, arg);
|
|
if (result == NULL) {
|
|
_PyEval_SetProfile(tstate, NULL, NULL);
|
|
return -1;
|
|
}
|
|
|
|
Py_DECREF(result);
|
|
return 0;
|
|
}
|
|
|
|
static int
|
|
trace_trampoline(PyObject *self, PyFrameObject *frame,
|
|
int what, PyObject *arg)
|
|
{
|
|
PyObject *callback;
|
|
if (what == PyTrace_CALL) {
|
|
callback = self;
|
|
}
|
|
else {
|
|
callback = frame->f_trace;
|
|
}
|
|
if (callback == NULL) {
|
|
return 0;
|
|
}
|
|
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
PyObject *result = call_trampoline(tstate, callback, frame, what, arg);
|
|
if (result == NULL) {
|
|
_PyEval_SetTrace(tstate, NULL, NULL);
|
|
Py_CLEAR(frame->f_trace);
|
|
return -1;
|
|
}
|
|
|
|
if (result != Py_None) {
|
|
Py_XSETREF(frame->f_trace, result);
|
|
}
|
|
else {
|
|
Py_DECREF(result);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static PyObject *
|
|
sys_settrace(PyObject *self, PyObject *args)
|
|
{
|
|
if (trace_init() == -1) {
|
|
return NULL;
|
|
}
|
|
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
if (args == Py_None) {
|
|
if (_PyEval_SetTrace(tstate, NULL, NULL) < 0) {
|
|
return NULL;
|
|
}
|
|
}
|
|
else {
|
|
if (_PyEval_SetTrace(tstate, trace_trampoline, args) < 0) {
|
|
return NULL;
|
|
}
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(settrace_doc,
|
|
"settrace(function)\n\
|
|
\n\
|
|
Set the global debug tracing function. It will be called on each\n\
|
|
function call. See the debugger chapter in the library manual."
|
|
);
|
|
|
|
/*[clinic input]
|
|
sys.gettrace
|
|
|
|
Return the global debug tracing function set with sys.settrace.
|
|
|
|
See the debugger chapter in the library manual.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_gettrace_impl(PyObject *module)
|
|
/*[clinic end generated code: output=e97e3a4d8c971b6e input=373b51bb2147f4d8]*/
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
PyObject *temp = tstate->c_traceobj;
|
|
|
|
if (temp == NULL)
|
|
temp = Py_None;
|
|
Py_INCREF(temp);
|
|
return temp;
|
|
}
|
|
|
|
static PyObject *
|
|
sys_setprofile(PyObject *self, PyObject *args)
|
|
{
|
|
if (trace_init() == -1) {
|
|
return NULL;
|
|
}
|
|
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
if (args == Py_None) {
|
|
if (_PyEval_SetProfile(tstate, NULL, NULL) < 0) {
|
|
return NULL;
|
|
}
|
|
}
|
|
else {
|
|
if (_PyEval_SetProfile(tstate, profile_trampoline, args) < 0) {
|
|
return NULL;
|
|
}
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(setprofile_doc,
|
|
"setprofile(function)\n\
|
|
\n\
|
|
Set the profiling function. It will be called on each function call\n\
|
|
and return. See the profiler chapter in the library manual."
|
|
);
|
|
|
|
/*[clinic input]
|
|
sys.getprofile
|
|
|
|
Return the profiling function set with sys.setprofile.
|
|
|
|
See the profiler chapter in the library manual.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getprofile_impl(PyObject *module)
|
|
/*[clinic end generated code: output=579b96b373448188 input=1b3209d89a32965d]*/
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
PyObject *temp = tstate->c_profileobj;
|
|
|
|
if (temp == NULL)
|
|
temp = Py_None;
|
|
Py_INCREF(temp);
|
|
return temp;
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys.setswitchinterval
|
|
|
|
interval: double
|
|
/
|
|
|
|
Set the ideal thread switching delay inside the Python interpreter.
|
|
|
|
The actual frequency of switching threads can be lower if the
|
|
interpreter executes long sequences of uninterruptible code
|
|
(this is implementation-specific and workload-dependent).
|
|
|
|
The parameter must represent the desired switching delay in seconds
|
|
A typical value is 0.005 (5 milliseconds).
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_setswitchinterval_impl(PyObject *module, double interval)
|
|
/*[clinic end generated code: output=65a19629e5153983 input=561b477134df91d9]*/
|
|
{
|
|
if (interval <= 0.0) {
|
|
PyErr_SetString(PyExc_ValueError,
|
|
"switch interval must be strictly positive");
|
|
return NULL;
|
|
}
|
|
_PyEval_SetSwitchInterval((unsigned long) (1e6 * interval));
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys.getswitchinterval -> double
|
|
|
|
Return the current thread switch interval; see sys.setswitchinterval().
|
|
[clinic start generated code]*/
|
|
|
|
static double
|
|
sys_getswitchinterval_impl(PyObject *module)
|
|
/*[clinic end generated code: output=a38c277c85b5096d input=bdf9d39c0ebbbb6f]*/
|
|
{
|
|
return 1e-6 * _PyEval_GetSwitchInterval();
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.setrecursionlimit
|
|
|
|
limit as new_limit: int
|
|
/
|
|
|
|
Set the maximum depth of the Python interpreter stack to n.
|
|
|
|
This limit prevents infinite recursion from causing an overflow of the C
|
|
stack and crashing Python. The highest possible limit is platform-
|
|
dependent.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_setrecursionlimit_impl(PyObject *module, int new_limit)
|
|
/*[clinic end generated code: output=35e1c64754800ace input=b0f7a23393924af3]*/
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
if (new_limit < 1) {
|
|
_PyErr_SetString(tstate, PyExc_ValueError,
|
|
"recursion limit must be greater or equal than 1");
|
|
return NULL;
|
|
}
|
|
|
|
/* Issue #25274: When the recursion depth hits the recursion limit in
|
|
_Py_CheckRecursiveCall(), the overflowed flag of the thread state is
|
|
set to 1 and a RecursionError is raised. The overflowed flag is reset
|
|
to 0 when the recursion depth goes below the low-water mark: see
|
|
Py_LeaveRecursiveCall().
|
|
|
|
Reject too low new limit if the current recursion depth is higher than
|
|
the new low-water mark. Otherwise it may not be possible anymore to
|
|
reset the overflowed flag to 0. */
|
|
if (tstate->recursion_depth >= new_limit) {
|
|
_PyErr_Format(tstate, PyExc_RecursionError,
|
|
"cannot set the recursion limit to %i at "
|
|
"the recursion depth %i: the limit is too low",
|
|
new_limit, tstate->recursion_depth);
|
|
return NULL;
|
|
}
|
|
|
|
Py_SetRecursionLimit(new_limit);
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.set_coroutine_origin_tracking_depth
|
|
|
|
depth: int
|
|
|
|
Enable or disable origin tracking for coroutine objects in this thread.
|
|
|
|
Coroutine objects will track 'depth' frames of traceback information
|
|
about where they came from, available in their cr_origin attribute.
|
|
|
|
Set a depth of 0 to disable.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_set_coroutine_origin_tracking_depth_impl(PyObject *module, int depth)
|
|
/*[clinic end generated code: output=0a2123c1cc6759c5 input=a1d0a05f89d2c426]*/
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
if (depth < 0) {
|
|
_PyErr_SetString(tstate, PyExc_ValueError, "depth must be >= 0");
|
|
return NULL;
|
|
}
|
|
_PyEval_SetCoroutineOriginTrackingDepth(tstate, depth);
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.get_coroutine_origin_tracking_depth -> int
|
|
|
|
Check status of origin tracking for coroutine objects in this thread.
|
|
[clinic start generated code]*/
|
|
|
|
static int
|
|
sys_get_coroutine_origin_tracking_depth_impl(PyObject *module)
|
|
/*[clinic end generated code: output=3699f7be95a3afb8 input=335266a71205b61a]*/
|
|
{
|
|
return _PyEval_GetCoroutineOriginTrackingDepth();
|
|
}
|
|
|
|
static PyTypeObject AsyncGenHooksType;
|
|
|
|
PyDoc_STRVAR(asyncgen_hooks_doc,
|
|
"asyncgen_hooks\n\
|
|
\n\
|
|
A named tuple providing information about asynchronous\n\
|
|
generators hooks. The attributes are read only.");
|
|
|
|
static PyStructSequence_Field asyncgen_hooks_fields[] = {
|
|
{"firstiter", "Hook to intercept first iteration"},
|
|
{"finalizer", "Hook to intercept finalization"},
|
|
{0}
|
|
};
|
|
|
|
static PyStructSequence_Desc asyncgen_hooks_desc = {
|
|
"asyncgen_hooks", /* name */
|
|
asyncgen_hooks_doc, /* doc */
|
|
asyncgen_hooks_fields , /* fields */
|
|
2
|
|
};
|
|
|
|
static PyObject *
|
|
sys_set_asyncgen_hooks(PyObject *self, PyObject *args, PyObject *kw)
|
|
{
|
|
static char *keywords[] = {"firstiter", "finalizer", NULL};
|
|
PyObject *firstiter = NULL;
|
|
PyObject *finalizer = NULL;
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(
|
|
args, kw, "|OO", keywords,
|
|
&firstiter, &finalizer)) {
|
|
return NULL;
|
|
}
|
|
|
|
if (finalizer && finalizer != Py_None) {
|
|
if (!PyCallable_Check(finalizer)) {
|
|
PyErr_Format(PyExc_TypeError,
|
|
"callable finalizer expected, got %.50s",
|
|
Py_TYPE(finalizer)->tp_name);
|
|
return NULL;
|
|
}
|
|
if (_PyEval_SetAsyncGenFinalizer(finalizer) < 0) {
|
|
return NULL;
|
|
}
|
|
}
|
|
else if (finalizer == Py_None && _PyEval_SetAsyncGenFinalizer(NULL) < 0) {
|
|
return NULL;
|
|
}
|
|
|
|
if (firstiter && firstiter != Py_None) {
|
|
if (!PyCallable_Check(firstiter)) {
|
|
PyErr_Format(PyExc_TypeError,
|
|
"callable firstiter expected, got %.50s",
|
|
Py_TYPE(firstiter)->tp_name);
|
|
return NULL;
|
|
}
|
|
if (_PyEval_SetAsyncGenFirstiter(firstiter) < 0) {
|
|
return NULL;
|
|
}
|
|
}
|
|
else if (firstiter == Py_None && _PyEval_SetAsyncGenFirstiter(NULL) < 0) {
|
|
return NULL;
|
|
}
|
|
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(set_asyncgen_hooks_doc,
|
|
"set_asyncgen_hooks(* [, firstiter] [, finalizer])\n\
|
|
\n\
|
|
Set a finalizer for async generators objects."
|
|
);
|
|
|
|
/*[clinic input]
|
|
sys.get_asyncgen_hooks
|
|
|
|
Return the installed asynchronous generators hooks.
|
|
|
|
This returns a namedtuple of the form (firstiter, finalizer).
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_get_asyncgen_hooks_impl(PyObject *module)
|
|
/*[clinic end generated code: output=53a253707146f6cf input=3676b9ea62b14625]*/
|
|
{
|
|
PyObject *res;
|
|
PyObject *firstiter = _PyEval_GetAsyncGenFirstiter();
|
|
PyObject *finalizer = _PyEval_GetAsyncGenFinalizer();
|
|
|
|
res = PyStructSequence_New(&AsyncGenHooksType);
|
|
if (res == NULL) {
|
|
return NULL;
|
|
}
|
|
|
|
if (firstiter == NULL) {
|
|
firstiter = Py_None;
|
|
}
|
|
|
|
if (finalizer == NULL) {
|
|
finalizer = Py_None;
|
|
}
|
|
|
|
Py_INCREF(firstiter);
|
|
PyStructSequence_SET_ITEM(res, 0, firstiter);
|
|
|
|
Py_INCREF(finalizer);
|
|
PyStructSequence_SET_ITEM(res, 1, finalizer);
|
|
|
|
return res;
|
|
}
|
|
|
|
|
|
static PyTypeObject Hash_InfoType;
|
|
|
|
PyDoc_STRVAR(hash_info_doc,
|
|
"hash_info\n\
|
|
\n\
|
|
A named tuple providing parameters used for computing\n\
|
|
hashes. The attributes are read only.");
|
|
|
|
static PyStructSequence_Field hash_info_fields[] = {
|
|
{"width", "width of the type used for hashing, in bits"},
|
|
{"modulus", "prime number giving the modulus on which the hash "
|
|
"function is based"},
|
|
{"inf", "value to be used for hash of a positive infinity"},
|
|
{"nan", "value to be used for hash of a nan"},
|
|
{"imag", "multiplier used for the imaginary part of a complex number"},
|
|
{"algorithm", "name of the algorithm for hashing of str, bytes and "
|
|
"memoryviews"},
|
|
{"hash_bits", "internal output size of hash algorithm"},
|
|
{"seed_bits", "seed size of hash algorithm"},
|
|
{"cutoff", "small string optimization cutoff"},
|
|
{NULL, NULL}
|
|
};
|
|
|
|
static PyStructSequence_Desc hash_info_desc = {
|
|
"sys.hash_info",
|
|
hash_info_doc,
|
|
hash_info_fields,
|
|
9,
|
|
};
|
|
|
|
static PyObject *
|
|
get_hash_info(PyThreadState *tstate)
|
|
{
|
|
PyObject *hash_info;
|
|
int field = 0;
|
|
PyHash_FuncDef *hashfunc;
|
|
hash_info = PyStructSequence_New(&Hash_InfoType);
|
|
if (hash_info == NULL)
|
|
return NULL;
|
|
hashfunc = PyHash_GetFuncDef();
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromLong(8*sizeof(Py_hash_t)));
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromSsize_t(_PyHASH_MODULUS));
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromLong(_PyHASH_INF));
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromLong(0)); // This is no longer used
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromLong(_PyHASH_IMAG));
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyUnicode_FromString(hashfunc->name));
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromLong(hashfunc->hash_bits));
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromLong(hashfunc->seed_bits));
|
|
PyStructSequence_SET_ITEM(hash_info, field++,
|
|
PyLong_FromLong(Py_HASH_CUTOFF));
|
|
if (_PyErr_Occurred(tstate)) {
|
|
Py_CLEAR(hash_info);
|
|
return NULL;
|
|
}
|
|
return hash_info;
|
|
}
|
|
/*[clinic input]
|
|
sys.getrecursionlimit
|
|
|
|
Return the current value of the recursion limit.
|
|
|
|
The recursion limit is the maximum depth of the Python interpreter
|
|
stack. This limit prevents infinite recursion from causing an overflow
|
|
of the C stack and crashing Python.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getrecursionlimit_impl(PyObject *module)
|
|
/*[clinic end generated code: output=d571fb6b4549ef2e input=1c6129fd2efaeea8]*/
|
|
{
|
|
return PyLong_FromLong(Py_GetRecursionLimit());
|
|
}
|
|
|
|
#ifdef MS_WINDOWS
|
|
|
|
static PyTypeObject WindowsVersionType = {0, 0, 0, 0, 0, 0};
|
|
|
|
static PyStructSequence_Field windows_version_fields[] = {
|
|
{"major", "Major version number"},
|
|
{"minor", "Minor version number"},
|
|
{"build", "Build number"},
|
|
{"platform", "Operating system platform"},
|
|
{"service_pack", "Latest Service Pack installed on the system"},
|
|
{"service_pack_major", "Service Pack major version number"},
|
|
{"service_pack_minor", "Service Pack minor version number"},
|
|
{"suite_mask", "Bit mask identifying available product suites"},
|
|
{"product_type", "System product type"},
|
|
{"platform_version", "Diagnostic version number"},
|
|
{0}
|
|
};
|
|
|
|
static PyStructSequence_Desc windows_version_desc = {
|
|
"sys.getwindowsversion", /* name */
|
|
sys_getwindowsversion__doc__, /* doc */
|
|
windows_version_fields, /* fields */
|
|
5 /* For backward compatibility,
|
|
only the first 5 items are accessible
|
|
via indexing, the rest are name only */
|
|
};
|
|
|
|
/* Disable deprecation warnings about GetVersionEx as the result is
|
|
being passed straight through to the caller, who is responsible for
|
|
using it correctly. */
|
|
#pragma warning(push)
|
|
#pragma warning(disable:4996)
|
|
|
|
/*[clinic input]
|
|
sys.getwindowsversion
|
|
|
|
Return info about the running version of Windows as a named tuple.
|
|
|
|
The members are named: major, minor, build, platform, service_pack,
|
|
service_pack_major, service_pack_minor, suite_mask, product_type and
|
|
platform_version. For backward compatibility, only the first 5 items
|
|
are available by indexing. All elements are numbers, except
|
|
service_pack and platform_type which are strings, and platform_version
|
|
which is a 3-tuple. Platform is always 2. Product_type may be 1 for a
|
|
workstation, 2 for a domain controller, 3 for a server.
|
|
Platform_version is a 3-tuple containing a version number that is
|
|
intended for identifying the OS rather than feature detection.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getwindowsversion_impl(PyObject *module)
|
|
/*[clinic end generated code: output=1ec063280b932857 input=73a228a328fee63a]*/
|
|
{
|
|
PyObject *version;
|
|
int pos = 0;
|
|
OSVERSIONINFOEXW ver;
|
|
DWORD realMajor, realMinor, realBuild;
|
|
HANDLE hKernel32;
|
|
wchar_t kernel32_path[MAX_PATH];
|
|
LPVOID verblock;
|
|
DWORD verblock_size;
|
|
|
|
ver.dwOSVersionInfoSize = sizeof(ver);
|
|
if (!GetVersionExW((OSVERSIONINFOW*) &ver))
|
|
return PyErr_SetFromWindowsErr(0);
|
|
|
|
version = PyStructSequence_New(&WindowsVersionType);
|
|
if (version == NULL)
|
|
return NULL;
|
|
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.dwMajorVersion));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.dwMinorVersion));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.dwBuildNumber));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.dwPlatformId));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyUnicode_FromWideChar(ver.szCSDVersion, -1));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.wServicePackMajor));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.wServicePackMinor));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.wSuiteMask));
|
|
PyStructSequence_SET_ITEM(version, pos++, PyLong_FromLong(ver.wProductType));
|
|
|
|
realMajor = ver.dwMajorVersion;
|
|
realMinor = ver.dwMinorVersion;
|
|
realBuild = ver.dwBuildNumber;
|
|
|
|
// GetVersion will lie if we are running in a compatibility mode.
|
|
// We need to read the version info from a system file resource
|
|
// to accurately identify the OS version. If we fail for any reason,
|
|
// just return whatever GetVersion said.
|
|
Py_BEGIN_ALLOW_THREADS
|
|
hKernel32 = GetModuleHandleW(L"kernel32.dll");
|
|
Py_END_ALLOW_THREADS
|
|
if (hKernel32 && GetModuleFileNameW(hKernel32, kernel32_path, MAX_PATH) &&
|
|
(verblock_size = GetFileVersionInfoSizeW(kernel32_path, NULL)) &&
|
|
(verblock = PyMem_RawMalloc(verblock_size))) {
|
|
VS_FIXEDFILEINFO *ffi;
|
|
UINT ffi_len;
|
|
|
|
if (GetFileVersionInfoW(kernel32_path, 0, verblock_size, verblock) &&
|
|
VerQueryValueW(verblock, L"", (LPVOID)&ffi, &ffi_len)) {
|
|
realMajor = HIWORD(ffi->dwProductVersionMS);
|
|
realMinor = LOWORD(ffi->dwProductVersionMS);
|
|
realBuild = HIWORD(ffi->dwProductVersionLS);
|
|
}
|
|
PyMem_RawFree(verblock);
|
|
}
|
|
PyStructSequence_SET_ITEM(version, pos++, Py_BuildValue("(kkk)",
|
|
realMajor,
|
|
realMinor,
|
|
realBuild
|
|
));
|
|
|
|
if (PyErr_Occurred()) {
|
|
Py_DECREF(version);
|
|
return NULL;
|
|
}
|
|
return version;
|
|
}
|
|
|
|
#pragma warning(pop)
|
|
|
|
/*[clinic input]
|
|
sys._enablelegacywindowsfsencoding
|
|
|
|
Changes the default filesystem encoding to mbcs:replace.
|
|
|
|
This is done for consistency with earlier versions of Python. See PEP
|
|
529 for more information.
|
|
|
|
This is equivalent to defining the PYTHONLEGACYWINDOWSFSENCODING
|
|
environment variable before launching Python.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys__enablelegacywindowsfsencoding_impl(PyObject *module)
|
|
/*[clinic end generated code: output=f5c3855b45e24fe9 input=2bfa931a20704492]*/
|
|
{
|
|
if (_PyUnicode_EnableLegacyWindowsFSEncoding() < 0) {
|
|
return NULL;
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
#endif /* MS_WINDOWS */
|
|
|
|
#ifdef HAVE_DLOPEN
|
|
|
|
/*[clinic input]
|
|
sys.setdlopenflags
|
|
|
|
flags as new_val: int
|
|
/
|
|
|
|
Set the flags used by the interpreter for dlopen calls.
|
|
|
|
This is used, for example, when the interpreter loads extension
|
|
modules. Among other things, this will enable a lazy resolving of
|
|
symbols when importing a module, if called as sys.setdlopenflags(0).
|
|
To share symbols across extension modules, call as
|
|
sys.setdlopenflags(os.RTLD_GLOBAL). Symbolic names for the flag
|
|
modules can be found in the os module (RTLD_xxx constants, e.g.
|
|
os.RTLD_LAZY).
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_setdlopenflags_impl(PyObject *module, int new_val)
|
|
/*[clinic end generated code: output=ec918b7fe0a37281 input=4c838211e857a77f]*/
|
|
{
|
|
PyInterpreterState *interp = _PyInterpreterState_GET();
|
|
interp->dlopenflags = new_val;
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys.getdlopenflags
|
|
|
|
Return the current value of the flags that are used for dlopen calls.
|
|
|
|
The flag constants are defined in the os module.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getdlopenflags_impl(PyObject *module)
|
|
/*[clinic end generated code: output=e92cd1bc5005da6e input=dc4ea0899c53b4b6]*/
|
|
{
|
|
PyInterpreterState *interp = _PyInterpreterState_GET();
|
|
return PyLong_FromLong(interp->dlopenflags);
|
|
}
|
|
|
|
#endif /* HAVE_DLOPEN */
|
|
|
|
#ifdef USE_MALLOPT
|
|
/* Link with -lmalloc (or -lmpc) on an SGI */
|
|
#include <malloc.h>
|
|
|
|
/*[clinic input]
|
|
sys.mdebug
|
|
|
|
flag: int
|
|
/
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_mdebug_impl(PyObject *module, int flag)
|
|
/*[clinic end generated code: output=5431d545847c3637 input=151d150ae1636f8a]*/
|
|
{
|
|
int flag;
|
|
mallopt(M_DEBUG, flag);
|
|
Py_RETURN_NONE;
|
|
}
|
|
#endif /* USE_MALLOPT */
|
|
|
|
size_t
|
|
_PySys_GetSizeOf(PyObject *o)
|
|
{
|
|
PyObject *res = NULL;
|
|
PyObject *method;
|
|
Py_ssize_t size;
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
/* Make sure the type is initialized. float gets initialized late */
|
|
if (PyType_Ready(Py_TYPE(o)) < 0) {
|
|
return (size_t)-1;
|
|
}
|
|
|
|
method = _PyObject_LookupSpecial(o, &PyId___sizeof__);
|
|
if (method == NULL) {
|
|
if (!_PyErr_Occurred(tstate)) {
|
|
_PyErr_Format(tstate, PyExc_TypeError,
|
|
"Type %.100s doesn't define __sizeof__",
|
|
Py_TYPE(o)->tp_name);
|
|
}
|
|
}
|
|
else {
|
|
res = _PyObject_CallNoArg(method);
|
|
Py_DECREF(method);
|
|
}
|
|
|
|
if (res == NULL)
|
|
return (size_t)-1;
|
|
|
|
size = PyLong_AsSsize_t(res);
|
|
Py_DECREF(res);
|
|
if (size == -1 && _PyErr_Occurred(tstate))
|
|
return (size_t)-1;
|
|
|
|
if (size < 0) {
|
|
_PyErr_SetString(tstate, PyExc_ValueError,
|
|
"__sizeof__() should return >= 0");
|
|
return (size_t)-1;
|
|
}
|
|
|
|
/* add gc_head size */
|
|
if (_PyObject_IS_GC(o))
|
|
return ((size_t)size) + sizeof(PyGC_Head);
|
|
return (size_t)size;
|
|
}
|
|
|
|
static PyObject *
|
|
sys_getsizeof(PyObject *self, PyObject *args, PyObject *kwds)
|
|
{
|
|
static char *kwlist[] = {"object", "default", 0};
|
|
size_t size;
|
|
PyObject *o, *dflt = NULL;
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
if (!PyArg_ParseTupleAndKeywords(args, kwds, "O|O:getsizeof",
|
|
kwlist, &o, &dflt)) {
|
|
return NULL;
|
|
}
|
|
|
|
size = _PySys_GetSizeOf(o);
|
|
|
|
if (size == (size_t)-1 && _PyErr_Occurred(tstate)) {
|
|
/* Has a default value been given */
|
|
if (dflt != NULL && _PyErr_ExceptionMatches(tstate, PyExc_TypeError)) {
|
|
_PyErr_Clear(tstate);
|
|
Py_INCREF(dflt);
|
|
return dflt;
|
|
}
|
|
else
|
|
return NULL;
|
|
}
|
|
|
|
return PyLong_FromSize_t(size);
|
|
}
|
|
|
|
PyDoc_STRVAR(getsizeof_doc,
|
|
"getsizeof(object [, default]) -> int\n\
|
|
\n\
|
|
Return the size of object in bytes.");
|
|
|
|
/*[clinic input]
|
|
sys.getrefcount -> Py_ssize_t
|
|
|
|
object: object
|
|
/
|
|
|
|
Return the reference count of object.
|
|
|
|
The count returned is generally one higher than you might expect,
|
|
because it includes the (temporary) reference as an argument to
|
|
getrefcount().
|
|
[clinic start generated code]*/
|
|
|
|
static Py_ssize_t
|
|
sys_getrefcount_impl(PyObject *module, PyObject *object)
|
|
/*[clinic end generated code: output=5fd477f2264b85b2 input=bf474efd50a21535]*/
|
|
{
|
|
return Py_REFCNT(object);
|
|
}
|
|
|
|
#ifdef Py_REF_DEBUG
|
|
/*[clinic input]
|
|
sys.gettotalrefcount -> Py_ssize_t
|
|
[clinic start generated code]*/
|
|
|
|
static Py_ssize_t
|
|
sys_gettotalrefcount_impl(PyObject *module)
|
|
/*[clinic end generated code: output=4103886cf17c25bc input=53b744faa5d2e4f6]*/
|
|
{
|
|
return _Py_GetRefTotal();
|
|
}
|
|
#endif /* Py_REF_DEBUG */
|
|
|
|
/*[clinic input]
|
|
sys.getallocatedblocks -> Py_ssize_t
|
|
|
|
Return the number of memory blocks currently allocated.
|
|
[clinic start generated code]*/
|
|
|
|
static Py_ssize_t
|
|
sys_getallocatedblocks_impl(PyObject *module)
|
|
/*[clinic end generated code: output=f0c4e873f0b6dcf7 input=dab13ee346a0673e]*/
|
|
{
|
|
return _Py_GetAllocatedBlocks();
|
|
}
|
|
|
|
|
|
/*[clinic input]
|
|
sys._getframe
|
|
|
|
depth: int = 0
|
|
/
|
|
|
|
Return a frame object from the call stack.
|
|
|
|
If optional integer depth is given, return the frame object that many
|
|
calls below the top of the stack. If that is deeper than the call
|
|
stack, ValueError is raised. The default for depth is zero, returning
|
|
the frame at the top of the call stack.
|
|
|
|
This function should be used for internal and specialized purposes
|
|
only.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys__getframe_impl(PyObject *module, int depth)
|
|
/*[clinic end generated code: output=d438776c04d59804 input=c1be8a6464b11ee5]*/
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
PyFrameObject *f = PyThreadState_GetFrame(tstate);
|
|
|
|
if (_PySys_Audit(tstate, "sys._getframe", "O", f) < 0) {
|
|
Py_DECREF(f);
|
|
return NULL;
|
|
}
|
|
|
|
while (depth > 0 && f != NULL) {
|
|
PyFrameObject *back = PyFrame_GetBack(f);
|
|
Py_DECREF(f);
|
|
f = back;
|
|
--depth;
|
|
}
|
|
if (f == NULL) {
|
|
_PyErr_SetString(tstate, PyExc_ValueError,
|
|
"call stack is not deep enough");
|
|
return NULL;
|
|
}
|
|
return (PyObject*)f;
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys._current_frames
|
|
|
|
Return a dict mapping each thread's thread id to its current stack frame.
|
|
|
|
This function should be used for specialized purposes only.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys__current_frames_impl(PyObject *module)
|
|
/*[clinic end generated code: output=d2a41ac0a0a3809a input=2a9049c5f5033691]*/
|
|
{
|
|
return _PyThread_CurrentFrames();
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys._current_exceptions
|
|
|
|
Return a dict mapping each thread's identifier to its current raised exception.
|
|
|
|
This function should be used for specialized purposes only.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys__current_exceptions_impl(PyObject *module)
|
|
/*[clinic end generated code: output=2ccfd838c746f0ba input=0e91818fbf2edc1f]*/
|
|
{
|
|
return _PyThread_CurrentExceptions();
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.call_tracing
|
|
|
|
func: object
|
|
args as funcargs: object(subclass_of='&PyTuple_Type')
|
|
/
|
|
|
|
Call func(*args), while tracing is enabled.
|
|
|
|
The tracing state is saved, and restored afterwards. This is intended
|
|
to be called from a debugger from a checkpoint, to recursively debug
|
|
some other code.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_call_tracing_impl(PyObject *module, PyObject *func, PyObject *funcargs)
|
|
/*[clinic end generated code: output=7e4999853cd4e5a6 input=5102e8b11049f92f]*/
|
|
{
|
|
return _PyEval_CallTracing(func, funcargs);
|
|
}
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*[clinic input]
|
|
sys._debugmallocstats
|
|
|
|
Print summary info to stderr about the state of pymalloc's structures.
|
|
|
|
In Py_DEBUG mode, also perform some expensive internal consistency
|
|
checks.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys__debugmallocstats_impl(PyObject *module)
|
|
/*[clinic end generated code: output=ec3565f8c7cee46a input=33c0c9c416f98424]*/
|
|
{
|
|
#ifdef WITH_PYMALLOC
|
|
if (_PyObject_DebugMallocStats(stderr)) {
|
|
fputc('\n', stderr);
|
|
}
|
|
#endif
|
|
_PyObject_DebugTypeStats(stderr);
|
|
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
#ifdef Py_TRACE_REFS
|
|
/* Defined in objects.c because it uses static globals in that file */
|
|
extern PyObject *_Py_GetObjects(PyObject *, PyObject *);
|
|
#endif
|
|
|
|
#ifdef DYNAMIC_EXECUTION_PROFILE
|
|
/* Defined in ceval.c because it uses static globals in that file */
|
|
extern PyObject *_Py_GetDXProfile(PyObject *, PyObject *);
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
/*[clinic input]
|
|
sys._clear_type_cache
|
|
|
|
Clear the internal type lookup cache.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys__clear_type_cache_impl(PyObject *module)
|
|
/*[clinic end generated code: output=20e48ca54a6f6971 input=127f3e04a8d9b555]*/
|
|
{
|
|
PyType_ClearCache();
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
/*[clinic input]
|
|
sys.is_finalizing
|
|
|
|
Return True if Python is exiting.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_is_finalizing_impl(PyObject *module)
|
|
/*[clinic end generated code: output=735b5ff7962ab281 input=f0df747a039948a5]*/
|
|
{
|
|
return PyBool_FromLong(_Py_IsFinalizing());
|
|
}
|
|
|
|
#ifdef ANDROID_API_LEVEL
|
|
/*[clinic input]
|
|
sys.getandroidapilevel
|
|
|
|
Return the build time API version of Android as an integer.
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys_getandroidapilevel_impl(PyObject *module)
|
|
/*[clinic end generated code: output=214abf183a1c70c1 input=3e6d6c9fcdd24ac6]*/
|
|
{
|
|
return PyLong_FromLong(ANDROID_API_LEVEL);
|
|
}
|
|
#endif /* ANDROID_API_LEVEL */
|
|
|
|
|
|
/*[clinic input]
|
|
sys._deactivate_opcache
|
|
|
|
Deactivate the opcode cache permanently
|
|
[clinic start generated code]*/
|
|
|
|
static PyObject *
|
|
sys__deactivate_opcache_impl(PyObject *module)
|
|
/*[clinic end generated code: output=00e20982bd012122 input=501eac146735ccf9]*/
|
|
{
|
|
_PyEval_DeactivateOpCache();
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
|
|
static PyMethodDef sys_methods[] = {
|
|
/* Might as well keep this in alphabetic order */
|
|
SYS_ADDAUDITHOOK_METHODDEF
|
|
{"audit", (PyCFunction)(void(*)(void))sys_audit, METH_FASTCALL, audit_doc },
|
|
{"breakpointhook", (PyCFunction)(void(*)(void))sys_breakpointhook,
|
|
METH_FASTCALL | METH_KEYWORDS, breakpointhook_doc},
|
|
SYS__CLEAR_TYPE_CACHE_METHODDEF
|
|
SYS__CURRENT_FRAMES_METHODDEF
|
|
SYS__CURRENT_EXCEPTIONS_METHODDEF
|
|
SYS_DISPLAYHOOK_METHODDEF
|
|
SYS_EXC_INFO_METHODDEF
|
|
SYS_EXCEPTHOOK_METHODDEF
|
|
SYS_EXIT_METHODDEF
|
|
SYS_GETDEFAULTENCODING_METHODDEF
|
|
SYS_GETDLOPENFLAGS_METHODDEF
|
|
SYS_GETALLOCATEDBLOCKS_METHODDEF
|
|
#ifdef DYNAMIC_EXECUTION_PROFILE
|
|
{"getdxp", _Py_GetDXProfile, METH_VARARGS},
|
|
#endif
|
|
SYS_GETFILESYSTEMENCODING_METHODDEF
|
|
SYS_GETFILESYSTEMENCODEERRORS_METHODDEF
|
|
#ifdef Py_TRACE_REFS
|
|
{"getobjects", _Py_GetObjects, METH_VARARGS},
|
|
#endif
|
|
SYS_GETTOTALREFCOUNT_METHODDEF
|
|
SYS_GETREFCOUNT_METHODDEF
|
|
SYS_GETRECURSIONLIMIT_METHODDEF
|
|
{"getsizeof", (PyCFunction)(void(*)(void))sys_getsizeof,
|
|
METH_VARARGS | METH_KEYWORDS, getsizeof_doc},
|
|
SYS__GETFRAME_METHODDEF
|
|
SYS_GETWINDOWSVERSION_METHODDEF
|
|
SYS__ENABLELEGACYWINDOWSFSENCODING_METHODDEF
|
|
SYS_INTERN_METHODDEF
|
|
SYS_IS_FINALIZING_METHODDEF
|
|
SYS_MDEBUG_METHODDEF
|
|
SYS_SETSWITCHINTERVAL_METHODDEF
|
|
SYS_GETSWITCHINTERVAL_METHODDEF
|
|
SYS_SETDLOPENFLAGS_METHODDEF
|
|
{"setprofile", sys_setprofile, METH_O, setprofile_doc},
|
|
SYS_GETPROFILE_METHODDEF
|
|
SYS_SETRECURSIONLIMIT_METHODDEF
|
|
{"settrace", sys_settrace, METH_O, settrace_doc},
|
|
SYS_GETTRACE_METHODDEF
|
|
SYS_CALL_TRACING_METHODDEF
|
|
SYS__DEBUGMALLOCSTATS_METHODDEF
|
|
SYS_SET_COROUTINE_ORIGIN_TRACKING_DEPTH_METHODDEF
|
|
SYS_GET_COROUTINE_ORIGIN_TRACKING_DEPTH_METHODDEF
|
|
{"set_asyncgen_hooks", (PyCFunction)(void(*)(void))sys_set_asyncgen_hooks,
|
|
METH_VARARGS | METH_KEYWORDS, set_asyncgen_hooks_doc},
|
|
SYS_GET_ASYNCGEN_HOOKS_METHODDEF
|
|
SYS_GETANDROIDAPILEVEL_METHODDEF
|
|
SYS_UNRAISABLEHOOK_METHODDEF
|
|
SYS__DEACTIVATE_OPCACHE_METHODDEF
|
|
{NULL, NULL} /* sentinel */
|
|
};
|
|
|
|
|
|
static PyObject *
|
|
list_builtin_module_names(void)
|
|
{
|
|
PyObject *list = PyList_New(0);
|
|
if (list == NULL) {
|
|
return NULL;
|
|
}
|
|
for (Py_ssize_t i = 0; PyImport_Inittab[i].name != NULL; i++) {
|
|
PyObject *name = PyUnicode_FromString(PyImport_Inittab[i].name);
|
|
if (name == NULL) {
|
|
goto error;
|
|
}
|
|
if (PyList_Append(list, name) < 0) {
|
|
Py_DECREF(name);
|
|
goto error;
|
|
}
|
|
Py_DECREF(name);
|
|
}
|
|
if (PyList_Sort(list) != 0) {
|
|
goto error;
|
|
}
|
|
PyObject *tuple = PyList_AsTuple(list);
|
|
Py_DECREF(list);
|
|
return tuple;
|
|
|
|
error:
|
|
Py_DECREF(list);
|
|
return NULL;
|
|
}
|
|
|
|
|
|
static PyObject *
|
|
list_stdlib_module_names(void)
|
|
{
|
|
Py_ssize_t len = Py_ARRAY_LENGTH(_Py_stdlib_module_names);
|
|
PyObject *names = PyTuple_New(len);
|
|
if (names == NULL) {
|
|
return NULL;
|
|
}
|
|
|
|
for (Py_ssize_t i = 0; i < len; i++) {
|
|
PyObject *name = PyUnicode_FromString(_Py_stdlib_module_names[i]);
|
|
if (name == NULL) {
|
|
Py_DECREF(names);
|
|
return NULL;
|
|
}
|
|
PyTuple_SET_ITEM(names, i, name);
|
|
}
|
|
|
|
PyObject *set = PyObject_CallFunction((PyObject *)&PyFrozenSet_Type,
|
|
"(O)", names);
|
|
Py_DECREF(names);
|
|
return set;
|
|
}
|
|
|
|
|
|
/* Pre-initialization support for sys.warnoptions and sys._xoptions
|
|
*
|
|
* Modern internal code paths:
|
|
* These APIs get called after _Py_InitializeCore and get to use the
|
|
* regular CPython list, dict, and unicode APIs.
|
|
*
|
|
* Legacy embedding code paths:
|
|
* The multi-phase initialization API isn't public yet, so embedding
|
|
* apps still need to be able configure sys.warnoptions and sys._xoptions
|
|
* before they call Py_Initialize. To support this, we stash copies of
|
|
* the supplied wchar * sequences in linked lists, and then migrate the
|
|
* contents of those lists to the sys module in _PyInitializeCore.
|
|
*
|
|
*/
|
|
|
|
struct _preinit_entry {
|
|
wchar_t *value;
|
|
struct _preinit_entry *next;
|
|
};
|
|
|
|
typedef struct _preinit_entry *_Py_PreInitEntry;
|
|
|
|
static _Py_PreInitEntry _preinit_warnoptions = NULL;
|
|
static _Py_PreInitEntry _preinit_xoptions = NULL;
|
|
|
|
static _Py_PreInitEntry
|
|
_alloc_preinit_entry(const wchar_t *value)
|
|
{
|
|
/* To get this to work, we have to initialize the runtime implicitly */
|
|
_PyRuntime_Initialize();
|
|
|
|
/* Force default allocator, so we can ensure that it also gets used to
|
|
* destroy the linked list in _clear_preinit_entries.
|
|
*/
|
|
PyMemAllocatorEx old_alloc;
|
|
_PyMem_SetDefaultAllocator(PYMEM_DOMAIN_RAW, &old_alloc);
|
|
|
|
_Py_PreInitEntry node = PyMem_RawCalloc(1, sizeof(*node));
|
|
if (node != NULL) {
|
|
node->value = _PyMem_RawWcsdup(value);
|
|
if (node->value == NULL) {
|
|
PyMem_RawFree(node);
|
|
node = NULL;
|
|
};
|
|
};
|
|
|
|
PyMem_SetAllocator(PYMEM_DOMAIN_RAW, &old_alloc);
|
|
return node;
|
|
}
|
|
|
|
static int
|
|
_append_preinit_entry(_Py_PreInitEntry *optionlist, const wchar_t *value)
|
|
{
|
|
_Py_PreInitEntry new_entry = _alloc_preinit_entry(value);
|
|
if (new_entry == NULL) {
|
|
return -1;
|
|
}
|
|
/* We maintain the linked list in this order so it's easy to play back
|
|
* the add commands in the same order later on in _Py_InitializeCore
|
|
*/
|
|
_Py_PreInitEntry last_entry = *optionlist;
|
|
if (last_entry == NULL) {
|
|
*optionlist = new_entry;
|
|
} else {
|
|
while (last_entry->next != NULL) {
|
|
last_entry = last_entry->next;
|
|
}
|
|
last_entry->next = new_entry;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static void
|
|
_clear_preinit_entries(_Py_PreInitEntry *optionlist)
|
|
{
|
|
_Py_PreInitEntry current = *optionlist;
|
|
*optionlist = NULL;
|
|
/* Deallocate the nodes and their contents using the default allocator */
|
|
PyMemAllocatorEx old_alloc;
|
|
_PyMem_SetDefaultAllocator(PYMEM_DOMAIN_RAW, &old_alloc);
|
|
while (current != NULL) {
|
|
_Py_PreInitEntry next = current->next;
|
|
PyMem_RawFree(current->value);
|
|
PyMem_RawFree(current);
|
|
current = next;
|
|
}
|
|
PyMem_SetAllocator(PYMEM_DOMAIN_RAW, &old_alloc);
|
|
}
|
|
|
|
|
|
PyStatus
|
|
_PySys_ReadPreinitWarnOptions(PyWideStringList *options)
|
|
{
|
|
PyStatus status;
|
|
_Py_PreInitEntry entry;
|
|
|
|
for (entry = _preinit_warnoptions; entry != NULL; entry = entry->next) {
|
|
status = PyWideStringList_Append(options, entry->value);
|
|
if (_PyStatus_EXCEPTION(status)) {
|
|
return status;
|
|
}
|
|
}
|
|
|
|
_clear_preinit_entries(&_preinit_warnoptions);
|
|
return _PyStatus_OK();
|
|
}
|
|
|
|
|
|
PyStatus
|
|
_PySys_ReadPreinitXOptions(PyConfig *config)
|
|
{
|
|
PyStatus status;
|
|
_Py_PreInitEntry entry;
|
|
|
|
for (entry = _preinit_xoptions; entry != NULL; entry = entry->next) {
|
|
status = PyWideStringList_Append(&config->xoptions, entry->value);
|
|
if (_PyStatus_EXCEPTION(status)) {
|
|
return status;
|
|
}
|
|
}
|
|
|
|
_clear_preinit_entries(&_preinit_xoptions);
|
|
return _PyStatus_OK();
|
|
}
|
|
|
|
|
|
static PyObject *
|
|
get_warnoptions(PyThreadState *tstate)
|
|
{
|
|
PyObject *warnoptions = sys_get_object_id(tstate, &PyId_warnoptions);
|
|
if (warnoptions == NULL || !PyList_Check(warnoptions)) {
|
|
/* PEP432 TODO: we can reach this if warnoptions is NULL in the main
|
|
* interpreter config. When that happens, we need to properly set
|
|
* the `warnoptions` reference in the main interpreter config as well.
|
|
*
|
|
* For Python 3.7, we shouldn't be able to get here due to the
|
|
* combination of how _PyMainInterpreter_ReadConfig and _PySys_EndInit
|
|
* work, but we expect 3.8+ to make the _PyMainInterpreter_ReadConfig
|
|
* call optional for embedding applications, thus making this
|
|
* reachable again.
|
|
*/
|
|
warnoptions = PyList_New(0);
|
|
if (warnoptions == NULL) {
|
|
return NULL;
|
|
}
|
|
if (sys_set_object_id(tstate->interp, &PyId_warnoptions, warnoptions)) {
|
|
Py_DECREF(warnoptions);
|
|
return NULL;
|
|
}
|
|
Py_DECREF(warnoptions);
|
|
}
|
|
return warnoptions;
|
|
}
|
|
|
|
void
|
|
PySys_ResetWarnOptions(void)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
if (tstate == NULL) {
|
|
_clear_preinit_entries(&_preinit_warnoptions);
|
|
return;
|
|
}
|
|
|
|
PyObject *warnoptions = sys_get_object_id(tstate, &PyId_warnoptions);
|
|
if (warnoptions == NULL || !PyList_Check(warnoptions))
|
|
return;
|
|
PyList_SetSlice(warnoptions, 0, PyList_GET_SIZE(warnoptions), NULL);
|
|
}
|
|
|
|
static int
|
|
_PySys_AddWarnOptionWithError(PyThreadState *tstate, PyObject *option)
|
|
{
|
|
PyObject *warnoptions = get_warnoptions(tstate);
|
|
if (warnoptions == NULL) {
|
|
return -1;
|
|
}
|
|
if (PyList_Append(warnoptions, option)) {
|
|
return -1;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
void
|
|
PySys_AddWarnOptionUnicode(PyObject *option)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
if (_PySys_AddWarnOptionWithError(tstate, option) < 0) {
|
|
/* No return value, therefore clear error state if possible */
|
|
if (tstate) {
|
|
_PyErr_Clear(tstate);
|
|
}
|
|
}
|
|
}
|
|
|
|
void
|
|
PySys_AddWarnOption(const wchar_t *s)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
if (tstate == NULL) {
|
|
_append_preinit_entry(&_preinit_warnoptions, s);
|
|
return;
|
|
}
|
|
PyObject *unicode;
|
|
unicode = PyUnicode_FromWideChar(s, -1);
|
|
if (unicode == NULL)
|
|
return;
|
|
PySys_AddWarnOptionUnicode(unicode);
|
|
Py_DECREF(unicode);
|
|
}
|
|
|
|
int
|
|
PySys_HasWarnOptions(void)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
PyObject *warnoptions = sys_get_object_id(tstate, &PyId_warnoptions);
|
|
return (warnoptions != NULL && PyList_Check(warnoptions)
|
|
&& PyList_GET_SIZE(warnoptions) > 0);
|
|
}
|
|
|
|
static PyObject *
|
|
get_xoptions(PyThreadState *tstate)
|
|
{
|
|
PyObject *xoptions = sys_get_object_id(tstate, &PyId__xoptions);
|
|
if (xoptions == NULL || !PyDict_Check(xoptions)) {
|
|
/* PEP432 TODO: we can reach this if xoptions is NULL in the main
|
|
* interpreter config. When that happens, we need to properly set
|
|
* the `xoptions` reference in the main interpreter config as well.
|
|
*
|
|
* For Python 3.7, we shouldn't be able to get here due to the
|
|
* combination of how _PyMainInterpreter_ReadConfig and _PySys_EndInit
|
|
* work, but we expect 3.8+ to make the _PyMainInterpreter_ReadConfig
|
|
* call optional for embedding applications, thus making this
|
|
* reachable again.
|
|
*/
|
|
xoptions = PyDict_New();
|
|
if (xoptions == NULL) {
|
|
return NULL;
|
|
}
|
|
if (sys_set_object_id(tstate->interp, &PyId__xoptions, xoptions)) {
|
|
Py_DECREF(xoptions);
|
|
return NULL;
|
|
}
|
|
Py_DECREF(xoptions);
|
|
}
|
|
return xoptions;
|
|
}
|
|
|
|
static int
|
|
_PySys_AddXOptionWithError(const wchar_t *s)
|
|
{
|
|
PyObject *name = NULL, *value = NULL;
|
|
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
PyObject *opts = get_xoptions(tstate);
|
|
if (opts == NULL) {
|
|
goto error;
|
|
}
|
|
|
|
const wchar_t *name_end = wcschr(s, L'=');
|
|
if (!name_end) {
|
|
name = PyUnicode_FromWideChar(s, -1);
|
|
value = Py_True;
|
|
Py_INCREF(value);
|
|
}
|
|
else {
|
|
name = PyUnicode_FromWideChar(s, name_end - s);
|
|
value = PyUnicode_FromWideChar(name_end + 1, -1);
|
|
}
|
|
if (name == NULL || value == NULL) {
|
|
goto error;
|
|
}
|
|
if (PyDict_SetItem(opts, name, value) < 0) {
|
|
goto error;
|
|
}
|
|
Py_DECREF(name);
|
|
Py_DECREF(value);
|
|
return 0;
|
|
|
|
error:
|
|
Py_XDECREF(name);
|
|
Py_XDECREF(value);
|
|
return -1;
|
|
}
|
|
|
|
void
|
|
PySys_AddXOption(const wchar_t *s)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
if (tstate == NULL) {
|
|
_append_preinit_entry(&_preinit_xoptions, s);
|
|
return;
|
|
}
|
|
if (_PySys_AddXOptionWithError(s) < 0) {
|
|
/* No return value, therefore clear error state if possible */
|
|
_PyErr_Clear(tstate);
|
|
}
|
|
}
|
|
|
|
PyObject *
|
|
PySys_GetXOptions(void)
|
|
{
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
return get_xoptions(tstate);
|
|
}
|
|
|
|
/* XXX This doc string is too long to be a single string literal in VC++ 5.0.
|
|
Two literals concatenated works just fine. If you have a K&R compiler
|
|
or other abomination that however *does* understand longer strings,
|
|
get rid of the !!! comment in the middle and the quotes that surround it. */
|
|
PyDoc_VAR(sys_doc) =
|
|
PyDoc_STR(
|
|
"This module provides access to some objects used or maintained by the\n\
|
|
interpreter and to functions that interact strongly with the interpreter.\n\
|
|
\n\
|
|
Dynamic objects:\n\
|
|
\n\
|
|
argv -- command line arguments; argv[0] is the script pathname if known\n\
|
|
path -- module search path; path[0] is the script directory, else ''\n\
|
|
modules -- dictionary of loaded modules\n\
|
|
\n\
|
|
displayhook -- called to show results in an interactive session\n\
|
|
excepthook -- called to handle any uncaught exception other than SystemExit\n\
|
|
To customize printing in an interactive session or to install a custom\n\
|
|
top-level exception handler, assign other functions to replace these.\n\
|
|
\n\
|
|
stdin -- standard input file object; used by input()\n\
|
|
stdout -- standard output file object; used by print()\n\
|
|
stderr -- standard error object; used for error messages\n\
|
|
By assigning other file objects (or objects that behave like files)\n\
|
|
to these, it is possible to redirect all of the interpreter's I/O.\n\
|
|
\n\
|
|
last_type -- type of last uncaught exception\n\
|
|
last_value -- value of last uncaught exception\n\
|
|
last_traceback -- traceback of last uncaught exception\n\
|
|
These three are only available in an interactive session after a\n\
|
|
traceback has been printed.\n\
|
|
"
|
|
)
|
|
/* concatenating string here */
|
|
PyDoc_STR(
|
|
"\n\
|
|
Static objects:\n\
|
|
\n\
|
|
builtin_module_names -- tuple of module names built into this interpreter\n\
|
|
copyright -- copyright notice pertaining to this interpreter\n\
|
|
exec_prefix -- prefix used to find the machine-specific Python library\n\
|
|
executable -- absolute path of the executable binary of the Python interpreter\n\
|
|
float_info -- a named tuple with information about the float implementation.\n\
|
|
float_repr_style -- string indicating the style of repr() output for floats\n\
|
|
hash_info -- a named tuple with information about the hash algorithm.\n\
|
|
hexversion -- version information encoded as a single integer\n\
|
|
implementation -- Python implementation information.\n\
|
|
int_info -- a named tuple with information about the int implementation.\n\
|
|
maxsize -- the largest supported length of containers.\n\
|
|
maxunicode -- the value of the largest Unicode code point\n\
|
|
platform -- platform identifier\n\
|
|
prefix -- prefix used to find the Python library\n\
|
|
thread_info -- a named tuple with information about the thread implementation.\n\
|
|
version -- the version of this interpreter as a string\n\
|
|
version_info -- version information as a named tuple\n\
|
|
"
|
|
)
|
|
#ifdef MS_COREDLL
|
|
/* concatenating string here */
|
|
PyDoc_STR(
|
|
"dllhandle -- [Windows only] integer handle of the Python DLL\n\
|
|
winver -- [Windows only] version number of the Python DLL\n\
|
|
"
|
|
)
|
|
#endif /* MS_COREDLL */
|
|
#ifdef MS_WINDOWS
|
|
/* concatenating string here */
|
|
PyDoc_STR(
|
|
"_enablelegacywindowsfsencoding -- [Windows only]\n\
|
|
"
|
|
)
|
|
#endif
|
|
PyDoc_STR(
|
|
"__stdin__ -- the original stdin; don't touch!\n\
|
|
__stdout__ -- the original stdout; don't touch!\n\
|
|
__stderr__ -- the original stderr; don't touch!\n\
|
|
__displayhook__ -- the original displayhook; don't touch!\n\
|
|
__excepthook__ -- the original excepthook; don't touch!\n\
|
|
\n\
|
|
Functions:\n\
|
|
\n\
|
|
displayhook() -- print an object to the screen, and save it in builtins._\n\
|
|
excepthook() -- print an exception and its traceback to sys.stderr\n\
|
|
exc_info() -- return thread-safe information about the current exception\n\
|
|
exit() -- exit the interpreter by raising SystemExit\n\
|
|
getdlopenflags() -- returns flags to be used for dlopen() calls\n\
|
|
getprofile() -- get the global profiling function\n\
|
|
getrefcount() -- return the reference count for an object (plus one :-)\n\
|
|
getrecursionlimit() -- return the max recursion depth for the interpreter\n\
|
|
getsizeof() -- return the size of an object in bytes\n\
|
|
gettrace() -- get the global debug tracing function\n\
|
|
setdlopenflags() -- set the flags to be used for dlopen() calls\n\
|
|
setprofile() -- set the global profiling function\n\
|
|
setrecursionlimit() -- set the max recursion depth for the interpreter\n\
|
|
settrace() -- set the global debug tracing function\n\
|
|
"
|
|
)
|
|
/* end of sys_doc */ ;
|
|
|
|
|
|
PyDoc_STRVAR(flags__doc__,
|
|
"sys.flags\n\
|
|
\n\
|
|
Flags provided through command line arguments or environment vars.");
|
|
|
|
static PyTypeObject FlagsType;
|
|
|
|
static PyStructSequence_Field flags_fields[] = {
|
|
{"debug", "-d"},
|
|
{"inspect", "-i"},
|
|
{"interactive", "-i"},
|
|
{"optimize", "-O or -OO"},
|
|
{"dont_write_bytecode", "-B"},
|
|
{"no_user_site", "-s"},
|
|
{"no_site", "-S"},
|
|
{"ignore_environment", "-E"},
|
|
{"verbose", "-v"},
|
|
{"bytes_warning", "-b"},
|
|
{"quiet", "-q"},
|
|
{"hash_randomization", "-R"},
|
|
{"isolated", "-I"},
|
|
{"dev_mode", "-X dev"},
|
|
{"utf8_mode", "-X utf8"},
|
|
{"warn_default_encoding", "-X warn_default_encoding"},
|
|
{0}
|
|
};
|
|
|
|
static PyStructSequence_Desc flags_desc = {
|
|
"sys.flags", /* name */
|
|
flags__doc__, /* doc */
|
|
flags_fields, /* fields */
|
|
16
|
|
};
|
|
|
|
static int
|
|
set_flags_from_config(PyInterpreterState *interp, PyObject *flags)
|
|
{
|
|
const PyPreConfig *preconfig = &interp->runtime->preconfig;
|
|
const PyConfig *config = _PyInterpreterState_GetConfig(interp);
|
|
|
|
// _PySys_UpdateConfig() modifies sys.flags in-place:
|
|
// Py_XDECREF() is needed in this case.
|
|
Py_ssize_t pos = 0;
|
|
#define SetFlagObj(expr) \
|
|
do { \
|
|
PyObject *value = (expr); \
|
|
if (value == NULL) { \
|
|
return -1; \
|
|
} \
|
|
Py_XDECREF(PyStructSequence_GET_ITEM(flags, pos)); \
|
|
PyStructSequence_SET_ITEM(flags, pos, value); \
|
|
pos++; \
|
|
} while (0)
|
|
#define SetFlag(expr) SetFlagObj(PyLong_FromLong(expr))
|
|
|
|
SetFlag(config->parser_debug);
|
|
SetFlag(config->inspect);
|
|
SetFlag(config->interactive);
|
|
SetFlag(config->optimization_level);
|
|
SetFlag(!config->write_bytecode);
|
|
SetFlag(!config->user_site_directory);
|
|
SetFlag(!config->site_import);
|
|
SetFlag(!config->use_environment);
|
|
SetFlag(config->verbose);
|
|
SetFlag(config->bytes_warning);
|
|
SetFlag(config->quiet);
|
|
SetFlag(config->use_hash_seed == 0 || config->hash_seed != 0);
|
|
SetFlag(config->isolated);
|
|
SetFlagObj(PyBool_FromLong(config->dev_mode));
|
|
SetFlag(preconfig->utf8_mode);
|
|
SetFlag(config->warn_default_encoding);
|
|
#undef SetFlagObj
|
|
#undef SetFlag
|
|
return 0;
|
|
}
|
|
|
|
|
|
static PyObject*
|
|
make_flags(PyInterpreterState *interp)
|
|
{
|
|
PyObject *flags = PyStructSequence_New(&FlagsType);
|
|
if (flags == NULL) {
|
|
return NULL;
|
|
}
|
|
|
|
if (set_flags_from_config(interp, flags) < 0) {
|
|
Py_DECREF(flags);
|
|
return NULL;
|
|
}
|
|
return flags;
|
|
}
|
|
|
|
|
|
PyDoc_STRVAR(version_info__doc__,
|
|
"sys.version_info\n\
|
|
\n\
|
|
Version information as a named tuple.");
|
|
|
|
static PyTypeObject VersionInfoType;
|
|
|
|
static PyStructSequence_Field version_info_fields[] = {
|
|
{"major", "Major release number"},
|
|
{"minor", "Minor release number"},
|
|
{"micro", "Patch release number"},
|
|
{"releaselevel", "'alpha', 'beta', 'candidate', or 'final'"},
|
|
{"serial", "Serial release number"},
|
|
{0}
|
|
};
|
|
|
|
static PyStructSequence_Desc version_info_desc = {
|
|
"sys.version_info", /* name */
|
|
version_info__doc__, /* doc */
|
|
version_info_fields, /* fields */
|
|
5
|
|
};
|
|
|
|
static PyObject *
|
|
make_version_info(PyThreadState *tstate)
|
|
{
|
|
PyObject *version_info;
|
|
char *s;
|
|
int pos = 0;
|
|
|
|
version_info = PyStructSequence_New(&VersionInfoType);
|
|
if (version_info == NULL) {
|
|
return NULL;
|
|
}
|
|
|
|
/*
|
|
* These release level checks are mutually exclusive and cover
|
|
* the field, so don't get too fancy with the pre-processor!
|
|
*/
|
|
#if PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_ALPHA
|
|
s = "alpha";
|
|
#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_BETA
|
|
s = "beta";
|
|
#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_GAMMA
|
|
s = "candidate";
|
|
#elif PY_RELEASE_LEVEL == PY_RELEASE_LEVEL_FINAL
|
|
s = "final";
|
|
#endif
|
|
|
|
#define SetIntItem(flag) \
|
|
PyStructSequence_SET_ITEM(version_info, pos++, PyLong_FromLong(flag))
|
|
#define SetStrItem(flag) \
|
|
PyStructSequence_SET_ITEM(version_info, pos++, PyUnicode_FromString(flag))
|
|
|
|
SetIntItem(PY_MAJOR_VERSION);
|
|
SetIntItem(PY_MINOR_VERSION);
|
|
SetIntItem(PY_MICRO_VERSION);
|
|
SetStrItem(s);
|
|
SetIntItem(PY_RELEASE_SERIAL);
|
|
#undef SetIntItem
|
|
#undef SetStrItem
|
|
|
|
if (_PyErr_Occurred(tstate)) {
|
|
Py_CLEAR(version_info);
|
|
return NULL;
|
|
}
|
|
return version_info;
|
|
}
|
|
|
|
/* sys.implementation values */
|
|
#define NAME "cpython"
|
|
const char *_PySys_ImplName = NAME;
|
|
#define MAJOR Py_STRINGIFY(PY_MAJOR_VERSION)
|
|
#define MINOR Py_STRINGIFY(PY_MINOR_VERSION)
|
|
#define TAG NAME "-" MAJOR MINOR
|
|
const char *_PySys_ImplCacheTag = TAG;
|
|
#undef NAME
|
|
#undef MAJOR
|
|
#undef MINOR
|
|
#undef TAG
|
|
|
|
static PyObject *
|
|
make_impl_info(PyObject *version_info)
|
|
{
|
|
int res;
|
|
PyObject *impl_info, *value, *ns;
|
|
|
|
impl_info = PyDict_New();
|
|
if (impl_info == NULL)
|
|
return NULL;
|
|
|
|
/* populate the dict */
|
|
|
|
value = PyUnicode_FromString(_PySys_ImplName);
|
|
if (value == NULL)
|
|
goto error;
|
|
res = PyDict_SetItemString(impl_info, "name", value);
|
|
Py_DECREF(value);
|
|
if (res < 0)
|
|
goto error;
|
|
|
|
value = PyUnicode_FromString(_PySys_ImplCacheTag);
|
|
if (value == NULL)
|
|
goto error;
|
|
res = PyDict_SetItemString(impl_info, "cache_tag", value);
|
|
Py_DECREF(value);
|
|
if (res < 0)
|
|
goto error;
|
|
|
|
res = PyDict_SetItemString(impl_info, "version", version_info);
|
|
if (res < 0)
|
|
goto error;
|
|
|
|
value = PyLong_FromLong(PY_VERSION_HEX);
|
|
if (value == NULL)
|
|
goto error;
|
|
res = PyDict_SetItemString(impl_info, "hexversion", value);
|
|
Py_DECREF(value);
|
|
if (res < 0)
|
|
goto error;
|
|
|
|
#ifdef MULTIARCH
|
|
value = PyUnicode_FromString(MULTIARCH);
|
|
if (value == NULL)
|
|
goto error;
|
|
res = PyDict_SetItemString(impl_info, "_multiarch", value);
|
|
Py_DECREF(value);
|
|
if (res < 0)
|
|
goto error;
|
|
#endif
|
|
|
|
/* dict ready */
|
|
|
|
ns = _PyNamespace_New(impl_info);
|
|
Py_DECREF(impl_info);
|
|
return ns;
|
|
|
|
error:
|
|
Py_CLEAR(impl_info);
|
|
return NULL;
|
|
}
|
|
|
|
static struct PyModuleDef sysmodule = {
|
|
PyModuleDef_HEAD_INIT,
|
|
"sys",
|
|
sys_doc,
|
|
-1, /* multiple "initialization" just copies the module dict. */
|
|
sys_methods,
|
|
NULL,
|
|
NULL,
|
|
NULL,
|
|
NULL
|
|
};
|
|
|
|
/* Updating the sys namespace, returning NULL pointer on error */
|
|
#define SET_SYS(key, value) \
|
|
do { \
|
|
PyObject *v = (value); \
|
|
if (v == NULL) { \
|
|
goto err_occurred; \
|
|
} \
|
|
res = PyDict_SetItemString(sysdict, key, v); \
|
|
Py_DECREF(v); \
|
|
if (res < 0) { \
|
|
goto err_occurred; \
|
|
} \
|
|
} while (0)
|
|
|
|
#define SET_SYS_FROM_STRING(key, value) \
|
|
SET_SYS(key, PyUnicode_FromString(value))
|
|
|
|
static PyStatus
|
|
_PySys_InitCore(PyThreadState *tstate, PyObject *sysdict)
|
|
{
|
|
PyObject *version_info;
|
|
int res;
|
|
|
|
/* stdin/stdout/stderr are set in pylifecycle.c */
|
|
|
|
#define COPY_SYS_ATTR(tokey, fromkey) \
|
|
SET_SYS(tokey, PyMapping_GetItemString(sysdict, fromkey))
|
|
|
|
COPY_SYS_ATTR("__displayhook__", "displayhook");
|
|
COPY_SYS_ATTR("__excepthook__", "excepthook");
|
|
COPY_SYS_ATTR("__breakpointhook__", "breakpointhook");
|
|
COPY_SYS_ATTR("__unraisablehook__", "unraisablehook");
|
|
|
|
#undef COPY_SYS_ATTR
|
|
|
|
SET_SYS_FROM_STRING("version", Py_GetVersion());
|
|
SET_SYS("hexversion", PyLong_FromLong(PY_VERSION_HEX));
|
|
SET_SYS("_git", Py_BuildValue("(szz)", "CPython", _Py_gitidentifier(),
|
|
_Py_gitversion()));
|
|
SET_SYS_FROM_STRING("_framework", _PYTHONFRAMEWORK);
|
|
SET_SYS("api_version", PyLong_FromLong(PYTHON_API_VERSION));
|
|
SET_SYS_FROM_STRING("copyright", Py_GetCopyright());
|
|
SET_SYS_FROM_STRING("platform", Py_GetPlatform());
|
|
SET_SYS("maxsize", PyLong_FromSsize_t(PY_SSIZE_T_MAX));
|
|
SET_SYS("float_info", PyFloat_GetInfo());
|
|
SET_SYS("int_info", PyLong_GetInfo());
|
|
/* initialize hash_info */
|
|
if (Hash_InfoType.tp_name == NULL) {
|
|
if (PyStructSequence_InitType2(&Hash_InfoType, &hash_info_desc) < 0) {
|
|
goto type_init_failed;
|
|
}
|
|
}
|
|
SET_SYS("hash_info", get_hash_info(tstate));
|
|
SET_SYS("maxunicode", PyLong_FromLong(0x10FFFF));
|
|
SET_SYS("builtin_module_names", list_builtin_module_names());
|
|
SET_SYS("stdlib_module_names", list_stdlib_module_names());
|
|
#if PY_BIG_ENDIAN
|
|
SET_SYS_FROM_STRING("byteorder", "big");
|
|
#else
|
|
SET_SYS_FROM_STRING("byteorder", "little");
|
|
#endif
|
|
|
|
#ifdef MS_COREDLL
|
|
SET_SYS("dllhandle", PyLong_FromVoidPtr(PyWin_DLLhModule));
|
|
SET_SYS_FROM_STRING("winver", PyWin_DLLVersionString);
|
|
#endif
|
|
#ifdef ABIFLAGS
|
|
SET_SYS_FROM_STRING("abiflags", ABIFLAGS);
|
|
#endif
|
|
|
|
/* version_info */
|
|
if (VersionInfoType.tp_name == NULL) {
|
|
if (PyStructSequence_InitType2(&VersionInfoType,
|
|
&version_info_desc) < 0) {
|
|
goto type_init_failed;
|
|
}
|
|
}
|
|
version_info = make_version_info(tstate);
|
|
SET_SYS("version_info", version_info);
|
|
/* prevent user from creating new instances */
|
|
VersionInfoType.tp_init = NULL;
|
|
VersionInfoType.tp_new = NULL;
|
|
res = PyDict_DelItemString(VersionInfoType.tp_dict, "__new__");
|
|
if (res < 0 && _PyErr_ExceptionMatches(tstate, PyExc_KeyError)) {
|
|
_PyErr_Clear(tstate);
|
|
}
|
|
|
|
/* implementation */
|
|
SET_SYS("implementation", make_impl_info(version_info));
|
|
|
|
// sys.flags: updated in-place later by _PySys_UpdateConfig()
|
|
if (FlagsType.tp_name == 0) {
|
|
if (PyStructSequence_InitType2(&FlagsType, &flags_desc) < 0) {
|
|
goto type_init_failed;
|
|
}
|
|
}
|
|
SET_SYS("flags", make_flags(tstate->interp));
|
|
/* prevent user from creating new instances */
|
|
FlagsType.tp_init = NULL;
|
|
FlagsType.tp_new = NULL;
|
|
res = PyDict_DelItemString(FlagsType.tp_dict, "__new__");
|
|
if (res < 0) {
|
|
if (!_PyErr_ExceptionMatches(tstate, PyExc_KeyError)) {
|
|
goto err_occurred;
|
|
}
|
|
_PyErr_Clear(tstate);
|
|
}
|
|
|
|
#if defined(MS_WINDOWS)
|
|
/* getwindowsversion */
|
|
if (WindowsVersionType.tp_name == 0)
|
|
if (PyStructSequence_InitType2(&WindowsVersionType,
|
|
&windows_version_desc) < 0) {
|
|
goto type_init_failed;
|
|
}
|
|
/* prevent user from creating new instances */
|
|
WindowsVersionType.tp_init = NULL;
|
|
WindowsVersionType.tp_new = NULL;
|
|
assert(!_PyErr_Occurred(tstate));
|
|
res = PyDict_DelItemString(WindowsVersionType.tp_dict, "__new__");
|
|
if (res < 0 && _PyErr_ExceptionMatches(tstate, PyExc_KeyError)) {
|
|
_PyErr_Clear(tstate);
|
|
}
|
|
#endif
|
|
|
|
/* float repr style: 0.03 (short) vs 0.029999999999999999 (legacy) */
|
|
#ifndef PY_NO_SHORT_FLOAT_REPR
|
|
SET_SYS_FROM_STRING("float_repr_style", "short");
|
|
#else
|
|
SET_SYS_FROM_STRING("float_repr_style", "legacy");
|
|
#endif
|
|
|
|
SET_SYS("thread_info", PyThread_GetInfo());
|
|
|
|
/* initialize asyncgen_hooks */
|
|
if (AsyncGenHooksType.tp_name == NULL) {
|
|
if (PyStructSequence_InitType2(
|
|
&AsyncGenHooksType, &asyncgen_hooks_desc) < 0) {
|
|
goto type_init_failed;
|
|
}
|
|
}
|
|
|
|
/* adding sys.path_hooks and sys.path_importer_cache */
|
|
SET_SYS("meta_path", PyList_New(0));
|
|
SET_SYS("path_importer_cache", PyDict_New());
|
|
SET_SYS("path_hooks", PyList_New(0));
|
|
|
|
if (_PyErr_Occurred(tstate)) {
|
|
goto err_occurred;
|
|
}
|
|
return _PyStatus_OK();
|
|
|
|
type_init_failed:
|
|
return _PyStatus_ERR("failed to initialize a type");
|
|
|
|
err_occurred:
|
|
return _PyStatus_ERR("can't initialize sys module");
|
|
}
|
|
|
|
static int
|
|
sys_add_xoption(PyObject *opts, const wchar_t *s)
|
|
{
|
|
PyObject *name, *value;
|
|
|
|
const wchar_t *name_end = wcschr(s, L'=');
|
|
if (!name_end) {
|
|
name = PyUnicode_FromWideChar(s, -1);
|
|
value = Py_True;
|
|
Py_INCREF(value);
|
|
}
|
|
else {
|
|
name = PyUnicode_FromWideChar(s, name_end - s);
|
|
value = PyUnicode_FromWideChar(name_end + 1, -1);
|
|
}
|
|
if (name == NULL || value == NULL) {
|
|
goto error;
|
|
}
|
|
if (PyDict_SetItem(opts, name, value) < 0) {
|
|
goto error;
|
|
}
|
|
Py_DECREF(name);
|
|
Py_DECREF(value);
|
|
return 0;
|
|
|
|
error:
|
|
Py_XDECREF(name);
|
|
Py_XDECREF(value);
|
|
return -1;
|
|
}
|
|
|
|
|
|
static PyObject*
|
|
sys_create_xoptions_dict(const PyConfig *config)
|
|
{
|
|
Py_ssize_t nxoption = config->xoptions.length;
|
|
wchar_t * const * xoptions = config->xoptions.items;
|
|
PyObject *dict = PyDict_New();
|
|
if (dict == NULL) {
|
|
return NULL;
|
|
}
|
|
|
|
for (Py_ssize_t i=0; i < nxoption; i++) {
|
|
const wchar_t *option = xoptions[i];
|
|
if (sys_add_xoption(dict, option) < 0) {
|
|
Py_DECREF(dict);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
return dict;
|
|
}
|
|
|
|
|
|
// Update sys attributes for a new PyConfig configuration.
|
|
// This function also adds attributes that _PySys_InitCore() didn't add.
|
|
int
|
|
_PySys_UpdateConfig(PyThreadState *tstate)
|
|
{
|
|
PyInterpreterState *interp = tstate->interp;
|
|
PyObject *sysdict = interp->sysdict;
|
|
const PyConfig *config = _PyInterpreterState_GetConfig(interp);
|
|
int res;
|
|
|
|
#define COPY_LIST(KEY, VALUE) \
|
|
SET_SYS(KEY, _PyWideStringList_AsList(&(VALUE)));
|
|
|
|
#define SET_SYS_FROM_WSTR(KEY, VALUE) \
|
|
SET_SYS(KEY, PyUnicode_FromWideChar(VALUE, -1));
|
|
|
|
#define COPY_WSTR(SYS_ATTR, WSTR) \
|
|
if (WSTR != NULL) { \
|
|
SET_SYS_FROM_WSTR(SYS_ATTR, WSTR); \
|
|
}
|
|
|
|
if (config->module_search_paths_set) {
|
|
COPY_LIST("path", config->module_search_paths);
|
|
}
|
|
|
|
COPY_WSTR("executable", config->executable);
|
|
COPY_WSTR("_base_executable", config->base_executable);
|
|
COPY_WSTR("prefix", config->prefix);
|
|
COPY_WSTR("base_prefix", config->base_prefix);
|
|
COPY_WSTR("exec_prefix", config->exec_prefix);
|
|
COPY_WSTR("base_exec_prefix", config->base_exec_prefix);
|
|
COPY_WSTR("platlibdir", config->platlibdir);
|
|
|
|
if (config->pycache_prefix != NULL) {
|
|
SET_SYS_FROM_WSTR("pycache_prefix", config->pycache_prefix);
|
|
} else {
|
|
PyDict_SetItemString(sysdict, "pycache_prefix", Py_None);
|
|
}
|
|
|
|
COPY_LIST("argv", config->argv);
|
|
COPY_LIST("orig_argv", config->orig_argv);
|
|
COPY_LIST("warnoptions", config->warnoptions);
|
|
|
|
SET_SYS("_xoptions", sys_create_xoptions_dict(config));
|
|
|
|
#undef SET_SYS_FROM_WSTR
|
|
#undef COPY_LIST
|
|
#undef COPY_WSTR
|
|
|
|
// sys.flags
|
|
PyObject *flags = _PySys_GetObject(interp, "flags"); // borrowed ref
|
|
if (flags == NULL) {
|
|
return -1;
|
|
}
|
|
if (set_flags_from_config(interp, flags) < 0) {
|
|
return -1;
|
|
}
|
|
|
|
SET_SYS("dont_write_bytecode", PyBool_FromLong(!config->write_bytecode));
|
|
|
|
if (_PyErr_Occurred(tstate)) {
|
|
goto err_occurred;
|
|
}
|
|
|
|
return 0;
|
|
|
|
err_occurred:
|
|
return -1;
|
|
}
|
|
|
|
#undef SET_SYS
|
|
#undef SET_SYS_FROM_STRING
|
|
|
|
|
|
/* Set up a preliminary stderr printer until we have enough
|
|
infrastructure for the io module in place.
|
|
|
|
Use UTF-8/surrogateescape and ignore EAGAIN errors. */
|
|
static PyStatus
|
|
_PySys_SetPreliminaryStderr(PyObject *sysdict)
|
|
{
|
|
PyObject *pstderr = PyFile_NewStdPrinter(fileno(stderr));
|
|
if (pstderr == NULL) {
|
|
goto error;
|
|
}
|
|
if (_PyDict_SetItemId(sysdict, &PyId_stderr, pstderr) < 0) {
|
|
goto error;
|
|
}
|
|
if (PyDict_SetItemString(sysdict, "__stderr__", pstderr) < 0) {
|
|
goto error;
|
|
}
|
|
Py_DECREF(pstderr);
|
|
return _PyStatus_OK();
|
|
|
|
error:
|
|
Py_XDECREF(pstderr);
|
|
return _PyStatus_ERR("can't set preliminary stderr");
|
|
}
|
|
|
|
|
|
/* Create sys module without all attributes.
|
|
_PySys_UpdateConfig() should be called later to add remaining attributes. */
|
|
PyStatus
|
|
_PySys_Create(PyThreadState *tstate, PyObject **sysmod_p)
|
|
{
|
|
assert(!_PyErr_Occurred(tstate));
|
|
|
|
PyInterpreterState *interp = tstate->interp;
|
|
|
|
PyObject *modules = PyDict_New();
|
|
if (modules == NULL) {
|
|
goto error;
|
|
}
|
|
interp->modules = modules;
|
|
|
|
PyObject *sysmod = _PyModule_CreateInitialized(&sysmodule, PYTHON_API_VERSION);
|
|
if (sysmod == NULL) {
|
|
return _PyStatus_ERR("failed to create a module object");
|
|
}
|
|
|
|
PyObject *sysdict = PyModule_GetDict(sysmod);
|
|
if (sysdict == NULL) {
|
|
goto error;
|
|
}
|
|
Py_INCREF(sysdict);
|
|
interp->sysdict = sysdict;
|
|
|
|
if (PyDict_SetItemString(sysdict, "modules", interp->modules) < 0) {
|
|
goto error;
|
|
}
|
|
|
|
PyStatus status = _PySys_SetPreliminaryStderr(sysdict);
|
|
if (_PyStatus_EXCEPTION(status)) {
|
|
return status;
|
|
}
|
|
|
|
status = _PySys_InitCore(tstate, sysdict);
|
|
if (_PyStatus_EXCEPTION(status)) {
|
|
return status;
|
|
}
|
|
|
|
if (_PyImport_FixupBuiltin(sysmod, "sys", interp->modules) < 0) {
|
|
goto error;
|
|
}
|
|
|
|
assert(!_PyErr_Occurred(tstate));
|
|
|
|
*sysmod_p = sysmod;
|
|
return _PyStatus_OK();
|
|
|
|
error:
|
|
return _PyStatus_ERR("can't initialize sys module");
|
|
}
|
|
|
|
|
|
static PyObject *
|
|
makepathobject(const wchar_t *path, wchar_t delim)
|
|
{
|
|
int i, n;
|
|
const wchar_t *p;
|
|
PyObject *v, *w;
|
|
|
|
n = 1;
|
|
p = path;
|
|
while ((p = wcschr(p, delim)) != NULL) {
|
|
n++;
|
|
p++;
|
|
}
|
|
v = PyList_New(n);
|
|
if (v == NULL)
|
|
return NULL;
|
|
for (i = 0; ; i++) {
|
|
p = wcschr(path, delim);
|
|
if (p == NULL)
|
|
p = path + wcslen(path); /* End of string */
|
|
w = PyUnicode_FromWideChar(path, (Py_ssize_t)(p - path));
|
|
if (w == NULL) {
|
|
Py_DECREF(v);
|
|
return NULL;
|
|
}
|
|
PyList_SET_ITEM(v, i, w);
|
|
if (*p == '\0')
|
|
break;
|
|
path = p+1;
|
|
}
|
|
return v;
|
|
}
|
|
|
|
void
|
|
PySys_SetPath(const wchar_t *path)
|
|
{
|
|
PyObject *v;
|
|
if ((v = makepathobject(path, DELIM)) == NULL)
|
|
Py_FatalError("can't create sys.path");
|
|
PyInterpreterState *interp = _PyInterpreterState_GET();
|
|
if (sys_set_object_id(interp, &PyId_path, v) != 0) {
|
|
Py_FatalError("can't assign sys.path");
|
|
}
|
|
Py_DECREF(v);
|
|
}
|
|
|
|
static PyObject *
|
|
make_sys_argv(int argc, wchar_t * const * argv)
|
|
{
|
|
PyObject *list = PyList_New(argc);
|
|
if (list == NULL) {
|
|
return NULL;
|
|
}
|
|
|
|
for (Py_ssize_t i = 0; i < argc; i++) {
|
|
PyObject *v = PyUnicode_FromWideChar(argv[i], -1);
|
|
if (v == NULL) {
|
|
Py_DECREF(list);
|
|
return NULL;
|
|
}
|
|
PyList_SET_ITEM(list, i, v);
|
|
}
|
|
return list;
|
|
}
|
|
|
|
void
|
|
PySys_SetArgvEx(int argc, wchar_t **argv, int updatepath)
|
|
{
|
|
wchar_t* empty_argv[1] = {L""};
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
if (argc < 1 || argv == NULL) {
|
|
/* Ensure at least one (empty) argument is seen */
|
|
argv = empty_argv;
|
|
argc = 1;
|
|
}
|
|
|
|
PyObject *av = make_sys_argv(argc, argv);
|
|
if (av == NULL) {
|
|
Py_FatalError("no mem for sys.argv");
|
|
}
|
|
if (sys_set_object_str(tstate->interp, "argv", av) != 0) {
|
|
Py_DECREF(av);
|
|
Py_FatalError("can't assign sys.argv");
|
|
}
|
|
Py_DECREF(av);
|
|
|
|
if (updatepath) {
|
|
/* If argv[0] is not '-c' nor '-m', prepend argv[0] to sys.path.
|
|
If argv[0] is a symlink, use the real path. */
|
|
const PyWideStringList argv_list = {.length = argc, .items = argv};
|
|
PyObject *path0 = NULL;
|
|
if (_PyPathConfig_ComputeSysPath0(&argv_list, &path0)) {
|
|
if (path0 == NULL) {
|
|
Py_FatalError("can't compute path0 from argv");
|
|
}
|
|
|
|
PyObject *sys_path = sys_get_object_id(tstate, &PyId_path);
|
|
if (sys_path != NULL) {
|
|
if (PyList_Insert(sys_path, 0, path0) < 0) {
|
|
Py_DECREF(path0);
|
|
Py_FatalError("can't prepend path0 to sys.path");
|
|
}
|
|
}
|
|
Py_DECREF(path0);
|
|
}
|
|
}
|
|
}
|
|
|
|
void
|
|
PySys_SetArgv(int argc, wchar_t **argv)
|
|
{
|
|
PySys_SetArgvEx(argc, argv, Py_IsolatedFlag == 0);
|
|
}
|
|
|
|
/* Reimplementation of PyFile_WriteString() no calling indirectly
|
|
PyErr_CheckSignals(): avoid the call to PyObject_Str(). */
|
|
|
|
static int
|
|
sys_pyfile_write_unicode(PyObject *unicode, PyObject *file)
|
|
{
|
|
if (file == NULL)
|
|
return -1;
|
|
assert(unicode != NULL);
|
|
PyObject *result = _PyObject_CallMethodIdOneArg(file, &PyId_write, unicode);
|
|
if (result == NULL) {
|
|
return -1;
|
|
}
|
|
Py_DECREF(result);
|
|
return 0;
|
|
}
|
|
|
|
static int
|
|
sys_pyfile_write(const char *text, PyObject *file)
|
|
{
|
|
PyObject *unicode = NULL;
|
|
int err;
|
|
|
|
if (file == NULL)
|
|
return -1;
|
|
|
|
unicode = PyUnicode_FromString(text);
|
|
if (unicode == NULL)
|
|
return -1;
|
|
|
|
err = sys_pyfile_write_unicode(unicode, file);
|
|
Py_DECREF(unicode);
|
|
return err;
|
|
}
|
|
|
|
/* APIs to write to sys.stdout or sys.stderr using a printf-like interface.
|
|
Adapted from code submitted by Just van Rossum.
|
|
|
|
PySys_WriteStdout(format, ...)
|
|
PySys_WriteStderr(format, ...)
|
|
|
|
The first function writes to sys.stdout; the second to sys.stderr. When
|
|
there is a problem, they write to the real (C level) stdout or stderr;
|
|
no exceptions are raised.
|
|
|
|
PyErr_CheckSignals() is not called to avoid the execution of the Python
|
|
signal handlers: they may raise a new exception whereas sys_write()
|
|
ignores all exceptions.
|
|
|
|
Both take a printf-style format string as their first argument followed
|
|
by a variable length argument list determined by the format string.
|
|
|
|
*** WARNING ***
|
|
|
|
The format should limit the total size of the formatted output string to
|
|
1000 bytes. In particular, this means that no unrestricted "%s" formats
|
|
should occur; these should be limited using "%.<N>s where <N> is a
|
|
decimal number calculated so that <N> plus the maximum size of other
|
|
formatted text does not exceed 1000 bytes. Also watch out for "%f",
|
|
which can print hundreds of digits for very large numbers.
|
|
|
|
*/
|
|
|
|
static void
|
|
sys_write(_Py_Identifier *key, FILE *fp, const char *format, va_list va)
|
|
{
|
|
PyObject *file;
|
|
PyObject *error_type, *error_value, *error_traceback;
|
|
char buffer[1001];
|
|
int written;
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
_PyErr_Fetch(tstate, &error_type, &error_value, &error_traceback);
|
|
file = sys_get_object_id(tstate, key);
|
|
written = PyOS_vsnprintf(buffer, sizeof(buffer), format, va);
|
|
if (sys_pyfile_write(buffer, file) != 0) {
|
|
_PyErr_Clear(tstate);
|
|
fputs(buffer, fp);
|
|
}
|
|
if (written < 0 || (size_t)written >= sizeof(buffer)) {
|
|
const char *truncated = "... truncated";
|
|
if (sys_pyfile_write(truncated, file) != 0)
|
|
fputs(truncated, fp);
|
|
}
|
|
_PyErr_Restore(tstate, error_type, error_value, error_traceback);
|
|
}
|
|
|
|
void
|
|
PySys_WriteStdout(const char *format, ...)
|
|
{
|
|
va_list va;
|
|
|
|
va_start(va, format);
|
|
sys_write(&PyId_stdout, stdout, format, va);
|
|
va_end(va);
|
|
}
|
|
|
|
void
|
|
PySys_WriteStderr(const char *format, ...)
|
|
{
|
|
va_list va;
|
|
|
|
va_start(va, format);
|
|
sys_write(&PyId_stderr, stderr, format, va);
|
|
va_end(va);
|
|
}
|
|
|
|
static void
|
|
sys_format(_Py_Identifier *key, FILE *fp, const char *format, va_list va)
|
|
{
|
|
PyObject *file, *message;
|
|
PyObject *error_type, *error_value, *error_traceback;
|
|
const char *utf8;
|
|
PyThreadState *tstate = _PyThreadState_GET();
|
|
|
|
_PyErr_Fetch(tstate, &error_type, &error_value, &error_traceback);
|
|
file = sys_get_object_id(tstate, key);
|
|
message = PyUnicode_FromFormatV(format, va);
|
|
if (message != NULL) {
|
|
if (sys_pyfile_write_unicode(message, file) != 0) {
|
|
_PyErr_Clear(tstate);
|
|
utf8 = PyUnicode_AsUTF8(message);
|
|
if (utf8 != NULL)
|
|
fputs(utf8, fp);
|
|
}
|
|
Py_DECREF(message);
|
|
}
|
|
_PyErr_Restore(tstate, error_type, error_value, error_traceback);
|
|
}
|
|
|
|
void
|
|
PySys_FormatStdout(const char *format, ...)
|
|
{
|
|
va_list va;
|
|
|
|
va_start(va, format);
|
|
sys_format(&PyId_stdout, stdout, format, va);
|
|
va_end(va);
|
|
}
|
|
|
|
void
|
|
PySys_FormatStderr(const char *format, ...)
|
|
{
|
|
va_list va;
|
|
|
|
va_start(va, format);
|
|
sys_format(&PyId_stderr, stderr, format, va);
|
|
va_end(va);
|
|
}
|