You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: CHANGELOG.md
+21
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,26 @@
1
1
# Changelog
2
2
3
+
## [Unreleased]
4
+
5
+
### Added
6
+
7
+
* upgrades in the paste back query where it can now support surrounded punctuation.
8
+
9
+
* the module delete alternatives has been added.
10
+
11
+
* View information now also exposes they get regions sublime API
12
+
13
+
* The interface module now has a clear_actions methods to flush the already pushed actions.
14
+
15
+
### Fixed
16
+
17
+
* fixed an important bug in the insertion query module. the writing positions were sorted, but on an ascending order which simply broke everything when there are multiple of them. Fix this to sort them in descending order, so the changes that are executed first do not affect the others.
18
+
19
+
### Changed
20
+
21
+
* the application module has been adopted, sought after selection queries we do not only store that arraigns corresponding to the main result in the alternative but we also keep the corresponding text.
22
+
23
+
* the paste back query now reads the corresponding text directly from the state instead of getting their location and obtaining from the code as it did in the past
PythonVoiceCodingPlugin is a Sublime Text 3 plugin meant to enhance user experience
16
16
when coding python 3 by voice.
17
17
18
-
18
+
19
19
20
20
21
-
## Update
21
+
## Contents
22
22
23
-
Release 0.0.5 he's out fixing problems of 0.0.4 regarding the installation via package control and adds a useful utilities under Preferences > Package Settings > PythonVoiceCodingPlugin iincluding links to online documentation issues, grammar bundles and so on. It is meant to be only temporary i'm currently wrapping up the development of 0.1.0. Also you should know that Caster 1.x.x is also supported but you must enable it by saying
23
+
<!-- MarkdownTOC autolink="true" -->
24
+
25
+
-[Documentation](#documentation)
26
+
-[Motivation](#motivation)
27
+
-[Release and Version](#release-and-version)
28
+
-[Limitations](#limitations)
29
+
-[Installation](#installation)
30
+
-[Package Control](#package-control)
31
+
-[note for those who installed between 0.0.4 and 0.0.5](#note-for-those-who-installed-between-004-and-005)
32
+
-[Git Install](#git-install)
33
+
-[Support for voice coding framework](#support-for-voice-coding-framework)
if you have any problem or questions regarding installation , whether of the plug-in itself or the grammar necessary to use it please let me know at my issues!
30
43
31
44
32
-
you can now also install via package control, see installation instructions [below](#installation)
33
45
34
46
## Documentation
35
47
36
-
Documentation is available [here](doc/README.md)
48
+
Documentation is available [here](doc/README.md) you can also find links to documentation under
@@ -44,14 +61,14 @@ with [Caster](https://github.com/dictation-toolbox/Caster). Despite the excelle
44
61
In particular, navigation through the code sometimes felt a little bit too mechanistic. Say for instance you want to go to some location or select some text. For the most part ,you are describing what actions
45
62
need to be taken to get there. What if you could instead simply describe (syntactically) what you want to select?
46
63
47
-
64
+
48
65
49
66
PythonVoiceCodingPlugin tries to enable you to do just that!
50
67
To provide this functionality, it ships with bundles the implement a grammar, hopefully expressive enough for describing regions of interest, while running on the voice coding macro system side. These bundles
51
68
cooperate with the core plugin, running on the editor side, arguably the more suitable of the two environments
52
69
for analyzing source code and decoding the meaning of queries within the given context.
53
70
54
-
71
+
55
72
56
73
57
74
I want to be honest. This is not exactly the best code ever written. It is far from it:) And it is far from the full functionality i would want it to offer. Nonetheless, I still think that PythonVoiceCodingPlugin is a tool that :
@@ -76,7 +93,7 @@ I want to be honest. This is not exactly the best code ever written. It is far f
76
93
* is partly customizable. If you find yourself using certain commands with some given parameters often and want a shorthand smaller command, you can always follow my commented banana example:)
77
94
78
95
79
-
96
+
80
97
81
98
As I said, far (really far) from perfect but nonetheless an out-of-the-box solution which I hope to be helpful ,especially for beginners to get up to speed , and a step towards the right direction. I hope you enjoy using it as much as I have enjoyed coding it:)
82
99
@@ -85,15 +102,9 @@ Needless to say, while coding PythonVoiceCodingPlugin , PythonVoiceCodingPlugin
85
102
## Release and Version
86
103
87
104
The code is available on [github](https://github.com/mpourmpoulis/PythonVoiceCodingPlugin)
88
-
along with its initial release (0.0.0)!
89
105
90
-
### Update 0.0.5
106
+
The latest release is 0.1.0!
91
107
92
-
Release 0.0.5 he's out fixing problems of 0.0.4 regarding the installation via package control and adds a useful utilities under Preferences > Package Settings > PythonVoiceCodingPlugin
93
-
94
-
Update: release 0.0.2 is out and with many thanks to @LexiconCode there are now bundles for Caster 0.6.11!
95
-
Update: Due an important error I missed, you might be faced with a situation where the pluggin cannot load and thus no commands are executed. in such a case please upgrade to release 0.0.3 which fixes it. I am sorry for any disconvenience caused!
96
-
Update: release 0.0.4 is out shipping with aenea support.
97
108
98
109
## Limitations
99
110
@@ -116,7 +127,7 @@ There are currently two installation methods for performing the first task
116
127
117
128
### Package Control
118
129
119
-
Release 0.0.5 fixes the errors that prevented 0.0.4 from installing directly from package control. You can now install the package simply by
130
+
Release 0.0.5 fixed the errors that prevented 0.0.4 from installing directly from package control. You can now install the package simply by
they are available grammars for Caster 0.5.11,0.6.11 as well as >=1.0.0 with many thanks to [LexiconCode](https://github.com/LexiconCode)!
203
214
204
-
It is my highest recommendation if you are using older versions of Caster that you upgrade to the latest master. Sooner or later the plug-in is going to drop support for those older versions and either way the newer version has a lot of improvements!
215
+
It is my highest recommendation if you are using older versions of Caster that you upgrade to the latest one. Sooner or later the plug-in is going to drop support for those older versions and either way the newer version has a lot of improvements!
205
216
206
217
Regarding operating system support, the plug-in has been tested both on Windows 10 and on Ubuntu 16.04 as release 0.0.4 introduced support for [aenea](https://github.com/mpourmpoulis/PythonVoiceCodingPlugin/blob/master/bundles/Aenea/README.md)!
207
218
208
219
220
+
Also note that if you are using the latest version of Caster, you must also enable the grammar by saying
209
221
210
-
211
-
212
-
213
-
214
-
215
-
### Long version:
216
-
217
-
Ok this can get a little bit complicated because there is a variety of operating systems, speech recognition backends, macro systems and toolkits built upon them which may or may not introduce complications. To give you an example lets see a few cases of how Caster with Dragon Naturally Speaking can be used:
218
-
219
-
- everything native in Windows
220
-
221
-
- in combination with aenea on linux host with windows guest where dragon is running and keystrokes are send to the host via rpc commands
222
-
223
-
- linux guest receiving keystrokes from pure dragonfly windows host
224
-
225
-
- oh and what about that linux guest receiving aenea rpc from windows host?:)
226
-
227
-
228
-
229
-
To understand why all this may become an issue, we need to take a look at how communication between dragonfly and the plugin works.
230
-
231
-
232
-
Probably by far the most convenient way is via sublime comand line interface. This is the default method used. For example after a command of the form
233
-
234
-
```python
235
-
"[smart] [<adjective>] argument <argument_index>"
236
222
```
237
-
like
238
-
239
-
```
240
-
"first argument 2"
241
-
```
242
-
243
-
The script invokes the subl cli tool with a command like that:
So effectively we trigger the command our plugin provides in its top file and pass information about the type of query we want and the parameters we used as a dict encoded as a json string.
255
225
256
-
Of course this does not work across virtual machine barriers:)
257
-
258
-
To counter this issue the simplest idea, which involves only keystrokes, is to open with some key command sublime console and using a text command to invoke the PythonVoiceCodingPlugin command from the command line. But
259
-
from my experience this is often way to slow if there are a lot of parameters to pass and messes up with user-interface, as it opens up the console.
260
-
261
-
So this is not implemented, even though it does not need custom rpc.
262
-
263
-
264
-
For the time being I have bundles for 0.5.11 release of Caster that work as expected on Windows 10 64bit.
265
226
266
227
267
228
@@ -309,6 +270,8 @@ Many thanks to the contributors and maintainers of the following pypi packages:
309
270
310
271
For specific versions be sure to check the requirements.txt
311
272
273
+
For their licensees check out the dedicated [file](https://github.com/mpourmpoulis/PythonVoiceCodingPlugin/blob/master/DEPENDENCES_LICENSE.md)
274
+
312
275
## Acknowledgements
313
276
314
277
### Useful Learning Resources
@@ -336,10 +299,23 @@ Many thanks to all of the developers that have put their time and effort behind
336
299
337
300
* Natlink
338
301
339
-
* Dragonfly
302
+
* Dragonfly and [Dragonfly2](https://github.com/dictation-toolbox/dragonfly)
340
303
341
304
* Caster
342
305
343
306
307
+
also some of the other tools I found useful developing this project
0 commit comments