예제 #1
0
        /// <summary>
        /// Convert an annotation and fenced code block in the documentation into something usable. Adds
        /// the detected object into one of the internal collections of resources, methods, or examples.
        /// </summary>
        /// <param name="metadata"></param>
        /// <param name="code"></param>
        public ItemDefinition ParseCodeBlock(Block metadata, Block code)
        {
            if (metadata.BlockType != BlockType.html)
                throw new ArgumentException("metadata block does not appear to be metadata");

            if (code.BlockType != BlockType.codeblock)
                throw new ArgumentException("code block does not appear to be code");

            var metadataJsonString = metadata.Content.Substring(4, metadata.Content.Length - 9);
            var annotation = CodeBlockAnnotation.FromJson(metadataJsonString);

            switch (annotation.BlockType)
            {
                case CodeBlockType.Resource:
                    {
                        var resource = new ResourceDefinition(annotation, code.Content, this, code.CodeLanguage);
                        this.resources.Add(resource);
                        return resource;
                    }
                case CodeBlockType.Request:
                    {
                        var method = MethodDefinition.FromRequest(code.Content, annotation, this);
                        if (string.IsNullOrEmpty(method.Identifier))
                            method.Identifier = string.Format("{0} #{1}", this.DisplayName, this.requests.Count);
                        this.requests.Add(method);
                        return method;
                    }

                case CodeBlockType.Response:
                    {
                        MethodDefinition pairedRequest = null;
                        if (!string.IsNullOrEmpty(annotation.MethodName))
                        {
                            // Look up paired request by name
                            pairedRequest = (from m in this.requests where m.Identifier == annotation.MethodName select m).FirstOrDefault();
                        }
                        else
                        {
                            pairedRequest = Enumerable.Last(this.requests);
                        }

                        if (null == pairedRequest)
                        {
                            throw new InvalidOperationException(string.Format("Unable to locate the corresponding request for response block: {0}. Requests must be defined before a response.", annotation.MethodName));
                        }

                        pairedRequest.AddExpectedResponse(code.Content, annotation);
                        return pairedRequest;
                    }
                case CodeBlockType.Example:
                    {
                        var example = new ExampleDefinition(annotation, code.Content, this, code.CodeLanguage);
                        this.examples.Add(example);
                        return example;
                    }
                case CodeBlockType.Ignored:
                    return null;
                case CodeBlockType.SimulatedResponse:
                    {
                        var method = Enumerable.Last(this.requests);
                        method.AddSimulatedResponse(code.Content, annotation);
                        return method;
                    }
                case CodeBlockType.TestParams:
                    {
                        var method = Enumerable.Last(this.requests);
                        method.AddTestParams(code.Content);
                        return method;
                    }
                default:
                    throw new NotSupportedException("Unsupported block type: " + annotation.BlockType);
            }
        }
예제 #2
0
        /// <summary>
        /// Convert an annotation and fenced code block in the documentation into something usable. Adds
        /// the detected object into one of the internal collections of resources, methods, or examples.
        /// </summary>
        /// <param name="metadata"></param>
        /// <param name="code"></param>
        public ItemDefinition ParseCodeBlock(Block metadata, Block code)
        {
            if (metadata.BlockType != BlockType.html)
            {
                throw new ArgumentException("metadata block does not appear to be metadata");
            }

            if (code.BlockType != BlockType.codeblock)
            {
                throw new ArgumentException("code block does not appear to be code");
            }

            var metadataJsonString = metadata.Content.Substring(4, metadata.Content.Length - 9);
            var annotation         = CodeBlockAnnotation.FromJson(metadataJsonString);

            switch (annotation.BlockType)
            {
            case CodeBlockType.Resource:
            {
                var resource = new ResourceDefinition(annotation, code.Content, this, code.CodeLanguage);
                this.resources.Add(resource);
                return(resource);
            }

            case CodeBlockType.Request:
            {
                var method = MethodDefinition.FromRequest(code.Content, annotation, this);
                if (string.IsNullOrEmpty(method.Identifier))
                {
                    method.Identifier = string.Format("{0} #{1}", this.DisplayName, this.requests.Count);
                }
                this.requests.Add(method);
                return(method);
            }

            case CodeBlockType.Response:
            {
                MethodDefinition pairedRequest = null;
                if (!string.IsNullOrEmpty(annotation.MethodName))
                {
                    // Look up paired request by name
                    pairedRequest = (from m in this.requests where m.Identifier == annotation.MethodName select m).FirstOrDefault();
                }
                else
                {
                    pairedRequest = Enumerable.Last(this.requests);
                }

                if (null == pairedRequest)
                {
                    throw new InvalidOperationException(string.Format("Unable to locate the corresponding request for response block: {0}. Requests must be defined before a response.", annotation.MethodName));
                }

                pairedRequest.AddExpectedResponse(code.Content, annotation);
                return(pairedRequest);
            }

            case CodeBlockType.Example:
            {
                var example = new ExampleDefinition(annotation, code.Content, this, code.CodeLanguage);
                this.examples.Add(example);
                return(example);
            }

            case CodeBlockType.Ignored:
                return(null);

            case CodeBlockType.SimulatedResponse:
            {
                var method = Enumerable.Last(this.requests);
                method.AddSimulatedResponse(code.Content, annotation);
                return(method);
            }

            case CodeBlockType.TestParams:
            {
                var method = Enumerable.Last(this.requests);
                method.AddTestParams(code.Content);
                return(method);
            }

            default:
                throw new NotSupportedException("Unsupported block type: " + annotation.BlockType);
            }
        }