.Ph6dZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z dZ ej jZdZn#e$r dZejZYnwxYweedddZejd d kZeed dd kZdZ ddlZn #e$rdZYnwxYw ddlZejZn #e$rd ZYnwxYw ddlZ ejZn #e$rdZYnwxYwn #e$rd ZYnwxYw ddl Z e!e j"Z#n #e$rd Z#YnwxYw ddl$Z$e$j%Z%n #e$rd Z%YnwxYw ddl&m'Z'e'j(Z(n #e$rd Z(YnwxYw ddl)m*Z*e*Z+n #e$rdZ+YnwxYw ddl,Z,dZ-n #e$rdZ-YnwxYw ej.Z/n #e$rdZ/YnwxYw ddl0m1Z1m2Z2e1e2\Z3Z4n#e$rd\Z3Z4YnwxYwe!e j 5e j6j7ej6 dz dZ8dZ9dZ:dZ;d dZej?dj@ZAd"dZBd"dZCeDdkr e=dS)#aAs a programming ecosystem grows, so do the chances of runtime variability. Python boasts one of the widest deployments for a high-level programming environment, making it a viable target for all manner of application. But with breadth comes variance, so it's important to know what you're working with. Some basic variations that are common among development machines: * **Executable runtime**: CPython, PyPy, Jython, etc., plus build date and compiler * **Language version**: 2.7 through 3.12 * **Host operating system**: Windows, OS X, Ubuntu, Debian, CentOS, RHEL, etc. * **Features**: 64-bit, IPv6, Unicode character support (UCS-2/UCS-4) * **Built-in library support**: OpenSSL, threading, SQLite, zlib * **User environment**: umask, ulimit, working directory path * **Machine info**: CPU count, hostname, filesystem encoding See the full example profile below for more. ecoutils was created to quantify that variability. ecoutils quickly produces an information-dense description of critical runtime factors, with minimal side effects. In short, ecoutils is like browser and user agent analytics, but for Python environments. Transmission and collection --------------------------- The data is all JSON serializable, and is suitable for sending to a central analytics server. An HTTP-backed service for this can be found at: https://github.com/mahmoud/espymetrics/ Notable omissions ----------------- Due to space constraints (and possibly latency constraints), the following information is deemed not dense enough, and thus omitted: * :data:`sys.path` * full :mod:`sysconfig` * environment variables (:data:`os.environ`) Compatibility ------------- So far ecoutils has has been tested on Python 3.7+ and PyPy3. Various versions have been tested on Ubuntu, Debian, RHEL, OS X, FreeBSD, and Windows 7. .. note:: ``boltons.ecoutils`` historically supported back to Python 2.4, but in 2024, due to increasing testing burden, ecoutils support tracks the same versions of Python as the rest of the boltons package. For older Pythons, see `this version`_ from boltons 23.0.0. .. _this version: https://github.com/mahmoud/boltons/blob/4b1d728f31a8378b193be9c966c853be0a57527d/boltons/ecoutils.py Profile generation ------------------ Profiles are generated by :func:`ecoutils.get_profile`. When run as a module, ecoutils will call :func:`~ecoutils.get_profile` and print a profile in JSON format:: $ python -m boltons.ecoutils { "_eco_version": "1.0.0", "cpu_count": 4, "cwd": "/home/mahmoud/projects/boltons", "fs_encoding": "UTF-8", "guid": "6b139e7bbf5ad4ed8d4063bf6235b4d2", "hostfqdn": "mahmoud-host", "hostname": "mahmoud-host", "linux_dist_name": "Ubuntu", "linux_dist_version": "14.04", "python": { "argv": "boltons/ecoutils.py", "bin": "/usr/bin/python", "build_date": "Jun 22 2015 17:58:13", "compiler": "GCC 4.8.2", "features": { "64bit": true, "expat": "expat_2.1.0", "ipv6": true, "openssl": "OpenSSL 1.0.1f 6 Jan 2014", "readline": true, "sqlite": "3.8.2", "threading": true, "tkinter": "8.6", "unicode_wide": true, "zlib": "1.2.8" }, "version": "2.7.6 (default, Jun 22 2015, 17:58:13) [GCC 4.8.2]", "version_info": [ 2, 7, 6, "final", 0 ] }, "time_utc": "2016-05-24 07:59:40.473140", "time_utc_offset": -8.0, "ulimit_hard": 4096, "ulimit_soft": 1024, "umask": "002", "uname": { "machine": "x86_64", "node": "mahmoud-host", "processor": "x86_64", "release": "3.13.0-85-generic", "system": "Linux", "version": "#129-Ubuntu SMP Thu Mar 17 20:50:15 UTC 2016" }, "username": "mahmoud" } ``pip install boltons`` and try it yourself! Nz1.1.0TFP maxunicodeizOpenSSL >0.8.0)expat) cpu_count) getrlimit RLIMIT_NOFILE)rrg @)time_utctime_utc_offsetc i}ttj|d<tj|d<dtj|d<tj|d<tj d|d<ttj |d<ttttt t"t$t&t(t*t,d |d <|S) Nargvbin versioncompiler build_date version_info) opensslr sqlitetkinterzlib unicode_widereadline64bitipv6 threadingurandomfeatures)_escape_shell_argssysr executablejoinrsplitplatformpython_compiler python_buildlistrOPENSSL_VERSION EXPAT_VERSIONSQLITE_VERSIONTKINTER_VERSION ZLIB_VERSION HAVE_UCS4 HAVE_READLINEIS_64BIT HAVE_IPV6HAVE_THREADING HAVE_URANDOM)rets P/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/boltons/ecoutils.pyget_python_infor:s C$SX..CKCJ XXck//1122C N.00C O -//2C s/00C"1 -!/"1+'0#0 (($2". 0 0C O Jc b|dd}|r$td|i} tj|d<n#t $rd|d<YnwxYwt t|d<tj |d<tj |d<tj }|d |d |d |d |d |dd|d< tj }n#t $rd}YnwxYw|d |d<|d |d<t|d<tj|d<t"|d<t$|d<t'j|d<t+t'jt'jd d d|d<t1|d<|t4t6|d<|r5d|d<d|d<d|d<d|dd<d|dd<d|dd <d|d<|S)!aThe main entrypoint to ecoutils. Calling this will return a JSON-serializable dictionary of information about the current process. It is very unlikely that the information returned will change during the lifetime of the process, and in most cases the majority of the information stays the same between runs as well. :func:`get_profile` takes one optional keyword argument, *scrub*, a :class:`bool` that, if True, blanks out identifiable information. This includes current working directory, hostname, Python executable path, command-line arguments, and username. Values are replaced with '-', but for compatibility keys remain in place. scrubFzunexpected keyword arguments: usernamer guidhostnamehostfqdnrrrr)systemnodereleasermachine processoruname)r r r linux_dist_namelinux_dist_versionr fs_encoding ulimit_soft ulimit_hardcwd0umaskpython _eco_version-rrrE)pop TypeErrorkeysgetpassgetuser Exceptionstr INSTANCE_IDsocket gethostnamegetfqdnr)rIlinux_distribution CPU_COUNTr%getfilesystemencodingRLIMIT_FDS_SOFTRLIMIT_FDS_HARDosgetcwdoctrQrjustr:updateSTART_TIME_INFO ECO_VERSION)kwargsr=r8rI linux_dists r9 get_profilern"sO" JJw & &E LJJJKKK C!/++J Jk""CK(**C On&&C O N  E#Ah!!H$Qx$Qx$Qx!&q ++CL "022 """! "']C *1 C C 244C (C (C CJrx ,,--33As;;CL#%%CMJJ%C E JJ"H e #H f"G VJ Js$AA)(A)3D DDc`|rtj|d|Stj|dS)NT) sort_keysindent)rp)jsondumps)valrqs r9rsrses6 >z#f==== :cT * * **r;cL|rd}nd}t}t||S)Nrr)rnrs)rq data_dicts r9get_profile_jsonrwks/  I F # ##r;c@ttddS)NT)rq)printrwr;r9mainr{us" $ ' ' '(((((r;rc|stjdkrd}nd}|dkrt||S|dkrt||St d|z)Nwin32cmdsh)sepz+style expected one of 'cmd' or 'sh', not %r)r%r)_args2sh _args2cmd ValueError)argsrstyles r9r$r$}so  <7 " "EEE }}#&&&& %3'''' BUJ K KKr;z[^a-zA-Z0-9_@%+=:,./-]cg}|D]n}|s|dt|||?|d|ddzdzod|S)Nz'''z'"'"'r)append_find_sh_unsafereplacer')rrret_listargs r9rrsH A A  OOD ! ! !  3   ' OOC  ckk#y999C?@@@@ 88H  r;chg}d}|D]}g}|r|dd|vpd|vp| }|r|d|D]}|dkr|||dkr@|dt|zdzg}|dd|r||g}|||r|||r*|||dd|S) NFr "\rz\"r )rlenextendr')rrresult needquoterbs_bufcs r9rrsp FI!!   MM#   CZrs>yyv  %%&%''3KLL%%%L$KKK% c++c""##AbD)//11 6?3  ! # GCq ) )E 1  OOOOMMMNNN+NNNNN JJJ+- +++++OOONNNc'+,,OOOOOKKK$LLLLL!!!!!!'MMMMM)))))) IIIIINNNNNIIIII,11111111'0y'?'?$O__,,,'+$O___, #s8#4#8#89J9N#O#OPP'+}nv&=??:@@@F+++ $$$$))) L L L L"*677>$''''\ zDFFF  sA AA3B88CC CCC C;%C-,C;-C74C;6C77C;;DD DD('D(, D88EE EEE"E33E=<E=FFFFF('F(,G GG