1QuickStartGuide.ExploringtheIDEWelcometoPyCharm!ThisshortguideaimstohelpyougetagriponthePyCharmIDE.Beforeyoustart…MakesurethatatleastonePythoninterpreter,versionfrom2.4to3.4isproperlyinstalledonyourcomputer.MindthatPyCharmisavailableintwoeditions:CommunityandProfessional.ThedifferencebetweentheeditionsisexploredinEditionComparisonMatrix.Notethatthedownloadpagecontainsinstallationinstructionsforthevariousplatforms;theseinstructionsmayvaryforthedifferentoperatingsystems.InitialsetupIfthisistheveryfirsttimeyoulaunchyourPyCharm,itwillaskyouseveralimportantquestions:First,whetheryoualreadyhavesettingyouwanttopreserve(forexample,fromapreviousversion)YourlicenseinformationAnd,finally,whichkeymapandthemeyouwanttouse:NotethatPyCharmhasseveralpre-definedkeymaps:forthosewholikeEclipseorVisualStudio,fortheEmacsfans,GNOME,KDEandmore.ExplorethelistofavailablekeymapsintheKeymappageofSettings/Preferencesdialog.2ForthededicatedVimusers,PyCharmsuggestsIdeaVimpluginthathelpscodinginPyCharmasifintheVimeditor.ForthosewhocannotlivewithoutrealEmacs,PyCharmprovidesthepossibilitytouseitasanexternaleditor.Iflateryoudecidethatyourinitialchoicewaswrong,youcanalwayschangeyoursettings.TolearnmoreaboutconfiguringtheIDEthemeandkeymap,refertoourdocumentationandtutorials:Seealso:GettingstartedwithPyCharmConfiguringkeyboardschemesSettingdefaultsfromtheWelcomescreenAgain,ifthisisyourveryfirststart(orifyouhavenoopenproject),you'llseetheWelcomescreen.IfyouclickthelinkConfigure,you'llseethepageoftheWelcomescreenthatsuggestsyoutoconfigureyourenvironment,plugins,importandexportsettings.YouhavetoclickConfigureoncemore-andseetheSettings/Preferencesdialog.Ifyoulookatthisdialog,you?llnoticetheheaderDefaultProject:3Whatdoesitmean?Thesesettingswillbeusedeverytimeyoucreateanewproject.Forexample,youwantallyounewlycreatedprojectstousethesameinterpreter-OK,youcandefinesuchaninterpreterintheTemplateProjectSettings.4TheIDEsettingscharacterizeyourworkingenvironment(keymaps,colorschemesetc.)Forexample,youwantyoureditortoalwaysshowlinenumbers.IntheSettings/Preferencesdialog,gototheIDEsettings,expandthenodeEditor,andintheAppearancepage,selectthecheckboxShowlinenumbers:Next,supposeyouwanttousesomeparticularcolorschemefortheeditor,andyouarenothappywiththecolorssuggestedbydefault.OK,selectthebasescheme,createitscopy,andthenchangecolors(theschemessuggestedbydefaultarenoteditable).Itisalsopossibletosetyourpreferredfontsizefortheeditor-thisisdoneintheFontspageoftheColorsandFontssettings.Again,youhavetocreateacopyoftheschemefirst,ifyouhaven'tdoneitalready,andthenspecifythedesiredfontsizefortheeditor.Thisfontsizewillapplytothecurrenteditortabs,andallthenewlyopenededitors.However,itdoesnotaffectthefontsizeoftheIDEcomponents.NotethatyoucanalwaysseetheresultsofyourexperimentsinthePreviewpane:5Thewholeprocedureisdescribedstep-by-stepinthetutorialWhatmyPyCharmlookslike.Whenaprojectisalreadycreated,youcanchangeitssettingsatanymoment.Configuringsettingsforthecurrentprojectwillbediscussedalittlebitlater,inthesectionCustomizeeverythingforyourproject!.Finally,youcanshoworhideactuallyalltheUIelements:toolbarbuttons,mainmenu,maintoolbar(menuView);PyCharmalsoenablesyoutochooseviewingmode.Refertothedocumentationfordetails:Seealso:PyCharmtoolwindowsPresentationandFullScreenviewingmodesProjectEverythingyoudoinPyCharm,isdonewithinthecontextofaproject.WhatismostinterestingaboutPyCharmprojectmanagement,isthepossibilitytoopenmultipleprojectsinoneframe.Whenyoucreateanewproject(File→NewProject),oropenanexistingone(File→Open),PyCharmsuggestsyoutochoosewhichwayyouwanttheprojecttobeopened:inanewwindow,inthesamewindowafterclosingthepreviouslyopenedproject,oraddedtothepreviouslyopenedproject.Youcanhaveasmanyprojectsopenedinonewindowasrequired.Sodoing,thefirstprojectisconsideredtheprimaryproject.Allthesymbolsoftheaddedprojectsarevisiblefromtheprimaryproject.Asanexercise,createanewemptyproject,whereyoucandevelopsomepurePythoncode.ThiscaseisdiscussedindetailinthetutorialGettingstartedwithPyCharm—inparticular,thesectionCreatingasimpleproject.Typesofprojects6Bytheway,PyCharmsuggestscreatingprojectsofthevarioustypes:Django,Flask,Pyramid,web2py,etc.Youcanexploretheavailabletypesyourself,whencreatinganewproject-justselectthenewprojecttypefromthedrop-downlist:Asyousee,PyCharmsupportsallthemajorPython-basedframeworks.Foreachofthesupportedprojecttypes,PyCharmcreatesthecorrespondingfileanddirectorystructure,andallthenecessaryartifacts.Refertotheproductdocumentation:DjangoFlaskPyramidGoogleAppEngineWeb2PyStarterOK,yourprojectisready.Beforeyoustartworkingwithit,justpressShifttwice.You'llseeapop-upwindowthatallowsfindinganythingandjumpingeverywhere:7Asyousee,thiswayonecansearchamongtheactions,settings,files,IDEcomponents,andmore.Notethatitisjustoneofthenumerousnavigationfeatures.We'llreturntothePyCharm'ssearchandnavigationfacilitiesalittlebitlater.Customizeeverythingforyourproject!Lookatthemaintoolbar—thereistheSettingsbutton.ClickingthisbuttonopenstheSettings/Preferencesdialogbox,whereyoucanchangeyou