yoanm/jsonrpc-server-doc-sdk

SDK to generate (Http) JSON-RPC server documentation

JSON-RPC server documentation

, _(*1)

, _(*2)

, _(*3)

, _(*4)

Php SDK to generate (Http) JSON-RPC server documentation, _(*5)

See yoanm/symfony-jsonrpc-http-server-doc for automatic dependency injection., _(*6)

See yoanm/jsonrpc-params-symfony-constraint-doc-sdk for params documentation generation., _(*7)

Availble formats

• Raw : Built-in json format
• Swagger : yoanm/jsonrpc-http-server-swagger-doc-sdk
• OpenApi : yoanm/jsonrpc-http-server-openapi-doc-sdk

How to use

Php objects

Available documentation objects:, _(*8)

• ServerDoc and HttpServerDoc for HTTP server
• MethodDoc
• ErrorDoc
• TagDoc : Allow to tag methods
• Types :
  • TypeDoc : Basic type
    • BooleanDoc
    • ScalarDoc
      • StringDoc
      • NumberDoc
        • IntegerDoc
        • FloatDoc
    • CollectionDoc
      • ArrayDoc
      • ObjectDoc

Normalizers

Available normalizers :, _(*9)

• TypeDocNormalizer, _(*10)

  use Yoanm\JsonRpcServerDoc\Infra\Normalizer\TypeDocNormalizer;
  
  $typeDocNormalizer = new TypeDocNormalizer();
  

• TagDocNormalizer, _(*11)

  use Yoanm\JsonRpcServerDoc\Infra\Normalizer\TagDocNormalizer;
  
  $tagDocNormalizer = new TagDocNormalizer();
  

• ErrorDocNormalizer, _(*12)

  use Yoanm\JsonRpcServerDoc\Infra\Normalizer\MethodDocNormalizer;
  
  $errorDocNormalizer = new ErrorDocNormalizer($typeDocNormalizer);
  

• MethodDocNormalizer, _(*13)

  use Yoanm\JsonRpcServerDoc\Infra\Normalizer\MethodDocNormalizer;
  
  $tagDocNormalizer = new MethodDocNormalizer(
    $typeDocNormalizer,
    $errorDocNormalizer
  );
  

• ServerDocNormalizer and HttpServerDocNormalizer for HTTP server, _(*14)

  use Yoanm\JsonRpcServerDoc\Infra\Normalizer\ServerDocNormalizer;
  use Yoanm\JsonRpcServerDoc\Infra\Normalizer\HttpServerDocNormalizer;
  
  $normalizer = new ServerDocNormalizer(
    $methodDocNormalizer,
    $tagDocNormalizer,
    $errorDocNormalizer
  );
  
  $httpNormalizer = new HttpServerDocNormalizer($normalizer);
  

Contributing

See contributing note, _(*15)