12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923 |
- /* 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_call.h" // _PyObject_CallNoArgs()
- #include "pycore_ceval.h" // _PyEval_SetAsyncGenFinalizer()
- #include "pycore_frame.h" // _PyInterpreterFrame
- #include "pycore_initconfig.h" // _PyStatus_EXCEPTION()
- #include "pycore_long.h" // _PY_LONG_MAX_STR_DIGITS_THRESHOLD
- #include "pycore_namespace.h" // _PyNamespace_New()
- #include "pycore_object.h" // _PyObject_IS_GC()
- #include "pycore_pathconfig.h" // _PyPathConfig_ComputeSysPath0()
- #include "pycore_pyerrors.h" // _PyErr_GetRaisedException()
- #include "pycore_pylifecycle.h" // _PyErr_WriteUnraisableDefaultHook()
- #include "pycore_pymath.h" // _PY_SHORT_FLOAT_REPR
- #include "pycore_pymem.h" // _PyMem_SetDefaultAllocator()
- #include "pycore_pystate.h" // _PyThreadState_GET()
- #include "pycore_structseq.h" // _PyStructSequence_InitBuiltinWithFlags()
- #include "pycore_tuple.h" // _PyTuple_FromArray()
- #include "frameobject.h" // PyFrame_FastToLocalsWithError()
- #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
- #ifdef __EMSCRIPTEN__
- #error #include <emscripten.h>
- #endif
- #ifdef HAVE_FCNTL_H
- #include <fcntl.h>
- #endif
- /*[clinic input]
- module sys
- [clinic start generated code]*/
- /*[clinic end generated code: output=da39a3ee5e6b4b0d input=3726b388feee8cea]*/
- #include "clinic/sysmodule.c.h"
- PyObject *
- _PySys_GetAttr(PyThreadState *tstate, PyObject *name)
- {
- PyObject *sd = tstate->interp->sysdict;
- if (sd == NULL) {
- return NULL;
- }
- PyObject *exc = _PyErr_GetRaisedException(tstate);
- /* XXX Suppress a new exception if it was raised and restore
- * the old one. */
- PyObject *value = _PyDict_GetItemWithError(sd, name);
- _PyErr_SetRaisedException(tstate, exc);
- return value;
- }
- 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 = _PyErr_GetRaisedException(tstate);
- PyObject *value = _PySys_GetObject(tstate->interp, name);
- /* XXX Suppress a new exception if it was raised and restore
- * the old one. */
- _PyErr_SetRaisedException(tstate, exc);
- 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);
- }
- }
- int
- _PySys_SetAttr(PyObject *key, PyObject *v)
- {
- PyInterpreterState *interp = _PyInterpreterState_GET();
- return sys_set_object(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);
- }
- int
- _PySys_ClearAttrString(PyInterpreterState *interp,
- const char *name, int verbose)
- {
- if (verbose) {
- PySys_WriteStderr("# clear sys.%s\n", name);
- }
- /* To play it safe, we set the attr to None instead of deleting it. */
- if (PyDict_SetItemString(interp->sysdict, name, Py_None) < 0) {
- return -1;
- }
- return 0;
- }
- 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_hooks.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 = _PyErr_GetRaisedException(ts);
- /* 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_SETREF(eventArgs, argTuple);
- }
- }
- else {
- eventArgs = PyTuple_New(0);
- }
- if (!eventArgs) {
- goto exit;
- }
- /* Call global hooks
- *
- * We don't worry about any races on hooks getting added,
- * since that would not leave is in an inconsistent state. */
- _Py_AuditHookEntry *e = is->runtime->audit_hooks.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 */
- PyThreadState_EnterTracing(ts);
- while ((hook = PyIter_Next(hooks)) != NULL) {
- PyObject *o;
- int canTrace = _PyObject_LookupAttr(hook, &_Py_ID(__cantrace__), &o);
- if (o) {
- canTrace = PyObject_IsTrue(o);
- Py_DECREF(o);
- }
- if (canTrace < 0) {
- break;
- }
- if (canTrace) {
- PyThreadState_LeaveTracing(ts);
- }
- PyObject* args[2] = {eventName, eventArgs};
- o = _PyObject_FastCallTstate(ts, hook, args, 2);
- if (canTrace) {
- PyThreadState_EnterTracing(ts);
- }
- if (!o) {
- break;
- }
- Py_DECREF(o);
- Py_CLEAR(hook);
- }
- PyThreadState_LeaveTracing(ts);
- if (_PyErr_Occurred(ts)) {
- goto exit;
- }
- }
- res = 0;
- exit:
- Py_XDECREF(hook);
- Py_XDECREF(hooks);
- Py_XDECREF(eventName);
- Py_XDECREF(eventArgs);
- if (!res) {
- _PyErr_SetRaisedException(ts, exc);
- }
- else {
- assert(_PyErr_Occurred(ts));
- Py_XDECREF(exc);
- }
- return res;
- }
- int
- _PySys_Audit(PyThreadState *tstate, const char *event,
- const char *argFormat, ...)
- {
- va_list vargs;
- va_start(vargs, argFormat);
- 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;
- va_start(vargs, argFormat);
- 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;
- /* The hooks are global so we have to check for runtime finalization. */
- 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);
- /* We don't worry about the very unlikely race right here,
- * since it's entirely benign. Nothing else removes entries
- * from the list and adding an entry right now would not cause
- * any trouble. */
- _Py_AuditHookEntry *e = runtime->audit_hooks.head, *n;
- runtime->audit_hooks.head = NULL;
- while (e) {
- n = e->next;
- PyMem_RawFree(e);
- e = n;
- }
- }
- static void
- add_audit_hook_entry_unlocked(_PyRuntimeState *runtime,
- _Py_AuditHookEntry *entry)
- {
- if (runtime->audit_hooks.head == NULL) {
- runtime->audit_hooks.head = entry;
- }
- else {
- _Py_AuditHookEntry *last = runtime->audit_hooks.head;
- while (last->next) {
- last = last->next;
- }
- last->next = entry;
- }
- }
- 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 = _PyThreadState_GET();
- }
- 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 = (_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;
- if (runtime->audit_hooks.mutex == NULL) {
- /* The runtime must not be initailized yet. */
- add_audit_hook_entry_unlocked(runtime, e);
- }
- else {
- PyThread_acquire_lock(runtime->audit_hooks.mutex, WAIT_LOCK);
- add_audit_hook_entry_unlocked(runtime, e);
- PyThread_release_lock(runtime->audit_hooks.mutex);
- }
- 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;
- }
- /* Avoid having our list of hooks show up in the GC module */
- PyObject_GC_UnTrack(interp->audit_hooks);
- }
- 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_GetAttr(outf, &_Py_ID(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_LookupAttr(outf, &_Py_ID(buffer), &buffer) < 0) {
- Py_DECREF(encoded);
- goto error;
- }
- if (buffer) {
- result = PyObject_CallMethodOneArg(buffer, &_Py_ID(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;
- PyThreadState *tstate = _PyThreadState_GET();
- builtins = PyImport_GetModule(&_Py_ID(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_SetAttr(builtins, _Py_LATIN1_CHR('_'), Py_None) != 0)
- return NULL;
- outf = _PySys_GetAttr(tstate, &_Py_ID(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 (PyFile_WriteObject(_Py_LATIN1_CHR('\n'), outf, Py_PRINT_RAW) != 0)
- return NULL;
- if (PyObject_SetAttr(builtins, _Py_LATIN1_CHR('_'), 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(NULL, value, traceback);
- Py_RETURN_NONE;
- }
- /*[clinic input]
- sys.exception
- Return the current exception.
- Return the most recent exception caught by an except clause
- in the current stack frame or in an older stack frame, or None
- if no such exception exists.
- [clinic start generated code]*/
- static PyObject *
- sys_exception_impl(PyObject *module)
- /*[clinic end generated code: output=2381ee2f25953e40 input=c88fbb94b6287431]*/
- {
- _PyErr_StackItem *err_info = _PyErr_GetTopmostException(_PyThreadState_GET());
- if (err_info->exc_value != NULL) {
- return Py_NewRef(err_info->exc_value);
- }
- 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 _PyErr_StackItemToExcInfoTuple(err_info);
- }
- /*[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]*/
- {
- _Py_DECLARE_STR(utf_8, "utf-8");
- PyObject *ret = &_Py_STR(utf_8);
- return Py_NewRef(ret);
- }
- /*[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)) {
- PyInterpreterState *interp = _PyInterpreterState_GET();
- Py_INCREF(s);
- _PyUnicode_InternMortal(interp, &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.
- */
- static PyObject *whatstrings[8] = {
- &_Py_ID(call),
- &_Py_ID(exception),
- &_Py_ID(line),
- &_Py_ID(return),
- &_Py_ID(c_call),
- &_Py_ID(c_exception),
- &_Py_ID(c_return),
- &_Py_ID(opcode),
- };
- static PyObject *
- call_trampoline(PyThreadState *tstate, PyObject* callback,
- PyFrameObject *frame, int what, PyObject *arg)
- {
- PyObject *stack[3];
- stack[0] = (PyObject *)frame;
- stack[1] = whatstrings[what];
- stack[2] = (arg != NULL) ? arg : Py_None;
- /* Discard any previous modifications the frame's fast locals */
- if (frame->f_fast_as_locals) {
- if (PyFrame_FastToLocalsWithError(frame) < 0) {
- return NULL;
- }
- }
- /* call the Python-level function */
- PyObject *result = _PyObject_FastCallTstate(tstate, callback, stack, 3);
- PyFrame_LocalsToFast(frame, 1);
- return result;
- }
- static int
- profile_trampoline(PyObject *self, PyFrameObject *frame,
- int what, PyObject *arg)
- {
- 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)
- {
- 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._settraceallthreads
- arg: object
- /
- Set the global debug tracing function in all running threads belonging to the current interpreter.
- It will be called on each function call. See the debugger chapter
- in the library manual.
- [clinic start generated code]*/
- static PyObject *
- sys__settraceallthreads(PyObject *module, PyObject *arg)
- /*[clinic end generated code: output=161cca30207bf3ca input=5906aa1485a50289]*/
- {
- PyObject* argument = NULL;
- Py_tracefunc func = NULL;
- if (arg != Py_None) {
- func = trace_trampoline;
- argument = arg;
- }
- PyEval_SetTraceAllThreads(func, argument);
- Py_RETURN_NONE;
- }
- /*[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;
- return Py_NewRef(temp);
- }
- static PyObject *
- sys_setprofile(PyObject *self, PyObject *args)
- {
- 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._setprofileallthreads
- arg: object
- /
- Set the profiling function in all running threads belonging to the current interpreter.
- It will be called on each function call and return. See the profiler chapter
- in the library manual.
- [clinic start generated code]*/
- static PyObject *
- sys__setprofileallthreads(PyObject *module, PyObject *arg)
- /*[clinic end generated code: output=2d61319e27b309fe input=d1a356d3f4f9060a]*/
- {
- PyObject* argument = NULL;
- Py_tracefunc func = NULL;
- if (arg != Py_None) {
- func = profile_trampoline;
- argument = arg;
- }
- PyEval_SetProfileAllThreads(func, argument);
- Py_RETURN_NONE;
- }
- /*[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;
- return Py_NewRef(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;
- }
- /* Reject too low new limit if the current recursion depth is higher than
- the new low-water mark. */
- int depth = tstate->py_recursion_limit - tstate->py_recursion_remaining;
- if (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, 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]*/
- {
- if (_PyEval_SetCoroutineOriginTrackingDepth(depth) < 0) {
- return NULL;
- }
- 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;
- }
- PyStructSequence_SET_ITEM(res, 0, Py_NewRef(firstiter));
- PyStructSequence_SET_ITEM(res, 1, Py_NewRef(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();
- #define SET_HASH_INFO_ITEM(CALL) \
- do { \
- PyObject *item = (CALL); \
- if (item == NULL) { \
- Py_CLEAR(hash_info); \
- return NULL; \
- } \
- PyStructSequence_SET_ITEM(hash_info, field++, item); \
- } while(0)
- SET_HASH_INFO_ITEM(PyLong_FromLong(8 * sizeof(Py_hash_t)));
- SET_HASH_INFO_ITEM(PyLong_FromSsize_t(_PyHASH_MODULUS));
- SET_HASH_INFO_ITEM(PyLong_FromLong(_PyHASH_INF));
- SET_HASH_INFO_ITEM(PyLong_FromLong(0)); // This is no longer used
- SET_HASH_INFO_ITEM(PyLong_FromLong(_PyHASH_IMAG));
- SET_HASH_INFO_ITEM(PyUnicode_FromString(hashfunc->name));
- SET_HASH_INFO_ITEM(PyLong_FromLong(hashfunc->hash_bits));
- SET_HASH_INFO_ITEM(PyLong_FromLong(hashfunc->seed_bits));
- SET_HASH_INFO_ITEM(PyLong_FromLong(Py_HASH_CUTOFF));
- #undef SET_HASH_INFO_ITEM
- 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 */
- };
- static PyObject *
- _sys_getwindowsversion_from_kernel32(void)
- {
- #ifndef MS_WINDOWS_DESKTOP
- return NULL;
- #else
- HANDLE hKernel32;
- wchar_t kernel32_path[MAX_PATH];
- LPVOID verblock;
- DWORD verblock_size;
- VS_FIXEDFILEINFO *ffi;
- UINT ffi_len;
- DWORD realMajor, realMinor, realBuild;
- Py_BEGIN_ALLOW_THREADS
- hKernel32 = GetModuleHandleW(L"kernel32.dll");
- Py_END_ALLOW_THREADS
- if (!hKernel32 || !GetModuleFileNameW(hKernel32, kernel32_path, MAX_PATH)) {
- PyErr_SetFromWindowsErr(0);
- return NULL;
- }
- verblock_size = GetFileVersionInfoSizeW(kernel32_path, NULL);
- if (!verblock_size) {
- PyErr_SetFromWindowsErr(0);
- return NULL;
- }
- verblock = PyMem_RawMalloc(verblock_size);
- if (!verblock ||
- !GetFileVersionInfoW(kernel32_path, 0, verblock_size, verblock) ||
- !VerQueryValueW(verblock, L"", (LPVOID)&ffi, &ffi_len)) {
- PyErr_SetFromWindowsErr(0);
- return NULL;
- }
- realMajor = HIWORD(ffi->dwProductVersionMS);
- realMinor = LOWORD(ffi->dwProductVersionMS);
- realBuild = HIWORD(ffi->dwProductVersionLS);
- PyMem_RawFree(verblock);
- return Py_BuildValue("(kkk)", realMajor, realMinor, realBuild);
- #endif /* !MS_WINDOWS_DESKTOP */
- }
- /* 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;
- version = PyObject_GetAttrString(module, "_cached_windows_version");
- if (version && PyObject_TypeCheck(version, &WindowsVersionType)) {
- return version;
- }
- if (!PyErr_ExceptionMatches(PyExc_AttributeError)) {
- return NULL;
- }
- Py_XDECREF(version);
- PyErr_Clear();
- ver.dwOSVersionInfoSize = sizeof(ver);
- if (!GetVersionExW((OSVERSIONINFOW*) &ver))
- return PyErr_SetFromWindowsErr(0);
- version = PyStructSequence_New(&WindowsVersionType);
- if (version == NULL)
- return NULL;
- #define SET_VERSION_INFO(CALL) \
- do { \
- PyObject *item = (CALL); \
- if (item == NULL) { \
- goto error; \
- } \
- PyStructSequence_SET_ITEM(version, pos++, item); \
- } while(0)
- SET_VERSION_INFO(PyLong_FromLong(ver.dwMajorVersion));
- SET_VERSION_INFO(PyLong_FromLong(ver.dwMinorVersion));
- SET_VERSION_INFO(PyLong_FromLong(ver.dwBuildNumber));
- SET_VERSION_INFO(PyLong_FromLong(ver.dwPlatformId));
- SET_VERSION_INFO(PyUnicode_FromWideChar(ver.szCSDVersion, -1));
- SET_VERSION_INFO(PyLong_FromLong(ver.wServicePackMajor));
- SET_VERSION_INFO(PyLong_FromLong(ver.wServicePackMinor));
- SET_VERSION_INFO(PyLong_FromLong(ver.wSuiteMask));
- SET_VERSION_INFO(PyLong_FromLong(ver.wProductType));
- // 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.
- PyObject *realVersion = _sys_getwindowsversion_from_kernel32();
- if (!realVersion) {
- if (!PyErr_ExceptionMatches(PyExc_WindowsError)) {
- return NULL;
- }
- PyErr_Clear();
- realVersion = Py_BuildValue("(kkk)",
- ver.dwMajorVersion,
- ver.dwMinorVersion,
- ver.dwBuildNumber
- );
- }
- SET_VERSION_INFO(realVersion);
- #undef SET_VERSION_INFO
- if (PyObject_SetAttrString(module, "_cached_windows_version", version) < 0) {
- goto error;
- }
- return version;
- error:
- Py_DECREF(version);
- return NULL;
- }
- #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();
- _PyImport_SetDLOpenFlags(interp, 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(
- _PyImport_GetDLOpenFlags(interp));
- }
- #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 */
- /*[clinic input]
- sys.get_int_max_str_digits
- Return the maximum string digits limit for non-binary int<->str conversions.
- [clinic start generated code]*/
- static PyObject *
- sys_get_int_max_str_digits_impl(PyObject *module)
- /*[clinic end generated code: output=0042f5e8ae0e8631 input=61bf9f99bc8b112d]*/
- {
- PyInterpreterState *interp = _PyInterpreterState_GET();
- return PyLong_FromLong(interp->long_state.max_str_digits);
- }
- /*[clinic input]
- sys.set_int_max_str_digits
- maxdigits: int
- Set the maximum string digits limit for non-binary int<->str conversions.
- [clinic start generated code]*/
- static PyObject *
- sys_set_int_max_str_digits_impl(PyObject *module, int maxdigits)
- /*[clinic end generated code: output=734d4c2511f2a56d input=d7e3f325db6910c5]*/
- {
- PyThreadState *tstate = _PyThreadState_GET();
- if ((!maxdigits) || (maxdigits >= _PY_LONG_MAX_STR_DIGITS_THRESHOLD)) {
- tstate->interp->long_state.max_str_digits = maxdigits;
- Py_RETURN_NONE;
- } else {
- PyErr_Format(
- PyExc_ValueError, "maxdigits must be 0 or larger than %d",
- _PY_LONG_MAX_STR_DIGITS_THRESHOLD);
- return NULL;
- }
- }
- 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, &_Py_ID(__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_CallNoArgs(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;
- }
- return (size_t)size + _PyType_PreHeaderSize(Py_TYPE(o));
- }
- 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);
- return Py_NewRef(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]*/
- {
- /* It may make sense to return the total for the current interpreter
- or have a second function that does so. */
- return _Py_GetGlobalRefTotal();
- }
- #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]*/
- {
- // It might make sense to return the count
- // for just the current interpreter.
- return _Py_GetGlobalAllocatedBlocks();
- }
- /*[clinic input]
- sys.getunicodeinternedsize -> Py_ssize_t
- *
- _only_immortal: bool = False
- Return the number of elements of the unicode interned dictionary
- [clinic start generated code]*/
- static Py_ssize_t
- sys_getunicodeinternedsize_impl(PyObject *module, int _only_immortal)
- /*[clinic end generated code: output=29a6377a94a14f70 input=0330b3408dd5bcc6]*/
- {
- if (_only_immortal) {
- return _PyUnicode_InternedSize_Immortal();
- }
- else {
- return _PyUnicode_InternedSize();
- }
- }
- /*[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();
- _PyInterpreterFrame *frame = tstate->cframe->current_frame;
- if (frame != NULL) {
- while (depth > 0) {
- frame = _PyFrame_GetFirstComplete(frame->previous);
- if (frame == NULL) {
- break;
- }
- --depth;
- }
- }
- if (frame == NULL) {
- _PyErr_SetString(tstate, PyExc_ValueError,
- "call stack is not deep enough");
- return NULL;
- }
- PyObject *pyFrame = Py_XNewRef((PyObject *)_PyFrame_GetFrameObject(frame));
- if (pyFrame && _PySys_Audit(tstate, "sys._getframe", "(O)", pyFrame) < 0) {
- Py_DECREF(pyFrame);
- return NULL;
- }
- return pyFrame;
- }
- /*[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 __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;
- }
- /* Note that, for now, we do not have a per-interpreter equivalent
- for sys.is_finalizing(). */
- /*[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 Py_STATS
- /*[clinic input]
- sys._stats_on
- Turns on stats gathering (stats gathering is on by default).
- [clinic start generated code]*/
- static PyObject *
- sys__stats_on_impl(PyObject *module)
- /*[clinic end generated code: output=aca53eafcbb4d9fe input=8ddc6df94e484f3a]*/
- {
- _py_stats = &_py_stats_struct;
- Py_RETURN_NONE;
- }
- /*[clinic input]
- sys._stats_off
- Turns off stats gathering (stats gathering is on by default).
- [clinic start generated code]*/
- static PyObject *
- sys__stats_off_impl(PyObject *module)
- /*[clinic end generated code: output=1534c1ee63812214 input=b3e50e71ecf29f66]*/
- {
- _py_stats = NULL;
- Py_RETURN_NONE;
- }
- /*[clinic input]
- sys._stats_clear
- Clears the stats.
- [clinic start generated code]*/
- static PyObject *
- sys__stats_clear_impl(PyObject *module)
- /*[clinic end generated code: output=fb65a2525ee50604 input=3e03f2654f44da96]*/
- {
- _Py_StatsClear();
- Py_RETURN_NONE;
- }
- /*[clinic input]
- sys._stats_dump
- Dump stats to file, and clears the stats.
- [clinic start generated code]*/
- static PyObject *
- sys__stats_dump_impl(PyObject *module)
- /*[clinic end generated code: output=79f796fb2b4ddf05 input=92346f16d64f6f95]*/
- {
- _Py_PrintSpecializationStats(1);
- _Py_StatsClear();
- Py_RETURN_NONE;
- }
- #endif
- #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.activate_stack_trampoline
- backend: str
- /
- Activate stack profiler trampoline *backend*.
- [clinic start generated code]*/
- static PyObject *
- sys_activate_stack_trampoline_impl(PyObject *module, const char *backend)
- /*[clinic end generated code: output=5783cdeb51874b43 input=a12df928758a82b4]*/
- {
- #ifdef PY_HAVE_PERF_TRAMPOLINE
- if (strcmp(backend, "perf") == 0) {
- _PyPerf_Callbacks cur_cb;
- _PyPerfTrampoline_GetCallbacks(&cur_cb);
- if (cur_cb.write_state != _Py_perfmap_callbacks.write_state) {
- if (_PyPerfTrampoline_SetCallbacks(&_Py_perfmap_callbacks) < 0 ) {
- PyErr_SetString(PyExc_ValueError, "can't activate perf trampoline");
- return NULL;
- }
- }
- }
- else {
- PyErr_Format(PyExc_ValueError, "invalid backend: %s", backend);
- return NULL;
- }
- if (_PyPerfTrampoline_Init(1) < 0) {
- return NULL;
- }
- Py_RETURN_NONE;
- #else
- PyErr_SetString(PyExc_ValueError, "perf trampoline not available");
- return NULL;
- #endif
- }
- /*[clinic input]
- sys.deactivate_stack_trampoline
- Deactivate the current stack profiler trampoline backend.
- If no stack profiler is activated, this function has no effect.
- [clinic start generated code]*/
- static PyObject *
- sys_deactivate_stack_trampoline_impl(PyObject *module)
- /*[clinic end generated code: output=b50da25465df0ef1 input=9f629a6be9fe7fc8]*/
- {
- if (_PyPerfTrampoline_Init(0) < 0) {
- return NULL;
- }
- Py_RETURN_NONE;
- }
- /*[clinic input]
- sys.is_stack_trampoline_active
- Return *True* if a stack profiler trampoline is active.
- [clinic start generated code]*/
- static PyObject *
- sys_is_stack_trampoline_active_impl(PyObject *module)
- /*[clinic end generated code: output=ab2746de0ad9d293 input=29616b7bf6a0b703]*/
- {
- #ifdef PY_HAVE_PERF_TRAMPOLINE
- if (_PyIsPerfTrampolineActive()) {
- Py_RETURN_TRUE;
- }
- #endif
- Py_RETURN_FALSE;
- }
- /*[clinic input]
- sys._getframemodulename
- depth: int = 0
- Return the name of the module for a calling frame.
- The default depth returns the module containing the call to this API.
- A more typical use in a library will pass a depth of 1 to get the user's
- module rather than the library module.
- If no frame, module, or name can be found, returns None.
- [clinic start generated code]*/
- static PyObject *
- sys__getframemodulename_impl(PyObject *module, int depth)
- /*[clinic end generated code: output=1d70ef691f09d2db input=d4f1a8ed43b8fb46]*/
- {
- if (PySys_Audit("sys._getframemodulename", "i", depth) < 0) {
- return NULL;
- }
- _PyInterpreterFrame *f = _PyThreadState_GET()->cframe->current_frame;
- while (f && (_PyFrame_IsIncomplete(f) || depth-- > 0)) {
- f = f->previous;
- }
- if (f == NULL || f->f_funcobj == NULL) {
- Py_RETURN_NONE;
- }
- PyObject *r = PyFunction_GetModule(f->f_funcobj);
- if (!r) {
- PyErr_Clear();
- r = Py_None;
- }
- return Py_NewRef(r);
- }
- #ifdef __cplusplus
- extern "C" {
- #endif
- static PerfMapState perf_map_state;
- PyAPI_FUNC(int) PyUnstable_PerfMapState_Init(void) {
- #ifndef MS_WINDOWS
- char filename[100];
- pid_t pid = getpid();
- // Use nofollow flag to prevent symlink attacks.
- int flags = O_WRONLY | O_CREAT | O_APPEND | O_NOFOLLOW;
- #ifdef O_CLOEXEC
- flags |= O_CLOEXEC;
- #endif
- snprintf(filename, sizeof(filename) - 1, "/tmp/perf-%jd.map",
- (intmax_t)pid);
- int fd = open(filename, flags, 0600);
- if (fd == -1) {
- return -1;
- }
- else{
- perf_map_state.perf_map = fdopen(fd, "a");
- if (perf_map_state.perf_map == NULL) {
- close(fd);
- return -1;
- }
- }
- perf_map_state.map_lock = PyThread_allocate_lock();
- if (perf_map_state.map_lock == NULL) {
- fclose(perf_map_state.perf_map);
- return -2;
- }
- #endif
- return 0;
- }
- PyAPI_FUNC(int) PyUnstable_WritePerfMapEntry(
- const void *code_addr,
- unsigned int code_size,
- const char *entry_name
- ) {
- #ifndef MS_WINDOWS
- if (perf_map_state.perf_map == NULL) {
- int ret = PyUnstable_PerfMapState_Init();
- if(ret != 0){
- return ret;
- }
- }
- PyThread_acquire_lock(perf_map_state.map_lock, 1);
- fprintf(perf_map_state.perf_map, "%" PRIxPTR " %x %s\n", (uintptr_t) code_addr, code_size, entry_name);
- fflush(perf_map_state.perf_map);
- PyThread_release_lock(perf_map_state.map_lock);
- #endif
- return 0;
- }
- PyAPI_FUNC(void) PyUnstable_PerfMapState_Fini(void) {
- #ifndef MS_WINDOWS
- if (perf_map_state.perf_map != NULL) {
- // close the file
- PyThread_acquire_lock(perf_map_state.map_lock, 1);
- fclose(perf_map_state.perf_map);
- PyThread_release_lock(perf_map_state.map_lock);
- // clean up the lock and state
- PyThread_free_lock(perf_map_state.map_lock);
- perf_map_state.perf_map = NULL;
- }
- #endif
- }
- #ifdef __cplusplus
- }
- #endif
- static PyMethodDef sys_methods[] = {
- /* Might as well keep this in alphabetic order */
- SYS_ADDAUDITHOOK_METHODDEF
- {"audit", _PyCFunction_CAST(sys_audit), METH_FASTCALL, audit_doc },
- {"breakpointhook", _PyCFunction_CAST(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_EXCEPTION_METHODDEF
- SYS_EXC_INFO_METHODDEF
- SYS_EXCEPTHOOK_METHODDEF
- SYS_EXIT_METHODDEF
- SYS_GETDEFAULTENCODING_METHODDEF
- SYS_GETDLOPENFLAGS_METHODDEF
- SYS_GETALLOCATEDBLOCKS_METHODDEF
- SYS_GETUNICODEINTERNEDSIZE_METHODDEF
- 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_CAST(sys_getsizeof),
- METH_VARARGS | METH_KEYWORDS, getsizeof_doc},
- SYS__GETFRAME_METHODDEF
- SYS__GETFRAMEMODULENAME_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__SETPROFILEALLTHREADS_METHODDEF
- SYS_GETPROFILE_METHODDEF
- SYS_SETRECURSIONLIMIT_METHODDEF
- {"settrace", sys_settrace, METH_O, settrace_doc},
- SYS__SETTRACEALLTHREADS_METHODDEF
- 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_CAST(sys_set_asyncgen_hooks),
- METH_VARARGS | METH_KEYWORDS, set_asyncgen_hooks_doc},
- SYS_GET_ASYNCGEN_HOOKS_METHODDEF
- SYS_GETANDROIDAPILEVEL_METHODDEF
- SYS_ACTIVATE_STACK_TRAMPOLINE_METHODDEF
- SYS_DEACTIVATE_STACK_TRAMPOLINE_METHODDEF
- SYS_IS_STACK_TRAMPOLINE_ACTIVE_METHODDEF
- SYS_UNRAISABLEHOOK_METHODDEF
- SYS_GET_INT_MAX_STR_DIGITS_METHODDEF
- SYS_SET_INT_MAX_STR_DIGITS_METHODDEF
- #ifdef Py_STATS
- SYS__STATS_ON_METHODDEF
- SYS__STATS_OFF_METHODDEF
- SYS__STATS_CLEAR_METHODDEF
- SYS__STATS_DUMP_METHODDEF
- #endif
- {NULL, NULL} // sentinel
- };
- static PyObject *
- list_builtin_module_names(void)
- {
- PyObject *list = _PyImport_GetBuiltinModuleNames();
- if (list == NULL) {
- return NULL;
- }
- 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 = _PySys_GetAttr(tstate, &_Py_ID(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(tstate->interp, &_Py_ID(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 = _PySys_GetAttr(tstate, &_Py_ID(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;
- _Py_COMP_DIAG_PUSH
- _Py_COMP_DIAG_IGNORE_DEPR_DECLS
- PySys_AddWarnOptionUnicode(unicode);
- _Py_COMP_DIAG_POP
- Py_DECREF(unicode);
- }
- int
- PySys_HasWarnOptions(void)
- {
- PyThreadState *tstate = _PyThreadState_GET();
- PyObject *warnoptions = _PySys_GetAttr(tstate, &_Py_ID(warnoptions));
- return (warnoptions != NULL && PyList_Check(warnoptions)
- && PyList_GET_SIZE(warnoptions) > 0);
- }
- static PyObject *
- get_xoptions(PyThreadState *tstate)
- {
- PyObject *xoptions = _PySys_GetAttr(tstate, &_Py_ID(_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(tstate->interp, &_Py_ID(_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);
- if (name == NULL) {
- goto error;
- }
- value = Py_NewRef(Py_True);
- }
- else {
- name = PyUnicode_FromWideChar(s, name_end - s);
- if (name == NULL) {
- goto error;
- }
- value = PyUnicode_FromWideChar(name_end + 1, -1);
- if (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_exc - the last uncaught exception\n\
- Only available in an interactive session after a\n\
- traceback has been printed.\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 the (deprecated) legacy representation of last_exc.\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\
- exception() -- return the current thread's active exception\n\
- exc_info() -- return information about the current thread's active 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"},
- {"safe_path", "-P"},
- {"int_max_str_digits", "-X int_max_str_digits"},
- {0}
- };
- static PyStructSequence_Desc flags_desc = {
- "sys.flags", /* name */
- flags__doc__, /* doc */
- flags_fields, /* fields */
- 18
- };
- 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);
- SetFlagObj(PyBool_FromLong(config->safe_path));
- SetFlag(config->int_max_str_digits);
- #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;
- }
- #ifdef __EMSCRIPTEN__
- PyDoc_STRVAR(emscripten_info__doc__,
- "sys._emscripten_info\n\
- \n\
- WebAssembly Emscripten platform information.");
- static PyTypeObject *EmscriptenInfoType;
- static PyStructSequence_Field emscripten_info_fields[] = {
- {"emscripten_version", "Emscripten version (major, minor, micro)"},
- {"runtime", "Runtime (Node.JS version, browser user agent)"},
- {"pthreads", "pthread support"},
- {"shared_memory", "shared memory support"},
- {0}
- };
- static PyStructSequence_Desc emscripten_info_desc = {
- "sys._emscripten_info", /* name */
- emscripten_info__doc__ , /* doc */
- emscripten_info_fields, /* fields */
- 4
- };
- EM_JS(char *, _Py_emscripten_runtime, (void), {
- var info;
- if (typeof navigator == 'object') {
- info = navigator.userAgent;
- } else if (typeof process == 'object') {
- info = "Node.js ".concat(process.version);
- } else {
- info = "UNKNOWN";
- }
- var len = lengthBytesUTF8(info) + 1;
- var res = _malloc(len);
- if (res) stringToUTF8(info, res, len);
- #if __wasm64__
- return BigInt(res);
- #else
- return res;
- #endif
- });
- static PyObject *
- make_emscripten_info(void)
- {
- PyObject *emscripten_info = NULL;
- PyObject *version = NULL;
- char *ua;
- int pos = 0;
- emscripten_info = PyStructSequence_New(EmscriptenInfoType);
- if (emscripten_info == NULL) {
- return NULL;
- }
- version = Py_BuildValue("(iii)",
- __EMSCRIPTEN_major__, __EMSCRIPTEN_minor__, __EMSCRIPTEN_tiny__);
- if (version == NULL) {
- goto error;
- }
- PyStructSequence_SET_ITEM(emscripten_info, pos++, version);
- ua = _Py_emscripten_runtime();
- if (ua != NULL) {
- PyObject *oua = PyUnicode_DecodeUTF8(ua, strlen(ua), "strict");
- free(ua);
- if (oua == NULL) {
- goto error;
- }
- PyStructSequence_SET_ITEM(emscripten_info, pos++, oua);
- } else {
- PyStructSequence_SET_ITEM(emscripten_info, pos++, Py_NewRef(Py_None));
- }
- #define SetBoolItem(flag) \
- PyStructSequence_SET_ITEM(emscripten_info, pos++, PyBool_FromLong(flag))
- #ifdef __EMSCRIPTEN_PTHREADS__
- SetBoolItem(1);
- #else
- SetBoolItem(0);
- #endif
- #ifdef __EMSCRIPTEN_SHARED_MEMORY__
- SetBoolItem(1);
- #else
- SetBoolItem(0);
- #endif
- #undef SetBoolItem
- if (PyErr_Occurred()) {
- goto error;
- }
- return emscripten_info;
- error:
- Py_CLEAR(emscripten_info);
- return NULL;
- }
- #endif // __EMSCRIPTEN__
- 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;
- PyInterpreterState *interp = tstate->interp;
- /* 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 (_PyStructSequence_InitBuiltin(interp, &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
- #define ENSURE_INFO_TYPE(TYPE, DESC) \
- do { \
- if (_PyStructSequence_InitBuiltinWithFlags( \
- interp, &TYPE, &DESC, Py_TPFLAGS_DISALLOW_INSTANTIATION) < 0) { \
- goto type_init_failed; \
- } \
- } while (0)
- /* version_info */
- ENSURE_INFO_TYPE(VersionInfoType, version_info_desc);
- version_info = make_version_info(tstate);
- SET_SYS("version_info", version_info);
- /* implementation */
- SET_SYS("implementation", make_impl_info(version_info));
- // sys.flags: updated in-place later by _PySys_UpdateConfig()
- ENSURE_INFO_TYPE(FlagsType, flags_desc);
- SET_SYS("flags", make_flags(tstate->interp));
- #if defined(MS_WINDOWS)
- /* getwindowsversion */
- ENSURE_INFO_TYPE(WindowsVersionType, windows_version_desc);
- SET_SYS_FROM_STRING("_vpath", VPATH);
- #endif
- #undef ENSURE_INFO_TYPE
- /* float repr style: 0.03 (short) vs 0.029999999999999999 (legacy) */
- #if _PY_SHORT_FLOAT_REPR == 1
- 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 (_PyStructSequence_InitBuiltin(interp, &AsyncGenHooksType,
- &asyncgen_hooks_desc) < 0)
- {
- goto type_init_failed;
- }
- #ifdef __EMSCRIPTEN__
- if (EmscriptenInfoType == NULL) {
- EmscriptenInfoType = PyStructSequence_NewType(&emscripten_info_desc);
- if (EmscriptenInfoType == NULL) {
- goto type_init_failed;
- }
- }
- SET_SYS("_emscripten_info", make_emscripten_info());
- #endif
- /* 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 = NULL;
- const wchar_t *name_end = wcschr(s, L'=');
- if (!name_end) {
- name = PyUnicode_FromWideChar(s, -1);
- if (name == NULL) {
- goto error;
- }
- value = Py_NewRef(Py_True);
- }
- else {
- name = PyUnicode_FromWideChar(s, name_end - s);
- if (name == NULL) {
- goto error;
- }
- value = PyUnicode_FromWideChar(name_end + 1, -1);
- if (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 {
- if (PyDict_SetItemString(sysdict, "pycache_prefix", Py_None) < 0) {
- return -1;
- }
- }
- 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));
- const wchar_t *stdlibdir = _Py_GetStdlibDir();
- if (stdlibdir != NULL) {
- SET_SYS_FROM_WSTR("_stdlib_dir", stdlibdir);
- }
- else {
- if (PyDict_SetItemString(sysdict, "_stdlib_dir", Py_None) < 0) {
- return -1;
- }
- }
- #undef SET_SYS_FROM_WSTR
- #undef COPY_LIST
- #undef COPY_WSTR
- // sys.flags
- PyObject *flags = _PySys_GetObject(interp, "flags"); // borrowed ref
- if (flags == NULL) {
- if (!_PyErr_Occurred(tstate)) {
- _PyErr_SetString(tstate, PyExc_RuntimeError, "lost sys.flags");
- }
- 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/backslashreplace and ignore EAGAIN errors. */
- static PyStatus
- _PySys_SetPreliminaryStderr(PyObject *sysdict)
- {
- PyObject *pstderr = PyFile_NewStdPrinter(fileno(stderr));
- if (pstderr == NULL) {
- goto error;
- }
- if (PyDict_SetItem(sysdict, &_Py_ID(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");
- }
- PyObject *_Py_CreateMonitoringObject(void);
- /* 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 = _PyImport_InitModules(interp);
- if (modules == NULL) {
- goto error;
- }
- 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;
- }
- interp->sysdict = Py_NewRef(sysdict);
- interp->sysdict_copy = PyDict_Copy(sysdict);
- if (interp->sysdict_copy == NULL) {
- goto error;
- }
- if (PyDict_SetItemString(sysdict, "modules", 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", modules) < 0) {
- goto error;
- }
- PyObject *monitoring = _Py_CreateMonitoringObject();
- if (monitoring == NULL) {
- goto error;
- }
- int err = PyDict_SetItemString(sysdict, "monitoring", monitoring);
- Py_DECREF(monitoring);
- if (err < 0) {
- goto error;
- }
- assert(!_PyErr_Occurred(tstate));
- *sysmod_p = sysmod;
- return _PyStatus_OK();
- error:
- return _PyStatus_ERR("can't initialize sys module");
- }
- void
- _PySys_FiniTypes(PyInterpreterState *interp)
- {
- _PyStructSequence_FiniBuiltin(interp, &VersionInfoType);
- _PyStructSequence_FiniBuiltin(interp, &FlagsType);
- #if defined(MS_WINDOWS)
- _PyStructSequence_FiniBuiltin(interp, &WindowsVersionType);
- #endif
- _PyStructSequence_FiniBuiltin(interp, &Hash_InfoType);
- _PyStructSequence_FiniBuiltin(interp, &AsyncGenHooksType);
- #ifdef __EMSCRIPTEN__
- if (_Py_IsMainInterpreter(interp)) {
- Py_CLEAR(EmscriptenInfoType);
- }
- #endif
- }
- 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(interp, &_Py_ID(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 = _PySys_GetAttr(tstate, &_Py_ID(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)
- {
- _Py_COMP_DIAG_PUSH
- _Py_COMP_DIAG_IGNORE_DEPR_DECLS
- PySys_SetArgvEx(argc, argv, 0);
- _Py_COMP_DIAG_POP
- }
- /* 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_CallMethodOneArg(file, &_Py_ID(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(PyObject *key, FILE *fp, const char *format, va_list va)
- {
- PyObject *file;
- char buffer[1001];
- int written;
- PyThreadState *tstate = _PyThreadState_GET();
- PyObject *exc = _PyErr_GetRaisedException(tstate);
- file = _PySys_GetAttr(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_SetRaisedException(tstate, exc);
- }
- void
- PySys_WriteStdout(const char *format, ...)
- {
- va_list va;
- va_start(va, format);
- sys_write(&_Py_ID(stdout), stdout, format, va);
- va_end(va);
- }
- void
- PySys_WriteStderr(const char *format, ...)
- {
- va_list va;
- va_start(va, format);
- sys_write(&_Py_ID(stderr), stderr, format, va);
- va_end(va);
- }
- static void
- sys_format(PyObject *key, FILE *fp, const char *format, va_list va)
- {
- PyObject *file, *message;
- const char *utf8;
- PyThreadState *tstate = _PyThreadState_GET();
- PyObject *exc = _PyErr_GetRaisedException(tstate);
- file = _PySys_GetAttr(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_SetRaisedException(tstate, exc);
- }
- void
- PySys_FormatStdout(const char *format, ...)
- {
- va_list va;
- va_start(va, format);
- sys_format(&_Py_ID(stdout), stdout, format, va);
- va_end(va);
- }
- void
- PySys_FormatStderr(const char *format, ...)
- {
- va_list va;
- va_start(va, format);
- sys_format(&_Py_ID(stderr), stderr, format, va);
- va_end(va);
- }
|