%global _empty_manifest_terminate_build 0 Name: python-pptop Version: 0.6.15 Release: 1 Summary: Open, extensible Python injector/profiler/analyzer License: MIT URL: https://pptop.bma.ai/ Source0: https://mirrors.aliyun.com/pypi/web/packages/1e/2b/ce8f10cd8d7d7e892aa56a4e0e78cbcebe8a160c363825192a7f1f6f3e0a/pptop-0.6.15.tar.gz BuildArch: noarch %description # ppTOP Project home: https://pptop.bma.ai/ ppTOP is open, extensible Python injector/profiler/analyzer. The main idea is to inject a custom code inside Python process (already running or going to be launched) and analyze its behavior with no any code modifications. Say no to "prints" and garbage in debug logs - now you have ppTOP. A modern MRI scanner for Python. ## Installation ``` pip3 install pptop ``` * Python: 3.5+ is required, as ppTOP uses asyncio * Can be injected into any Python version (tested: 2.7+) * Injection into running processes requires *gdb* (present in almost all Linux distributions) * Only Linux systems are currently supported ## Features ppTOP can be injected into any running Python process [![asciicast](https://asciinema.org/a/265309.svg)](https://asciinema.org/a/265309) or you can load Python program manually and profile its launch [![asciicast](https://asciinema.org/a/265310.svg)](https://asciinema.org/a/265310) To launch a program, press *Ctrl+L* or specify *-w sec* param in command line args to start it automatically after the specified delay. Data from connected process is collected in real-time and displayed in table-based console UI, which can be easily extended with custom plugins. All data tables can be scrolled, filtered, new data collection can be paused. In case of problems, any plugin can be re-injected at any time. ## Usage To start ppTOP, type ```shell pptop ``` and then select Python process you want to inject to from the list. Alternatively, you can start it with ```shell pptop PID # or pptop PID-FILE ``` and specify the process from the command line. If you want to analyze program startup, just type ```shell pptop /path/to/program.py ``` The program will be loaded in waiting state, press *Ctrl+L* when you are ready. To get a help for the current plugin, press *F1* to display module documentation. ## Configuration Plugins and keyboard shortcuts are configured by default in *~/.pptop/pptop.yml* file (created automatically at first launch). ## Standard plugins * **asyncio** asyncio loop monitor * **atasker** [atasker](https://github.com/alttch/atasker) monitor * **env** view process OS environment variables * **log** inject into all Python loggers and collect log messages * **malloc** trace object memory allocations * **neotasker** [neotasker](https://github.com/alttch/neotasker) monitor * **open_files** view process open files * **script_runner** launch a custom scripts inside process * **threads** view process threads * **vars** variable/function watcher * **yappi** [yappi](https://github.com/sumerc/yappi) profiler plugin Most of plugins contain 2 parts of code: one collects data inside profiling process, other display it in ppTOP UI. For the profiling process all plug-ins are invisible, safe and unloadable (at least they try their best :) ## Console mode With "`" button, remote Python console can be opened. It has no full functionality like a standard Python console, but supports all frequently used features, like importing modules, defining functions and variables, executing functions and loops etc. [![asciicast](https://asciinema.org/a/265307.svg)](https://asciinema.org/a/265307) Console has own remote *globals*, which are preserved until ppTOP quit and injected server is terminated. ## Grab stdout/stderr If launched with "-g" option, ppTOP will grab stdout/stderr of injected process and print it to local console. You can view local console without entering console mode, by pressing *Ctrl+O*. ## Documentation Configuration, troubleshooting, advanced usage, plugin development: https://pptop.bma.ai/doc/ ## TODO * [ ] More plugins * [ ] Advanced filtering * [ ] Data snapshots * [ ] Step-by-step debugger * [ ] JSON API, web interface * [ ] Charts Enjoy! :) p.s. Code in **master** can be completely broken, install with *pip* only. %package -n python3-pptop Summary: Open, extensible Python injector/profiler/analyzer Provides: python-pptop BuildRequires: python3-devel BuildRequires: python3-setuptools BuildRequires: python3-pip %description -n python3-pptop # ppTOP Project home: https://pptop.bma.ai/ ppTOP is open, extensible Python injector/profiler/analyzer. The main idea is to inject a custom code inside Python process (already running or going to be launched) and analyze its behavior with no any code modifications. Say no to "prints" and garbage in debug logs - now you have ppTOP. A modern MRI scanner for Python. ## Installation ``` pip3 install pptop ``` * Python: 3.5+ is required, as ppTOP uses asyncio * Can be injected into any Python version (tested: 2.7+) * Injection into running processes requires *gdb* (present in almost all Linux distributions) * Only Linux systems are currently supported ## Features ppTOP can be injected into any running Python process [![asciicast](https://asciinema.org/a/265309.svg)](https://asciinema.org/a/265309) or you can load Python program manually and profile its launch [![asciicast](https://asciinema.org/a/265310.svg)](https://asciinema.org/a/265310) To launch a program, press *Ctrl+L* or specify *-w sec* param in command line args to start it automatically after the specified delay. Data from connected process is collected in real-time and displayed in table-based console UI, which can be easily extended with custom plugins. All data tables can be scrolled, filtered, new data collection can be paused. In case of problems, any plugin can be re-injected at any time. ## Usage To start ppTOP, type ```shell pptop ``` and then select Python process you want to inject to from the list. Alternatively, you can start it with ```shell pptop PID # or pptop PID-FILE ``` and specify the process from the command line. If you want to analyze program startup, just type ```shell pptop /path/to/program.py ``` The program will be loaded in waiting state, press *Ctrl+L* when you are ready. To get a help for the current plugin, press *F1* to display module documentation. ## Configuration Plugins and keyboard shortcuts are configured by default in *~/.pptop/pptop.yml* file (created automatically at first launch). ## Standard plugins * **asyncio** asyncio loop monitor * **atasker** [atasker](https://github.com/alttch/atasker) monitor * **env** view process OS environment variables * **log** inject into all Python loggers and collect log messages * **malloc** trace object memory allocations * **neotasker** [neotasker](https://github.com/alttch/neotasker) monitor * **open_files** view process open files * **script_runner** launch a custom scripts inside process * **threads** view process threads * **vars** variable/function watcher * **yappi** [yappi](https://github.com/sumerc/yappi) profiler plugin Most of plugins contain 2 parts of code: one collects data inside profiling process, other display it in ppTOP UI. For the profiling process all plug-ins are invisible, safe and unloadable (at least they try their best :) ## Console mode With "`" button, remote Python console can be opened. It has no full functionality like a standard Python console, but supports all frequently used features, like importing modules, defining functions and variables, executing functions and loops etc. [![asciicast](https://asciinema.org/a/265307.svg)](https://asciinema.org/a/265307) Console has own remote *globals*, which are preserved until ppTOP quit and injected server is terminated. ## Grab stdout/stderr If launched with "-g" option, ppTOP will grab stdout/stderr of injected process and print it to local console. You can view local console without entering console mode, by pressing *Ctrl+O*. ## Documentation Configuration, troubleshooting, advanced usage, plugin development: https://pptop.bma.ai/doc/ ## TODO * [ ] More plugins * [ ] Advanced filtering * [ ] Data snapshots * [ ] Step-by-step debugger * [ ] JSON API, web interface * [ ] Charts Enjoy! :) p.s. Code in **master** can be completely broken, install with *pip* only. %package help Summary: Development documents and examples for pptop Provides: python3-pptop-doc %description help # ppTOP Project home: https://pptop.bma.ai/ ppTOP is open, extensible Python injector/profiler/analyzer. The main idea is to inject a custom code inside Python process (already running or going to be launched) and analyze its behavior with no any code modifications. Say no to "prints" and garbage in debug logs - now you have ppTOP. A modern MRI scanner for Python. ## Installation ``` pip3 install pptop ``` * Python: 3.5+ is required, as ppTOP uses asyncio * Can be injected into any Python version (tested: 2.7+) * Injection into running processes requires *gdb* (present in almost all Linux distributions) * Only Linux systems are currently supported ## Features ppTOP can be injected into any running Python process [![asciicast](https://asciinema.org/a/265309.svg)](https://asciinema.org/a/265309) or you can load Python program manually and profile its launch [![asciicast](https://asciinema.org/a/265310.svg)](https://asciinema.org/a/265310) To launch a program, press *Ctrl+L* or specify *-w sec* param in command line args to start it automatically after the specified delay. Data from connected process is collected in real-time and displayed in table-based console UI, which can be easily extended with custom plugins. All data tables can be scrolled, filtered, new data collection can be paused. In case of problems, any plugin can be re-injected at any time. ## Usage To start ppTOP, type ```shell pptop ``` and then select Python process you want to inject to from the list. Alternatively, you can start it with ```shell pptop PID # or pptop PID-FILE ``` and specify the process from the command line. If you want to analyze program startup, just type ```shell pptop /path/to/program.py ``` The program will be loaded in waiting state, press *Ctrl+L* when you are ready. To get a help for the current plugin, press *F1* to display module documentation. ## Configuration Plugins and keyboard shortcuts are configured by default in *~/.pptop/pptop.yml* file (created automatically at first launch). ## Standard plugins * **asyncio** asyncio loop monitor * **atasker** [atasker](https://github.com/alttch/atasker) monitor * **env** view process OS environment variables * **log** inject into all Python loggers and collect log messages * **malloc** trace object memory allocations * **neotasker** [neotasker](https://github.com/alttch/neotasker) monitor * **open_files** view process open files * **script_runner** launch a custom scripts inside process * **threads** view process threads * **vars** variable/function watcher * **yappi** [yappi](https://github.com/sumerc/yappi) profiler plugin Most of plugins contain 2 parts of code: one collects data inside profiling process, other display it in ppTOP UI. For the profiling process all plug-ins are invisible, safe and unloadable (at least they try their best :) ## Console mode With "`" button, remote Python console can be opened. It has no full functionality like a standard Python console, but supports all frequently used features, like importing modules, defining functions and variables, executing functions and loops etc. [![asciicast](https://asciinema.org/a/265307.svg)](https://asciinema.org/a/265307) Console has own remote *globals*, which are preserved until ppTOP quit and injected server is terminated. ## Grab stdout/stderr If launched with "-g" option, ppTOP will grab stdout/stderr of injected process and print it to local console. You can view local console without entering console mode, by pressing *Ctrl+O*. ## Documentation Configuration, troubleshooting, advanced usage, plugin development: https://pptop.bma.ai/doc/ ## TODO * [ ] More plugins * [ ] Advanced filtering * [ ] Data snapshots * [ ] Step-by-step debugger * [ ] JSON API, web interface * [ ] Charts Enjoy! :) p.s. Code in **master** can be completely broken, install with *pip* only. %prep %autosetup -n pptop-0.6.15 %build %py3_build %install %py3_install install -d -m755 %{buildroot}/%{_pkgdocdir} if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi pushd %{buildroot} if [ -d usr/lib ]; then find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/lib64 ]; then find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/bin ]; then find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/sbin ]; then find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi touch doclist.lst if [ -d usr/share/man ]; then find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst fi popd mv %{buildroot}/filelist.lst . mv %{buildroot}/doclist.lst . %files -n python3-pptop -f filelist.lst %dir %{python3_sitelib}/* %files help -f doclist.lst %{_docdir}/* %changelog * Fri Jun 09 2023 Python_Bot - 0.6.15-1 - Package Spec generated