mwxlib 0.98.1__py3-none-any.whl → 0.98.6__py3-none-any.whl

mwxlib-0.98.6.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.1
+Name: mwxlib
+Version: 0.98.6
+Summary: A wrapper of matplotlib and wxPython (phoenix)
+Home-page: https://github.com/komoto48g/mwxlib
+Author: Kazuya O'moto
+Author-email: komoto@jeol.co.jp
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: wxpython >=4.2.0
+Requires-Dist: matplotlib
+Requires-Dist: opencv-python
+Requires-Dist: scipy
+
+# mwxlib
+
+Welcome to mwxlib project!
+Python package based on matplotlib/wx and wxPython shell extension library
+
+See [Demo Script and Gallery](./demo/readme.md).
+
+
+## Getting Started
+
+These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
+
+### Prerequisites
+
+- ~~Python 2.7~~ (PY2 support has ended since 0.50)
+- ~~Python 3.5~~ (PY35 support has ended since 0.70)
+- ~~Python 3.7~~ (PY37 support has ended since 0.80)
+- Python 3.8 -- 3.9 (deprecated since 0.90)
+    - wxpython >= 4.1.1
+    - numpy
+    - pillow
+    - matplotlib
+    - opencv-python
+- Python 3.10 -- 3.11
+    - wxpython >= 4.2.1
+    - numpy
+    - pillow
+    - matplotlib
+    - opencv-python
+- Python 3.12
+    - A version of wxpython for PY312 has not yet released on PyPi.
+        * You can download the snapshot from https://wxpython.org/Phoenix/snapshot-builds/,
+        * or the latest snapshot from Azure Pipelines https://alldunn.visualstudio.com/wxPython-CI/_build?definitionId=2&_a=summary
+
+
+### Installing
+
+To install, type:
+```
+pip install mwxlib
+```
+To install latest version from GitHub, type:
+```
+pip install git+https://github.com/komoto48g/mwxlib.git
+```
+
+### How to use
+
+mwx.deb is wx.py.shell-base inspector used for debugging in the target process.
+```
+>>> import mwx; mwx.deb()
+```
+
+:memo: mwxlib creates "~/.mwxlib/" in your *HOME* directory.
+This includes history, logs, dump files used to check when an error occurs.
+
+:memo: At the first startup, it takes some time to collect module information and create a dictionary file.
+The collected module name is used for completion at the time of input in the shell.
+(If you start the shell while pressing [C-S-], the dictionary file will be recreated)
+
+As you are diving into the python process, you can watch, inspect, and debug the target.
+
+Enjoy diving!
+
+### Uninstalling
+```
+pip uninstall mwxlib
+```
+
+
+# Features
+
+![intro](./demo/images/demo-shell.gif)
+The animation shows how the Nautilus works, which is embedded in a simple PyEditor app.
+
+As you are diving into the python process,
+you can watch, inspect, and change everything in the target.
+
+
+## Nautilus in the Shell
+
+The framework has an extended class based on wx.py.shell.Shell named Nautilus,
+which has the following features:
+
+1. Auto-completion and apropos functions are reinforced.
+    - [1] history-comp-mode
+    - [2] word-comp-mode
+    - [3] apropos-comp-mode
+    - [4] text-comp-mode
+    - [5] module-comp-mode
+2. Magic syntax.
+    - [ ` ] quoteback
+    - [@] pullback
+3. Powerful inspectoin utilities.
+    - Filling
+    - InspectionTool
+    - Ghost in the shell
+
+**All objects in the process can be accessed using:**
+```
+    self : the target of the shell,
+    this : the module which includes target.
+```
+
+**To include the shell in your wxPython application:**
+```
+>>> self.inspector = mwx.ShellFrame(self, target=self)
+```
+
+
+## Autocomp key bindings
+
+        C-up : [0] retrieve previous history
+      C-down : [0] retrieve next history
+    C-j, M-j : [0] tooltip of eval (for the selected or focused word)
+    C-h, M-h : [0] calltip of help (for the selected or focused func)
+         TAB : [1] history-comp-mode
+         M-p : [1] retrieve previous history in comp-mode
+         M-n : [1] retrieve next history in comp-mode
+         M-. : [2] word-comp-mode
+         M-/ : [3] apropos-comp-mode
+         M-, : [4] text-comp-mode
+         M-m : [5] module-comp-mode
+  * All completions [1--5] are incremental when pressed any alnums, and decremental when backspace.  
+See [key bindings](key-bindings.md) for more information.
+
+
+## Magic syntax
+
+  - quoteback : ```x`y --> y=x  | x`y`z --> z=y=x```
+
+  - pullback : ```x@y --> y(x) | x@y@z --> z(y(x))```
+
+  - apropos : ```x.y? [not] p => shows apropos &optional (not-)matched by p:predicates```
+                equiv. apropos(y, x [,ignorecase ?:True,??:False] [,pred=p])
+                y can contain regular expressions.
+                    (RE) \\a:[a-z], \\A:[A-Z] can be used in addition.
+                p can be ?atom, ?callable, ?instance(*types), and
+                    predicates imported from inspect
+                    e.g., isclass, ismodule, ismethod, isfunction, etc.
+  
+  * info :  ?x --> info(x) shows short information
+  * help : ??x --> help(x) shows full description
+  * sx   :  !x --> sx(x) executes command in external shell
+    
+    Note: The last three (*) are original syntax defined in wx.py.shell,
+    at present version, enabled with USE_MAGIC switch being on
+
+
+## built-in utilities
+
+    @p          : Synonym of print.
+    @pp         : Synonym of pprint.
+    @mro        : Display mro list and filename:lineno.
+    @where      : Display filename:lineno.
+    @info       : Short info.
+    @help       : Full description.
+    @load       : Load a file in Log.
+    @dive       : Clone the shell with new target.
+    @debug      : Open pdb debugger or event monitor.
+    @watch      : Watch for events using event monitor.
+    @timeit     : Measure CPU time (per one execution).
+    @profile    : Profile a single function call.
+    @highlight  : Highlight the widget.
+    @filling    : Inspection using ``wx.lib.filling.Filling``.
+
+
+## Ghost in the shell
+
+Ghost in the shell is the help system for divers,
+which is a notebook-style window consists of four editors:
+- scratch buffer
+    + a temporary buffer
+- Help buffer
+    + piping text from info(?) and help(??)
+- Logging buffer
+    + logging debug process and the input-history
+
+
+# Authors
+
+* Kazuya O'moto - *Initial work* -
+
+See also the list of who participated in this project.
+
+
+# Attribution
+
+Default icons are provided by `wx.ArtProvider`.
+Optional icons are provided by:
+
+- [famfamfam: Silk icons](http://www.famfamfam.com/lab/icons/silk/) designed by Mark James.
+- [Tango desktop project](http://tango.freedesktop.org/Tango_Desktop_Project).
+- [Iconify - Freedom to choose icons](https://iconify.design/).
+
+Note:
+    Other icons could be attributed to other open sources.
+    This is a mish-mash of stuff from all over the internet.
+    If I missed an author credit or attribution, please let me know.
+
+
+# License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details

{mwxlib-0.98.1.dist-info → mwxlib-0.98.6.dist-info}/RECORD

@@ -1,28 +1,28 @@
 mwx/__init__.py,sha256=nN62CGTWjME7Zz2h-jIRB8MxwuErIkHPGrlBzydkF0o,643
 mwx/bookshelf.py,sha256=Y4xI2SrEO22DrI1hyyfFx7DfFZA8znOzX9RWMPsA2BE,5137
-mwx/controls.py,sha256=K4GJB81TXv5q0faTELQgbUmtMQBRIM9yINJdTI0xA3g,47556
-mwx/framework.py,sha256=xSh2cxTyg6SHU3jh9cGTaiC2u7teJPJwRuFrmEfSXiQ,75509
-mwx/graphman.py,sha256=Cyhl_Da_HGBfk721gu1r5iwSH9L3yPEG8Fzmc2gx-EU,70462
+mwx/controls.py,sha256=jhru4HiIijb3QJz2elGt0in9soaR3xilgHsfItYY0JI,47595
+mwx/framework.py,sha256=rp93Nh7eqeAWGpkjxp-NY84RYBfmI1Ahn_tauavWSbg,75475
+mwx/graphman.py,sha256=A53ufapRAysL0wTCr1anrg_T_PqpumonnYn-swaC598,70165
 mwx/images.py,sha256=_-Eh3xF7Khu42ivkYp97NXIzSNGbjcidqtWjZQFGtqE,47827
 mwx/matplot2.py,sha256=xCJ_ZzdDEWmzctpPaOrzTnwXyHINP4nfFHweoTZa6ug,32899
-mwx/matplot2g.py,sha256=wiZFDFuQe3ax71fmyeR_9hvAmgT-4nVfZ30UByv8Nv8,64379
+mwx/matplot2g.py,sha256=3hS0ilXCif0mZkSufE_Rf-taRs3m1hIxiIFMuioYYuc,64371
 mwx/matplot2lg.py,sha256=JRWjWnLJUytbSq6wxs4P0gbVUr3xoLSF6Wwqd5V_pJI,27404
-mwx/mgplt.py,sha256=ITzxA97yDwr_35BUk5OqnyskSuKVDbpf2AQCKY1jHTI,5671
-mwx/nutshell.py,sha256=nTEKmJ0CMqkVtbmIlDHvZDpkUjefgL6QbxMZKwbZpIk,141553
-mwx/utilus.py,sha256=mmqB4P_3mTi7SrFleMiN1599Jm0Us0XKnNA6v2xglSs,37333
+mwx/mgplt.py,sha256=r56SFryorIgO12mvHJY-z6uwWsaPEqk6pHYwKWqbTY4,5663
+mwx/nutshell.py,sha256=9SjAwZB0NkSe7K-REBXEaqYwgML7JVKbp2HkI6cLM54,141807
+mwx/utilus.py,sha256=B76pDg6_kW8FMNdQ6xO0Bwy4KJ0laY98Gg6N3iqV7c8,37325
 mwx/wxmon.py,sha256=f3V24EF7kdMlYF7usLYK9QE5KU6fSu0jVqsvwAiA-Ag,12647
 mwx/wxpdb.py,sha256=lLowkkAgMhPFHAfklD7wZHq0qbSMjRxnBFtSajmVgME,19133
 mwx/wxwil.py,sha256=hhyB1lPrF9ixeObxCOKQv0Theu-B-kpJg_yVU3EGSNg,5406
 mwx/wxwit.py,sha256=ifxMwdIz-QhDEr8vyAztToF8VVSxKNXlq4Ap1awBZvo,7362
 mwx/plugins/__init__.py,sha256=jnJ-Sl9XJ_7BFDslD_r7dsbxsOT57q_IaEriV53XIGY,41
-mwx/plugins/ffmpeg_view.py,sha256=1s7QqIbOpqNrSwbNoc4wQQNo8o1ho5JfXLuseAhgzK4,10441
+mwx/plugins/ffmpeg_view.py,sha256=epO_26sPmdDyr_lApa2Jtgxp-yCEdW0OEz0_QbrFEuM,10427
 mwx/plugins/fft_view.py,sha256=xxTDD-_z4l18u4t2ybPB3xAMIslJmJ0gQlTxEqJUhNI,2782
 mwx/plugins/frame_listview.py,sha256=hbApzZWa9-BmQthu7uZBlBbGbtf4iJ_prO8IhxoGMs8,10421
 mwx/plugins/line_profile.py,sha256=--9NIc3x5EfRB3L59JvD7rzENQHyiYfu7wWJo6AuMkA,820
 mwx/py/__init__.py,sha256=xykgfOytOwNuvXsfkLoumFZSTN-iBsHOjczYXngjmUE,12
 mwx/py/filling.py,sha256=fumUG1F5M9TL-Dfqni4G85uk7TmvnUunTbdcPDV0vfo,16857
-mwxlib-0.98.1.dist-info/LICENSE,sha256=PGtRKCaTkmUDlBQwpptJAxJtdqxIUtAmdBsaT9nUVkA,1091
-mwxlib-0.98.1.dist-info/METADATA,sha256=XcUcwip9zlP_OGddgjt4s8fHdRvz7pGU-y1NS1t4kXg,1880
-mwxlib-0.98.1.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-mwxlib-0.98.1.dist-info/top_level.txt,sha256=SI1Mh118AstnUFGPNq5aMNKiAnVNmZk1S9Ij-OwAEpY,4
-mwxlib-0.98.1.dist-info/RECORD,,
+mwxlib-0.98.6.dist-info/LICENSE,sha256=PGtRKCaTkmUDlBQwpptJAxJtdqxIUtAmdBsaT9nUVkA,1091
+mwxlib-0.98.6.dist-info/METADATA,sha256=RDfB4NPf48FHJKeGXjSM72yYzMlOlrs5nqqPqO45ToU,7411
+mwxlib-0.98.6.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+mwxlib-0.98.6.dist-info/top_level.txt,sha256=SI1Mh118AstnUFGPNq5aMNKiAnVNmZk1S9Ij-OwAEpY,4
+mwxlib-0.98.6.dist-info/RECORD,,

{mwxlib-0.98.1.dist-info → mwxlib-0.98.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (73.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

mwxlib-0.98.1.dist-info/METADATA

@@ -1,54 +0,0 @@
-Metadata-Version: 2.1
-Name: mwxlib
-Version: 0.98.1
-Summary: A wrapper of matplotlib and wxPython (phoenix)
-Home-page: https://github.com/komoto48g/mwxlib
-Author: Kazuya O'moto
-Author-email: komoto@jeol.co.jp
-License: MIT
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Scientific/Engineering :: Image Processing
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-License-File: LICENSE
-Requires-Dist: wxpython
-Requires-Dist: matplotlib
-Requires-Dist: opencv-python
-Requires-Dist: scipy
-
-Project description
-===================
-
-Welcome to mwxlib project!
-The mwxlib is the Python package based on matplotlib/wx and wxPython shell extension.
-
-For more information please refer to the `Readme file <https://github.com/komoto48g/mwxlib>`_ and demos.
-
-
-How to use
-----------
-
-mwx.deb is wx.py.shell-base inspector used for debugging in the target process.
-
->>> import mwx; mwx.deb()
-
-It is very easy to include the shell in your wxPython application.
-
->>> self.inspector = mwx.ShellFrame(self, target=self)
-
-As you are diving into the python process, you can watch, inspect, and debug the target.
-
-Enjoy diving!
-
-:memo:
-    mwxlib creates ~/.mwxlib/ in your home directory.
-    This includes history, logs, dump files used to report when an error occurs.
-
-:memo:
-    At the first startup, it takes some time to collect module information and create a dictionary.
-    The collected module name is used for completion at the time of input in the shell.
-    If you start the shell while pressing [C-S-], the dictionary will be recreated.