protontypes / AwesomeCure

Analyze and cure awesome lists by collecting, processing and presenting data from listed Git projects.
MIT License
17 stars 3 forks source link

Added the Poetry src layout including the 'open-sustain-tech' module'… #21

Closed aguennoune closed 9 months ago

aguennoune commented 9 months ago

An extended Poetry's command-line interface by developing plugins

In response to the open issue, and for better integration and interaction with other tools, the alternative to the usage of a Jupyter notebook is a command-line tool out of the project.

Indeed, this option will allow users to interact with the project from a command line without having to install Jupyter notebooks or other dependencies.

Usage:

From an integrated terminal, the plugin needs to depend on Poetry to interface with it, so you can run the following commands:

poetry install

then,
poetry add open-sustain-tech

or,
pip install open-sustain-tech

Once it's done, and the poetry.lock file installed, you can run:

poetry run python -m open_sustain_tech

or,
poetry run oss-opt

or simply
oss-opt

As presented in the protontypes/AwesomeCure README.md, currently under the Architecture section and as described under Data Acquisition, the oss-opt command-line interface lets your read the Awesome list from any repository as well.

Note: Depending on the size of the list, the processing can take multiple hours.

Ly0n commented 9 months ago

Wow, this looks like a proper overhaul of the previously rather impractical scripts. I'll have a closer look over the weekend. Thanks a lot for supporting this project.

aguennoune commented 9 months ago

Hi @Ly0n ! AwesomeCure needs Awesome People like you. Thanks to you, i may learn and growth within the right track, and accordingly to the purposes of the Open Sustainability Technologies and such overwhelming perspectives it covers through the Open Source Software Sustainable Areas. So thank you for according me to contribute to such interesting perspectives!

aguennoune commented 9 months ago

This is an update to the open_sustain_tech command-line interface, and here are the main changes to consider regarding this update: