Welcome!
This is the community forum for my apps Pythonista and Editorial.
For individual support questions, you can also send an email. If you have a very short question or just want to say hello — I'm @olemoritz on Twitter.
Black Mamba - releases
-
Black Mamba 0.0.19 released:
- Fixed unused import in action picker
- Compatibility check with 3.1.1 (311009)
- Introduced
ide.scroll_to_line(line_number)
Ctrl L
Jump to line... addedCmd E
to show Drag Provider (iOS 11 & iPad only)
What's the Drag Provider all about? See this video. You must have latest Working Copy beta, iOS beta and iPad. Otherwise it will not work for you.
-
using pip install blackmamba
and then run:
#!python3 import blackmamba as bm bm.main()
Error:
ImportError: No module named 'httplib' -
@wolf71 unfortunately, there's no
pip3
in StaSh and Black Mamba is Python 3 only. As a workaround, you have to:pip remove blackmamba pip install blackmamba -d ~/Documents/site-packages-3
And ...
#!python3 import blackmamba as bm bm.main()
... must be placed in the
~/Documents/site-packages-3/pythonista_startup.py
file. Hope that helps. If not, please file an issue with more details (like how did you install it, which version was installed, pip installation console log, Pythonista version, default interpreter, ...). Thanks.And you have to use
dev
StaSh (selfupdate -f dev
).P.S. Note the
-3
suffix in installation path / python startup file path. Also I tried to reproduce your issue, but no luck (even if I change interpreter, omit-d
in thepip
command, ...). -
Black Mamba 0.0.21 released
- Code cleanup (circular deps, ...)
- Fixed analyzer where
ignore_code=None
means realNone
- Please, check sample pythonista_startup.py, breaking changes, sry
- Config option to disable keyboard shortcuts registration
It's basically clean up release, because it was quickly written, there were lot of circular deps, ... Also configuration of Black Mamba is done via dict, not via modifying module variables. And option to disable keyboard shortcuts was introduced, because I'm planning to add stuff which is useful even without external keyboard.
How to update
Pythonista console
import requests as r; exec(r.get('http://bit.ly/get-blackmamba').text)`
pip
StaSh dev (
selfupdate -f dev
).pip remove blackmamba pip install blackmamba -d ~/Documents/site-packages-3
pip update
doesn't honor-d
from previouspip install
command. Will file an issue and fix this. -
BlackMamba 0.0.22 released:
- Toggle comments improved
- Honors both tabs and spaces
- Indented
#
if line is indented - Shortest indent is used for all lines
#
if commenting multiple of them - Empty lines are ignored
- Fixed
ide.run_action
when script_name starts with/
- Toggle comments improved
-
BlackMamba 0.0.23 released:
- Jump to definition (
Cmd Shift D
)
- Jump to definition (
-
Black Mamba 0.0.24 released:
blackmamba.keyboard
module added- Pickers (open, script, ... quickly)
- Do not focus search field if HW keyboard is not connected
- Show title bar instead of custom title to allow users to close dialogs with X button
ide.scroll_to_line
optimized- Toggle comments various fixes
- Line is properly commented when there's inline comment
- Uncommented line -> whitespaces only -> 'n'
- More test coverage to avoid future bugs
-
@zrzka Thanks,it's work.
can add cmd+up cmd+down to page up and page down?
-
-
Black Mamba 0.0.25 released:
blackmamba.script
introduced and it does contain following scriptsaction_quickly.py
,analyze.py
,clear_annotations.py
,close_all_tabs_except_current_one.py
,
drag_provider.py
,jump_to_definition.py
,jump_to_line.py
,new_file.py
,new_tab.py
,
open_quickly.py
,outline_quickly.py
,run_quickly.py
,run_unit_tests.py
,search_dash.py
,
toggle_comments.py
- These scripts can be used in the wrench icon (action)
- These scripts are binded to keyboard shortcuts, whenever you run it via wrench icon
or via keyboard shortcut, same script is executed - It's still required to call
blackmamba.main
from within
~/Documents/site-packages-3/pythonista_startup.py
file to properly configure it
(even without external keyboard)
- Drag Provider uses Pythonista title bar instead of custom title to allow users to close the
the dialog without external keyboard - Unit tests (
tester.py
) moved fromblackmamba.experimental
toblackmamba
ide.run_script
andide.run_action
has new args nameddelay
, which defaults toNone
- Run Quickly & Action Quickly runs scripts with 1.0s delay and that's because
both these actions are binded to scripts in the new script folder and if there's no
delay, nothing happens if these scripts are Python 3 (basically it runs script from script,
which doesn't ended yet) - Fixed #20 (Pythonista appex error)
- Allow to run
main
- Do not check compatibility, updates
- Do not register keyboard shortcuts
- Allow to run
blackmamba.system.Pythonista
decorator has new argappex
- Defaults to
None
appex=True
- run decorated function if it's running as application extensionappex=False
- run decorated function if it's not running as application extensionappex=None
- run in both case, just don't check
- Defaults to
blackmamba.key_command.register_key_command
is decorated withPythonista(appex=False)
to avoid shortcut registration if it's running as application extension- Page Up (
Ctrl Up
) and Page Down (Ctrl Down
)
-
BTW if you've got beta version of Working Copy (build 3.0.9.16), you can use drag provider script to drag file or the folder to the Working Copy. Works flawlessly now and this version was already submitted to the app store. Will be available along with iOS 11 release. This is the only way how I commit & push now. See demonstration video.
-
Black Mamba 0.0.26 released:
- Jump to definition fixes
- Jedi - ignore definitions if there's no path & line number
blackmamba.project
trashed (replaced with Jedi, thanks to @JonB)- Jump to definition shortcut synced with Xcode (
Control Command J
) - Find usages added (
script/find_usages.py
&Control Command U
) - Show documentation (
script/show_documentation.py
&Control Command ?
)- Displayed as
success
annotation on the current line - You can clear annotation with
Cmd Shift K
(already there)
- Displayed as
- All these three featues does
jedi
now. Jedi is not thread safe and
because I had not lot of time to investigate how and when is the Jedi
used by Pythonista, I decided to disable these three features by
default. To enable them, just setgeneral.jedi
toTrue
when
passing configuration to themain
.
BTW this
.
notation is a shortcut for documentation and you have to pass
it as dictionary:config = { 'general': { 'jedi': True } } blackmamba.main(config)
-
Black Mamba 0.0.27 released:
- Drag provider trashed (
Cmd E
) - Drag & Drop introduced (
Cmd E
)- Allows bidirectional drag & drop of files & folders & repos
- List of ignored folders is configurable via
drag_and_drop.ignored_folders
, check config.py for default values - Can be used as wrench menu icon (
script/drag_and_drop.py
)
There's one limitation (will be fixed). Whenever you drop folder from Working Copy, UI isn't updated and you have to close Drag & Drop window and open it again to see this folder.
Here's demonstration video of Drag & Drop.
P.S. I did test this with latest Working Copy. You can drag file & folder from Pythoista, you can drag file & folder & repo from Working Copy. No more missed files in my commits :)
- Drag provider trashed (
-
Black Mamba 1.0.0 released:
- Development status changed to
5 - Production/Stable
- Fixed programming language classifier (Python 3.6)
- Detailed documentation available at blackmamba.readthedocs.io
- Contains About, User Guide, Reference, Contribution, Development and FAQ
- If you're just Black Mamba user, read User Guide
- If you'd like to use Black Mamba functions, read Reference
- Dialogs
- Keyboard shortcut to close dialogs (
Ctrl [
) replaced withCmd .
(Apple one) - Default width is 80% of window width (max 700)
- Default height is 80% of window height
- Keyboard shortcut to close dialogs (
- Open, run, action, ... dialogs
- Properly sorted items (by lowercased file names)
- Filtering works on folders too
bl __init
matches any file where full path does containbl
and__init
- Folders up to
~/Documents
are not matched, only subfolders of~/Documents
- Drag & Drop
- New way how a folder / file is provided
- Works with Kaleidoscope for example
- Still compatible with Working Copy
- All opened files are listed in the dialog
- Open Quickly
- If file is already opened, tab with file is selected
- Find usages
- It actually did show definitions instead of usages, fixed
- Some other bugfixes I can't recall now
And 1.0.1:
- Fixed unit tests annotations
And 1.0.2:
- Fixed Black Mamba for stable Pythonista version (Python 3.5)
Here's the gallery if you'd like to know what is this all about. Gallery is included in latest docs, not stable ones. Will be included in stable docs when the next version will be released.
- Development status changed to
-
Black Mamba 1.1.0 released:
- Dropped PyPI packaging
- Black Mamba provides own / updated modules to provide new functionality
- This is not compatible with
pip
at all, thus this installation method is no longer supported - Latest Black Mamba release in PyPI is 1.0.2
- Find usages contains symbol name in the dialog title
- Jump to definition contains symbol name in the dialog title
- Show documentation contains symbol name in the dialog title
tab.open_file
has newline
argument- Jump to definition, Find usages utilizes
tab.open_file
instead ofeditor
's one
- Jump to definition, Find usages utilizes
- Analyze script does use bundled
flake8
,mccabe
, ...- See documentation to check how to configure it
- First pass defaults are
['--select=E901,E999,F821,F822,F823']
- Second pass defaults are
['--max-complexity=10', '--max-line-length=127']
- Open quickly, ... filter is case insensitive
P.S. This bundled
flake8
, ... means that you can analyze your code even with f-strings likef'Hallo {sender.title}'
, etc. - Dropped PyPI packaging
-
Is it possible for the users who do not have external keyboard to use the sidebar menu (see the link below) for running your scripts?
https://forum.omz-software.com/topic/3543/share-in-work-side-bar-replacement -
Black Mamba 1.2.0 released:
.uikit.overlay
introduced which allows Black Mamba to display information as overlays- Overlays are Pythonista app overlays (visible in editor, console, ...)
.ide.theme
introduced to get some theme functionality- Show documentation script leverages new overlays
- Overlay can be closed via
Ctrl W
shortcut - Overlay can be moved (title bar)
- Overlay can be resized (drag bottom left/right corner)
- Script is configurable, see docs
- See screenshot (reuse disabled)
- Overlay can be closed via
P.S. If you don't see a new screenshot in the gallery (one with overlays), just force reload the page / image.
@enceladus please, use another topic for questions (see first post). Thanks. I don't know what the sidebar menu is, but I also don't see a reason why it wouldn't be possible. Just run them in the same way as Black Mamba does.
-
Black Mamba 1.2.1 released:
- Bundled packages links and licenses
ide.run_script
respectsdelay
argument (did contain hardcoded value)- Analyze script documentation mentions
flake8
- Drag & Drop script
- Children nodes are lazy-loaded (faster)
- Dropped folder reloads ...
- Target row if not expanded (to display triangle)
- Children nodes (dropped folder appears if it didn't exist before drop)
- Show documentation
- Do not show picker / docstring if symbol was found, but it has no docstring
-
Black Mamba 1.2.2 released:
- Bundled
lib/pep8
removed, unused - Fixed
get_actions
(exception when user has no custom actions) - Pythonista 3.1.1 (311013)
- Compatibility check with 311013
- Shortcuts
Cmd W
,Ctrl Tab
,Ctrl Shift Tab
no longer work (1) - Shortcuts
Cmd 1..9
,Cmd Shift ]
,Cmd Shift [
,Cmd Shift W
still work
(1) Pythonista 311013 provides these shortcuts natively. Unfortunately, they do not work. Also these shortcuts are provided elsewhere in the responder chain, so, even if I register them via the Black Mamba, responder chain catches them sooner then Black Mamba and they do not work.
All these shortcuts do work prior to 311013. If you have 311013 installed, you can use
Cmd Q
to close tab (temporary) andCmd Shift ]
/Cmd Shift [
to show next / previous tab.P.S. User documentation is not updated (for
Cmd Q
), because it's a temporary workaround. I do expect that these shortcuts (Cmd W
, ...) will be fixed in the Pythonista and thenCmd Q
will be removed. - Bundled
-
Black Mamba 1.3.0 released:
- Pythonista 3.1.1 (311014)
- Compatibility check with 311014
- Shortcuts
Cmd W
,Ctrl [Shift] Tab
work
- Trashed
Cmd Q
shortcut (workaround for 311013) - Open Quickly supports File System Provider bookmarks
- You can search / open files added to Pythonista via
Open...
(External files) - These files are added as bookmarks (iOS terminology)
- If cell subtitle starts with
Documents
, it's a file from~/Documents
- If cell subtitle starts with
Bookmark
, it's a file from FSP
- You can search / open files added to Pythonista via
- Pythonista 3.1.1 (311014)