kythe

Kythe is a pluggable, (mostly) language-agnostic ecosystem for building tools that work with code.

APACHE-2.0 License

Stars
1.9K
Committers
100

Bot releases are visible (Hide)

kythe - v0.0.27

Published by schroederc over 6 years ago

Due to the period of time between this release and v0.0.26, many relevant changes and fixes may not appear in the following list. For a complete list of changes, please check the commit logs: https://github.com/google/kythe/compare/v0.0.26...v0.0.27

Notable additions:

  • First release of Go indexer and Go extractors.
  • Objective C is now supported in the C++ indexer.
  • identifier.proto: adds a new IdentifierService API.
  • Runtime plugins can be added to the Java indexer.

Notable changes:

  • Remove gRPC server and client code.
  • Schema:
    • Anchors no longer have childof edges to their parent file.
    • Anchor nodes must share their path, root, and corpus VName
      components with their parent file.
  • Format strings have been replaced by the MarkedSource protobuf message.
  • C++ analysis:
    • Included files are referenced by the ref/file edge.
    • code facts (containing MarkedSource protos) are emitted.
    • Better support for C++11, 14, and 17.
    • Limited CUDA support.
    • Improvements to indexing and rendering of documentation.
    • Added a plugin for indexing proto fields in certain string literals.
    • Type ranges for builtin structural types are no longer destructured (T*
      is now [T]*, not [[T]*]).
    • Decoration of builtin types can be controlled with
      --emit_anchors_on_builtins.
    • Namespaces are never defined, only refd.
    • Old-style name nodes removed.
    • The extractor now captures more build state, enabling support for
      __has_include
    • anchors involved in completes edges now contain their targets mixed
      with their signatures, making each completion relationship unique.
    • Support for indexing uses of make_unique et al as direct references to
      the relevant constructor.
    • Template instantiations can be aliased together with
      --experimental_alias_template_instantiations, which significantly
      decreases output size at the expense of lower fidelity.
  • Java analysis:
    • name nodes are now defined as JVM binary names.
    • diagnostic nodes are emitted on errors.
    • code facts (MarkedSource protos) are emitted.
    • Add callgraph edges for constructors.
    • Non-member classes are now childof their enclosing method.
    • Local variables are now childof their enclosing method.
    • Blame calls in static initializers on the enclosing class.
    • Emit references for all matching members of a static import.
    • Reference abs nodes for generic classes instead of their record nodes.
    • Emit data for annotation arguments.
    • Emit package relations from package-info.java files.
  • Protocol Buffers:
    • analysis.proto: add revision and build ID to AnalysisRequest.
    • analysis.proto: add AnalysisResult summary to AnalysisOutput.
    • analysis.proto: remove revision from CompilationUnit.
    • graph.proto: new location of the GraphService API
    • xref.proto: remove DecorationsReply.Reference.source_ticket.
    • xref.proto: add Diagnostic messages to DecorationsReply.
    • xref.proto: replace Location.Point pairs with common.Span.
    • xref.proto: by default, elide snippets from xrefs/decor replies.
    • xref.proto: replace Printable formats with MarkedSource.
    • xref.proto: allow filtering related nodes in the xrefs reply.
    • xref.proto: optionally return documentation children.
    • xref.proto: return target definitions with overrides.
kythe - v0.0.26

Published by zrlk almost 8 years ago

Notable changes:

  • Nodes and Edges API calls have been moved from XRefService to GraphService.
kythe - v0.0.25

Published by zrlk almost 8 years ago

Notable changes:

  • Replace google.golang.org/cloud dependencies with cloud.google.com/go
  • Update required version of Go from 1.6 to 1.7
kythe - v0.0.24

Published by zrlk about 8 years ago

Notable fixes:

  • write_tables now tolerates nodes with no facts. Previously it could sometimes crash if this occurred.
kythe - v0.0.23

Published by schroederc about 8 years ago

Notable changes:

  • CrossReferences API: hide signature generation behind feature flag
  • Java indexer: emit ref/imports anchors for imported symbols

Notable additions:

  • Java indexer: emit basic format facts
kythe - v0.0.22

Published by schroederc over 8 years ago

Notable changes:

  • Schema: callable nodes and callableas edges have been removed.
  • xrefs.CrossReferences: change Anchors in the reply to RelatedAnchors
  • Removed search API
kythe - v0.0.21

Published by schroederc over 8 years ago

Notable changes:

  • xrefs service: replace most repeated fields with maps
  • xrefs service: add ordinal field to each EdgeSet edge
  • xrefs.CrossReferences: group declarations/definitions for incomplete nodes
  • C++ indexer: --flush_after_each_entry now defaults to true

Notable additions:

  • xrefs.Decorations: add experimental target_definitions switch
  • kythe tool: add --graphviz output flag to edges subcommand
  • kythe tool: add --target_definitions switch to decor subcommand

Notable fixes:

  • write_tables: correctly handle nodes with missing facts
  • Javac extractor: add processors registered in META-INF/services
  • javac-wrapper.sh: prepend bootclasspath jar to use packaged javac tools
kythe - v0.0.20

Published by schroederc over 8 years ago

Notable fixes:

  • Java indexer: reduce redundant AST traversals causing large slowdowns
kythe - v0.0.19

Published by schroederc over 8 years ago

Notable changes:

  • C++ extractor: KYTHE_ROOT_DIRECTORY no longer changes the working
    directory during extraction, but does still change the root for path
    normalization.
  • http_server: ensure the given --serving_table exists (do not create, if missing)
  • Java indexer: fixes/tests for interfaces, which now have extends edges
  • kythe tool: display subkinds for related nodes in xrefs subcommand

Notable additions:

  • entrystream: add --unique flag
  • write_tables: add --entries flag
kythe - v0.0.18

Published by schroederc over 8 years ago

Notable changes:

  • C++ indexer: --ignore_unimplemented now defaults to true
  • Java indexer: emit single anchor for package in qualified identifiers

Notable additions:

  • Java indexer: add callgraph edges
  • Java indexer: add Java 8 member reference support
kythe - v0.0.17

Published by schroederc almost 9 years ago

Notable additions:

  • write_tables: produce serving data for xrefs.CrossReferences method
  • write_tables: add flags to tweak performance
    • --compress_shards: determines whether intermediate data written to disk
      should be compressed
    • --max_shard_size: maximum number of elements (edges, decoration
      fragments, etc.) to keep in-memory before flushing an intermediary data
      shard to disk
    • --shard_io_buffer: size of the reading/writing buffers for the
      intermediary data shards
kythe - v0.0.16

Published by schroederc almost 9 years ago

Notable changes:

  • Denormalize the serving table format
  • xrefs.Decorations: only return Reference targets in DecorationsReply.Nodes
  • Use proto3 JSON mapping for web requests: https://developers.google.com/protocol-buffers/docs/proto3#json
  • Java indexer: report error when indexing from compilation's source root
  • Consistently use corpus root relative paths in filetree API
  • Java, C++ indexer: ensure file node VNames to be schema compliant
  • Schema: File nodes should no longer have the language VName field set

Notable additions:

  • Java indexer: emit (possibly multi-line) snippets over entire surrounding statement
  • Java indexer: emit class node for static imports

Notable fixes:

  • Java extractor: correctly parse @file arguments using javac CommandLine parser
  • Java extractor: correctly parse/load -processor classes
  • xrefs.Edges: correctly return empty page_token on last page (when filtering by edge kinds)
kythe - v0.0.15

Published by schroederc about 9 years ago

Notable changes:

  • Java 8 is required for the Java extractor/indexer

Notable fixes:

  • write_tables: don't crash when given a node without any edges
  • Java extractor: ensure output directory exists before writing kindex
kythe - v0.0.14

Published by schroederc about 9 years ago

Notable fixes:

  • Bazel Java extractor: filter out Bazel-specific flags
  • Java extractor/indexer: filter all unsupported options before yielding to the compiler
kythe - v0.0.13

Published by schroederc about 9 years ago

Notable additions:

  • Java indexer: add ref/doc anchors for simple class references in JavaDoc
  • Java indexer: emit JavaDoc comments more consistently; emit enum documentation
kythe - v0.0.12

Published by schroederc about 9 years ago

Notable changes:

  • C++ indexer: rename /kythe/edge/defines to /kythe/edge/defines/binding
  • Java extractor: change failure to warning on detection of non-java sources
  • Java indexer: defines anchors span an entire class/method/var definition (instead of
    just their identifier; see below for defines/binding anchors)
  • Add public protocol buffer API/message definitions

Notable additions:

  • Java indexer: ref anchors span import packages
  • Java indexer: defines/binding anchors span a definition's identifier (identical
    behavior to previous defines anchors)
  • http_server: add --http_allow_origin flag that adds the Access-Control-Allow-Origin header to each HTTP response
kythe - v0.0.11

Published by schroederc about 9 years ago

Notable additions:

  • Java indexer: name node support for array types, builtins, files, and generics

Notable fixes:

  • Java indexer: stop an exception from being thrown when a line contains multiple comments
kythe - v0.0.10

Published by schroederc about 9 years ago

Notable additions:

  • http_server: support TLS HTTP2 server interface
  • Java indexer: broader name node coverage
  • Java indexer: add anchors for method/field/class definition comments
  • write_table: add --max_edge_page_size flag to control the sizes of each
    PagedEdgeSet and EdgePage written to the output table

Notable fixes:

  • entrystream: prevent panic when given --entrysets flag
kythe - v0.0.9

Published by schroederc about 9 years ago

Notable changes:

  • xrefs.Decorations: nodes will not be populated unless given a fact filter
  • xrefs.Decorations: each reference has its associated anchor start/end byte offsets
  • Schema: loosened restrictions on VNames to permit hashing

Notable additions:

  • dedup_stream: add --cache_size flag to limit memory usage
  • C++ indexer: hash VNames whenever permitted to reduce output size

Notable fixes:

  • write_tables: avoid deadlock in case of errors
kythe - v0.0.8

Published by schroederc about 9 years ago

Notable additions:

Notable fixes:

  • write_tables: ensure that all edges are scanned for FileDecorations
  • kythe refs command: normalize locations within dirty buffer, if given one