initial commit

Author: sqs

.editorconfig

@@ -0,0 +1,13 @@
+[*]
+insert_final_newline = true
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{json,js,yml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

.gitignore

@@ -0,0 +1,3 @@
+dist/
+node_modules/
+.cache/

.prettierignore

@@ -0,0 +1,8 @@
+node_modules/
+.git/
+coverage/
+.cache/
+lib/
+dist/
+package.json
+package-lock.json

.prettierrc

@@ -0,0 +1,6 @@
+{
+  "semi": false,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "useTabs": false
+}

README.md

@@ -0,0 +1,37 @@
+# Python
+
+This extension adds Python code intelligence to Sourcegraph using a [Python language server](https://github.com/Microsoft/python-language-server) (the [@sourcegraph fork](https://github.com/sourcegraph/python-language-server/tree/wip2)).
+
+[**🗃️ Source code**](https://github.com/sourcegraph/sourcegraph-python)
+
+[**➕ View in extension registry**](https://sourcegraph.com/extensions/sourcegraph/python)
+
+## Features
+
+For Python code viewed on [Sourcegraph](https://sourcegraph.com) and when using the [Sourcegraph browser extension](https://docs.sourcegraph.com/integration/browser_extension):
+
+-   Hovers with documentation and inferred type signatures
+-   Go to definition
+-   Find references
+
+## Usage
+
+This extension is enabled for all users by default on Sourcegraph.com and when using the [Sourcegraph browser extension](https://docs.sourcegraph.com/integration/browser_extension) on public code.
+
+To use it, just visit a Python file and hover over tokens. Examples:
+
+-   Tensorflow: [tensorflow_ranking/examples/tf_ranking_libsvm.py](https://sourcegraph.com/github.com/tensorflow/ranking@931e4e18d68612d0b29dc3c81994acdd4b6ab743/-/blob/tensorflow_ranking/examples/tf_ranking_libsvm.py#L294:27&tab=references)
+-   Flask: [flask/views.py](https://sourcegraph.com/github.com/pallets/flask/-/blob/flask/views.py)
+-   Zulip: [corporate/lib/stripe.py](https://sourcegraph.com/github.com/zulip/zulip/-/blob/corporate/lib/stripe.py)
+-   Trivial sample: [pkg0/m0.py](http://sourcegraph.com/github.com/sgtest/python-sample-0/-/blob/pkg0/m0.py)
+
+![Screenshot](https://user-images.githubusercontent.com/1976/49628952-d4c92800-f99b-11e8-9605-d880b733cde6.png)
+
+### On self-hosted Sourcegraph instances
+
+_Documentation to be added soon._
+
+## Known issues
+
+-   Dependencies are not installed. Hovers, definitions, and references only work for sources checked into the single repository you are viewing.
+-   Cross-repository definitions and references are not yet supported.

package.json

@@ -0,0 +1,63 @@
+{
+  "name": "python",
+  "title": "Python",
+  "description": "Python code intelligence (using the Python language server)",
+  "publisher": "sourcegraph",
+  "activationEvents": [
+    "onLanguage:python"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sourcegraph/sourcegraph-python"
+  },
+  "contributes": {
+    "configuration": {
+      "title": "Python settings",
+      "properties": {
+        "python.languageServer.url": {
+          "description": "The URL to the Python language server (which is an instance of https://github.com/sourcegraph/python-language-server).",
+          "type": "string",
+          "format": "uri",
+          "pattern": "^wss?://"
+        }
+      }
+    }
+  },
+  "version": "0.0.0-DEVELOPMENT",
+  "license": "MIT",
+  "main": "dist/sourcegraph-python.js",
+  "scripts": {
+    "prettier": "prettier '**/*.{js?(on),ts}' --write --list-different",
+    "tslint": "tslint -p tsconfig.json './src/**/*.ts'",
+    "typecheck": "tsc -p tsconfig.json",
+    "build": "parcel build --out-file dist/sourcegraph-python.js src/sourcegraph-python.ts",
+    "serve": "parcel serve --no-hmr --out-file sourcegraph-python.js src/sourcegraph-python.ts",
+    "watch:typecheck": "tsc -p tsconfig.json -w",
+    "watch:build": "tsc -p tsconfig.dist.json -w",
+    "sourcegraph:prepublish": "npm run build"
+  },
+  "browserslist": [
+    "last 1 Chrome versions",
+    "last 1 Firefox versions",
+    "last 1 Edge versions",
+    "last 1 Safari versions"
+  ],
+  "devDependencies": {
+    "@sourcegraph/tsconfig": "^3.0.0",
+    "@sourcegraph/tslint-config": "^12.0.0",
+    "parcel-bundler": "^1.10.3",
+    "prettier": "^1.14.3",
+    "sourcegraph": "^19.4.0",
+    "tslint": "^5.11.0",
+    "tslint-language-service": "^0.9.9",
+    "typescript": "^3.1.3"
+  },
+  "dependencies": {
+    "@types/ws": "^6.0.1",
+    "rxjs": "^6.3.3",
+    "vscode-jsonrpc": "^4.0.0",
+    "vscode-languageserver-protocol": "^3.13.0",
+    "vscode-ws-jsonrpc": "^0.0.3",
+    "ws": "^6.1.0"
+  }
+}

screenshot.png

@@ -0,0 +1,43 @@
+/**
+ * Converts to/from Sourcegraph client URIs to the URIs known to the language server.
+ */
+export interface UriConverter {
+    toLanguageServer: (clientUri: string) => string
+    toClient: (languageServerUri: string) => string
+}
+
+export function createUriConverter(
+    originalRootUri: string | null,
+    actualRootUri: string | null
+): UriConverter {
+    if (!originalRootUri || !actualRootUri) {
+        throw new Error(
+            'not yet implemented: null values for originalRootUri and/or actualRootUri'
+        )
+    }
+    return {
+        toLanguageServer: clientUri => {
+            let path = clientUri
+            if (path.startsWith(originalRootUri)) {
+                path = path.slice(originalRootUri.length)
+                if (path.startsWith('#')) {
+                    path = path.slice(1)
+                }
+                if (!path.startsWith('/')) {
+                    path = '/' + path
+                }
+            }
+            return actualRootUri + path
+        },
+        toClient: languageServerUri => {
+            let path = languageServerUri
+            if (path.startsWith(actualRootUri)) {
+                path = path.slice(actualRootUri.length)
+                if (path.startsWith('/')) {
+                    path = path.slice(1)
+                }
+            }
+            return originalRootUri + '#' + path
+        },
+    }
+}