Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Cleo 3.0 writeup

Aperta
  • Qualcosa non va?
#415 4 commenti 4 reazioni 1 assegnatario Vedi su GitHub

@Secrus ci sta già lavorando.

Dal 30/3/2024.

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

Below is a list of changes, required bugfixes and planned features for the next version of Cleo, Cleo 3.0. The list is not finished, it might evolve, change and expand. It's, basically, a download of my plans and ideas for Cleo.

Cleo 3.0 writeup

Docs

  • Rewrite docs from scratch
    • user docs
    • usage examples

New features

  • new CLI parser
  • introduce dynamic and static (user's choice) completions
  • introduce Powershell completions
  • introduce Tree UI component (extract the implementation from poetry show command)
  • replace the usage of rapidfuzz with difflib (dependent on new parser semantics)
  • remove namespace commands in favor of subcommands registered on commands (dependent on new parser semantics)
  • integration with logging
  • add helper functions for text transformations (colors, underline etc)

Refactorings

  • use @property.getter/@property.setter instead of get_*/set_* methods
  • UI components should be behind proxy UI() object instead of as methods on Command
  • Commands should not need Application reference
  • cleanup Windows support options into a separate module
  • help and list commands replacement (should be handled by the new parser)
  • colors and ansi escape sequences should be properly handled along with FORCE_COLOR/NO_COLOR and terminal features detection
  • strict API design (consider which methods/functions/classes need to be available and make stuff private/hidden, use __all__)
  • simplify lazy command loading (still easy to register new commands for poetry plugins)

Typing

  • remove all (or as much as possible) usage of optional types and Any
  • for types, all complex (more than 1 level deep) types should have a nice alias

To consider

  • drop event handling (cleo.events)

Misc

  • "inbox-zero" on issue tracker (aka resolve all issues)
  • test coverage in 90+% range

Best case scenario

This is a list of optional requirements that will not stop a release from happening if not completed

  • make highlighter extendable (json highlighting etc)
  • provide Protocols/hooks/base classes to easily modify or extend default behavior
  • dev docs with deep dive into inner works of every part of code

"I want to help!"

First of all, thank you.
Second, if you want to tackle one of the issues mentioned here or an issue from the issue tracker, please comment under this issue what you want to take care of. That will allow us to avoid duplicating our work. When in doubt, feel free to reach out in issues or on our Discord channel

Lingua principale
Python
Stelle
1.4k
Fork
104
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di python-poetry/cleo

Tutte le issue di python-poetry/cleo

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.