Im working on a project and one of the tasks requires getting all function definitions

Here's a sample output for <a href="https://github.com/openssl/openssl/blob/master/cry

Support retrieving function definitions for a project path,about oracle/opengrok

vladak commented on May 25, 2024

The definitions for given file are stored in the index document and can be retrieved via IndexDocument#getDefinitions(File file). The Definitions object returned contains data such as map of symbol name to line number, map of line numbers to tag, and set of tags. Tag contains information such as line number, symbol name, type, full line string, namespace, signature, start/end offsets within the line. The question is what and how to represent this information in the API results. A good practice is to introduce a DTO (Data Transfer Object) to make this information available in the API. The DTO can contain a subset of the data from the Definitions object, it is just a question which data and in what form.

The API calls would obviously need to go through authorization checks.

from opengrok.

vladak commented on May 25, 2024

Also, the above suggests the API endpoint would be limited to single file, i.e.be similar to the pre-existing genre API, i.e. api/v1/file/defs?path=

from opengrok.

vladak commented on May 25, 2024

Also, pagination should be considered as the "tags" data for some files can be significant. On the other hand, I don't want to complicate this API endpoint too much.

from opengrok.

vladak commented on May 25, 2024

Speaking of simplicity, it would seem to me that the API should merely present the list of tags, i.e. the contents of Definitions#tags list. The items of the list, Tag objects, contain various interesting pieces of information:

opengrok/opengrok-indexer/src/main/java/org/opengrok/indexer/analysis/Definitions.java

Lines 209 to 242 in 6fb5eee

    
                   /** 
        
                    * Line number of the tag. 
        
                    */ 
        
                   public final int line; 
        
                   /** 
        
                    * The symbol used in the definition. 
        
                    */ 
        
                   public final String symbol; 
        
                   /** 
        
                    * The type of the tag. 
        
                    */ 
        
                   public final String type; 
        
                   /** 
        
                    * The full line on which the definition occurs. 
        
                    */ 
        
                   public final String text; 
        
                   /** 
        
                    * Namespace/class of tag definition. 
        
                    */ 
        
                   public final String namespace; 
        
                   /** 
        
                    * Scope of tag definition. 
        
                    */ 
        
                   public final String signature; 
        
                   /** 
        
                    * The starting offset (possibly approximate) of {@link #symbol} from 
        
                    * the start of the line. 
        
                    */ 
        
                   public final int lineStart; 
        
                   /** 
        
                    * The ending offset (possibly approximate) of {@link #symbol} from 
        
                    * the start of the line. 
        
                    */ 
        
                   public final int lineEnd;

If one needs the line to tag mapping, that could be reconstructed from the list.

Would that match your use case @ronvgs ?

from opengrok.

vladak commented on May 25, 2024

Here's a sample output for https://github.com/openssl/openssl/blob/master/crypto/aes/aes_cbc.c (the query URL would end with /api/v1/file/defs?path=/openssl-master/crypto/aes/aes_cbc.c ):

[
  {
    "type": "function",
    "signature": "(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "text": "void AES_cbc_encrypt(const unsigned char *in, unsigned char *out,",
    "symbol": "AES_cbc_encrypt",
    "lineStart": 5,
    "lineEnd": 20,
    "line": 20,
    "namespace": null
  },
  {
    "type": "argument",
    "signature": "(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "text": "AES_cbc_encrypt(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "symbol": "in",
    "lineStart": 21,
    "lineEnd": 44,
    "line": 20,
    "namespace": null
  },
  {
    "type": "argument",
    "signature": "(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "text": "AES_cbc_encrypt(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "symbol": "out",
    "lineStart": 46,
    "lineEnd": 64,
    "line": 20,
    "namespace": null
  },
  {
    "type": "argument",
    "signature": "(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "text": "AES_cbc_encrypt(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "symbol": "len",
    "lineStart": 21,
    "lineEnd": 31,
    "line": 21,
    "namespace": null
  },
  {
    "type": "argument",
    "signature": "(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "text": "AES_cbc_encrypt(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "symbol": "key",
    "lineStart": 33,
    "lineEnd": 51,
    "line": 21,
    "namespace": null
  },
  {
    "type": "argument",
    "signature": "(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "text": "AES_cbc_encrypt(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "symbol": "ivec",
    "lineStart": 21,
    "lineEnd": 40,
    "line": 22,
    "namespace": null
  },
  {
    "type": "argument",
    "signature": "(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "text": "AES_cbc_encrypt(const unsigned char * in,unsigned char * out,size_t len,const AES_KEY * key,unsigned char * ivec,const int enc)",
    "symbol": "enc",
    "lineStart": 42,
    "lineEnd": 55,
    "line": 22,
    "namespace": null
  }
]

from opengrok.

Support retrieving function definitions for a project path about opengrok HOT 5 CLOSED

Comments (5)

Related Issues (20)

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent

	/**
	* Line number of the tag.
	*/
	public final int line;
	/**
	* The symbol used in the definition.
	*/
	public final String symbol;
	/**
	* The type of the tag.
	*/
	public final String type;
	/**
	* The full line on which the definition occurs.
	*/
	public final String text;
	/**
	* Namespace/class of tag definition.
	*/
	public final String namespace;
	/**
	* Scope of tag definition.
	*/
	public final String signature;
	/**
	* The starting offset (possibly approximate) of {@link #symbol} from
	* the start of the line.
	*/
	public final int lineStart;
	/**
	* The ending offset (possibly approximate) of {@link #symbol} from
	* the start of the line.
	*/
	public final int lineEnd;