Blackmamba

* Fixed Black Mamba for stable Pythonista version (Python 3.5)

* Fixed unit tests annotations

* Development status changed to `5 - Production/Stable`
* Fixed programming language classifier (Python 3.6)
* Detailed documentation available at [blackmamba.readthedocs.io](http://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 with `Cmd .` (Apple one)
* Default width is 80% of window width (max 700)
* Default height is 80% of window height
* 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 contain `bl` 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](https://www.kaleidoscopeapp.com/) 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

* 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](https://github.com/zrzka/blackmamba/blob/master/blackmamba/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.

* 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)
* 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 set `general.jedi` to `True` when
passing configuration to the `main`.

BTW this `.` notation is a shortcut for documentation and you have to pass
it as dictionary:

python
config = {
'general': {
'jedi': True
}
}

blackmamba.main(config)

* `blackmamba.script` introduced and it does contain following scripts
* `action_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, esame 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 from `blackmamba.experimental` to `blackmamba`
* `ide.run_script` and `ide.run_action` has new args named `delay`, which defaults to `None`
* 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
* `blackmamba.system.Pythonista` decorator has new arg `appex`
* Defaults to `None`
* `appex=True` - run decorated function if it's running as application extension
* `appex=False` - run decorated function if it's not running as application extension
* `appex=None` - run in both case, just don't check
* `blackmamba.key_command.register_key_command` is decorated with `Pythonista(appex=False)`
to avoid shortcut registration if it's running as application extension
* Page Up (`Ctrl Up`) and Page Down (`Ctrl Down`)
* It jumps up / down by 40 lines by [default](https://github.com/zrzka/blackmamba/blob/master/blackmamba/config.pyL17)
* You can modify this value via `general.page_line_count`
* See [395](https://github.com/omz/Pythonista-Issues/issues/395), it's recommended
to hit Left / Right arrow key after page up / down to workaround iOS / Pythonista bug