Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/liblaf/awesome-list-generator
📚✨ Awesome List Generator: Automatically generate beautiful, structured awesome lists from YAML configuration files! Supports GitHub project metadata, markdown formatting, and customizable categories. Perfect for maintaining curated lists of awesome resources with minimal effort! 🚀
https://github.com/liblaf/awesome-list-generator
List: awesome-list-generator
automation awesome cli data-visualization dependency-management documentation github-api markdown project-management python
Last synced: 8 days ago
JSON representation
📚✨ Awesome List Generator: Automatically generate beautiful, structured awesome lists from YAML configuration files! Supports GitHub project metadata, markdown formatting, and customizable categories. Perfect for maintaining curated lists of awesome resources with minimal effort! 🚀
- Host: GitHub
- URL: https://github.com/liblaf/awesome-list-generator
- Owner: liblaf
- License: mit
- Created: 2025-01-26T09:15:36.000Z (11 days ago)
- Default Branch: main
- Last Pushed: 2025-01-26T18:08:04.000Z (11 days ago)
- Last Synced: 2025-01-26T18:17:33.650Z (11 days ago)
- Topics: automation, awesome, cli, data-visualization, dependency-management, documentation, github-api, markdown, project-management, python
- Language: Python
- Homepage: https://pypi.org/project/awesome-list-generator/
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: docs/README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Awesome List Generator
Awesome List Generator is a powerful Python tool for creating and maintaining curated lists of awesome projects. It supports multiple formats, integrates with GitHub for project metadata, and provides customizable templates for generating professional-looking lists with rich project details.
[](https://pypi.org/project/awesome-list-generator/)
[](https://pypi.org/project/awesome-list-generator/)
[](https://pypi.org/project/awesome-list-generator/)
[](https://github.com/liblaf/awesome-list-generator/graphs/contributors)
[](https://github.com/liblaf/awesome-list-generator/forks)
[](https://github.com/liblaf/awesome-list-generator/stargazers)
[](https://github.com/liblaf/awesome-list-generator/issues)
[](https://github.com/liblaf/awesome-list-generator/blob/main/LICENSE)
[Changelog](https://github.com/liblaf/awesome-list-generator/blob/main/CHANGELOG.md) · [Report Bug](https://github.com/liblaf/awesome-list-generator/issues) · [Request Feature](https://github.com/liblaf/awesome-list-generator/issues)
## ✨ Features
- 📜 **Markdown Generation:** Automatically generates beautiful and structured Markdown files for awesome lists, complete with badges, descriptions, and project statistics;
- 🚀 **GitHub Integration:** Seamlessly fetches project information from GitHub, including stars, forks, issues, pull requests, and license details;
- 🧩 **Plugin Architecture:** Extensible plugin system allows for easy integration of additional data sources and formats beyond GitHub;
- 🎨 **Customizable Formatting:** Supports multiple output formats (currently Markdown) with customizable templates for different presentation styles;
- ⚡ **Async Performance:** Built with asyncio for efficient concurrent fetching of project data from multiple sources;
- 🔍 **Project Categorization:** Automatically organizes projects into categories with customizable titles and subtitles;
- 🛠️ **CLI Interface:** Easy-to-use command-line interface for generating lists with a single command;
- 🧪 **Type Safety:** Fully type-annotated codebase with Pydantic models for robust data validation and IDE support;
- 🧰 **Dependency Management:** Uses modern Python packaging tools (Hatch) for clean dependency management and reproducible builds;
- 🤖 **Automation Ready:** Includes GitHub Actions workflows for automated testing, linting, and releases.
[](#readme-top)
## 📦 Installation
To install `awesome-list-generator`, run the following command:
```bash
uv tool install awesome-list-generator
```
[](#readme-top)
## ⌨️ Local Development
You can use Github Codespaces for online development:
[](https://codespaces.new/liblaf/awesome-list-generator)
Or clone it for local development:
```bash
git clone https://github.com/liblaf/awesome-list-generator.git
cd lime
uv sync
```
[](#readme-top)
## 🤝 Contributing
Contributions of all types are more than welcome, if you are interested in contributing code, feel free to check out our GitHub [Issues](https://github.com/liblaf/awesome-list-generator/issues) to get stuck in to show us what you're made of.
[](https://github.com/liblaf/awesome-list-generator/pulls)
[](https://github.com/liblaf/awesome-list-generator/graphs/contributors)
[](#readme-top)
---
#### 📝 License
Copyright © 2025 [liblaf](https://github.com/liblaf).
This project is [MIT](https://github.com/liblaf/awesome-list-generator/blob/main/LICENSE) licensed.