Metadata-Version: 2.1
Name: micropy-cli
Version: 1.0.0
Summary: Command line Application for automating Micropython project     setup and management in Visual Studio Code.
Home-page: https://github.com/BradenM/micropy-cli
Author: Braden Mars
License: GNU GPLv3
Description: 
        # Micropy Cli [![PyPI][pypi-img]][pypi-url] [![PyPI - Python Version][pypiv-img]][pypi-url] [![Travis (.com)][travis-img]][travis-url] [![Coverage Status][cover-img]][cover-url]
        
        
        Micropy Cli is a project management/generation tool for writing [Micropython](https://micropython.org/) code in modern IDEs such as VSCode.
        Its primary goal is to automate the process of creating a workspace complete with:
        
        * **Linting** compatible with Micropython
        * VSCode **Intellisense**
        * **Autocompletion**
        * Dependency Management (_WIP_)
        * VCS Compatibility
        
        <!-- Command line Application for automating Micropython project creation in Visual Studio Code. -->
        
        <p align='center'>
            <img width='725' src='.github/img/micropy.svg' alt="Micropy Demo SVG">
        </p>
        
        [pypi-img]: https://img.shields.io/pypi/v/micropy-cli.svg?style=popout-square
        [pypi-url]: https://pypi.org/project/micropy-cli/
        [pypiv-img]: https://img.shields.io/pypi/pyversions/micropy-cli.svg?style=popout-square
        [travis-img]: https://img.shields.io/travis/com/BradenM/micropy-cli/master.svg?style=popout-square
        [travis-url]: https://travis-ci.com/BradenM/micropy-cli
        [cover-img]: https://coveralls.io/repos/github/BradenM/micropy-cli/badge.svg
        [cover-url]: https://coveralls.io/github/BradenM/micropy-cli
        
        ## Installation
        
        You can download and install the latest version of this software from the Python package index (PyPI) as follows:
        
        `pip install --upgrade micropy-cli`
        
        ## Usage
        
        ```sh
        Usage: micropy [OPTIONS] COMMAND [ARGS]...
        
          CLI Application for creating/managing Micropython Projects.
        
        Options:
          --version  Show the version and exit.
          --help     Show this message and exit.
        
        Commands:
          init   Create new Micropython Project
          stubs  Manage Micropy Stubs
        ```
        
        ### Creating a Project
        
        Creating a new project folder is as simple as:
        
        1. Executing `micropy init <PROJECT NAME>`
        2. Selecting your target device/firmware
        3. Boom. Your workspace is ready.
        
        ### Stub Management
        
        Stub files are the magic behind how micropy allows features such as linting, Intellisense, and autocompletion to work. To achieve the best results with MicropyCli, its important that you first add the appropriate stubs for the device/firmware your project uses.
        
        #### Adding Stubs
        
        Adding stubs to Micropy is a breeze. Simply run: `micropy stubs add <STUB_NAME>`
        By sourcing [micropy-stubs](https://github.com/BradenM/micropy-stubs), MicroPy has several premade stub packages to choose from.
        
        These packages generally use the following naming schema:
        
        `<device>-<firmware>-<version>`
        
        For example, running `micropy stubs add esp32-micropython-1.11.0` will install the following:
        * Micropython Specific Stubs
        * ESP32 Micropython v1.11 Device Specific Stubs
        * Frozen Modules for both device and firmware
        
        You can search stubs that are made available to Micropy via `micropy stubs search <QUERY>`
        
        Alternatively, using `micropy stubs add <PATH>`, you can manually add stubs to Micropy.
        For manual stub generation, please see [Josvel/micropython-stubber](https://github.com/Josverl/micropython-stubber).
        
        #### Creating Stubs
        
        Using `micropy stubs create <PORT/IP_ADDRESS>`, MicropyCli can automatically generate and add stubs from any Micropython device you have on hand. This can be done over both USB and WiFi.
        
        
        #### Viewing Stubs
        
        To list stubs you have installed, simply run `micropy stubs list`.
        
        To search for stubs for your device, use `micropy stubs search <QUERY>`.
        
        
        ## Acknowledgements
        
        ### Micropython-Stubber
        [Josvel/micropython-stubber](https://github.com/Josverl/micropython-stubber)
        
        Josverl's Repo is full of information regarding Micropython compatibility with VSCode and more. To find out more about how this process works, take a look at it.
        
        micropy-cli and [micropy-stubs](https://github.com/BradenM/micropy-stubs) depend on micropython-stubber for its ability to generate frozen modules, create stubs on a pyboard, and more.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: MicroPython
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
