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

mwx/framework.py

@@ -1,7 +1,7 @@
 #! python3
 """mwxlib framework.
 """
-__version__ = "0.98.5"
+__version__ = "0.98.6"
 __author__ = "Kazuya O'moto <komoto@jeol.co.jp>"
 
 from contextlib import contextmanager
@@ -1278,7 +1278,6 @@ class ShellFrame(MiniFrame):
             self.Scratch.buffer.eval_line()
             evt.Skip(False) # Don't skip explicitly.
         
-        @self.Scratch.define_key('C-S-j')
         @self.Scratch.define_key('M-j')
         def eval_buffer(evt):
             self.Scratch.buffer.exec_region()

mwx/nutshell.py

@@ -875,19 +875,6 @@ class EditorInterface(AutoCompInterfaceMixin, CtrlInterface):
                 q = self.cpos
             return self.GetTextRange(p, q)
     
-    def gen_text_at_caret(self):
-        """Generates the selected text,
-        otherwise the line or expression at the caret.
-        """
-        def _gen_text():
-            text = self.SelectedText
-            if text:
-                yield text
-            else:
-                yield self.line_at_caret
-                yield self.expr_at_caret
-        return filter(None, _gen_text())
-    
     ## --------------------------------
     ## Python syntax and indentation
     ## --------------------------------
@@ -2064,6 +2051,19 @@ class Buffer(EditorInterface, EditWindow):
         dispatcher.send(signal='Interpreter.push',
                         sender=self, command=None, more=False)
     
+    def gen_text_at_caret(self):
+        """Generates the selected text,
+        otherwise the line or expression at the caret.
+        """
+        def _gen_text():
+            text = self.SelectedText
+            if text:
+                yield text
+            else:
+                yield self.line_at_caret
+                yield self.expr_at_caret
+        return filter(None, _gen_text())
+    
     def eval_line(self):
         self.py_eval_line(self.globals, self.locals)
     
@@ -2853,10 +2853,8 @@ class Nautilus(EditorInterface, Shell):
            'C-S-insert pressed' : (0, _F(self.Paste, rectangle=1)),
                   'C-j pressed' : (0, self.eval_line),
                   'M-j pressed' : (0, self.exec_region),
-                'C-S-j pressed' : (0, self.exec_region),
                   'C-h pressed' : (0, self.call_helpTip),
                   'M-h pressed' : (0, self.call_helpDoc),
-                'C-S-h pressed' : (0, self.call_helpDoc),
                     '. pressed' : (2, self.OnEnterDot),
                   'tab pressed' : (1, self.call_history_comp),
                   'M-p pressed' : (1, self.call_history_comp),
@@ -3610,6 +3608,20 @@ class Nautilus(EditorInterface, Shell):
         self.cpos, self.anchor = self.anchor, self.cpos
         self.EnsureCaretVisible()
     
+    def gen_text_at_caret(self):
+        """Generates the selected text,
+        otherwise the line or expression at the caret.
+        (override) Generates command line (that starts with a prompt).
+        """
+        def _gen_text():
+            text = self.SelectedText
+            if text:
+                yield text
+            else:
+                yield self.getCommand() # self.line_at_caret
+                yield self.expr_at_caret
+        return filter(None, _gen_text())
+    
     def eval_line(self, evt):
         """Evaluate the selected word or line."""
         if self.CallTipActive():

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.5.dist-info → mwxlib-0.98.6.dist-info}/RECORD

@@ -1,14 +1,14 @@
 mwx/__init__.py,sha256=nN62CGTWjME7Zz2h-jIRB8MxwuErIkHPGrlBzydkF0o,643
 mwx/bookshelf.py,sha256=Y4xI2SrEO22DrI1hyyfFx7DfFZA8znOzX9RWMPsA2BE,5137
 mwx/controls.py,sha256=jhru4HiIijb3QJz2elGt0in9soaR3xilgHsfItYY0JI,47595
-mwx/framework.py,sha256=I4Hvu2swHbgvbjqVXNnuU2V8kkxKmK6eRktqQa5D0cE,75518
+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=3hS0ilXCif0mZkSufE_Rf-taRs3m1hIxiIFMuioYYuc,64371
 mwx/matplot2lg.py,sha256=JRWjWnLJUytbSq6wxs4P0gbVUr3xoLSF6Wwqd5V_pJI,27404
 mwx/mgplt.py,sha256=r56SFryorIgO12mvHJY-z6uwWsaPEqk6pHYwKWqbTY4,5663
-mwx/nutshell.py,sha256=vz3RTrIECi9LpjgAj2jKAIjMCeJ7ZvJ8mbH3phBxuvg,141423
+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
@@ -21,8 +21,8 @@ mwx/plugins/frame_listview.py,sha256=hbApzZWa9-BmQthu7uZBlBbGbtf4iJ_prO8IhxoGMs8
 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.5.dist-info/LICENSE,sha256=PGtRKCaTkmUDlBQwpptJAxJtdqxIUtAmdBsaT9nUVkA,1091
-mwxlib-0.98.5.dist-info/METADATA,sha256=nGXEgL3ckNH2HlXpYXQsjteMpc8MhQWDZ_5DtjAtp2A,1880
-mwxlib-0.98.5.dist-info/WHEEL,sha256=HiCZjzuy6Dw0hdX5R3LCFPDmFS4BWl8H-8W39XfmgX4,91
-mwxlib-0.98.5.dist-info/top_level.txt,sha256=SI1Mh118AstnUFGPNq5aMNKiAnVNmZk1S9Ij-OwAEpY,4
-mwxlib-0.98.5.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.5.dist-info → mwxlib-0.98.6.dist-info}/WHEEL

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

mwxlib-0.98.5.dist-info/METADATA

@@ -1,54 +0,0 @@
-Metadata-Version: 2.1
-Name: mwxlib
-Version: 0.98.5
-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.