Since I have no other way how to inform users about new Black Mamba features, I decided to create this topic. I will only post info about new releases here. Nothing else, to keep it short.
Thanks!
Black Mamba 0.0.12 released:
pyflakes & pep8 code style checksbm.settings.ANALYZER_* variablesCmd Shift K shortcut introduced - Clear AnnotationsBlack Mamba 0.0.13 released:
flake8 report, down to zero nowbm.settings...)Black Mamba 0.0.14 released:
# (hash space) instead of just # (#12)Ctrl Tab (or Cmd Shift ]) selects next tabCtrl Shift Tab (or Cmd Shift [) selects previous tabCmd 1..9 selects specific tabEXPERIMENTAL
Cmd U to run unit tests. Using pytest directly, because I'd like to add more unit tests features like - run unit tests for the whole package, file, test in a file, ... Works for the file now, but it has issues with some global states, reloading, ...
Black Mamba 0.0.15 released:
Installation
If you have already Black Mamba installed, remove it. Then open console, issue ...
import requests as r; exec(r.get('http://bit.ly/get-blackmamba').text)
... and that's it. GitHub installation is not user friendly and PyPI doesn't work.
Breaking Changes
Check pythonista_startup.py sample how to configure Black Mamba a how to start it. You have to call main() and that's all you have to do. Minimum is:
import blackmamba as bm
bm.main()
Why?
It's based on GitHub releases. These releases will be stable, master branch is not stable at all.
Black Mamba 0.0.16 released:
log.info (.error, .warn)bm.log.level allows to set logging level (default INFO)You can install / update it with with:
import requests as r; exec(r.get('http://bit.ly/get-blackmamba').text)
@zrzka , I have had little time the last few days. A lot of overseas guests. But just installed 0.0.16. Very nice. I love the Analyse and combined check. I am still using the git pull to do upgrades. Is this the preferred method, or is itr better to switch to the requests statement?
@Phuket2 depends ... The only mandatory thing is to place GitHub's blackmamba folder into site-packages-3. That's it. The difference between git & installer is ...
git
master branch is not stable, it can brake thingsv0.0.16, etc.)installer
~/Documents/site-packages-3/blackmamba/.release.json) and check for updates regularly (during Pythonista startup)You can look at updates.check for more details.
IMO installer is more friendly if you do not want to develop it, because I'm going to add updater as well.
I'll put PyPI back when it starts working, because this is the most preferred way of installation. Sadly it doesn't work.
Also, please, discuss in another topic, this is just for releases. See the first post. Thanks for understanding.
Black Mamba 0.0.18 released:
system.Pythonista and system.iOS decorators to limit functionsCmd Shift L) introducedOutline Quickly mimicks Pythonista outline (Cmd L), but allows node filtering. On the other side, it does not contain annotations (yet).
Would it be possible to put this stuff into https://github.com/zrzka/blackmamba/releases ?
As someone who does not use an external keyboard with Pythonista, I find much of this discussion to be off topic. Is it just me or do others agree?
I do not use Xcode Template for example, I find much of it to be off topic for me. Others do use Xcode Template, they don't consider it off topic, they're reading it, participating, ... So, I simply don't read Xcode Template related threads.
I understand that this thread can be off topic for some people, but for some of them not. Just don't read it as I or others don't read Xcode Template topics.
P.S. I have nothing against Xcode Template, it's just an example :)
@ccc , i dont agree. I normally agree with you. Sorry, in this case I dont. @zrzka has put a lot of effort into this and it works great. For those who use ext keyboards, its a gift from god. There are many subjects in Pythonista i have no interest in, I just skip them. No disrespect to you, but i think this is a great project. It's easy to skip over if you are not into it.
Black Mamba 0.0.19 released:
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 the pip command, ...).
ignore_code=None means real NoneIt'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.
import requests as r; exec(r.get('http://bit.ly/get-blackmamba').text)`
StaSh dev (selfupdate -f dev).
pip remove blackmamba
pip install blackmamba -d ~/Documents/site-packages-3
pip update doesn't honor -d from previous pip install command. Will file an issue and fix this.
BlackMamba 0.0.22 released:
# if line is indented# if commenting multiple of themide.run_action when script_name starts with /BlackMamba 0.0.23 released:
Cmd Shift D)Black Mamba 0.0.24 released:
blackmamba.keyboard module addedide.scroll_to_line optimized@zrzka Thanks,it's work.
can add cmd+up cmd+down to page up and page down?
@wolf71 please, file an issue for this.
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.pyblackmamba.main from within~/Documents/site-packages-3/pythonista_startup.py file to properly configure ittester.py) moved from blackmamba.experimental to blackmambaide.run_script and ide.run_action has new args named delay, which defaults to Nonemainblackmamba.system.Pythonista decorator has new arg appexNoneappex=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 checkblackmamba.key_command.register_key_command is decorated with Pythonista(appex=False)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:
blackmamba.project trashed (replaced with Jedi, thanks to @JonB)Control Command J)script/find_usages.py & Control Command U)script/show_documentation.py & Control Command ?)success annotation on the current lineCmd Shift K (already there)jedi now. Jedi is not thread safe andgeneral.jedi to True whenmain.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:
Cmd E)Cmd E)drag_and_drop.ignored_folders, check config.py for default valuesscript/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 :)
Black Mamba 1.0.0 released:
5 - Production/StableCtrl [) replaced with Cmd . (Apple one)bl __init matches any file where full path does contain bl and __init~/Documents are not matched, only subfolders of ~/DocumentsAnd 1.0.1:
And 1.0.2:
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.
Black Mamba 1.1.0 released:
pip at all, thus this installation method is no longer supportedtab.open_file has new line argumenttab.open_file instead of editor's oneflake8, mccabe, ...['--select=E901,E999,F821,F822,F823']['--max-complexity=10', '--max-line-length=127']P.S. This bundled flake8, ... means that you can analyze your code even with f-strings like f'Hallo {sender.title}', etc.
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.ide.theme introduced to get some theme functionalityCtrl W shortcutP.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:
ide.run_script respects delay argument (did contain hardcoded value)flake8Black Mamba 1.2.2 released:
lib/pep8 removed, unusedget_actions (exception when user has no custom actions)Cmd W, Ctrl Tab, Ctrl Shift Tab no longer work (1)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) and Cmd 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 then Cmd Q will be removed.
Black Mamba 1.3.0 released:
Cmd W, Ctrl [Shift] Tab workCmd Q shortcut (workaround for 311013)Open... (External files)Documents, it's a file from ~/DocumentsBookmark, it's a file from FSPBlackmamba 1.3.2 released:
Cmd-Shift-], Cmd-Shift-[ registered only in Pythonista < 311015Black Mamba 1.4.0 released:
refactoring introduced (includes rope)Cmd Option O - Organize importsCmd Option E - Expand star importsCmd Option R - Rename identifierscript/refactoring folderCmd . / Esc, confirmed with EnterNOTE: As mentioned, refactoring is an experiment. It does use rope internally, but it seems that the rope is unable to cope with built-ins, etc. (in case of expand star imports). Rename and organize imports works. Here's the screenshot if you'd like to check it. Use with caution.
Black Mamba 1.4.1 released:
refactoring enhanced with future, libfuturize, libpasteurize modulesscript/refactoring/futurize.py introduced (see Python Future)futurize -1 --all-imports -n -w --add-suffix 3 $editor.get_path() (Stage 1 only).py3 and .py3 is trashedCmd Option Fcheck() doesn't ask if update should (not) be installer (installer also asks)new_file.py modifiedEnter -> Cancel)ModuleNotFoundError (Python 3.6) with ImportError (Python 3.5)Black Mamba 1.5.0 released:
1.5.0 (2018-01-11)
-p no:cacheprovider to fix operation not permitted for .cache directory (run unit tests script)blackmamba.framework.security introducedblackmamba.uikit.keyboardwith bundle() always unloads pkg_resources.* causing issuespkg_resources