Ocdskit

------------------

Added
~~~~~

New CLI options:

- :ref:`mapping-sheet`: ``--codelist``

------------------

Added
~~~~~

- :func:`ocdskit.util.get_ocds_patch_tag`

Changed
~~~~~~~

- :ref:`compile` omits ``packages`` from a record package for OCDS 1.2+.

Fixed
~~~~~

- :ref:`compile` omits ``packages`` from a record package if empty.
- :ref:`compile` raises an error if the OCDS version is not recognized, instead of failing silently.

------------------

Fixed
~~~~~

- :ref:`mapping-sheet` correctly populates the ``extension`` column for extension fields on OCDS objects with ``items`` properties that ``$ref``'erence OCDS definitions.

------------------

Changed
~~~~~~~

- :func:`ocdskit.util.detect_format` accepts a ``reader`` keyword argument: for example, ``gzip.open`` instead of ``open``.

------------------

Changed
~~~~~~~

- ``validate``: Remove command. Instead, use `lib-cove-ocds <https://github.com/open-contracting/lib-cove-ocds>`__.
- ``tabulate``: Remove command. Instead, convert the JSON data to CSV format using `Spoonbill <https://github.com/open-contracting/spoonbill>`__ or `Flatten Tool <https://flatten-tool.readthedocs.io/en/latest/usage-ocds/>`__, and then load the CSV files into your preferred database. See:

- SQLite's `.import <https://sqlite.org/cli.html#importing_csv_files>`__ command (see also `sqlite-utils <https://sqlite-utils.datasette.io/en/stable/>`__)
- PostgreSQL's `COPY <https://www.postgresql.org/docs/current/sql-copy.html>`__ command
- MySQL's `LOAD DATA <https://dev.mysql.com/doc/refman/8.0/en/load-data.html>`__ command
- csvkit's `csvsql <https://csvkit.readthedocs.io/en/latest/scripts/csvsql.html>`__ command

- ``convert-to-oc4ids``: Remove command. Instead, use oc4idskit's `convert-from-ocds <https://oc4idskit.readthedocs.io/en/latest/cli.html>`__.
- ``ocdskit.oc4ids``: Remove module. Instead, use oc4idskit's `transforms <https://oc4idskit.readthedocs.io/en/latest/library.html>`__.

-------------------

Fixed
~~~~~

- :ref:`mapping-sheet`: Set ``deprecated`` on the extra rows for arrays.