Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@ember-template-lint/todo-utils

Package Overview
Dependencies
Maintainers
4
Versions
37
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@ember-template-lint/todo-utils

![CI Build](https://github.com/ember-template-lint/ember-template-lint-todo-utils/workflows/CI%20Build/badge.svg) [![License](https://img.shields.io/npm/l/@checkup/cli.svg)](https://github.com/checkupjs/checkup/blob/master/package.json) ![Dependabot](http

  • 3.2.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
17K
increased by9.24%
Maintainers
4
Weekly downloads
 
Created
Source

@ember-template-lint/todo-utils

CI Build License Dependabot Volta Managed TypeScript Code Style: prettier

A collection of utilities to generate and store lint item metadata.

Those utilities are:

Functions

buildTodoData(baseDir, lintResults, daysToDecay)

Adapts a list of LintResult to a map of FilePath, TodoData.

_buildTodoDatum(lintResult, lintMessage, daysToDecay)

Adapts an LintResult to a TodoData. FilePaths are absolute when received from a lint result, so they're converted to relative paths for stability in serializing the contents to disc.

todoStorageDirExists(baseDir)

Determines if the .lint-todo storage directory exists.

ensureTodoStorageDir(baseDir)

Creates, or ensures the creation of, the .lint-todo directory.

getTodoStorageDirPath(baseDir)
todoFilePathFor(baseDir, todoData)

Creates a file path from the linting data. Excludes extension.

todoDirFor(filePath)

Creates a short hash for the todo's file path.

todoFileNameFor(todoData)

Generates a unique filename for a todo lint data.

writeTodos(baseDir, lintResults, filePath, daysToDecay)

Writes files for todo lint violations. One file is generated for each violation, using a generated hash to identify each.

Given a list of todo lint violations, this function will also delete existing files that no longer have a todo lint violation.

readTodos(baseDir)

Reads all todo files in the .lint-todo directory.

readTodosForFilePath(todoStorageDir, filePath)

Reads todo files in the .lint-todo directory for a specific filePath.

getTodoBatches(lintResults, existing)

Gets 3 maps containing todo items to add, remove, or those that are stable (not to be modified).

applyTodoChanges(todoStorageDir, add, remove)

Applies todo changes, either adding or removing, based on batches from getTodoBatches.

buildTodoData(baseDir, lintResults, daysToDecay) ⇒

Adapts a list of LintResult to a map of FilePath, TodoData.

Kind: global function
Returns: - A Promise resolving to a Map of FilePath/TodoData.

ParamDescription
baseDirThe base directory that contains the .lint-todo storage directory.
lintResultsA list of LintResult objects to convert to TodoData objects.
daysToDecayAn object containing the warn or error days, in integers.

_buildTodoDatum(lintResult, lintMessage, daysToDecay) ⇒

Adapts an LintResult to a TodoData. FilePaths are absolute when received from a lint result, so they're converted to relative paths for stability in serializing the contents to disc.

Kind: global function
Returns: - A TodoData object.

ParamDescription
lintResultThe lint result object.
lintMessageA lint message object representing a specific violation for a file.
daysToDecayAn object containing the warn or error days, in integers.

todoStorageDirExists(baseDir) ⇒

Determines if the .lint-todo storage directory exists.

Kind: global function
Returns: - true if the todo storage directory exists, otherwise false.

ParamDescription
baseDirThe base directory that contains the .lint-todo storage directory.

ensureTodoStorageDir(baseDir) ⇒

Creates, or ensures the creation of, the .lint-todo directory.

Kind: global function
Returns: - The todo storage directory path.

ParamDescription
baseDirThe base directory that contains the .lint-todo storage directory.

getTodoStorageDirPath(baseDir) ⇒

Kind: global function
Returns: - The todo storage directory path.

ParamDescription
baseDirThe base directory that contains the .lint-todo storage directory.

todoFilePathFor(baseDir, todoData) ⇒

Creates a file path from the linting data. Excludes extension.

Kind: global function
Returns: - The todo file path for a TodoData object.

ParamDescription
baseDirThe base directory that contains the .lint-todo storage directory.
todoDataThe linting data for an individual violation.

Example

42b8532cff6da75c5e5895a6f33522bf37418d0c/6e3be839

todoDirFor(filePath) ⇒

Creates a short hash for the todo's file path.

Kind: global function
Returns: - The todo directory for a specific filepath.

ParamDescription
filePathThe filePath from linting data for an individual violation.

todoFileNameFor(todoData) ⇒

Generates a unique filename for a todo lint data.

Kind: global function
Returns: - The todo file name for a TodoData object.

ParamDescription
todoDataThe linting data for an individual violation.

writeTodos(baseDir, lintResults, filePath, daysToDecay) ⇒

Writes files for todo lint violations. One file is generated for each violation, using a generated hash to identify each.

Given a list of todo lint violations, this function will also delete existing files that no longer have a todo lint violation.

Kind: global function
Returns: - The todo storage directory path.

ParamDescription
baseDirThe base directory that contains the .lint-todo storage directory.
lintResultsThe raw linting data.
filePathThe relative file path of the file to update violations for.
daysToDecayAn object containing the warn or error days, in integers.

readTodos(baseDir) ⇒

Reads all todo files in the .lint-todo directory.

Kind: global function
Returns: - A Promise resolving to a Map of FilePath/TodoData.

ParamDescription
baseDirThe base directory that contains the .lint-todo storage directory.

readTodosForFilePath(todoStorageDir, filePath) ⇒

Reads todo files in the .lint-todo directory for a specific filePath.

Kind: global function
Returns: - A Promise resolving to a Map of FilePath/TodoData.

ParamDescription
todoStorageDirThe .lint-todo storage directory.
filePathThe relative file path of the file to return todo items for.

getTodoBatches(lintResults, existing) ⇒

Gets 3 maps containing todo items to add, remove, or those that are stable (not to be modified).

Kind: global function
Returns: - A Promise resolving to a Map of FilePath/TodoData.

ParamDescription
lintResultsThe linting data for all violations.
existingExisting todo lint data.

applyTodoChanges(todoStorageDir, add, remove)

Applies todo changes, either adding or removing, based on batches from getTodoBatches.

Kind: global function

ParamDescription
todoStorageDirThe .lint-todo storage directory.
addBatch of todos to add.
removeBatch of todos to remove.

FAQs

Package last updated on 22 Dec 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc