Menu
AWS Cloud9
User Guide

Working with Project Settings in the AWS Cloud9 Integrated Development Environment (IDE)

Project settings, which apply only to the current AWS Cloud9 development environment, include the following kinds of settings:

  • Code editor behaviors, such as whether to use soft tabs and new file line ending behavior

  • File types to ignore

  • The types of hints and warnings to display or suppress

  • Code and formatting behaviors for programming languages such as JavaScript, PHP, Python, and Go

  • The types of configurations to use when running and building code

Although project settings apply to only a single environment, you can apply the project settings for one environment to any other environment.

View or Change Project Settings

  1. On the menu bar, choose AWS Cloud9, Preferences.

  2. To view the project settings for the current environment, on the Preferences tab, in the side navigation pane, choose Project Settings.

  3. To change the current project settings for the environment, change the settings you want in the Project Settings pane.

See Project Setting Changes You Can Make.

Apply the Current Project Settings for an Environment to Another Environment

  1. In both the source and target environment, on the menu bar of the AWS Cloud9 IDE, choose AWS Cloud9, Open Your Project Settings.

  2. In the source environment, copy the contents of the project.settings tab that is displayed.

  3. In the target environment, overwrite the contents of the project.settings tab with the copied contents from the source environment.

  4. In the target environment, save the project.settings tab.

Project Setting Changes You Can Make

These sections describe the kinds of project settings that you can change on the Preferences tab's Project Settings pane.

Code Editor (Ace)

Soft Tabs

If selected, inserts the specified number of spaces instead of a tab character each time you press Tab.

Autodetect Tab Size on Load

If selected, AWS Cloud9 attempts to guess the tab size.

New File Line Endings

The type of line endings to use for new files.

Valid options include:

  • Windows (CRLF) to end lines with a carriage return and then a line feed.

  • Unix (LF) to end lines with just a line feed.

On Save, Strip Whitespace

If selected, AWS Cloud9 attempts to remove what it considers to be unnecessary spaces and tabs from a file each time that file is saved.

Find in Files

Ignore these Files

When finding in files, the types of files that AWS Cloud9 will ignore.

Maximum number of files to search (in 1000)

When finding in files, the maximum number of files, in multiples of 1,000, that AWS Cloud9 will find in the current scope.

Hints & Warnings

Warning Level

The minimum level of messages to enable.

Valid values include:

  • Info to enable informational, warning, and error messages.

  • Warning to enable just warning and error messages.

  • Error to enable just error messages.

Mark Missing Optional Semicolons

If enabled, AWS Cloud9 flags in a file each time it notices a semicolon that could be used in code, but that isn't used.

Mark Undeclared Variables

If enabled, AWS Cloud9 flags in a file each time it notices an undeclared variable in code.

Mark Unused Function Arguments

If enabled, AWS Cloud9 flags in a file each time it notices an unused argument in a function.

Ignore Messages Matching Regex

AWS Cloud9 will not display any messages matching the specified regular expression. For more information, see Writing a regular expression pattern in the JavaScript Regular Expressions topic on the Mozilla Developer Network.

JavaScript Support

Customize JavaScript Warnings With .eslintrc

If enabled, AWS Cloud9 uses an .eslintrc file to determine which JavaScript warnings to enable or disable. For more information, see Configuration File Formats on the ESLint website.

JavaScript Library Code Completion

The JavaScript libraries AWS Cloud9 uses to attempt to suggest or do automatic code completion.

Format Code on Save

If enabled, AWS Cloud9 attempts to format the code in a JavaScript file every time that file is saved.

Use Builtin JSBeautify as Code Formatter

If enabled, AWS Cloud9 uses its internal implementation of JSBeautify to attempt to increase the readability of code in files.

Custom Code Formatter

The command for AWS Cloud9 to attempt to run when formatting code in a JavaScript file.

Build

Builder Path in environment

The path to any custom build configurations.

Run & Debug

Runner Path in Environment

The path to any custom run configurations.

Preview URL

The URL to use to preview applications for the environment.

Run Configurations

The custom run configurations for this environment.

Remove Selected Configs

Deletes the selected run configurations.

Add New Config

Creates a new run configuration.

Set As Default

Sets the selected run configuration as the default run configuration.

Code Formatters

JSBeautify settings

Settings for increasing the readability of code in files.

Format Code on Save

If enabled, AWS Cloud9 attempts to apply JSBeautify settings whenever code files are saved.

Use JSBeautify for JavaScript

If enabled, AWS Cloud9 attempts to apply JSBeautify settings whenever JavaScript files are saved.

Preserve Empty Lines

If enabled, AWS Cloud9 does not remove empty lines in code files.

Keep Array Indentation

If enabled, AWS Cloud9 preserves the indentation of element declarations in arrays in code files.

JSLint Strict Whitespace

If enabled, AWS Cloud9 attempts to apply JSLint whitespace rules in code files. For more information, see "Whitespace" in JSLint Help.

Braces

Specifies the alignment of braces in code.

Valid values include:

  • Braces with control statement to move each beginning and end brace to align with its related control statement, as needed.

    For example, this code:

    Copy
    for (var i = 0; i < 10; i++) { if (i == 5) { console.log("Halfway done.") }}

    Turns into this code when the file is saved:

    Copy
    for (var i = 0; i < 10; i++) { if (i == 5) { console.log("Halfway done.") } }
  • Braces on own line to move each brace to its own line, as needed.

    For example, this code:

    Copy
    for (var i = 0; i < 10; i++) { if (i == 5) { console.log("Halfway done.") }}

    Turns into this code when the file is saved:

    Copy
    for (var i = 0; i < 10; i++) {if (i == 5) { console.log("Halfway done.") } }
  • End braces on own line to move each end brace to its own line, as needed.

    For example, this code:

    Copy
    for (var i = 0; i < 10; i++) { if (i == 5) { console.log("Halfway done.") } }

    Turns into this code when the file is saved:

    Copy
    for (var i = 0; i < 10; i++) { if (i == 5) { console.log("Halfway done.") } }
Space Before Conditionals

If enabled, AWS Cloud9 adds a space before each conditional declaration, as needed.

Unescape Strings

If enabled, AWS Cloud9 converts escaped strings to their unescaped equivalents. For example, converts \n to a newline character and converts \r to a carriage return character.

Indent Inner Html

If enabled, AWS Cloud9 indents <head> and <body> sections in HTML code.

PHP Support

Enable PHP code Completion

If enabled, AWS Cloud9 attempts to complete PHP code.

PHP Completion Include Paths

Locations that AWS Cloud9 uses to attempt to help complete PHP code.

Format Code on Save

If enabled, AWS Cloud9 attempts to format PHP code whenever PHP files are saved.

Custom Code Formatter

The path to any custom code formatting configuration for PHP code.

Python Support

Enable Python code completion

If enabled, AWS Cloud9 attempts to complete Python code.

Python Version

Specifies the version of Python to use.

Pylint command-line options

Options for AWS Cloud9 to use for Pylint wih Python code. For more information, see the Pylint User Manual on the Pylint website.

PYTHONPATH

The paths to Python libraries and packages for AWS Cloud9 to use.

Format Code on Save

If enabled, AWS Cloud9 attempts to format Python code whenever Python files are saved.

Custom Code Formatter

The path to any custom code formatting configuration for Python code.

Go Support

Enable Go code completion

If enabled, AWS Cloud9 attempts to complete Go code.

Format Code on Save

If enabled, AWS Cloud9 attempts to format Go code whenever Go files are saved.

Custom Code Formatter

The path to any custom code formatting configuration for Go code.