mahmoud / apatite

Awesomer awesome list management and analysis, originally designed for Awesome Python Applications: https://github.com/mahmoud/awesome-python-applications

Apatite

A command-line application for curating structured lists of software projects.

First run

pip install apatite

Then run

apatite --help

And you'll see

Usage: /home/mahmoud/virtualenvs/apatite/bin/apatite subcommand [FLAGS]

    automation and analytics for curated lists of awesome software.

    Normal analysis workflow:

      * apatite pull-repos  (can take 3-4 hours, 25GB on the full APA, use --targets to limit)
      * apatite collect-metrics
      * apatite export-metrics
      * apatite analyze  # TODO



Subcommands:

  render                    generate the list markdown from the yaml listing
  normalize                 normalize project and tag order, checking for duplicates and format divergences,
                            overwrites the yaml listing
  pull-repos                clone or pull all projects. requires git, hg, and bzr to be installed for projects in APA
  collect-metrics           use local clones of repositories (from pull-repos) to gather data about projects
  show-recent-metrics       shows the most recent metrics collection
  export-metrics            export a csv with metrics collated from previous collect-metrics runs
  show-exportable-metrics   show a list of metric names available for export-metrics --cols and --cols-file flags
  console                   use pdb to explore plist and pdir
  version                   print the apatite version and exit


Flags:

  --help / -h   show this help message and exit

apatite's Issues

apatite v 20.0.0 requires pip install ashes before it works

I upgraded apatite to the latest version (20.0.0) and ran $ apatite render. got the following error:

$ apatite render
Traceback (most recent call last):
  File "c:\users\mcgyv\appdata\local\programs\python\python37\lib\runpy.py", line 193, in _run_module_as_main
    "__main__", mod_spec)
  File "c:\users\mcgyv\appdata\local\programs\python\python37\lib\runpy.py", line 85, in _run_code
    exec(code, run_globals)
  File "C:\Users\mcgyv\AppData\Local\Programs\Python\Python37\Scripts\apatite.exe\__main__.py", line 5, in <module>
  File "c:\users\mcgyv\appdata\local\programs\python\python37\lib\site-packages\apatite\__main__.py", line 4, in <module>
    from .cli import main
  File "c:\users\mcgyv\appdata\local\programs\python\python37\lib\site-packages\apatite\cli.py", line 22, in <module>
    from ashes import AshesEnv
ModuleNotFoundError: No module named 'ashes'

so I ran pip install ashes and now it works.

Dev plans?

Hey @mahmoud

This sounds like a cool idea! Your talk on this reminded me of https://python.libhunt.com/

Do you have any dev plans for this? Do you know of other projects that try to accomplish the same?

Cheers! 🚀