snooty-parser

Added

• Added infrastructure to support editor preview.

• Added infrastructure to support TOC generation.

• Added diagnostic for merge conflict markers.

• Parse published-branches.yaml and persist data to a metadata collection (DOCSP-7193).

Fixed

• Parsing of extract filenames that include periods (DOCSP-6904).

• Miscellaneous reStructuredText support improvements.

• Properly report snooty.toml errors.

Added

• Support for reStructuredText footnotes (DOCSP-6620).

• Support for project-wide reStructuredText substitutions (DOCSP-6442).

• Support for downloading and ingesting intersphinx inventories (DOCSP-5776).

• Validation for links under the doc role (DOCSP-6190).

• Support for the following reStructuredText constructs:

  • datalakeconf rstobject
  • caption option to toctree
  • includehidden option to toctree
  • backlinks option to contents is an enum
  • gcp and azure extlinks
  • only directive
  • tab directive accepts a tabid option (DOCSP-6493)
  • list-table directive accepts an argument (DOCSP-6554)
  • card-group directive (DOCSP-6447)

Changed

• The original filename of static assets is now saved in the filename field of the
  snooty.assets collection, replacing the type field (DOCSP-6849).
• Directive "flag" options have a true value in the AST instead of null (DOCSP-6383).
• The "only" directive is now deprecated in favor of "cond".

Fixed

• Parsing of the versionadded, versionchanged, and deprecated directives (DOCSP-6504).

Added

• Add support for the following reStructuredText constructs:

  • todo
  • deprecated
  • see
  • describe
  • glossary
  • rubric
  • envvar

• Add support for the following extlinks:

  • go-api
  • ecosystem
  • products
  • wtdocs

Fixed

• No longer create spurious diagnostics about including apiargs artifacts and hash.rst.

Changed

• Undefined source constants are now replaced with a zero-width space (\u200b),
  preventing them from creating a syntax error.

Added

• Add support for the following directives (DOCSP-6210):

  • tabs-top
  • tabs-stitch-auth-provid
  • tabs-deployments
  • tabs-stitch-sdks
  • tabs-stitch-interfaces
  • blockquote
  • caution

• Add support for the wikipedia role.

Fixed

• All YAML parsing errors are caught, rather than just scanning errors (DOCSP-6251).
• Opening a project with missing static assets no longer triggers an unhandled exception (DOCSP-6267).

[v0.1.10] - 2019-07-11

Added

• code directive alias for code-block.

Fixed

• Language server URIs now map correctly into local FileIds, and vice versa.

[v0.1.9] - 2019-07-08

Added

• Add textDocument/resolve RPC endpoint to return the source file path of an artifact relative to the project's root (DOCSP-5967).

Fixed

• Don't throw exception if saving an asset to the server fails (DOCSP-5998).
• The language server can now be gracefully shutdown using a context manager,
  for use in tests.

Changed

• Diagnostic messages when failing to open a static asset are more succinct.
• Warn about YAML files with duplicated refs (DOCSP-5704).

[v0.1.8] - 2019-06-27

Added

• Warn if a simple include (e.g. not generated from YAML) is missing.

• Add support for the following roles:

  • api
  • aws
  • gettingstarted
  • master
  • docsgithub
  • guides
  • mms-docs
  • mms-home
  • mongo-spark
  • source
  • opsmgr
  • charts-v0.10
  • charts-v0.9

Fixed

• The full dns package is included in binary builds, letting them connect to the database.

Changed

• Avoid unnecessarily reprocessing figures and literal includes.
• Automatically rebuild files if their dependent assets change.
• Heading nodes now have an attached ID.

Added

• Add support for the following directives:

  • image
  • tabs-pillstrip
  • tabs-cloud-providers
  • website
  • cloudmgr
  • stitch
  • charts
  • compass
  • driver
  • meta
  • topic

Fixed

• raw directive contents are now ignored.
• Bundle docutils.parsers.rst.directives.misc in binary release to avoid runtime errors when using unicode.

Changed

• Avoid processing giza substitutions in base nodes to avoid superfluous diagnostics.

Added

• The literalinclude directive.
• AST nodes for substitutions.

Changed

• Only match PAT_EXPLICIT_TILE if needed by role.

  Roles are now categorized in one of three ways:

  • text roles only provide a label field in the AST.
  • explicit_title roles provide a target field in the AST, as well as
    optionally a label field.
  • link roles do not emit a role node at all; instead, they emit a
    reference with the refuri already set.

Fixed

• Multiline directive arguments.
• Include guide "languages" in legacy guide syntax.
• :dedent: on literalinclude directives with empty lines.
• Child giza nodes should not always have their parent's ref.
• Extracts should be created with the category extracts, not extract.

• Support additional directives and roles

• Bundle Python hash function implementations temporarily; this shouldn't be required.
• Add support for additional MongoDB rst constructs

• Substitute constants from language-server, and report bad project config
• Force encodings to utf-8

Bundle openssl with macOS binary build.