Render the `core:version` banner natively and deprecate `povils/figlet`

Đang mở
#688 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
74/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
php
Lĩnh vực
backend, cli

Hướng nghiên cứu

Start with src/Console/Commands/VersionCommand.php and trace how it currently calls povils/figlet. Check the starter project's public/assets/shared/fonts/figlet/ files and the existing changelog format. Done means the core renderer handles all four shipped fonts, php qt core:version matches the previous slant banner for QUANTUM PHP 3.2.0, and the changelog records the deprecation.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

console enhancement

Summary

Add a small FIGlet renderer to the core and use it for the banner of php qt core:version, instead of povils/figlet. Keep povils/figlet in composer.json, deprecated, and remove it in a later release.

Why

povils/figlet has had no release since 2016. Its last version, 1.0.0, requires symfony/console ~3.0, so it cannot be installed next to the Symfony Console the core uses, and the core is stuck on 0.1.0 (found while working on #687). The only maintained-looking alternative, laminas/laminas-text, is abandoned. The core uses the package for one thing: rendering QUANTUM PHP <version> with the slant font, which the starter project already ships in public/assets/shared/fonts/figlet/.

Proposed change

  • A renderer class in the Console package that reads a FIGlet .flf font file and renders a string, with the three methods VersionCommand uses: setFontDir(), setFont() and render().
  • VersionCommand uses it.
  • povils/figlet stays in composer.json and gets a Deprecated changelog entry: the core no longer uses it, and it will be removed in a later release. Applications that call Povils\Figlet\Figlet themselves should require the package in their own composer.json.

Acceptance criteria

  • php qt core:version prints the same banner as before: a test compares the native output for QUANTUM PHP 3.2.0 with the slant font against the output of povils/figlet 0.1.0.
  • the renderer handles the four fonts the starter project ships (big, slant, small, standard)
  • the changelog records the deprecation

Notes

  • src/Console/Commands/VersionCommand.php
  • the font files are in quantum-php/project, public/assets/shared/fonts/figlet/
Ngôn ngữ chính
PHP
Star
43
Fork
22
Merge trung bình
54 phút
Pull request đã merge (30 ngày)
57

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của quantum-php/framework

Tất cả issue của quantum-php/framework

Issue tương tự

Thêm issue về PHP

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.