forked from DonJayamanne/pythonVSCode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathindex.html
More file actions
129 lines (88 loc) · 8.22 KB
/
Copy pathindex.html
File metadata and controls
129 lines (88 loc) · 8.22 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8'>
<meta http-equiv="X-UA-Compatible" content="chrome=1">
<meta name="description" content="Python for Visual Studio Code : Python extension for Visual Studio Code">
<link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
<title>Python for Visual Studio Code</title>
</head>
<body>
<!-- HEADER -->
<div id="header_wrap" class="outer">
<header class="inner">
<a id="forkme_banner" href="https://github.com/DonJayamanne/pythonVSCode">View on GitHub</a>
<h1 id="project_title">Python for Visual Studio Code</h1>
</header>
</div>
<!-- MAIN CONTENT -->
<div id="main_content_wrap" class="outer">
<section id="main_content" class="inner">
<h3>
<a id="welcome-to-python-for-visual-studio-code" class="anchor" href="#welcome-to-python-for-visual-studio-code" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Welcome to Python for Visual Studio Code</h3>
<p>Python for Visual Studio Code is an extension for Visual Studio which aims at providing you with the best python development environment and experience possible. The extension is built for the Visual Studio Code IDE that is built from the ground up using Open Source technologies such as NodeJs.</p>
<p><img src="https://raw.githubusercontent.com/DonJayamanne/pythonVSCode/master/images/general.gif" alt="Image of Generate Features"></p>
<p><img src="https://raw.githubusercontent.com/DonJayamanne/pythonVSCode/master/images/standardDebugging.gif" alt="Image of Debugging"></p>
<h3>
<a id="open-source-and-cross-platforma" class="anchor" href="#open-source-and-cross-platform" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Open Source and Cross Platform</h3>
<p>The extension along with the IDE is both open source and runs on multiple platforms such as Windows, Mac and Linux.
Both the <a href="https://github.com/DonJayamanne/pythonVSCode">Python extension</a> and <a href="https://github.com/Microsoft/vscode">Visual Studio Code</a> are built using open source technologies such as NodeJs.</p>
<h2>
<a id="works-out-of-the-box" class="anchor" href="#works-out-of-the-box" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Works out of the box</h2>
<p>Once installed, the extension works out of the box with absolutely no configuration.
This is made possible by using the default Python interpreter available in the current PATH variable on the operating system.</p>
<p>If necessary, the python interpreter being used by the extension could be changed to point to a specific version of the interpreter (or one that is in a specific virtual environment). This is made possible by altering the following setting in the <a href="https://code.visualstudio.com/Docs/customization/userandworkspace">User or Workspace settings file</a>:</p>
<div class="highlight highlight-source-json"><pre>“python.pythonPath” : “<fully qualified path to the python interpreter>”</pre></div>
<h2>
<a id="features" class="anchor" href="#features" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Features</h2>
<h3>
<a id="virtual-environments" class="anchor" href="#virtual-environments" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Virtual Environments</h3>
<p>Python virtual environments are completely supported. </p>
<h3>
<a id="rich-intellisense-code-completion" class="anchor" href="#rich-intellisense-code-completion" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Rich Intellisense (code completion)</h3>
<p>The extension provides a very rich set of intellisense and code completion capabilities. This significantly reduces the development effort by removing the guess work from the equation. Intellisense (code completion) works out of the box with no additional configuration. However, this can be fined tuned if necessary.</p>
<h3>
<a id="code-navigation-and-the-like" class="anchor" href="#code-navigation-and-the-like" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Code Navigation and the like</h3>
<p>The extension integrates with most if not all of the code navigation capabilities exposed by the Visual Studio Code IDE. What this means to the end user is simple, features such as Go to Definition, Go to Symbol, Find all References, hover over a symbol to view the documentation, etc. are available to the user through the IDE via standard commands and interfaces.<br>
This alone feature alone saves development time and effort with improved code navigation.</p>
<h3>
<a id="linting" class="anchor" href="#linting" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Linting</h3>
<p>The extension utilizes some of the best and most popular python linters in order to analyze the source code and provide feedback to the user. Popular linters such as Pylint, Flake8, pydocstyle, and the like are used. As a user you could either use all of them or just one or none. Users have the ability to fine tune each linter placing relevant configuration files in the project directory.</p>
<h3>
<a id="code-formatting" class="anchor" href="#code-formatting" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Code formatting</h3>
<p>Code formatting ensures your code meets certain standards of coding styles. This capability is provided by using either one of Yapf or AutoPep8 library. Using this feature you can be assured your code meets some of the best known standards in python coding (format) styles.</p>
<h3>
<a id="debugging" class="anchor" href="#debugging" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Debugging</h3>
<p>The debugging experience provided is unparalleled. You could debug almost any type of application, web and console applications, local and remote applications (yes remote debugging too). The debugger provides a rich set of debugging capabilities such as:</p>
<ul>
<li>Multi-threaded debugging</li>
<li>Local variables and arguments </li>
<li>Watch window and stack trace</li>
<li>Conditional breakpoints</li>
<li>Evaluating expressions </li>
<li>and more</li>
</ul>
<h3>
<a id="miscellaneous-features-that-make-this-a-great-python-development-ide" class="anchor" href="#miscellaneous-features-that-make-this-a-great-python-development-ide" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Miscellaneous features that make this a great Python development IDE</h3>
<ul>
<li>Executing unit tests</li>
<li>Rename refactor</li>
<li>Sort imports within a python file</li>
<li>Auto-indenting as you type</li>
<li>Code Snippets</li>
<li>Total control over the linters and formatters used</li>
</ul>
<h3>
<a id="creating-pages-manually" class="anchor" href="#creating-pages-manually" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Creating pages manually</h3>
<p>If you prefer to not use the automatic generator, push a branch named <code>gh-pages</code> to your repository to create a page manually. In addition to supporting regular HTML content, GitHub Pages support Jekyll, a simple, blog aware static site generator. Jekyll makes it easy to create site-wide headers and footers without having to copy them across every page. It also offers intelligent blog support and other advanced templating features.</p>
<h2>
<a id="contributions-and-suggestions" class="anchor" href="#contributions-and-suggestions" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Contributions and Suggestions</h2>
<p>If you have an idea, we’d love to hear about it, you can add them <a href="https://github.com/DonJayamanne/pythonVSCode/issues/183">here</a>.</p>
<p>If you think you can build it, then by all means fork the repo, make the changes and create a pull request.</p>
<h2>
<a id="license" class="anchor" href="#license" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>License</h2>
<p><a href="https://raw.githubusercontent.com/DonJayamanne/pythonVSCode/master/LICENSE">MIT</a></p>
</section>
</div>
</body>
</html>