Skip to content

baozouai/taro-history

Repository files navigation

taro-history

A vite Plugin to add log filename, log line, log argument name and separator

NPM version NPM downloads

Test

English | 中文

🔥 Features

  • Support to log the flog filename,
  • Support tolog line
  • Support to log argument name
  • Support to log separator
  • Support different files —— 👉 .js, .jsx, .ts, .tsx, .vue, .svelte, and .astro

for more usage please see the examples

📦 Install

pnpm add taro-history -D
# or
yarn add taro-history -D
# or
npm i taro-history -D

⚙️ Options

interface Options {
  /**
   * log file name
   * If your file name is too long,
   * and you don;t want to log the directory of  the file path, 
   * such as src/pages/xxxyyy/a.tsx, 
   * then you can configure enableDir to false, and only print a.tsx
   * @default true
   */
  enableFileName?: boolean | {
    enableDir?: boolean
  }
  /**
   * tip of start argument default 🚀🚀🚀🚀🚀🚀🚀🚀🚀🚀
   * @example
   * console.log(' 🚀🚀🚀🚀🚀🚀🚀🚀🚀🚀', ...)
   */
  preTip?: string
  /** the delimiter for each parameter is an empty string by default, you can also use a newline \n, a semicolon';' a comma',' or even a pig '🐖' */
  splitBy?: boolean
  /** 
   * need endLine, default false, only if startLine unequal endLine
   * @example
   * console.log('line of 1 🚀🚀🚀🚀🚀🚀🚀🚀🚀🚀 ~ main.tsx', ..., 'line of 10 🚀🚀🚀🚀🚀🚀🚀🚀🚀🚀 ~ main.tsx')
   *  */
  endLine?: boolean
}

🔨 Usage

import { defineConfig } from 'vite'
import EnhanceLog from 'taro-history'

const config = defineConfig({
  plugins: [
    // if you use vue, ensure the vuePlugin before the log plugin
    EnhanceLog({
      splitBy: '\n',
      preTip: '🐖🐖🐖🐖🐖🐖🐖🐖🐖🐖',
      enableFileName: true, // or enableFileName: { enableDir: false}
    }),
  ],
})

export default config

👇 Example

Clone the project and start playgrounds by running:

pnpm play # corresponding to vue
# or
pnpm play:react # corresponds to react

For specific configuration, see vue/vite.config.ts or react/vite.config.ts

For example, if you don't like small 🚀, but you like piggy 🐖, you can configure preTip as 🐖🐖🐖🐖🐖🐖🐖🐖🐖🐖:

img

For example, in the case of many parameters, you want log to wrap each parameter, then you can configure splitBy as \n:

img

Or the delimiter is ;:

img

Of course, you can also specify it at will, such as using a dog head 🐶 to separate:

img

For example, if you want to know the file name where the log is located, you can configure enableFileName to be true (of course the default is true):

img

If the file path is too long: img

and you only want to print the file name without the directory prefix, you can configure enableFileName: { enableDir: false }: img

For another example, if there is a log that spans multiple lines, you want the number of lines at the beginning and end of the log, with the log entity in the middle, then you can set endLine to true:

img

img

We can see that the number of lines at the beginning is 29, and the number of lines at the end is 44, which is consistent with the source code

📄 License

taro-history is MIT licensed.