Package 'diario'

Get company details

Description

This function retrieves company details from the Diario API.

Usage

diario_get_company()

Value

A list containing company details.

Examples

## Not run: 
company <- diario_get_company()

## End(Not run)

---

Get all registered entities (cadastros)

Description

This function retrieves all registered entities from the Diario API.

Usage

diario_get_entities()

Value

A list containing the entities data.

Examples

## Not run: 
entities <- diario_get_entities()

## End(Not run)

---

Get details of a specific project

Description

This function retrieves details of a specific project by its ID from the Diario API.

Usage

diario_get_project_details(project_id)

Arguments

project_id

A valid non-empty string with the project ID.

Value

A list containing the project details.

Examples

## Not run: 
project <- diario_get_project_details("66face5fe26175e0a904d398")

## End(Not run)

---

Get list of projects (obras)

Description

This function retrieves a list of projects from the Diario API.

Usage

diario_get_projects()

Value

A tibble containing the projects data.

Examples

## Not run: 
projects <- diario_get_projects()

## End(Not run)

---

Get details of a specific report

Description

This function retrieves details of a specific report by report ID within a project.

Usage

diario_get_report_details(project_id, report_id)

Arguments

project_id	A valid non-empty string with the project ID.
report_id	A valid non-empty string with the report ID.

Value

A list containing the report details.

Examples

## Not run: 
report <- diario_get_report_details("6717f864d163f517ae06e242", "67648080f0971de9d00324c2")

## End(Not run)

---

Get reports of a specific project

Description

This function retrieves reports of a specific project with optional parameters for limit and order.

Usage

diario_get_reports(project_id, limit = 50, order = "desc")

Arguments

project_id	A valid non-empty string with the project ID.
limit	An integer specifying the maximum number of reports to retrieve. Default is 50.
order	A character string specifying the order of the reports (e.g., "asc" or "desc"). Default is "desc".

Value

A tibble containing the reports.

Examples

## Not run: 
reports <- diario_get_reports("6717f864d163f517ae06e242", limit = 10, order = "asc")

## End(Not run)

---

Get details of a specific task

Description

This function retrieves details of a specific task by task ID within a project.

Usage

diario_get_task_details(project_id, task_id)

Arguments

project_id	A valid non-empty string with the project ID.
task_id	A valid non-empty string with the task ID.

Value

A list containing task details.

Examples

## Not run: 
task <- diario_get_task_details("66cf438223aa80386306e647", "66cf44209e4fedefb306bcd3")

## End(Not run)

---

Get the task list of a specific project

Description

This function retrieves the task list (schedule, or cronograma) of a specific project by its ID. The underlying API wraps the schedule items in a cronograma field alongside summary counters; this function returns the schedule items themselves as one row per task.

Usage

diario_get_task_list(project_id)

Arguments

project_id

A valid non-empty string with the project ID.

Value

A tibble with one row per schedule item (task). Returns an empty tibble if the project has no tasks.

Examples

## Not run: 
tasks <- diario_get_task_list("66cf438223aa80386306e647")

## End(Not run)

---

Perform an API request to Diario

Description

This function performs an authenticated request to the specified endpoint of the Diario API.

Usage

diario_perform_request(
  endpoint,
  query = list(),
  method = "GET",
  body = NULL,
  verbosity = 0
)

Arguments

endpoint	A non-empty character string specifying the API endpoint.
query	A named list of query parameters (optional).
method	The HTTP method to use (e.g., "GET", "POST", "PUT", "DELETE"). Default is "GET".
body	A list representing the JSON body for request methods that support a body (e.g., POST).
verbosity	Verbosity level for the request (0 = none, 1 = minimal). Default is 0.

Value

A list (by default) containing the response from the API. If the content is JSON, it will be returned as an R object. If not, an error is raised.

Examples

## Not run: 
diario_perform_request("v1/obras", query = list(status = "active"))

## End(Not run)

---

Retrieve the API token for Diario

Description

This function retrieves the stored authentication token using the keyring package. If no valid token (or keyring) is found, it will return NULL and (unless quiet = TRUE) emit an informational message indicating that no valid token was found.

Usage

diario_retrieve_token(quiet = FALSE)

Arguments

quiet

A logical flag. If TRUE, suppresses the informational message emitted when no token is found. Default is FALSE.

Value

A character string containing the API token, or NULL if no valid token is found.

Examples

## Not run: 
token <- diario_retrieve_token()

## End(Not run)

---

Store the API token for Diario

Description

This function stores the provided authentication token using the keyring package. If the token cannot be stored (for example, because the keyring is not accessible), it emits a warning instead of throwing an error, and returns FALSE.

Usage

diario_store_token(token)

Arguments

token

A character string containing the API token to be stored.

Value

TRUE (invisibly) if the token was stored successfully; FALSE otherwise.

Examples

## Not run: 
# Attempt to store a token:
diario_store_token("your-api-token")

## End(Not run)

---