diff --git a/src/utilities/__tests__/schemaPrinter-test.js b/src/utilities/__tests__/schemaPrinter-test.js index bb4f518d131..c5ecf56105b 100644 --- a/src/utilities/__tests__/schemaPrinter-test.js +++ b/src/utilities/__tests__/schemaPrinter-test.js @@ -612,6 +612,72 @@ 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` + schema { + query: Root + } + + type Root { + """This field is awesome""" + singleField: String + } + `); + const recreatedRoot = buildSchema(output).getTypeMap()['Root']; + 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` + schema { + query: Root + } + + type Root { + """ + This field is "awesome" + """ + singleField: String + } + `); + const recreatedRoot = buildSchema(output).getTypeMap()['Root']; + 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` + schema { + query: Root + } + + type Root { + """ This field is "awesome" + """ + singleField: String + } + `); + const recreatedRoot = buildSchema(output).getTypeMap()['Root']; + const recreatedField = recreatedRoot.getFields()['singleField']; + expect(recreatedField.description).to.equal(description); + }); + it('Print Introspection Schema', () => { const Root = new GraphQLObjectType({ name: 'Root', diff --git a/src/utilities/schemaPrinter.js b/src/utilities/schemaPrinter.js index 6dc1e189bc2..461210554a7 100644 --- a/src/utilities/schemaPrinter.js +++ b/src/utilities/schemaPrinter.js @@ -338,15 +338,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;