Skip to content

Document Tika proto#1826

Closed
bartek wants to merge 1 commit into
apache:tika-grpc-3x-featuresfrom
bartek:bartek/document-tika-proto
Closed

Document Tika proto#1826
bartek wants to merge 1 commit into
apache:tika-grpc-3x-featuresfrom
bartek:bartek/document-tika-proto

Conversation

@bartek

@bartek bartek commented Jun 19, 2024

Copy link
Copy Markdown

This adds documentation to the Tika protobuf, specifically on the fields which may be ambiguous at initial glance.

Thanks for your contribution to Apache Tika! Your help is appreciated!

// fetcher_id is the unique identifier for this fetcher as defined by the user.
string fetcher_id = 1;
// fetcher_class is the implementation class name of the fetcher. More details at:
// https://cwiki.apache.org/confluence/display/TIKA/tika-pipes

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if this is the ideal link to reference class names.

string fetch_key = 1;
// fields is a collection of echoed metadata (from the request), extracted metadata, and content.
map<string, string> fields = 2;
// status is ... ?? (what possible values? Is it fetcher dependent?)

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left this as a ? as I am not sure what this may be. Is this a constrained set of values? Does it vary per fetcher?

// fetcher_class is the implementation class name of the fetcher. More details at:
// https://cwiki.apache.org/confluence/display/TIKA/tika-pipes
string fetcher_class = 2;
// params are the stored parameters for the fetcher.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

While documenting I notice we use params as a field name here but fetcher_config_json when saving the fetcher. But I think this references the same underlying resources? Clarification would be great here.

@nddipiazza

nddipiazza commented Jun 19, 2024

Copy link
Copy Markdown
Contributor

incorporated changes in grpc branch
see ba92f9d

@nddipiazza nddipiazza closed this Jun 19, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants