forked from platformio/platformio-core
192 lines
9.0 KiB
ReStructuredText
192 lines
9.0 KiB
ReStructuredText
.. _cmd_lib_search:
|
|
|
|
platformio lib search
|
|
=====================
|
|
|
|
.. contents::
|
|
|
|
Usage
|
|
-----
|
|
|
|
.. code-block:: bash
|
|
|
|
platformio lib search [OPTIONS] [QUERY]
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
Search for library in `PlatformIO Library Registry <http://platformio.ikravets.com/#!/lib>`_
|
|
by :ref:`library_config` fields in the boolean mode.
|
|
|
|
The boolean search capability supports the following operators:
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Operator
|
|
- Description
|
|
* - ``+``
|
|
- A leading or trailing plus sign indicates that this word must be present
|
|
in library fields (see above) that is returned.
|
|
* - ``-``
|
|
- A leading or trailing minus sign indicates that this word must not be
|
|
present in any of the libraries that are returned.
|
|
* - ``(no operator)``
|
|
- By default (when neither ``+`` nor ``-`` is specified), the
|
|
word is optional, but the libraries that contain it are rated higher.
|
|
* - ``> <``
|
|
- These two operators are used to change a word's contribution to the
|
|
relevance value that is assigned to a library. The ``>`` operator
|
|
increases the contribution and the ``<`` operator decreases it.
|
|
* - ``( )``
|
|
- Parentheses group words into subexpressions. Parenthesized groups can
|
|
be nested.
|
|
* - ``~``
|
|
- A leading tilde acts as a negation operator, causing the word's
|
|
contribution to the library's relevance to be negative. This is useful for
|
|
marking "noise" words. A library containing such a word is rated lower than
|
|
others, but is not excluded altogether, as it would be with the ``-`` operator.
|
|
* - ``*``
|
|
- The asterisk serves as the truncation (or wildcard) operator. Unlike the
|
|
other operators, it is appended to the word to be affected. Words match if
|
|
they begin with the word preceding the ``*`` operator.
|
|
* - ``"``
|
|
- A phrase that is enclosed within double quote (``"``) characters matches
|
|
only libraries that contain the phrase literally, as it was typed.
|
|
|
|
For more detail information please go to
|
|
`MySQL Boolean Full-Text Searches <http://dev.mysql.com/doc/refman/5.6/en/fulltext-boolean.html>`_.
|
|
|
|
Options
|
|
-------
|
|
|
|
.. option::
|
|
-a, --author
|
|
|
|
Filter libraries by specified author
|
|
|
|
.. option::
|
|
-k, --keyword
|
|
|
|
Filter libraries by specified keyword
|
|
|
|
|
|
.. option::
|
|
-f, --framework
|
|
|
|
Filter libraries by specified framework
|
|
|
|
|
|
.. option::
|
|
-p, --platform
|
|
|
|
Filter libraries by specified keyword
|
|
|
|
Examples
|
|
--------
|
|
|
|
1. List all libraries
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio lib search
|
|
# Found N libraries:
|
|
#
|
|
# [ ID ] Name Compatibility "Authors": Description
|
|
# -------------------------------------------------------------------------------------
|
|
# [ 14 ] Adafruit-9DOF-Unified arduino, atmelavr "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
|
|
# [ 13 ] Adafruit-GFX arduino, atmelavr "Adafruit Industries": A core graphics library for all our displays, providing a common set of graphics primitives (points, lines, circles, etc.)
|
|
# [ 23 ] Adafruit-L3GD20-Unified arduino, atmelavr "Adafruit Industries": Unified sensor driver for the L3GD20 Gyroscope
|
|
# [ 26 ] Adafruit-LSM303DLHC-Unified arduino, atmelavr "Adafruit Industries": Unified sensor driver for Adafruit's LSM303 Breakout (Accelerometer + Magnetometer)
|
|
# [ 12 ] Adafruit-ST7735 arduino, atmelavr "Adafruit Industries": A library for the Adafruit 1.8" SPI display
|
|
# [ 31 ] Adafruit-Unified-Sensor arduino, atmelavr "Adafruit Industries": Adafruit Unified Sensor Driver
|
|
# [ 4 ] IRremote arduino, atmelavr "Ken Shirriff": Send and receive infrared signals with multiple protocols
|
|
# [ 1 ] OneWire arduino, atmelavr "Paul Stoffregen": Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)
|
|
# [ 6 ] XBee arduino, atmelavr "Andrew Rapp": Arduino library for communicating with XBees in API mode
|
|
# [ 15 ] Adafruit-ADXL345-Unified arduino, atmelavr "Adafruit Industries": Unified driver for the ADXL345 Accelerometer
|
|
# Show next libraries? [y/N]:
|
|
# ...
|
|
|
|
2. Search for `1-Wire libraries <http://platformio.ikravets.com/#!/lib/search?query=%25221-wire%2522>`_
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio lib search "1-wire"
|
|
# Found N libraries:
|
|
#
|
|
# [ ID ] Name Compatibility "Authors": Description
|
|
# -------------------------------------------------------------------------------------
|
|
# [ 1 ] OneWire arduino, atmelavr "Paul Stoffregen": Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)
|
|
# ...
|
|
|
|
3. Search for `Arduino-based "I2C" libraries <http://platformio.ikravets.com/#!/lib/search?query=framework%253Aarduino%2520i2c&page=1>`_
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio lib search "i2c" --framework="arduino"
|
|
# Found N libraries:
|
|
#
|
|
# [ ID ] Name Compatibility "Authors": Description
|
|
# -------------------------------------------------------------------------------------
|
|
# [ 11 ] I2Cdevlib-Core arduino, atmelavr "Jeff Rowberg": The I2C Device Library (I2Cdevlib) is a collection of uniform and well-documented classes to provide simple and intuitive interfaces to I2C devices.
|
|
# [ 24 ] Adafruit-L3GD20 arduino, atmelavr "Adafruit Industries": Driver for Adafruit's L3GD20 I2C Gyroscope Breakout
|
|
# [ 10 ] I2Cdevlib-AK8975 arduino, atmelavr "Jeff Rowberg": AK8975 is 3-axis electronic compass IC with high sensitive Hall sensor technology
|
|
# [ 14 ] Adafruit-9DOF-Unified arduino, atmelavr "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
|
|
# ...
|
|
|
|
4. Search for `libraries by "web" and "http" keywords <http://platformio.ikravets.com/#!/lib/search?query=keyword%253A%2522web%2522%2520keyword%253A%2522http%2522&page=1>`_.
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio lib search --keyword="web" --keyword="http"
|
|
# Found N libraries:
|
|
#
|
|
# [ ID ] Name Compatibility "Authors": Description
|
|
# -------------------------------------------------------------------------------------
|
|
# [ 5 ] Webduino arduino, atmelavr "Ben Combee": An extensible web server library (for use with the Arduino WizNet Ethernet Shield)
|
|
# [ 17 ] Adafruit-CC3000 arduino, atmelavr "Adafruit Industries": Library code for Adafruit's CC3000 Wi-Fi/WiFi breakouts
|
|
# ...
|
|
|
|
5. Search for `libraries from "Adafruit Industries" author <http://platformio.ikravets.com/#!/lib/search?query=author%253A%2522Adafruit%20Industries%2522>`_
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio lib search --author="Adafruit Industries"
|
|
# Found N libraries:
|
|
#
|
|
# [ ID ] Name Compatibility "Authors": Description
|
|
# -------------------------------------------------------------------------------------
|
|
# [ 14 ] Adafruit-9DOF-Unified arduino, atmelavr "Adafruit Industries": Unified sensor driver for the Adafruit 9DOF Breakout (L3GD20 / LSM303)
|
|
# [ 13 ] Adafruit-GFX arduino, atmelavr "Adafruit Industries": A core graphics library for all our displays, providing a common set of graphics primitives (points, lines, circles, etc.)
|
|
# [ 23 ] Adafruit-L3GD20-Unified arduino, atmelavr "Adafruit Industries": Unified sensor driver for the L3GD20 Gyroscope
|
|
# [ 26 ] Adafruit-LSM303DLHC-Unified arduino, atmelavr "Adafruit Industries": Unified sensor driver for Adafruit's LSM303 Breakout (Accelerometer + Magnetometer)
|
|
# ...
|
|
|
|
6. Search for `libraries that are compatible with Dallas temperature sensors <http://platformio.ikravets.com/#!/lib/search?query=DS*>`_
|
|
like DS18B20, DS18S20 and etc.
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio lib search "DS*"
|
|
# Found N libraries:
|
|
#
|
|
# [ ID ] Name Compatibility "Authors": Description
|
|
# -------------------------------------------------------------------------------------
|
|
# [ 1 ] OneWire arduino, atmelavr "Paul Stoffregen": Control devices (from Dallas Semiconductor) that use the One Wire protocol (DS18S20, DS18B20, DS2408 and etc)
|
|
# ...
|
|
|
|
7. Search for `Arduino-based *X10* or *XBee* libraries <http://platformio.ikravets.com/#!/lib/search?query=framework%253Aarduino%2520%252B(x10%2520xbee)&page=1>`_.
|
|
The search query that is described below can be interpreted like
|
|
``arduino x10 OR arduino xbee``
|
|
|
|
.. code-block:: bash
|
|
|
|
$ platformio lib search "+(x10 xbee)" --framework="arduino"
|
|
# Found 2 libraries:
|
|
#
|
|
# [ ID ] Name Compatibility "Authors": Description
|
|
# -------------------------------------------------------------------------------------
|
|
# [ 36 ] X10 arduino, atmelavr "Doug Clinton": Sending X10 signals over AC power lines (PL513, TW523 and etc)
|
|
# [ 6 ] XBee arduino, atmelavr "Andrew Rapp": Arduino library for communicating with XBees in API mode
|