Prettier 高级应用:集成 CI/CD 流水线与插件开发

简介: 【10月更文挑战第18天】Prettier 是一款流行的代码格式化工具,它能够自动将代码格式化成一致的风格,从而提高代码的可读性和维护性。对于希望进一步发挥 Prettier 潜力的高级用户而言,将 Prettier 集成到持续集成(CI)和持续部署(CD)流程中,确保每次提交的代码都符合团队标准,是非常重要的。此外,通过开发自定义插件来支持更多语言或扩展 Prettier 的功能也是值得探索的方向。本文将详细介绍这两方面的内容。

Prettier 是一款流行的代码格式化工具,它能够自动将代码格式化成一致的风格,从而提高代码的可读性和维护性。对于希望进一步发挥 Prettier 潜力的高级用户而言,将 Prettier 集成到持续集成(CI)和持续部署(CD)流程中,确保每次提交的代码都符合团队标准,是非常重要的。此外,通过开发自定义插件来支持更多语言或扩展 Prettier 的功能也是值得探索的方向。本文将详细介绍这两方面的内容。
1111.png

Prettier 简介

Prettier 是一个代码美化器,支持多种编程语言,如 JavaScript、TypeScript、CSS、HTML、Markdown 等。它的特点是“意见明确”——即它有固定的格式规则,不会因为不同的开发者有不同的代码风格而产生冲突。

集成 CI/CD 流水线

为什么要集成 Prettier 到 CI/CD?

在 CI/CD 流程中集成 Prettier 可以确保每次提交的代码都符合统一的编码规范,从而减少因代码风格问题导致的合并冲突,提高团队协作效率。

如何集成 Prettier 到 CI/CD?

使用 Git Hooks

在本地开发环境中,可以使用 Git hooks 来在提交之前自动格式化代码。例如,可以创建一个 pre-commit 脚本:

#!/bin/sh
npx prettier --write .

将此脚本保存到 .git/hooks/pre-commit 文件中,并确保它具有可执行权限。

在 CI/CD 服务器上运行 Prettier

在 CI/CD 环境中,可以配置任务来检查提交的代码是否已经格式化。如果代码不符合格式要求,则构建失败。

Jenkins 配置示例

在 Jenkins 中,可以在构建步骤中加入 Prettier 的检查:

pipeline {
   
    agent any
    stages {
   
        stage('Format Check') {
   
            steps {
   
                script {
   
                    def prettierCheck = sh(returnStdout: true, script: 'npx prettier --check .')
                    if (!prettierCheck.trim().isEmpty()) {
   
                        error 'Code is not properly formatted.'
                    }
                }
            }
        }
    }
}
GitHub Actions 配置示例

在 GitHub Actions 中,可以定义一个工作流程来运行 Prettier:

name: Format Check
on: [push, pull_request]
jobs:
  format:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run Prettier
        run: |
          npm install -g prettier
          npx prettier --check .

配置 Prettier 规则

在项目根目录创建一个 .prettierrc 文件来配置格式化规则。例如:

{
   
  "printWidth": 80,
  "tabWidth": 2,
  "useTabs": false,
  "semi": true,
  "singleQuote": true,
  "trailingComma": "es5",
  "bracketSpacing": true,
  "jsxBracketSameLine": false,
  "arrowParens": "avoid"
}

开发自定义插件

为什么需要开发插件?

尽管 Prettier 支持多种语言,但在某些情况下,你可能需要支持一种尚未被支持的语言,或者想要扩展 Prettier 的功能以满足特定需求。

如何开发插件?

开发 Prettier 插件涉及到实现 Prettier 的插件接口。首先,你需要熟悉 Prettier 的源码结构和插件机制。接下来,按照以下步骤创建插件:

  1. 初始化项目:创建一个新的 Node.js 项目,并安装 Prettier 作为开发依赖。

    npm init -y
    npm install prettier --save-dev
    
  2. 实现插件接口:创建一个模块导出符合 Prettier 插件接口的函数。例如,如果你正在为一种新的编程语言 foo-lang 开发插件,那么需要实现 parser-foo-langprinter-foo-lang

    module.exports = {
         
      parsers: {
         
        'foo-lang': {
         
          parse(code, options) {
         
            // 实现 foo-lang 代码的解析逻辑
          }
        }
      },
      printers: {
         
        'foo-lang': {
         
          print(path, options, print) {
         
            // 实现 foo-lang 代码的打印逻辑
          }
        }
      }
    };
    
  3. 注册插件:在项目中注册你的插件。可以通过 prettier.resolveConfig 动态加载插件配置。

    const prettier = require('prettier');
    const parserFooLang = require('./parser-foo-lang');
    
    prettier.resolveConfig(process.cwd()).then((config) => {
         
      if (config.parser === 'foo-lang') {
         
        prettier.registerParser('foo-lang', parserFooLang.parsers['foo-lang']);
        prettier.registerPrinter('foo-lang', parserFooLang.printers['foo-lang']);
      }
    });
    
  4. 测试插件:确保你的插件按预期工作。可以使用 Prettier 提供的测试工具来验证插件的正确性。

  5. 发布插件:如果你认为你的插件可能会对社区有所帮助,可以将其发布到 npm 上,让更多的人使用。

结论

通过将 Prettier 集成到 CI/CD 流程中,可以确保代码的一致性和质量。而通过开发自定义插件,可以进一步扩展 Prettier 的功能,支持更多编程语言或实现特定的格式化需求。希望本文能帮助开发者更好地利用 Prettier 的强大功能,提高团队的开发效率和代码质量。

目录
相关文章
|
4天前
|
SQL 人工智能 安全
【灵码助力安全1】——利用通义灵码辅助快速代码审计的最佳实践
本文介绍了作者在数据安全比赛中遇到的一个开源框架的代码审计过程。作者使用了多种工具,特别是“通义灵码”,帮助发现了多个高危漏洞,包括路径遍历、文件上传、目录删除、SQL注入和XSS漏洞。文章详细描述了如何利用这些工具进行漏洞定位和验证,并分享了使用“通义灵码”的心得和体验。最后,作者总结了AI在代码审计中的优势和不足,并展望了未来的发展方向。
|
13天前
|
存储 弹性计算 人工智能
阿里云Alex Chen:普惠计算服务,助力企业创新
本文整理自阿里云弹性计算产品线、存储产品线产品负责人陈起鲲(Alex Chen)在2024云栖大会「弹性计算专场-普惠计算服务,助力企业创新」中的分享。在演讲中,他分享了阿里云弹性计算,如何帮助千行百业的客户在多样化的业务环境和不同的计算能力需求下,实现了成本降低和效率提升的实际案例。同时,基于全面升级的CIPU2.0技术,弹性计算全线产品的性能、稳定性等关键指标得到了全面升级。此外,他还宣布了弹性计算包括:通用计算、加速计算和容器计算的全新产品家族,旨在加速AI与云计算的融合,推动客户的业务创新。
|
11天前
|
编解码 Java 程序员
写代码还有专业的编程显示器?
写代码已经十个年头了, 一直都是习惯直接用一台Mac电脑写代码 偶尔接一个显示器, 但是可能因为公司配的显示器不怎么样, 还要接转接头 搞得桌面杂乱无章,分辨率也低,感觉屏幕还是Mac自带的看着舒服
|
18天前
|
存储 人工智能 缓存
AI助理直击要害,从繁复中提炼精华——使用CDN加速访问OSS存储的图片
本案例介绍如何利用AI助理快速实现OSS存储的图片接入CDN,以加速图片访问。通过AI助理提炼关键操作步骤,避免在复杂文档中寻找解决方案。主要步骤包括开通CDN、添加加速域名、配置CNAME等。实测显示,接入CDN后图片加载时间显著缩短,验证了加速效果。此方法大幅提高了操作效率,降低了学习成本。
2928 10
|
13天前
|
存储 缓存 关系型数据库
MySQL事务日志-Redo Log工作原理分析
事务的隔离性和原子性分别通过锁和事务日志实现,而持久性则依赖于事务日志中的`Redo Log`。在MySQL中,`Redo Log`确保已提交事务的数据能持久保存,即使系统崩溃也能通过重做日志恢复数据。其工作原理是记录数据在内存中的更改,待事务提交时写入磁盘。此外,`Redo Log`采用简单的物理日志格式和高效的顺序IO,确保快速提交。通过不同的落盘策略,可在性能和安全性之间做出权衡。
1578 12
|
5天前
|
人工智能 关系型数据库 Serverless
1024,致开发者们——希望和你一起用技术人独有的方式,庆祝你的主场
阿里云开发者社区推出“1024·云上见”程序员节专题活动,包括云上实操、开发者测评和征文三个分会场,提供14个实操活动、3个解决方案、3 个产品方案的测评及征文比赛,旨在帮助开发者提升技能、分享经验,共筑技术梦想。
730 99
|
1月前
|
弹性计算 人工智能 架构师
阿里云携手Altair共拓云上工业仿真新机遇
2024年9月12日,「2024 Altair 技术大会杭州站」成功召开,阿里云弹性计算产品运营与生态负责人何川,与Altair中国技术总监赵阳在会上联合发布了最新的“云上CAE一体机”。
阿里云携手Altair共拓云上工业仿真新机遇
|
18天前
|
人工智能 Serverless API
AI助理精准匹配,为您推荐方案——如何快速在网站上增加一个AI助手
通过向AI助理提问的方式,生成一个技术方案:在网站上增加一个AI助手,提供7*24的全天候服务,即时回答用户的问题和解决他们可能遇到的问题,无需等待人工客服上班,显著提升用户体验。
1485 9
|
6天前
|
SQL 存储 人工智能
【产品升级】Dataphin V4.3重大升级:AI“弄潮儿”,数据资产智能化
DataAgent如何助理业务和研发成为业务参谋?如何快速低成本的创建行业数据分类标准?如何管控数据源表的访问权限?如何满足企业安全审计需求?
366 0
【产品升级】Dataphin V4.3重大升级:AI“弄潮儿”,数据资产智能化
|
3天前
|
人工智能 自然语言处理 程序员
提交通义灵码创新实践文章,重磅好礼只等你来!
通义灵码创新实践征集赛正式开启,发布征文有机会获得重磅好礼+流量福利,快来参加吧!
205 7