Python

vscodeでPythonのdocstringを作成する方法を現役エンジニアが解説【初心者向け】

初心者向けにvscodeでPythonのdocstringを作成する方法について現役エンジニアが解説しています。docstringとはPythonの関数やクラスに記述するコメントの事を指します。vscodeの機能を使って簡単に書けるようにautoDocstringをインストールします。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元：GMOリサーチ株式会社　調査期間：2021年8月12日～8月16日　調査対象：2020年8月以降にプログラミングスクールを受講した18～80歳の男女1,000名　調査手法：インターネット調査

vscodeでPythonのdocstringを作成する方法について、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。

今回は、Pythonに関する内容だね！

どういう内容でしょうか？

vscodeでPythonのdocstringを作成する方法について詳しく説明していくね！

お願いします！

今回は、vscodeでPythonのdocstringを作成する方法について紹介します。

docstringとは

まずはじめに、docstringとはPythonの関数やクラスに記述するコメントの事を指します。docstringを記述する事で、コードの可読性が向上します。

docstringの基本的な記述ポイントは以下の3点になります。

コメントを複数行のコメントブロック「”””」で囲み、最初の「”””」の右隣にタイトルを記載する
docstringは基本的にimportよりも前に記載する
docstringを記述できるのは、モジュール、クラス、関数(メソッド)の3つが対象となる

docstringの作成に便利なvscodeの拡張機能

ここではdocstringの作成に便利なvscodeの拡張機能「autoDocstring」について紹介します。

導入方法

導入方法は以下の画像を参考に、拡張機能の検索から「autoDocstring」を入力すると出てくるのでそちらをインストールしてください。

VSCODEでautoDocstringをインストールするために、拡張機能の画面の検索ボックスに入力した場面。

Installボタンをクリックし以下のような画面になったらインストール完了です。

VSCODEでautoDocstringをインストールした画面。

初期設定

ここでは先ほどインストールしたautoDocstringを使用して挿入するdocstringのフォーマットを設定します。VScode左下の歯車のマークからSettingsを選択し設定画面を開きます。

VSCODEにインストールしたautoDocstringの設定画面を開くために左下の歯車のマークからSettingsを選択した画面。

設定画面が開いたら、検索欄にautoDocstringと入力し、Auto Docstring: Docstring Formatの部分が表示されますのでリストから任意のフォーマットを指定します。(今回はGoogleを選択しました。)

VSCODEにインストールしたautoDocstringの設定画面で、フォーマットを選択した画面。

以上で、autoDocstringの初期設定は終了です。

[PR] 未経験からWebエンジニアを目指す方法とは

実際に使ってみよう

それでは、早速「autoDocstring」を使用して実際にdocstringを記述してみましょう。vscodeを起動し、以下のようなサンプルコードを用意します。

このコードはあくまで例としてであり、特に指定はないので自由に設定して大丈夫です。

サンプルコード

def docstring_sample(test):

    pass

vscode画面

VSCODEにインストールしたautoDocstringを使うために書く、Pythonのサンプルコード。
vscode画面上で右クリック→GenerateDocstringで自動的にdocstringが挿入されます。

PythonのコードにVSCODEで右クリックしてautoDocstringのGenerateDocstringを選択した画面。

「autoDocstring」を使用してdocstringが挿入された状態が以下の画面になります。

VSCODEのautoDocstringを使って、Pythonのサンプルコードにdocstringを挿入した画面。

挿入されたdocstringに関数の説明や引数の説明を入力します。

VSCODEのautoDocstringを使って、docstringを挿入した後に、関数や引数の説明を入力した画面。

まとめ

今回は、vscodeでPythonのdocstringを作成する方法について紹介しました。

記事冒頭でも述べたように作成したコードにdocstringを挿入する事でコードの可読性が向上します。

過去に作成したプログラムを再度アップデートする際や、プログラムを複数人で開発する際などにdocstringが挿入されていることでコードが読みやすくなり作業をスムーズに行うことができるというようなメリットがありますので、コードを書く際の癖としてしっかり身につけていきましょう。

監修してくれたメンター

菅繕久（すがよしひこ）

現在はフリーランスのエンジニアをしていてプログラミング歴は8年目になります。

普段は Python、FileMaker等を使って様々な業務で活用できるIoTプロダクトRPAツールを作成しています。
開発実績としては、業務自動化ツール(在庫管理・発注・ファイル操作 etc)、電子カルテシステム、ロボット用プログラムなどがあります。
TechAcademyではPythonコースを担当しております。

内容分かりやすくて良かったです！

ゆかりちゃんも分からないことがあったら質問してね！

分かりました。ありがとうございます！

TechAcademyでは、初心者でも、Pythonを使った人工知能（AI）や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。

また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。

Pythonで現在時刻を取得する方法を現役エンジニアが解説【初心者向け】

Pythonで現在時刻を取得する方法について、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに解説します。 &nb...

Python

Pythonのitertoolsモジュールについて現役エンジニアが解説【初心者向け】

Pythonのitertoolsモジュールについて、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 &nb...

Python

Pythonで出力結果をファイルに保存する方法を現役エンジニアが解説【初心者向け】

Pythonで出力結果をファイルに保存する方法について解説します。そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した...

Python

実際に書いてみよう！Pythonで演算子を使う方法【初心者向け】

今回は、Pythonで演算子を使う方法を解説します。演算子は、プログラミング全般で必須知識なので、演算子の種類全てを覚える必要はないですが、使い方を知っ...

Python

PythonでOpenCVによりカメラの画像を表示する方法を現役エンジニアが解説【初心者向け】

PythonでOpenCVによりカメラの画像を表示する方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します...

Python

Pythonのaverage関数で平均を求める方法を現役エンジニアが解説【初心者向け】

Pythonのaverage関数で平均を求める方法について解説します。そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説...

Python

あわせてよく読まれている記事

Pythonのdocstringを使う方法【初心者向け】

Pythonのdocstringの使い方について解説します。そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。なお本記事は、TechAcademyのオンラインブートキャンプPython講座の内容をもとに紹介しています。田島悠介今回は、Pythonに関する内容だね！大石ゆかりどういう内容でしょうか？田島悠介 docstringの使い方について詳しく説明していくね！大石ゆかりお願いします！ docstringとは docstringとは、関数やクラスに対する説明文のことです。実際に表示して確認してみましょう。パソコンがMacの場合はターミナル、Windowsの場合はコマンドプロンプトから「python」と入力し、Pythonの対話型インタプリタを起動します。なお、事前に Python のインストールが必要です。起動したら、以下のように入力します。 print(range.__doc__) 実行結果は以下のようになります。range関数の説明文が表示されています。 range(stop) -> range object range(start, stop[, step]) -> range object Return an object that produces a sequence of integers from start (inclusive) to stop (exclusive) by step. range(i, j) produces i, i+1, i+2, ..., j-1. start defaults to 0, and stop is omitted! range(4) produces 0, 1, 2, 3. These are exactly the valid indices for a

Python

【Atom、Sublime、Visual Studio Code、Vimの人気エディタを徹底比較】ベストなテキストエディタはこれだ！

本稿は、Codementorのブログ記事を了解を得て日本語翻訳し掲載した記事になります。また本記事は、10年以上リードエンジニアとして活躍するMatt Goldspink氏によって投稿されました。プログラム記述用テキストエディタが溢れる今日この頃ですが、そこから一つを選ぶとなるとそれは難しい問題でしょう。「開発者にとって最適なテキストエディタは何ですか？」という質問への回答はすぐには見つかりませんが、ここでは Atom, Sublime, Visual Studio Code, Vim という4つの人気のエディタについて比較してみます。ここでの比較が、読者のニーズに合ったエディタを選択をする一助になれば良いなと思います。お断り：ここでのいくつかの比較は主観的であり、ほとんどが私の個人的な好みに基づいています。私はMac用のSublimeを使用してWeb（HTML、CSS、JavaScriptなど）の記述を行なっています。そのため、評価の視点は使い慣れているものに多少傾いてはいますが、できる限り客観的に評価を行いました。目次 Atom Sublime Text Visual Studio Code Vim Atom Url: https://atom.io/ 費用：フリー(MIT Licence) 開発者：GitHub プラットフォーム：OSX, Windows, Linux Atomは21世紀に向けて改良可能なテキストエディタと言われています。 Atomは比較的新しいテキストエディタで、2014年に最初にリリースされて以来、多くの人気を集めています。では、メインの機能から見てみましょう。パッケージ編集機能を追加できることはたいへん重要ですが、このエリアはAtomが得意としています。標準でインストールされるパッケージマネージャがこの機能を果たし、全てのパッケージはGithubで管理されています。現在では、6,452個という多数のパッケージとテーマが利用できます。Atomにとってパッケージは基本的なものであり、プリインストールされたツリービューと設定ビューの機能でさえも単に最初から組み込まれたパッケージなのです。編集とワークフロー Atomでは全ての機能がスムーズに操作できます。では、最大の弱点はなんでしょうか。考えた末に出てきたのは、使い始めた際にどの追加パッケージをインストールすべきかを見つけるのに苦労する点です。例えば、私はファイルの一部分を視覚的にスキップできるミニマップを愛用しているが、この機能をセットアップするためには「オートコンプリート+」を使用して、自動補間機能を設定する必要がありました。私はよく複数のファイルを同時に開いて作業するので多くの場合、分割ペインの編集を設定する機能は必須ですが、これはAtomがうまくサポートしてくれている機能のひとつです。 Sublimeには無いAtomのもう1つの優れた機能は、ツリービューでのファイル/フォルダのドラッグ&ドロップのサポートです。私は周りのものをシフトできる機能がSublimeに無いことを知ってはいましたが、この機能はとても役に立つのです。最後に、gitとの統合は素晴らしいのではありますが、結局は GitHub側で構築された結果なのです。カスタマイズエディタを自分の開発フロー、およびスタイルに合うようにカスタマイズする機能は必須です。私は「保存する時に空白を取り除く」,「編集していないファイルを保存する」という設定をいつも使っていますが、これらを有効にしたり、無効にしたりすることは簡単に行うことができます。 Atomには優れたドキュメントが用意されており、そこにはスタイルを再設定する方法も書かれています。私は構成設定に優れたAtomを好んで使っています。ファイルの種類ごとに設定の上書きができる機能は素晴らしい。例えばJS, CSS, HTML に別々の設定をすることはAtomでは容易なのです。パフォーマンス Atomを選ぶ際に問題になるとすれば、それは処理速度です。ファイルを開いたり、タブを切り替える毎に生じるタイムラグは苦痛です。（本格的な開発の編集に使っている場合には特に気になります）Atomの最初のリリースではそこが問題点であり、最近ではかなり改善されてはいますが、まだまだ不十分です。まとめカスタマイズを簡単に行いたいというユーザーにとってはAtomは優れたツールです。修正、追加、拡張性の自由度は大きな力を与えてくれます。ドキュメントも優れています。私としてはやはりパフォーマンスの点が気になりますが、Atomはフリーのエディタとして光っているのは確かです。 Atomの使い方 [PR] 未経験からWebエンジニアを目指す方法とはSublime Text Url：https://www.sublimetext.com/ 試用するにはライセンス費70ドルが必要開発者：Jon Skinner （前グーグル技術者）プラットフォーム：OSX, Windows, Linux Sublimeは2007年にリリースされ、ほぼ10年が経過しています。Stackoverflowの2016年の開発環境調査ではSublimeは第3位にランクされています。 V3Betaは最新バージョンで、長い間Betaバージョンのままです。気にすることはありませんが、新版はたいへん安定しています。パッケージ最初にインストールするSublimeのパッケージはコントロールプラグインであるようです。Sublime 3ではこれらがデフォルトで追加されていることを期待しています。 Atomと同様にSublimeでもたくさんのパッケージとテーマが用意されていますが、私にとって必要なのは次の3つです。 SideBarEnhancements：これを使わないとファイルのリネーム/移動/複製はできません。 SublimeLinter：異なるプログラム言語にlintを追加するのに必要です。 GitGutter：git 上の状態をラインナンバーの左に表示します。 Sublimeにおいても多くの(パッケージの)中から選択ことが出来ます。Sublimeのパッケージサポートは全体的によくできているのですが、最初に使い始める際に複雑な手続きがあるというのがちょっと残念な点です。編集とワークフロー重要なプロジェクトでは、Sublimeを使ってきました。ファイルの検索、ファイルの内容の検索は高速で簡単です。私は何百ものファイルからコードの断片を検索する作業をよく行いましたが、Sublimeの処理速度に不満を持つことはありませんでした。 Atomと同様に、Sublimeの本領はいくつかのキープラグインをインストールしてから発揮されます。正しい文法ハイライトを行うにはJSONフォーマッタ、LINTなどのインストールで時間が取られますが、一旦インストールしてしまえば再び触る必要はありません。カスタマイズ前述しましたが、SublimeはAtomと非常によく似ています。「フォーカスが無くなったら保存する」、「空白を取り除く」の設定も可能です。設定ファイルは簡単なJSONで書かれており、隠された全体のホストの設定があります。パフォーマンス SublimeがAtomより優れた点として、オープニング、クロージング、検索などがたいへんスムーズで速いことがあげられます。まとめ冒頭に述べたように、私は長年のSublimeユーザーなので、ここでの私の意見は少しだけSublime寄りではありますが、一般的にはSublimeは柔軟性があり高速なエディタであるとされています。 2016年の開発環境のトップ3に入るだけの理由はあるのです。 Sublime Textの使い方 Visual Studio Code Url: https://code.visualstudio.com/ 費用：フリー開発者：Microsoft Platforms：OSX, Windows, Linux Visual Studio Code(VSCode)は比較的新しいテキストエディタです。昨年(2015年4月)にリリースされていますが、すでに大きな牽引力を持っています。Microsoftはパワフルで柔軟性のあるクロスプラットフォームエディタを作り出すという大きな業績を残しました。そのプラグインは開発者からの注目を集めています。パッケージ他のエディタと同様に、VSCodeもよくできたプラグイン（エクステンション）を持っています。エクステンションの管理は内蔵されており、何百ものエクステンションが利用可能になっています。これがAtomでは、いくつかのものだけがデフォルトでインストールされています。自分のワークフローに最適なプラグインを選ぶのに多少の時間はかかります。私の好きな（そして私がVSCodeで興味深く思うのは） Chrome用のデバッガです。これを使ってVSCodeの中からブレークポイントをセットしてJSをデバッグできます。同じことはNoode.jsでもできます。つまり、JSCodeからブレークポイントをセットして、ターミナルのノードプロセスが走っている状態でステップ実行させることができるのです。編集とワークフロー VSCodeはAtomと似たやり方でElectron、Node、HTML/CSSを使っていますが、タイムラグもなく極めて高速です。私は、エディタを一週間使用してみて、かなり満足しました。Sublime,Atomに非常に親和性がありました。前述のデバッグ機能は拾い物でした。入力補間（最初は設定に苦労しましたが）が一日かそこらで利用できるようになりました。私はすでに引数を覚えていなくても、関数名を入力することに関しては達人になっていました。カスタマイズ前述の2つのエディタのようにVSCodeにもカスタマイズ機能はあります。wrapping, インデント、テーマなど必要な全ての機能が用意されています。パフォーマンス前述しましたが、VSCodeは(Atomと同様に)、Node.js, Electron, HTML, CSSを使って作られていますが(Atomとは違って)　明らかに高速です。起動、終了時のタイムラグも感じないし、検索も速いです。察するところ、AtomとVSCodeの違いはUIエディタがMonaco(Visual Studio Onlineより)で作られていることだと思われます。これがパフォーマンスの違いの理由だと思いますが、とにかくパフォーマンスはSublimeと同等なのです。まとめ全体を見て私はVSCodeの検討結果にたいへん感激し、より継続して使うことも考えました。私は完全に乗り換えるためのステップを踏んでいる状態ですが、Sublimeと同様の設定をしてみたこの休日は楽しいものとなりました。結局、私はSublimeを長く使い過ぎたようです。Gitとの統合、エディタ内デバッガーはすばらしい機能であり、私がSublimeを使って苦労していたことが、VSCodeを使うとあっと言う間にできてしまうのです。 Vim Url: http://www.vim.org/ 費用：フリー開発者：Bram Moolenaar プラットフォーム：OSX, Windows, Linux 私は開発者は成長するための通過点として、プロジェクトでVi、あるいはVimを使ってみるべきだと思う。ターミナルを通してリモートサーバ上のファイルを見たり編集できることは生産的で重要な機能です。私は多くの開発者が、SFTP、curlを使って、ファイルを再アップロードするのを見てきました。しかし、Vimについての厳しい意見は、Vimの愛好者を苛立たせ、さらには理屈の通った怒りを買うことを私は知っています。Vimを修得する事に時間を費やしている人にとって、Vimはたいへんに生産的な環境なのですから。パッケージ Vim　では　14,00ものパッケージを使うことができます。たとえば、木探索、文法のハイライト、テーマ設定、Gitとの統合などがあります。Vimは信じられないくらいの柔軟性を持ち、パワフルなのです。しかしながら、上で述べた他のエディタと同様に、インストールすべき最適なプラグインがどれかを知るには、インサイダーの知識とコメントが必要です。私は人気のあるプラグインはWebサイト(http://vimawesome.com/)を手がかりとして探しています。編集とワークフロー Vimに不慣れな人に最初に言っておきますが、Vimはコマンドラインのテキストエディタです。ダブルクリックしたり、移動のためにマウスを使うアプリとは違うのです。テキストを開く、編集する、閉じる、保存するという操作は全てショートカットを使って行います。私が学生の頃、Viだけを使うように教えられました。本当のVimのユーザーになるにはそれなりの覚悟が必要ですが、最後には「頭が良くなった」ような気分を味わうことができるでしょう。正直言って、私がVim をあまり使わなくなったのは、ショートカットを充分に覚えていなかったからです。ひとつのファイルなら、検索したり、置き換えたりすることが簡単にできるのですが、これが複数のファイルとなると、途端に操作が分からなくなります。カスタマイズ Vimは驚くほどカスタマイズできます。Googleで「.vimrc」を検索すれば、Vimの設定例をたくさん見つけることができます。Vimはいろんなことが可能なのです。パフォーマンス Vimのパフォーマンス上の障害となるのは「ユーザー」、つまり「あなた」なのです。原理的で高速でありますが、パフォーマンスとしては、あなたがいかに速くコマンドを打てるかにかかっています。あなたがVimのパワーユーザであればVimもすごく速くなるのです。まとめ Vimは原理的なエディタです。速い動作速度を持ち、開発環境としては充分です。ただし、辛抱強くコマンドを覚える必要があります。 VIM Adventuresというオンラインゲームがありますが、これを使ってファイル内を移動する h, i, k, l のような基本的なコマンドを覚えることができます。最終判断以上のエディタは各々長所、短所を持っています。個人的には私は、開発者のキャリアの中で各々のエディタについて最低1週間は何が役に立ち、何が役に立たないかを見極めるべきだと思います。これら人気のある4つのエディタを包括することは、エディターを選びなおす良い切っ掛けになると思います。 [お知らせ]TechAcademyでは初心者でもエンジニアになれるオンラインブートキャンプを開催しています。これからプログラミングを始めようと思っている人はぜひご覧ください。

プログラミング

JavaScriptのテキストエディタの選び方を現役エンジニアが解説【初心者向け】

JavaScriptのテキストエディタの選び方について、TechAcademyのメンター（現役エンジニア）が実際のコードを使って初心者向けに解説します。 JavaScriptについてそもそもよく分からないという方は、JavaScriptとは何なのか解説した記事をまずご覧ください。なお本記事は、TechAcademyのオンラインブートキャンプ、JavaScript/jQuery講座の内容をもとにしています。田島悠介今回は、JavaScriptに関する内容だね！大石ゆかりどういう内容でしょうか？田島悠介 JavaScriptのテキストエディタの選び方について詳しく説明していくね！大石ゆかりお願いします！テキストエディタの選び方のポイント HTMLやJavaScriptなどのソースコードを入力するときに便利なのがテキストエディタです。単にソースコードを入力するだけならパソコンに添付されているメモ帳などのソフトも使えますが、テキストエディタには多くのメリットがあります。入力補完：キーワードを入力している途中で候補を表示してくれる機能です。長い関数名などを間違いなく簡単に入力できます。自動フォーマット：ソースコードの一部分または全体をフォーマットする機能です。検索/置換：正規表現などを使った強力な検索や置換が可能です。各種ツールとの連携：簡易Webサーバーを組み込んでJavaScriptのプログラムを実行したり、バージョン管理などのソフトと連携することで開発作業効率を向上します。テーマの設定：最近エンジニアの間で流行している「ダークテーマ」など、見た目を自分好みに変更できます。テキストエディタは多くの種類があります。JavaScriptのテキストエディタを選ぶ際は以下のような点がポイントになるでしょう。多くの開発者が利用している開発が継続して行われている ESLintなどの構文チェックツールを組み込むことができる JavaScriptのコーディングにおすすめのテキストエディタこの記事では、JavaScriptのコーディングにおすすめのテキストエディタを3つ紹介します。どれも無料で利用できます。 Visual Studio Code(VSCode) マイクロソフト社を中心としたコミュニティで開発が進められているオープンソースのテキストエディタです。筆者も愛用しています。統合開発環境の Visual Studio とは別物なので注意しましょう。 WindowsやMacOS、Linuxで動作します。VSCodeの魅力は軽快な動作と豊富な拡張機能です。コーディングからテスト、バージョン管理まで、開発に関する一連の作業をVSCodeの中で行なえます。ほとんどのプログラミング言語で選んで間違いなしのテキストエディタと言えるでしょう。 >> Visual Studio Code Atom AtomはGithubが開発したオープンソースのテキストエディタです。こちらもWindowsやMacOS、Linuxで動作します。Atom は見た目のシンプルさとカスタマイズの容易さ、拡張性の高さからVSCodeと並んで人気のテキストエディタです。以前はVSCodeと比較してやや動作がもったりしていましたが、最近では開発が進んでそのようなことも無くなりました。こちらも選んで間違いの無いテキストエディタです。 >> Atom その他、開発者の間で良く使われているテキストエディタをいくつかご紹介します。サクラエディタエンジニアのパソコンにはほぼ100%の確率でインストールされていると思われるエディタです。古くからテキストエディタのデファクトスタンダードであり、使いやすさや小回りの良さは今も色あせません。 VSCodeやAtomを使っていても、ちょっとした編集はサクラエディタで行うというエンジニアも多いのではないでしょうか。 >> サクラエディタ Sublime Text 熱心なファンが多いエディタです。無償版と有償版があります。プラグインパッケージを組み合わせることで、自分好みのエディタに仕上げることができます。一度好みの環境が出来てしまうと手放せない理由も分かりますね。有償版と無償版があります。 >> Sublime Text Cloud9 最後にちょっと変わったテキストエディタをご紹介しましょう。 Cloud9はソースコードの記述から実行までを行えるクラウド環境です。AWSで提供されているサービスの他、オープンソースでのリポジトリも提供されています。ローカル環境の設定を行う必要が無いことから、教育やテストなどにも利用されています。 >> AWS Cloud9 [PR] 未経験からWebエンジニアを目指す方法とは筆者プロフィール太田和樹（おおたかずき） ITベンチャー企業のPM兼エンジニア普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。開発実績：画像認識技術を活用した駐車場混雑状況把握（実証実験）、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント。地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。大石ゆかり内容分かりやすくて良かったです！田島悠介ゆかりちゃんも分からないことがあったら質問してね！大石ゆかり分かりました。ありがとうございます！ TechAcademyでは、初心者でも、JavaScript・jQueryを使ったWebサービス公開を習得できる、オンラインブートキャンプを開催しています。また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。

JavaScript

今さら聞けない！Pythonとは【初心者向け】｜現役エンジニアが解説

人気のプログラミング言語「Python」について解説します。どんなシーンで使われるプログラミング言語なのか、Pythonで作れるアプリケーション、Pythonのメリット・デメリットについて説明しているので、これから習得を目指している方は知っておきましょう。日本でもこれからより注目される言語になるはずです。なお本記事は、TechAcademyのPythonオンライン講座の内容をもとにしています。なお、今回の記事の内容は動画でもご覧いただけます。テキストよりも動画の方が理解しやすいという場合はぜひご覧ください。目次 Pythonとは？言語の特徴 Pythonを学習するメリット Pythonでできること Pythonが使われているサービス初心者が効率よくPythonを学習するための順番（ロードマップ）まずはPythonの開発環境を整えよう Pythonとは？言語の特徴 Pythonとはプログラミング言語の1つです。C言語などと比較して分かりやすい文法が特徴です。非常に広く使われているため学習するためのサイトや本も充実しています。2020年現在、最新のGitHubの調査(2019年)では世界2位の人気を記録しています。画像出典：GitHub また、Pythonはプログラミング教育や初心者向けのプログラミング言語としても多く使われています。これは、Pythonの簡潔な言語仕様により、少ないコード行数で分かりやすいソースコードを書くことができるためです。がんばれば、超一流のプログラマーと同じようなコードを、初心者でも真似して書くことが可能です。また、最近では、AI（人工知能）分野でPythonが利用されることで注目を浴びています。 [PR] 未経験からWebエンジニアを目指す方法とはPythonを学習するメリット Pythonを学ぶメリットは多くあります。前述の通り、プログラミング初心者の方でも安心して学ぶことができますし、非常に人気があるプログラミング言語なので、これからも長期に渡って利用できることでしょう。以前は日本では大学や研究機関での利用が主でしたが、最近ではPythonを使ったWebサービスやAI関連のビジネスなどに多く活用されています。例えば求人・採用サイトのGreenでPythonの求人情報を検索してみると約760件該当があります(2020年6月現在)。これはフロントエンドとほぼ同等の求人数です。すでにシステム開発でも一般的に利用されているプログラミング言語と言って良いでしょう。画像出典：Green PythonはGoogleやNASAの内部でも利用されています。現在でもGoogleの求人情報にはPythonエンジニアの求人が存在します。画像出典：Google人材募集 Pythonでできること Pythonは、組み込みアプリ開発やWebサイト構築から、ディープラーニングまで様々な分野で利用可能な言語です。Pythonでは多くのWebサービスが作成されています。 PythonでWebサービスを作成する上でよく利用されているのが「Django」や「Flask」というフレームワークです。 Pythonで人気のフレームワークまとめ現在は、AI（人工知能）や機械学習分野で使用されているPythonの技術が注目されています。例えば、深層学習と呼ばれるディープラーニングの分野でも多くのソフトウェアがPythonで動作しています。 Scikit-learn（統一された関数で機械学習を実施可能） Keras（簡単に計算グラフを扱うことができる。） TensorFlow（Googleが開発したディープラーニングのフレームワーク） PyTorch（Facebookで研究用途に使用されているディープラーニングのフレームワーク）その他にもインターネット上から情報を収集するWebスクレイピングと呼ばれる分野でもPythonは多く活用されています。 Pythonが使われているサービスそれでは実際にPythonが使われているサービスをいくつか見てみましょう。 YouTube 世界最大の動画共有サービスであるYouTubeにPythonが使用されています。Pythonは主にバックエンド(Webサーバー側で動作するプログラム)で活用されており、動画処理やデータの読み込みなどに使用されています。 YouTubeのエンジニアによると「PythonはYouTubeにとって十分に早く、最小の開発者で迅速に開発を行うことができる」と評価されています(※)。 ※ Python公式サイト – Quotes about Python より YouTube Google GmailやGoogle MapsのバックエンドでPythonが利用されています。Googleではソフトウェア開発はデータサイエンスなどの分野で多くのPythonエンジニアが活躍しており、前述の通り求人も行われています。 Google Blender Blenderはオープンソースの3Dグラフィックスを作成するソフトウェアです。オープンソースながら非常に機能が充実しており、日本語にも対応しているため幅広く利用されています。 Blenderにはプログラミングによりキャラクターを動作させてりグラフィックス効果を行う機能があり、そのプログラミング言語としてPythonが使用されています。 Blender PayPal PayPalは世界最大規模のオンライン決済サービスです。ディープラーニングのライブラリであるTensorFlowを使用して、不正な決済の検出を実現しています。 TensorFlowを始めとするディープラーニングは金融業界(フィンテック分野)でも多く利用されており、プログラミング言語としては主にPythonが使用されています。 PayPal OpenStack クラウド環境の構築に利用されているオープンソースのソフトウェアであるOpenStackも大部分にPythonが利用されています。OpenStackを使うと自前でAWSのようなクラウドサービスを提供することができます。様々な規模のデータセンターで数多く利用されており、安定的な運用をPythonが支えています。 OpenStack 初心者が効率よくPythonを学習するための順番（ロードマップ）初心者が効率よくPythonを学習するには、プログラミング言語の基本を学習した後で、機械学習やWebサービスなどの興味がある分野を掘り下げて学習すると良いでしょう。プログラミング言語の基本を学習する初めてプログラミング言語を学習する場合、できれば周りに相談できる人がいると理想的です。プログラムはちょっとした間違いで動作しなくなってしまう場合があり、一人で学習していると間違っているところが分からずに何日も無駄にしかねません。そのような時に経験者が身の回りにいると心強いことでしょう。身の回りにプログラミング経験者がいない場合は、YouTubeなどの動画で学ぶのもおすすめです。最近はプログラミング教育系の動画も充実しており「python 入門」というキーワードで検索すると数多くの動画がヒットします。TechacademyでもPythonの入門動画を公開しているので、ぜひ参考にしてください。 YouTube – Techacademy「Pythonとは」もちろん王道は書籍や公式サイトでじっくりと学習することです。一人で調べるスキルはエンジニアにとってとても重要です。せっかくの機会ですので学習の過程で調査するスキルも身につけると良いでしょう。機械学習やWebサービスなどの興味がある分野を掘り下げるある程度プログラミングの基本が学習できたら、興味がある分野に集中して、実際に動作するアプリの開発にチャレンジしてみましょう。はじめはどのようにアプリを開発すれば良いか全く分からないでしょうから、フレームワークの公式サイトや書籍などを参考にしながら進めると良いでしょう。いくつかおすすめのライブラリをご紹介します。機械学習機械学習のライブラリでおすすめなのはscikit-learnです。また行列計算を行うNumPy、データの前処理で活用するPandas、グラフ描画に使用するMatplotlibなども一緒に良く使われます。 scikit-learn Numpy Pandas Matplotlib また、機械学習では、JupyterNotebookと呼ばれるソフトウェアで開発を行うことが多くあります。JupyterNotebookはソースコードと説明文、実行結果をひとまとめにNotebookで管理できるソフトウェアで、データサイエンティストや機械学習エンジニアに多く利用されています。 Jupyter Notebook Webサービス PythonでWebサービスを開発するのであればDjangoまたはFlaskというフレームワークを使用することが一般的です。比較的Flaskの方が覚えることが少なく容易に利用を始めることができます。日本ではDjangoの方が多く利用されており、日本語ドキュメントの充実といった観点からはDjangoに軍配があがることでしょう。 Django Flask まずはPythonの開発環境を整えよう Pythonの学習をはじめるにあたり、まずはPythonの開発環境を整えましょう。Pythonの学習をスムーズに行うためには以下のようなものが必要です。パソコン WindowsでもMacでもかまいません。CPUはCorei5以上、メモリは8GB以上あると快適でしょう。iPadなどのタブレットでも学習できない訳ではありませんが、エンジニアがプログラミングを行う場合は基本的にパソコンを使用するため、揃えておくと良いでしょう。インターネットへの接続環境 Python本体やライブラリ、フレームワークなどの入手は全てインターネットを経由して行います。できれば光回線などの常時接続環境を良いすると良いでしょう。パソコンとインターネットへの接続環境が整ったら、Pythonの開発環境を構築しましょう。とは言ってもPythonの公式サイトからダウンロードしてインストールするだけです。 Python公式サイト – ダウンロード「Download Python 3.8.3」と書かれてあるボタンをクリックするとダウンロードが開始されます(3.8.3などのバージョンは時期により異なります)。 Pythonのインストールが完了したらプログラミングを行うエディタもインストールしておくと良いでしょう。おすすめはVisual Studio Codeです。こちらもリンクからダウンロードしてインストールするだけで利用できます。 Visual Studio Code Visual Studio Codeの使い方を解説した記事もありますので読んでみるといいでしょう。まとめ今回は、人気のプログラミング言語であるPythonについて解説しました。 GoogleやYouTubeなど多くのデータを扱うサービスで積極的に採用されている言語です。これから日本でもPythonを採用する企業は増えるでしょうし、海外でも常に必要とされる人材なので、グローバルに働くチャンスがあるでしょう。監修してくれたメンター太田和樹（おおたかずき） ITベンチャー企業のPM兼エンジニア普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。開発実績：画像認識技術を活用した駐車場混雑状況把握、音声認識を活用したヘルプデスク支援システム、ロボットアプリの開発、大規模基幹系システムの開発・導入マネジメント。著書「知識ゼロからの機械学習入門（技術評論社）」。地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。また、オンラインのプログラミングスクールTechAcademyではPythonを使って機械学習の基礎を学ぶPythonオンライン講座を開催しています。初心者向けの書籍を使って人工知能（AI）や機械学習について学ぶことができます。現役エンジニアがパーソナルメンターとして受講生に1人ずつつき、マンツーマンのメンタリングで学習をサポートし、習得することが可能です。オンラインでの説明動画や、実際のカリキュラムで学べる無料体験も実施しています。まずはこちらを試してみてくださいね！

Python

PythonのIDE（統合開発環境）でオススメなものは？現役エンジニアが解説【初心者向け】

PythonのIDE（統合開発環境）でおすすめなものについて解説します。目次 IDEとは PythonでのIDEにはどんなものがある？ Pythonでの開発の際にIDEを選ぶポイント IDEとは IDEとは、Integrated Development Environmentの略で、日本語では統合開発環境です。ソフトウェア開発では、コーディング、コンパイル、リンク、テスト、バージョン管理といった複数の作業を繰り返し行います。 IDEを使うことで、一つのソフトウェアでこれらの操作を行うことができ、ソフトウェア開発の効率や品質が向上します。最近では拡張機能(プラグイン)を用いて、後から対応言語や機能を増やせるものが一般的です。 [PR] 未経験からWebエンジニアを目指す方法とはPythonでのIDEにはどんなものがある？ PyCharm PyCharmはJetBrainsの販売している、有償のPython向けIDEです。 PyCharmはコーディングをインテリジェントに補佐することをうたっています。例えば、コード補完、検査、リアルタイムでのエラー指摘や修正、自動リファクタリングといった機能を持ちます。 PyCharmに関しては、次の記事も参考にしてみてくださいね。 PyCharmでAnacondaと連携してPython開発する方法を現役エンジニアが解説【初心者向け】 | TechAcademyマガジン Visual Studio Code Visual Studio Codeは、マイクロソフトが無料で公開しているエディタです。エディタですが、無料で利用できる拡張機能が非常に多いため、無料とは思えないほど使いやすいです。 Visual Studio Code（ビジュアル・スタジオ・コード）は、略してVSCode（ブイエスコード）と呼ばれています。 Azure や GitHub と統合された機能と拡張機能を使用して、すべてを 1か所で開発、デバッグ、デプロイできます。 Visual Studio Codeについては、こちらの記事も参考にしてみてください。 Visual Studio Codeとは？インストールや使い方も現役エンジニアが解説 | TechAcademyマガジン Visual Studio CodeでPythonを実行する方法を現役エンジニアが解説【初心者向け】 | TechAcademyマガジン PyScripter PyScripterはフリー、オープンソースのPython向けIDEです。有償のIDEに匹敵する機能の提供を目指しています。機能が豊富かつ無償のため、最初に試すPython向けIDEとして良い選択肢です。利用方法 ①PyScripterにアクセスし、緑色のDownloadをクリック。 ②PyScripter-3.6.4-x64-Setup.exe　のようなファイルがダウンロードされるので、ダブルクリックする。 ③インストール準備が開始されるので、基本的には標準設定の状態でOKや次へをクリックする。次へをクリックする。デスクトップにアイコンを作成する場合は、デスクトップ上にアイコンを追加するにチェックを入れて、次へをクリックする。 ④インストール準備が完了したら、インストールをクリックしてインストールを完了させる。 ⑤デスクトップ上にこのようなアイコンが生成されるのでダブルクリックしてPyScripterを起動してください。 Atom AtomはIDEというよりはエディタで、パッケージによる機能拡張を特徴にしています。パッケージにより、Pythonに限らず多数の言語に対応しています。複数のプログラミング言語を使い分ける場合、エディタをAtomで統一するのはーつの有効な手段です。以下でPythonのコーディングに便利なパッケージを紹介します。 atom-runner Atom内でスクリプトを実行できます。Pythonの他、JavaScriptやRubyにも対応しています。 autocomplete-python Pythonスクリプトのコーディングで自動補完を行います。変数、クラス、パッケージ名などのタイピングが楽になります。 atom-beautify プログラミング言語の構文にもとづき、コードを自動整形します。カッコの対応やインデントの間違いを見つけやすくなります。 Atomに関しては、次の記事も参考にしてみてくださいね。 AtomでPythonの開発環境を作る方法を現役エンジニアが解説【初心者向け】 | TechAcademyマガジン Microsoft Visual Studio Microsoft Visual StudioはMicrosoft社の提供するIDEです。有償のProfessional, Enterprise版と、無償のCommunity版があります。 Pythonだけでなく、C++, C#, Visual Basicでのコーディングなどにも対応しています。 Visual Studioは巨大な製品群です。 VSCodeの場合、必要に応じて自分の好きな拡張機能を追加しながら利用していくことができます。しかし、それは大企業で利用する場合は管理上難しいことがあります。つまり、大企業で利用する場合セキュリティの安全性を保ったり、作業を管理するために開発環境をすべて統一することがあります。その場合、VSCodeではなく、VisualStudioを利用することで、有償サポートを利用したりもでき、結果的に大企業内での管理コストや開発コストを削減することにつながります。 VisualStudioの有償プラン Pythonでの開発の際にIDEを選ぶポイント会社(業務)で開発する際には、会社、部署、所属のプロジェクトなどで、IDEが規定されている場合があります。規定されていない場合も、周囲に特定のIDEユーザが多いようであれば、そのIDEを選択しておくのが無難です。 IDEごとにソースコード整形の規則が異なるため、別のIDEを使うと可読性を損なうケースがあります。また、IDEの利用方法で困った際に、周囲のサポートを受けやすいという面もあります。一方、個人で開発する際には、捻出できる費用も限られがちなので、まずは無償のIDEをいくつか試してみるのがおすすめです。開発するプログラムの性質や、個人の趣向により、IDEの向き不向きがあります。そのIDEをしばらく使ってみて、合うならば継続すればよいでしょう。合わなかったり機能の不足を感じたりするならば、別の無償IDEを試すか、有償IDEの購入を検討してみてはどうでしょうか。この記事を監修してくれた方中本賢吾（なかもとけんご）アジマッチ有限会社　代表取締役社長開発実績：PHPフレームワークによるフランチャイズ企業向け会員制SNS。Shopifyによる海外進出用大規模ネットショップ構築。Vue.jsによる金融機関向け内部アプリ。AWSやLinuxハウジングサーバでの環境構築。人工知能を利用した画像判別システム。小売チェーン店舗用スマホアプリ。Wordpressによる不動産チェーン店向け賃貸・売買仲介システム。基幹システム移管用データコンバートシステム。小学生がオリジナルAndroidアプリをGoogle Playでリリース、NHK Whyプログラミング入賞、全国Programing Festival入賞、中学生がSNS型PWAアプリリリースなど、ボランティアプログラミング教育活動行っている。大石ゆかり内容が分かりやすくて良かったです！田島悠介ゆかりちゃんも分からないことがあったら質問してね！大石ゆかり分かりました。ありがとうございます！ Pythonを学習中の方へこれで解説は終了です、お疲れさまでした。つまずかず「効率的に」学びたい副業や転職後の「現場で使える」知識やスキルを身につけたいプログラミングを学習していて、このように思ったことはありませんか？テックアカデミーのPythonコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、人工知能（AI）や機械学習の基礎を完全オンラインでしっかり習得できます。まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！

Python

Visual Studio Code（VSCode）とは？インストールや使い方も現役エンジニアが解説

Visual Studio Code（VSCode）について、TechAcademyのメンター（現役エンジニア）が初心者向けに解説します。Visual Studio Codeとはエディタのひとつです。機能性や拡張性や開発者コミュニティなどが優れており、使いこなせるようになると実装したい機能を手早くプログラムできるようになりましょう。今回の記事では概要から実際のダウンロード方法まで解説していきます。なお本記事は、TechAcademyのオンラインブートキャンプの内容をもとにしています。なお、今回の記事の内容は動画でもご覧いただけます。テキストよりも動画の方が理解しやすいという場合はぜひご覧ください。田島悠介今回は、プログラミングに関する内容だね！大石ゆかりどういう内容でしょうか？田島悠介 Visual Studio Codeについて詳しく説明していくね！大石ゆかりお願いします！目次 Visual Studio Codeとは Visual Studio Codeの特徴 Visual Studio Codeを使うメリット/デメリット Visual Studio Codeの使い方 Visual Studio Codeの料金 Visual Studio Codeの評判 Visual Studio Codeを使うべき人まとめ Visual Studio Codeとは Visual Studio Codeとは、プログラミングを行う時は「エディタ」と呼ばれるソフトウェアのひとつです。エディタとは言わば高機能なメモ帳のようなものです。エディタには多くの種類がありますが、その中でも現在エンジニアの間で最も多く利用されていると言われているのが「Visual Studio Code（ビジュアル・スタジオ・コード）」です。エンジニアの間では略して「VSCode（ブイエスコード）」と呼ばれています。 Visual Studio Codeは単にエディタというだけではなく、プログラミングやシステム開発に関する様々な作業を効率的に行える機能が数多く用意されています。プログラミングを開発するソフトウェア群を「開発環境」と呼びます。 Visual Studio Codeは数多くのプログラミング言語で使用されている主要な開発環境の1つと言えます。 [PR] 未経験からWebエンジニアを目指す方法とはVisual Studio Codeの特徴 Visual Studio Codeはマイクロソフト社が開発しているエディタであり以下のような特徴があります。オープンソース誰でも無償で利用できます。 Visual Studio Codeのソースコード自体もGitHubというWebサイトで誰でも閲覧可能な状態で管理されています。多くのオペレーティングシステム（OS）に対応 WindowsやMac、Linuxなど、多くのオペレーティングシステムに対応しています。多くの言語に対応メニューなどの表記を様々な言語に切り替えることが可能です。英語や日本語だけでなく、中国語やフランス語、ドイツ語など多くの言語に対応しています。拡張機能「拡張機能」と呼ばれる仕組みで機能を追加することが出来ます。拡張機能は数多く提供されており、プログラミングの目的に合った拡張機能を組み合わせることで最適な開発環境を構築することができます。その他ソースコードの入力補助（コード補完）や見た目を変えるテーマ、キーボード入力の変更など、多くの機能が提供されています。なお、Visual Studio Codeと名前は似ていますが全く別の製品としてVisual Studioがあります。 Visual StudioはWebやWindowsアプリーケーションなどを構築する統合開発環境です。エディタ機能に加えてシステム開発プロジェクトの管理やアプリの試験、解析などを行う機能が組み込まれています。用途が異なりますので間違えないように注意しましょう。 Visual Studio Codeを使うメリット/デメリット Visual Studio Codeを使うメリット/デメリットについて解説していきます。メリットは開発効率の向上上記のようにVisual Studio Codeは非常に自由度と拡張性が高いエディタであるため、慣れてくるととても作業効率が上がることを実感できます。現在最も多く利用されているエディタだけあり、システム開発で使用されるバージョン管理やUI設計などのソフトウェアとの連携、クラウド環境との接続などをVisual Studio Code上で行うことが出来ます。利用者が多いため、使用方法などについて多くの情報を得られることもメリットの1つです。デメリットは機能を使いこなせない逆にデメリットとして、あまりにも機能が豊富すぎるため、最初はメニュー構成や設定、拡張機能の導入などに戸惑うことも多いと思われます。これらについてはインターネット上で多くの導入事例が提供されているため、自分の目的に合った開発環境を構築する情報を収集すると良いでしょう。また、インターネットから切り離された環境の場合、拡張機能のインストールなどを手動で行う必要があり、やや運用が面倒に感じられるかもしれません。ただ一度開発環境を構築してしまえば常時インターネット接続は必須ではないため、そのような環境でも十分に運用に耐えられることでしょう。 Visual Studio Codeの使い方それでは具体的にVisual Studio Codeの使い方をご説明しましょう。ダウンロード手順 Visual Studio

プログラミング

記事を検索

ニュース

インタビュー

テクノロジー

キャリア

お問い合わせ

vscodeでPythonのdocstringを作成する方法を現役エンジニアが解説【初心者向け】

docstringとは

docstringの作成に便利なvscodeの拡張機能

導入方法

初期設定