CLI Module
==========

.. automodule:: wosecopy.cli
   :members:
   :undoc-members:
   :show-inheritance:

The CLI module provides the command-line interface for wosecopy.

Commands Reference
------------------

extract
~~~~~~~

Extract wosecopy concepts from CSV file.

.. code-block:: bash

   wosecopy extract INPUT_FILE [OPTIONS]

**Options**:

* ``-o, --output PATH``: Output CSV file path
* ``--text-column TEXT``: Name of column containing text (default: Story)
* ``-l, --language [en|de]``: Language (default: en)
* ``--model-size [sm|md|lg]``: Spacy model size (default: lg)
* ``--similarity-threshold FLOAT``: Minimum similarity (0-1)

metrics
~~~~~~~

Calculate network metrics.

.. code-block:: bash

   wosecopy metrics INPUT_FILE [OPTIONS]

**Options**:

* ``-o, --output PATH``: Output JSON file
* ``--concepts-column TEXT``: Concepts column name (default: wosecopy_concepts)
* ``--graph-type [chain|dense]``: Graph type (default: chain)

export
~~~~~~

Export graphs to files.

.. code-block:: bash

   wosecopy export INPUT_FILE -o OUTPUT_DIR [OPTIONS]

**Options**:

* ``-o, --output-dir PATH``: Output directory (required)
* ``--concepts-column TEXT``: Concepts column name
* ``--graph-type [chain|dense]``: Graph type
* ``-f, --format [graphml|gexf|gml]``: Export format (default: graphml)
* ``--prefix TEXT``: Filename prefix (default: graph)

visualize
~~~~~~~~~

Visualize a concept network.

.. code-block:: bash

   wosecopy visualize INPUT_FILE -o OUTPUT [OPTIONS]

**Options**:

* ``-o, --output PATH``: Output image file (required)
* ``--concepts-column TEXT``: Concepts column name
* ``--graph-type [chain|dense]``: Graph type
* ``--index INTEGER``: Story index to visualize (default: 0)

analyze-ratings
~~~~~~~~~~~~~~~

Analyze metrics by ratings.

.. code-block:: bash

   wosecopy analyze-ratings INPUT_FILE --rating-column COLUMN [OPTIONS]

**Options**:

* ``--rating-column TEXT``: Rating column name (required)
* ``--concepts-column TEXT``: Concepts column name
* ``-o, --output PATH``: Output JSON file
* ``--graph-type [chain|dense]``: Graph type

compare
~~~~~~~

Compare metrics across raters.

.. code-block:: bash

   wosecopy compare INPUT_FILE -r RATER1 -r RATER2 ... -o OUTPUT_DIR

**Options**:

* ``-r, --rating-columns TEXT``: Rating columns (multiple, required)
* ``--concepts-column TEXT``: Concepts column name
* ``-o, --output-dir PATH``: Output directory for plots (required)

unexpectedness
~~~~~~~~~~~~~~

Calculate unexpectedness scores.

.. code-block:: bash

   wosecopy unexpectedness INPUT_FILE [OPTIONS]

**Options**:

* ``--concepts-column TEXT``: Concepts column name
* ``--prompt-column TEXT``: Prompt column name (default: prompt)
* ``-l, --language [en|de]``: Language
* ``-o, --output PATH``: Output CSV file

download-model
~~~~~~~~~~~~~~

Download spaCy language models.

.. code-block:: bash

   wosecopy download-model --language LANG [OPTIONS]

**Options**:

* ``-l, --language [en|de]``: Language (required)
* ``-s, --size [sm|md|lg]``: Model size (default: lg)