Support all StackExchange sites with advanced search

Author: deanishe

.gitignore

@@ -1,107 +1,4 @@
-
-# Created by https://www.gitignore.io/api/python,vim,sublimetext
-
-### Python ###
-# Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
 *$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-env/
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-*.egg-info/
-.installed.cfg
-*.egg
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*,cover
-.hypothesis/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-
-# Flask instance folder
-instance/
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-target/
-
-# IPython Notebook
-.ipynb_checkpoints
-
-# pyenv
-.python-version
-
-# dotenv
-.env
-
-
-### Vim ###
-# swap
-[._]*.s[a-w][a-z]
-[._]s[a-w][a-z]
-# session
-Session.vim
-# temporary
-.netrwhist
-*~
-# auto-generated tag files
-tags
-
-
-### SublimeText ###
-# cache files for sublime text
-*.tmlanguage.cache
-*.tmPreferences.cache
-*.stTheme.cache
-
-# workspace files are user-specific
-*.sublime-workspace
-
-# project files should be checked into the repository, unless a significant
-# proportion of contributors will probably not be using SublimeText
-# *.sublime-project
-
-# sftp configuration file
-sftp-config.json
-
+*.dist-info/

README.md

@@ -1,43 +1,90 @@
 
-StackOverflow Search for Alfred
+StackExchange Search for Alfred
 ===============================
 
-Search for answers on StackOverflow.com from [Alfred 2 & 3][alfred].
+Search for answers on StackExchange sites from [Alfred 4+][alfred].
 
 ![](demo.gif "")
 
+<!-- MarkdownTOC autolink="true" autoanchor="true" -->
 
+- [Download](#download)
+- [Usage](#usage)
+- [Query syntax](#query-syntax)
+- [Results](#results)
+- [Adding custom searches](#adding-custom-searches)
+- [Licensing, thanks](#licensing-thanks)
+
+<!-- /MarkdownTOC -->
+
+
+<a id="download"></a>
 Download
 --------
 
-Get StackOverflow for Alfred from [GitHub][gh-releases] or
-[Packal][packal-page].
+Get StackExchange for Alfred from [GitHub releases][gh-releases].
 
 
+<a id="usage"></a>
 Usage
 -----
 
+The main action (keyword `stack`) shows a list of all StackExchange
+sites. Choose one to search it.
+
+There is also a search for StackOverflow.com configured (keyword
+`.so`), but it is easy to add searches for your own favourite
+StackExchange sites.
+
+- `stack [<query>]` — Choose a StackExchange site to search.
+    - `↩` — Select site
+    - `⌘↩` — Set as default site
+    - `⌥↩` — Reveal site icon in Finder
+    - `⌘C` — Copy site ID to clipboard (for adding Script Filters)
 - `.so <query>` — Search StackOverflow.com for `<query>`.
     See below for syntax.
     - `↩` or ` ⌘+NUM` — Open result in default browser
-    - `⌘+L` — Show full question title in Alfred's Large Text window
+    - `⌘L` — Show full question title in Alfred's Large Text window
 
 
+<a id="query-syntax"></a>
 Query syntax
 ------------
 
-By default, words in `<query>` will be search for in the title of posts. To
-specify a tag, prefix it with `.`, e.g. `python` will search for `python` in
-the post title, `.python` will search for the tag `python`.
+Prefix a word in your `<query>` with `.` (full stop) to indicate that
+it's a tag, e.g `requests .python` will search for answers tagged
+`python` with the query `requests`.
 
 
+<a id="results"></a>
 Results
 -------
 
-Answered questions will be shown first in the list of results (and have a
-tick on their icon).
+Answered questions will be shown first in the list of results (and have
+a green check mark on their icon).
+
+
+<a id="adding-custom-searches"></a>
+Adding custom searches
+----------------------
+
+You can easily add your own searches for specific sites by adding your
+own Script Filter with the following Script:
+
+```bash
+/usr/bin/python so.py search --site <siteid> "$1"
+```
+
+The easiest way to do this is to make and edit a copy of the built-in
+StackOverflow.com search.
+
+To get a site ID, use the site search (keyword `stack`) and hit `⌘C` on
+the desired site to copy its ID to the clipboard.
+
+You can also use `⌥↩` on a site to reveal its icon in Finder.
 
 
+<a id="licensing-thanks"></a>
 Licensing, thanks
 -----------------
 
@@ -51,5 +98,4 @@ It is heavily based on [Alfred-Workflow][alfred-workflow], also
 [mit]: http://opensource.org/licenses/MIT
 [alfred-workflow]: http://www.deanishe.net/alfred-workflow/
 [gh-releases]: https://github.com/deanishe/alfred-stackoverflow/releases
-[packal-page]: http://www.packal.org/workflow/stackoverflow-search
 [demo]: https://raw.githubusercontent.com/deanishe/alfred-stackoverflow/master/demo.gif

StackExchange-Search-2.0.0.alfredworkflow

@@ -0,0 +1,29 @@
+
+# When sourced, creates an Alfred-like environment
+
+# getvar <name> | Read a value from info.plist
+getvar() {
+    local v="$1"
+    /usr/libexec/PlistBuddy -c "Print :$v" ./src/info.plist
+}
+
+export alfred_workflow_bundleid=$( getvar "bundleid" )
+export alfred_workflow_version=$( getvar "version" )
+export alfred_workflow_name=$( getvar "name" )
+
+# Alfred 4
+export alfred_workflow_cache="${HOME}/Library/Caches/com.runningwithcrayons.Alfred/Workflow Data/${alfred_workflow_bundleid}"
+export alfred_workflow_data="${HOME}/Library/Application Support/Alfred/Workflow Data/${alfred_workflow_bundleid}"
+
+# Alfred 3
+if [[ ! -f "$HOME/Library/Preferences/com.runningwithcrayons.Alfred.plist" ]]; then
+    export alfred_workflow_cache="${HOME}/Library/Caches/com.runningwithcrayons.Alfred-3/Workflow Data/${alfred_workflow_bundleid}"
+    export alfred_workflow_data="${HOME}/Library/Application Support/Alfred 3/Workflow Data/${alfred_workflow_bundleid}"
+    export alfred_version="3.8.1"
+fi
+
+export cache_max_age=$( getvar "variables:cache_max_age" )
+export site_id=$( getvar "variables:site_id" )
+export site_name=$( getvar "variables:site_name" )
+export result_count=$( getvar "variables:result_count" )
+export ignore_meta_sites=$( getvar "variables:ignore_meta_sites" )