Core CLI Interface 🖥️

[lalithaar]

Priority: High | Difficulty: Low | Estimated: 3-5 days

Problem

Need a command-line interface that developers can actually use to process CSS files.

Scope

Basic CLI that takes a CSS file, processes colors through CM-Colors, and outputs results.

Usage

# Basic processing
cm-colors process input.css

# Specify output file
cm-colors process input.css --output accessible.css

Acceptance Criteria

• Install as CLI command (pip install cm-colors → cm-colors available)
• Process single CSS file
• Clear progress feedback and error messages
• Help documentation (cm-colors --help)
• Exit codes (0 = success, 1 = errors found)

Technical Requirements

• Use Click for CLI framework
• Rich for pretty terminal output
• Proper error handling and user feedback
• Cross-platform compatibility

Dependencies

• Requires previous sub issue (CSS extraction) to be completed

[Chandru03]

@lalithaar I would also like to contribute to this issue! Can you assign this issue to me

[lalithaar]

Assigned! Thanks for stepping up on this 🎉 @Chandru03
Just a heads up - for any functions that use the core CM-Colors API, please use placeholders for now since we're refactoring the main functions (see #14). Once that's done, we can easily swap in the real function names.
Feel free to ask questions as you work on it!

[lalithaar]

Hello @Chandru03 I just wanted to check up on the progress, do lemme know if you have any questions :>

[Chandru03]

Thanks for checking up on the progress! This week is a bit hectic in my work. So I guess I'll be able to work only on Saturday. I'll let you know if I have any queries and will update you on the progress :) thanks again!

[kylowren85]

@Chandru03 I would like to know if the progress has started, just in case i dont make a new branch, and we both implement same feature in different ways, btw, i was not able to find a fork of this repo in your github account, so I can't know the progress (what pip package is to be used for cli and how), which if I knew, I could look into contributing.

[kylowren85]

Considering the priority of the feature (a very important feature it is), I suggest a branch be created for people who want to contribute in cli development, so that cli development is unified and concentrated into one branch rather than multiple personal forks.

[lalithaar]

I have created a new branch for cli-development, so it's synced - We can track the progress and follow through in the new branch until the base is ready for release

@Chandru03 Do let me know if you need any help, take good rest when you can :>