Metadata-Version: 2.1
Name: KiCadRW
Version: 0.1
Summary: Python library to read/write KiCad Sexpr file format
Home-page: https://github.com/FabriceSalvaire/kicad-rw
Author: Fabrice Salvaire
Author-email: kicad-rw@fabrice-salvaire.fr
Maintainer: Fabrice Salvaire
Maintainer-email: kicad-rw@fabrice-salvaire.fr
License: GPLv3
Project-URL: Code, https://github.com/FabriceSalvaire/kicad-rw
Project-URL: Issue Tracker, https://github.com/FabriceSalvaire/kicad-rw/issues
Description: .. -*- Mode: rst -*-
        
        .. -*- Mode: rst -*-
        
        .. |KiCadRWUrl| replace:: https://kicad-rw.fabrice-salvaire.fr
        
        .. |KiCadRWHomePage| replace:: KiCadRW Home Page
        .. _KiCadRWHomePage: https://kicad-rw.fabrice-salvaire.fr
        
        
        .. |KiCadRW@github| replace:: https://github.com/FabriceSalvaire/KiCadRW
        
        
        .. |KiCadRW@pypi| replace:: https://pypi.python.org/pypi/KiCadRW
        
        
        .. |KiCadRW@anaconda| replace:: https://anaconda.org/conda-forge/kicad-rw
        
        .. |KiCadRW@fs-anaconda| replace:: https://anaconda.org/fabricesalvaire/kicad-rw
        
        .. |Anaconda Version| image:: https://anaconda.org/conda-forge/kicad-rw/badges/version.svg
           :target: https://anaconda.org/conda-forge/kicad-rw/badges/version.svg
           :alt: Anaconda last version
        
        .. |Anaconda Downloads| image:: https://anaconda.org/conda-forge/kicad-rw/badges/downloads.svg
           :target: https://anaconda.org/conda-forge/kicad-rw/badges/downloads.svg
           :alt: Anaconda donwloads
        
        
        .. |Pypi Version| image:: https://img.shields.io/pypi/v/KiCadRW.svg
           :target: https://pypi.python.org/pypi/KiCadRW
           :alt: KiCadRW last version
        
        .. |Pypi License| image:: https://img.shields.io/pypi/l/KiCadRW.svg
           :target: https://pypi.python.org/pypi/KiCadRW
           :alt: KiCadRW license
        
        .. |Pypi Python Version| image:: https://img.shields.io/pypi/pyversions/KiCadRW.svg
           :target: https://pypi.python.org/pypi/KiCadRW
           :alt: KiCadRW python version
        
        
        .. |Tavis CI master| image:: https://travis-ci.com/FabriceSalvaire/KiCadRW.svg?branch=master
           :target: https://travis-ci.com/FabriceSalvaire/KiCadRW
           :alt: KiCadRW build status @travis-ci.org
        
        .. |KiCadRW Test Workflow| image:: https://github.com/FabriceSalvaire/kicad-rw/actions/workflows/pyspice-test.yml/badge.svg?branch=devel
           :target: https://github.com/FabriceSalvaire/kicad-rw/actions/workflows/kicadrw-test.yml
        .. -*- Mode: rst -*-
        
        .. _IPython: http://ipython.org
        .. _Kicad: http://www.kicad-pcb.org
        .. _PyPI: https://pypi.python.org/pypi
        .. _Pyterate: https://github.com/FabriceSalvaire/Pyterate
        .. _Python: http://python.org
        .. _Sphinx: http://sphinx-doc.org
        .. _Tikz: http://www.texample.net/tikz
        
        .. |Circuit_macros| replace:: Circuit_macros
        .. |IPython| replace:: IPython
        .. |Kicad| replace:: Kicad
        .. |PyPI| replace:: PyPI
        .. |Pyterate| replace:: Pyterate
        .. |Python| replace:: Python
        .. |Sphinx| replace:: Sphinx
        .. |Tikz| replace:: Tikz
        
        =================================================================
         KiCad-RW : Python library to read/write KiCad Sexpr file format 
        =================================================================
        
        ..
           |Pypi License|
           |Pypi Python Version|
        
           |Pypi Version|
        
           |Anaconda Version|
           |Anaconda Downloads|
        
           |KiCadRW Test Workflow|
        
        **Quick Links**
        
        * `Devel Branch <https://github.com/FabriceSalvaire/kicad-rw/tree/devel>`_
        * `Production Branch <https://github.com/FabriceSalvaire/kicad-rw/tree/master>`_
        
        ..
           * `kicad-rw@conda-forge <https://github.com/conda-forge/kicad-rw-feedstock>`_
           * `conda-forge/kicad-rw <https://anaconda.org/conda-forge/kicad-rw>`_
        
        Overview
        ========
        
        What is KiCaD-RW ?
        ------------------
        
        **A WORK IN PROGRESS...**
        
        **keywords:** kicad, 6, sexpr, python, schema
        
        **KiCad-RW** is a Python module to read the KiCad version 6 schema file format (`.kicad_sch` file
        extension) and to compute the netlist which is not actually stored by KiCad.  This module is
        standalone and independent of the KiCad Python API, thus it don't require KiCad to work.
        
        **Examples of use cases:**
        
        * perform checks on circuit
        * export a BOM
        * generate a customised SPICE netlist, see `PySpice <https://github.com/FabriceSalvaire/PySpice>`_
        * generate a `LaTeX/Tikz <https://ctan.org/pkg/pgf?lang=en>`_ graphic **TO BE IMPLEMENTED**
        * generate a draft for `Circuit_macros <https://ece.uwaterloo.ca/~aplevich/Circuit_macros>`_,
          a tool for drawing electric high quality circuits, see `CircuitMacrosDumper`
        * etc.
        
        **KiCad-RW** uses the Python library `sexpdata <https://github.com/jd-boyd/sexpdata>`_ to parse the file.
        
        **How to go further:**
        
        * KiCad uses Sexpr format, thus we don't have so many tools and a DTD like for XML
        * We must use an external library to parse Sexpr format: sexpdata actually
        * We must be able to parse the file without the need of KiCad, especially if we think KiCad is a reference EDA software
        * We must not write tons of code to handle this format...
        * We must try to auto-learn the KiCad format from a reference file collection and generate an OO API (fully automatic, jinja template)
        
        `Look at this project <https://github.com/FabriceSalvaire/kicad-rw/projects/1>`_
        
        `Comprehensive bibliography and relevant links on the topic <https://github.com/FabriceSalvaire/kicad-rw/blob/main/LINKS.md>`_
        
        Where is the Documentation ?
        ----------------------------
        
        *TO BE COMPLETED*
        
        .. The documentation is available on the |KiCaDRWHomePage|_.
        
        Where to get help or talk about KiCaD-RW ?
        ------------------------------------------
        
        *TO BE COMPLETED*:
        
        What are the main features ?
        ----------------------------
        
        How to install it ?
        -------------------
        
        *TO BE COMPLETED*
        
        .. Look at the `installation <https://kicad-rw.fabrice-salvaire.fr/releases/latest/installation.html>`_ section in the documentation.
        
        Pull Request Recommendation
        ===========================
        
        To make it easier to merge your pull request, you should divide your PR into smaller and easier-to-verify units.
        
        Please do not make a pull requests with a lot of modifications which are difficult to check.
        
        .. If I merge pull requests blindly then there is a high risk this software will become a mess quickly for everybody.
        
        Credits
        =======
        
        Authors: `Fabrice Salvaire <http://fabrice-salvaire.fr>`_ and `contributors <https://github.com/FabriceSalvaire/kicad-rw/blob/master/CONTRIBUTORS.md>`_
        
        News
        ====
        
        .. -*- Mode: rst -*-
        
        
        .. no title here
        
        V0 2020-05-xx
        -------------
        
        Started project...
        
        .. End
        
        .. End
        
Keywords: kicad,sexpr
Platform: any
Classifier: Topic :: Scientific/Engineering
Classifier: Intended Audience :: Education
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
