diff --git a/src/utilities/__tests__/schemaPrinter-test.js b/src/utilities/__tests__/schemaPrinter-test.js index ce728bd180..66c8baabf5 100644 --- a/src/utilities/__tests__/schemaPrinter-test.js +++ b/src/utilities/__tests__/schemaPrinter-test.js @@ -545,6 +545,60 @@ describe('Type System Printer', () => { `); }); + it('One-line prints a short description', () => { + const description = 'This field is awesome'; + const output = printSingleFieldSchema({ + type: GraphQLString, + description, + }); + expect(output).to.equal(dedent` + type Query { + """This field is awesome""" + singleField: String + } + `); + const recreatedRoot = buildSchema(output).getTypeMap()['Query']; + const recreatedField = recreatedRoot.getFields()['singleField']; + expect(recreatedField.description).to.equal(description); + }); + + it('Does not one-line print a description that ends with a quote', () => { + const description = 'This field is "awesome"'; + const output = printSingleFieldSchema({ + type: GraphQLString, + description, + }); + expect(output).to.equal(dedent` + type Query { + """ + This field is "awesome" + """ + singleField: String + } + `); + const recreatedRoot = buildSchema(output).getTypeMap()['Query']; + const recreatedField = recreatedRoot.getFields()['singleField']; + expect(recreatedField.description).to.equal(description); + }); + + it('Preserves leading spaces when printing a description', () => { + const description = ' This field is "awesome"'; + const output = printSingleFieldSchema({ + type: GraphQLString, + description, + }); + expect(output).to.equal(dedent` + type Query { + """ This field is "awesome" + """ + singleField: String + } + `); + const recreatedRoot = buildSchema(output).getTypeMap()['Query']; + const recreatedField = recreatedRoot.getFields()['singleField']; + expect(recreatedField.description).to.equal(description); + }); + it('Print Introspection Schema', () => { const Query = new GraphQLObjectType({ name: 'Query', diff --git a/src/utilities/schemaPrinter.js b/src/utilities/schemaPrinter.js index 8515bafef8..f52785e9d0 100644 --- a/src/utilities/schemaPrinter.js +++ b/src/utilities/schemaPrinter.js @@ -336,15 +336,30 @@ function printDescription( return printDescriptionWithComments(lines, indentation, firstInBlock); } - let description = indentation && !firstInBlock ? '\n' : ''; - if (lines.length === 1 && lines[0].length < 70) { - description += indentation + '"""' + escapeQuote(lines[0]) + '"""\n'; - return description; + let description = + indentation && !firstInBlock + ? '\n' + indentation + '"""' + : indentation + '"""'; + + // In some circumstances, a single line can be used for the description. + if ( + lines.length === 1 && + lines[0].length < 70 && + lines[0][lines[0].length - 1] !== '"' + ) { + return description + escapeQuote(lines[0]) + '"""\n'; } - description += indentation + '"""\n'; + // Format a multi-line block quote to account for leading space. + const hasLeadingSpace = lines[0][0] === ' ' || lines[0][0] === '\t'; + if (!hasLeadingSpace) { + description += '\n'; + } for (let i = 0; i < lines.length; i++) { - description += indentation + escapeQuote(lines[i]) + '\n'; + if (i !== 0 || !hasLeadingSpace) { + description += indentation; + } + description += escapeQuote(lines[i]) + '\n'; } description += indentation + '"""\n'; return description;