Wolf - Live Python editing for VS-Code
Wolf is a VsCode extension that enables visual inspection of live Python code from the editor. It was inspired by
Wolf is Good for:
Wolf Feature Overview
Check out variables inline
Works inside functions
And nested objects
Works with loops
Works with http requests
Relative imports and paths all just work!
What people are saying about Wolf
This extension contributes the following settings:
Can I have the text annotations in cornflower blue?
I don't see any annotations
Make sure to save the file you're working on, and that Wolf is activated. You can try stopping and starting Wolf again on the file to see if this helps.
The annotations are everywhere
Sorry, it's a feature for now. Try stopping and starting Wolf from the command menu to clear the pesky buggers.
Can my script have relative imports?
Yes. Sorry, I mean, HELL YES!
Will APIs Hate Me?
That depends. If you code reponsibly and use something like diskcache or redis to cache your calls, then you'll do just fine out there. But if you decide to just bang away at some API without some other sort of caching in place, then it's on you my friend. Having said that, Wolf will only actually run your code on document save. So you do get a small amount of throttling by default.
Here's an example using diskcache:
Wolf is stupid.. PDB is better
Honestly, if you need a real debugger, the one builtin to VSCode is
about as good as it gets. So really, please use that (or
I see Wolf as more of an exploration tool, for teachers or students in a learning environment, and definitely for streamers. You can't get any better than live feedback next to the code you're editing!
v0.3.10 ~ Patch
Fixed hunter installation and added setting for python path (Fixes contributed by @Almenon). This should
fix any remaining
v0.3.0 ~ Minor Release
No Config Setup
Wolf works in what was once called "Hot Mode" by default now. This means your live editing experience will be tuned for performance out of the box, with updating annotations on the fly.
v0.2.0 ~ Minor Release
Turn on Hot Mode to enable live reloading of code as you work. You can set the minimum frequency from the user settings if you want more control over when your file is saved/run.
Turn on Live Reloading:
Adjust minimum time between saves (throttle control) in milliseconds:
Macros are Back!!!
A comment macro is any single line comment character (pound/hash symbol) followed by a question mark. See the examples above to get a better idea of how they work, and check out the macro syntax rules below.
Completely Rewritten Codebase
Efforts have been made to improve the structure of the core Wolf extension to allow for easier updates and more powerful features in the future.
ReWritten Sticky Logic
Wolf now uses the builtin API for improving the sticky behavior of line decorations, especially while coding with Hot Reloading turned off.
Overview Ruler Markers
Annotated lines now show up in the OverView ruler panel on the left side and are color coded for easy visual grepping.
Hover over any Wolf annotation to see the value pretty printed in a popup box.
Macbook Touch-Bar Icons
Toggle Wolf on and off from the touch bar.
Wolf Paw gutter icons
v0.1.6.patch ~ Minor updates to sticky handling
Windows does not support SIGALRM so a custom decorator was provided by Almenon.
Python 3.5 Support
Newly added support for Python 3.5 was also provided by Almenon.
Thanks for contributing to Wolf, Almenon! :tada:
v0.1.4 - patch
Better sticky handling during multi-line range edits and deletions.
v0.1.3 - updates
Sticky annotations during editing
Annotations now stay attached to their line during editing and between saves. Multi line editing is supported as well. A page save is still necessary to update the values, this means the script is still only run when the file is manually saved.
v0.1.2 - updates
Colored notification icons in the gutter to aid in visual grepping of Wolf output. Error lines get a red icon while okay lines get a green icon.
Shortcut Icons now a Single Toggle Button
The shortcut icons are now a single icon that senses whether Wolf is running on the current script and updates accordingly.
v0.1.1 - updates
New shortcut buttons added to the action bar for easier starting and stopping.
Added a timeout to prevent locking and high cpu usage.
v0.1.0 - minor release
Much more stable
The previous version of Wolf would crap out a lot due to some poor choices on my part. Essentially, I tried to make it do too much too soon. I felt that stabilty should come before shiny features and have adjusted accordingly. This really shouldn't affect usability, but if you have other thoughts please let me know. That feedback is important.
Proper object printing
Things like nested lists, sets, tuples.. etc, are now printed properly. Certain structures were flattened during printing during the last version and it was pretty frustrating, this should also be fixed but feel free to let me know if you find a way to break it.
This was a quiet feature in the last release, so not totally new in 0.1.0. But it wasn't mentioned in the docs before so I'm making it official now.
* Removed - Will possibly be re-implemented in a later version
v0.0.2 - updates
Auto evaluate print statements
Wolf now automatically adds annotations for
Macros ~ Removed in 0.1.0
v0.0.1 - initial release
First release of the Wolf. :tada:
I found a bug
You mean a flea? Report any fleas in the issue tracker, please!
Can I help
That would be awesome. You can shoot me an email or submit a PR. I'm also on
The following people have contributed to Wolf:
Wolf source is available under the Apache 2.0 Software license. Any dependant libraries are subject to their own licenses and terms, the most direct of which are listed below.
Third Party Libraries