Metadata-Version: 2.1
Name: pycarbonsh
Version: 0.1.1
Summary: The Asynchronous web-scraper for carbon.now.sh which helps to create and share beautiful pics of your code!
Home-page: https://github.com/Pranav-Saxena/PyCarbonSh
Author: Pranav Saxena
License: MIT
Project-URL: Documentation, https://pycarbonsh.readthedocs.io/en/latest/
Project-URL: Issue tracker, https://github.com/Pranav-Saxena/PyCarbonSh/issues
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8.0
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: pyppeteer
Requires-Dist: asyncio
Provides-Extra: docs
Requires-Dist: sphinx (==4.0.2) ; extra == 'docs'
Requires-Dist: sphinxcontrib-trio (==1.1.2) ; extra == 'docs'
Requires-Dist: sphinxcontrib-napoleon ; extra == 'docs'
Requires-Dist: sphinxcontrib-websupport ; extra == 'docs'
Provides-Extra: speed
Requires-Dist: orjson (>=3.5.4) ; extra == 'speed'

***********
PyCarbonSh 
***********

.. image:: https://cdn.discordapp.com/attachments/862939982837317672/875030619606888458/pycarbonsh.png
    :align: center
    :target: https://github.com/Pranav-Saxena/PyCarbonSh/
    :alt: PyCarbonSh

*The Asynchronous web-scraper for carbon.now.sh which helps to create and share beautiful pics of your code!*

.. image:: https://discord.com/api/guilds/833364768076988458/embed.png
   :target: https://discord.gg/tTr6DvyRCH
   :alt: Discord server invite
.. image:: https://img.shields.io/pypi/v/pycarbonsh.svg
   :target: https://pypi.python.org/pypi/pycarbonsh
   :alt: PyPI version info
.. image:: https://img.shields.io/pypi/pyversions/pycarbonsh.svg
   :target: https://pypi.python.org/pypi/pycarbonsh
   :alt: PyPI supported Python versions
.. image:: https://img.shields.io/github/license/Pranav-Saxena/PyCarbonSh?color=2b9348.svg
    :target: LICENSE
.. image:: https://img.shields.io/github/stars/Pranav-Saxena/PyCarbonSh?color=2b9348.svg
    :alt: Stars
.. image:: https://img.shields.io/github/forks/Pranav-Saxena/PyCarbonSh?color=2b9348.svg
    :alt: forks


Documentation
---------------------------
`Official Documentation <https://pycarbonsh.readthedocs.io/en/latest/index.html#>`_.

Support
---------------------------
For support using PyCarbonSh, please join the official `support server
<https://discord.gg/tTr6DvyRCH>`_ on `Discord <https://discordapp.com/>`_.

Installation
---------------------------
The following commands are currently the valid ways of installing PyCarbonSh.

Through pip
############

**Windows**

.. code:: sh

    py -3 -m pip install pycarbonsh

**Linux/MacOS**

.. code:: sh

    python3 -m pip3 install pycarbonsh


To install master branch
#########################

**Windows**

.. code:: sh

    py -3 -m pip install -U git+https://github.com/Pranav-Saxena/PyCarbonSh@master

**Linux/MacOS**

.. code:: sh

    python3 -m pip3 install -U git+https://github.com/Pranav-Saxena/PyCarbonSh@master

Manual Installation
####################
- ``git clone https://github.com/Pranav-Saxena/PyCarbonSh/``
- ``setup.bat``
- ``venv\scripts\activate``
- ``pycarbonsh``

Usage
#######
    .. note:: When you run pycarbonsh for the first time, it downloads the latest version of Chromium (~150MB) if it is not found on your system. If you don't prefer this behavior, ensure that a suitable Chrome binary is installed. One way to do this is to run ``pyppeteer-install`` command before prior to using this library.

Getting Started
----------------------------

A quick and easy example to get started with PyCarbonSh

.. code:: py

    from pycarbonsh import generatecarbon
    import asyncio
    loop = asyncio.get_event_loop()
    loop.run_until_complete(generatecarbon(code="Made with ❤ by Pranav Saxena"))

Contribute
----------------------------
Any contributions you make are **greatly appreciated**.
    
- PRs are accepted!!
- If you have some ideas for new features and you don't have time to implement them please open an issue with the tag new_feature.
- Please don't forget to comment (document) your code!

