.. _chemfp_fpb_text:

chemfp fpb_text command-line options
====================================

The ``fpb_text`` subcommand shows the TEXT sections of an FPB file.
Currently this is only used to store the copyright notice, attribution,
and license for licensed ChEMBL data sets.

The following comes from ``chemfp fpb_text --help``:

.. code-block:: none

  usage: fpb_text fpb_text [-h] [--list-labels] [--label LABEL] [--in FORMAT]
                           filename
  
  Show the TEXT sections of an FPB file
  
  positional arguments:
    filename
  
  options:
    -h, --help     show this help message and exit
    --list-labels  only show the labels of the TEXT blocks
    --label LABEL  only show the named label(s). Can be used more than once.
    --in FORMAT    input FPB format

Example output:
------------------------

.. code-block:: console

  % chemfp fpb_text --list-labels chembl_29.fpb.gz
  Notice
  Attribution
  License
  % chemfp fpb_text --label  Attribution chembl_29.fpb.gz | head -5
  Attribution
  ===========
  The data in ChEMBL is covered by the licence in the file LICENSE.
  
  Under the -BY clause, we request attribution for subsequent use of ChEMBL.