Skip to main content

micoo is a command-line tool for easily accessing mise cookbooks

Project description

micoo: quick access to mise-cookbooks

CI PyPI - Version PyPI - Python Version License - MIT Latest Commit

Checked with mypy linting - Ruff GitHub Tag

Downloads Downloads/Month Downloads/Week

micoo (short for mise cookbooks) is a :zap: command-line tool that makes it easy to access mise configuration files from mise-cookbooks :books:.

Typical Usage :rocket:

# List available cookbooks
micoo list

# Create a new mise.toml with a cookbook
micoo dump python > mise.toml

Features :sparkles:

  • ๐Ÿš€ Quick access to mise-cookbooks
  • ๐Ÿ“š Easy cookbook listing and content viewing
  • ๐Ÿ’พ Simple dumping of cookbooks to mise.toml
  • ๐Ÿ”„ Repository cloning and updating
  • ๐ŸŒ Browser integration for quick repository access

Installation :package:

There are several ways to install micoo! :rocket: I recommend using (obviously) mise :hammer_and_wrench:. Here's how to do it:

mise install pipx:micoo

Alternatively, you can install it using uv tool install micoo :jigsaw:

uv tool install micoo

Command Reference :book:

Here is the output of the micoo --help command:

 Usage: micoo [OPTIONS] COMMAND [ARGS]...
โ•ญโ”€ Options โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚ --install-completion          Install completion for the current shell.               โ”‚
โ”‚ --show-completion             Show completion for the current shell, to copy it or    โ”‚
โ”‚                               customize the installation.                             โ”‚
โ”‚ --help                        Show this message and exit.                             โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
โ•ญโ”€ Commands โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚ update    Clone or fetch the `mise-cookbooks` repository.                             โ”‚
โ”‚ list      List the available mise cookbooks.                                          โ”‚
โ”‚ search    Search for a mise cookbook.                                                 โ”‚
โ”‚ dump      Dump a mise cookbook.                                                       โ”‚
โ”‚ root      Show the path to the micoo boilerplates directory.                          โ”‚
โ”‚ remote    Show the URL to the remote repository.                                      โ”‚
โ”‚ version   Show the current version number of micoo.                                   โ”‚
โ”‚ info      Display information about the micoo application.                            โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

Usage :hammer_and_wrench:

You can use the micoo command to interact with mise-cookbooks. Here are some common commands:

List all available cookbooks:

micoo list

This will output:

Available cookbooks:
- terraform
- python
- cpp
- pnpm
- node
- ruby-on-rails
- opentofu

Dump a specific cookbook to a mise.toml file:

micoo dump python > mise.toml

Open the mise-cookbooks repository in the browser:

open $(micoo remote)

Open the cloned repository in the file manager:

open $(micoo root)

Show the current version of micoo:

micoo version

Show the information about the micoo application:

micoo info

Support :heart:

If you have any questions or need help, feel free to open an issue on the GitHub repository.

Author :person_with_crown:

This project is maintained by Hasan Sezer TaลŸan, It's me :wave:

Contributing :heart:

Any contributions are welcome! Please follow the Contributing Guidelines to contribute to this project.

Development :toolbox:

To set up the development environment:

# Clone the repository
git clone https://github.com/hasansezertasan/micoo.git
cd micoo

# Install development dependencies
uv sync

# Update the code...

# Run tests
uv run --locked tox run

# Add a new git tag.
git tag -a v0.1.0 -m "bump: version 0.0.0 โ†’ 0.1.0"

# Build the package
uv build

Related Projects :chains:

Changelog :memo:

For a detailed list of changes, please refer to the CHANGELOG.

License :scroll:

This project is licensed under the MIT License.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

micoo-0.1.0.tar.gz (130.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

micoo-0.1.0-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

Details for the file micoo-0.1.0.tar.gz.

File metadata

  • Download URL: micoo-0.1.0.tar.gz
  • Upload date:
  • Size: 130.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for micoo-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f67b649123f79e1a93e991aa051fc73c3f8f527f173cdab5b52d6dc15e042132
MD5 23298d5e1d10dabba8e0539e981b76a9
BLAKE2b-256 7b10864e42bbc0c90bcd0c7e947b1e55f3b9b4b77b9d5a9445c2a13574c33cb8

See more details on using hashes here.

Provenance

The following attestation bundles were made for micoo-0.1.0.tar.gz:

Publisher: cd.yml on hasansezertasan/micoo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file micoo-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: micoo-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for micoo-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 54a26f8326b5c6cccb83b6c20be05013d7cef4f15f39c98b9d8b1684671e362d
MD5 283775865ddd8168db8b84e6ac401f00
BLAKE2b-256 da762956e22d5a678b1f9e01f31a561b4a551dda964ef72d062c1e6155df9938

See more details on using hashes here.

Provenance

The following attestation bundles were made for micoo-0.1.0-py3-none-any.whl:

Publisher: cd.yml on hasansezertasan/micoo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page