File: migrating.rst

package info (click to toggle)
python-chemspipy 2.0.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 288 kB
  • sloc: python: 1,125; makefile: 14
file content (68 lines) | stat: -rw-r--r-- 2,580 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
.. _migrating:

Migration Guide
===============

Upgrading to version 2.x
------------------------

The RSC released an entirely new REST API in 2018, necessitating a number of changes to ChemSpiPy. Where possible,
backwards compatibility has been maintained, but many methods are deprecated and some have been removed entirely.

ChemSpider Object
~~~~~~~~~~~~~~~~~

- Instantiate the :class:`~chemspipy.api.ChemSpider` with a required ``api_key`` parameter instead of the optional
  ``security_token`` parameter.

- Deprecated methods:

    - ``get_databases`` → :meth:`~chemspipy.api.ChemSpider.get_datasources`
    - ``get_extended_compound_info`` → :meth:`~chemspipy.api.ChemSpider.get_details`
    - ``get_extended_compound_info_list`` → :meth:`~chemspipy.api.ChemSpider.get_details_batch`
    - ``get_extended_mol_compound_info_list`` → :meth:`~chemspipy.api.ChemSpider.get_details_batch`
    - ``get_record_mol`` → :meth:`~chemspipy.api.ChemSpider.get_mol`
    - ``async_simple_search`` → :meth:`~chemspipy.api.ChemSpider.filter_name`
    - ``async_simple_search_ordered`` → :meth:`~chemspipy.api.ChemSpider.filter_name`
    - ``get_async_search_status`` → :meth:`~chemspipy.api.ChemSpider.filter_status`
    - ``get_async_search_status_and_count`` → :meth:`~chemspipy.api.ChemSpider.filter_status`
    - ``get_async_search_result`` → :meth:`~chemspipy.api.ChemSpider.filter_results`
    - ``get_async_search_result_part`` → :meth:`~chemspipy.api.ChemSpider.filter_results`
    - ``get_compound_info`` → :meth:`~chemspipy.api.ChemSpider.get_details`
    - ``get_compound_thumbnail`` → :meth:`~chemspipy.api.ChemSpider.get_image`
    - ``simple_search`` → :meth:`~chemspipy.api.ChemSpider.search`

- Removed methods:

    - ``get_original_mol``
    - ``get_all_spectra_info``
    - ``get_spectrum_info``
    - ``get_compound_spectra_info``
    - ``get_spectra_info_list``

Compound Object
~~~~~~~~~~~~~~~

- Non-standard InChI and InChIKey are no longer available. All are now 'standard'. Deprecated properties:

    - ``stdinchi`` → :attr:`~chemspipy.objects.Compound.inchi`
    - ``stdinchikey`` → :attr:`~chemspipy.objects.Compound.inchikey`

- Removed properties:

    - ``xlogp``
    - ``alogp``
    - ``mol_3d``
    - ``mol_raw``

Spectrum Object
~~~~~~~~~~~~~~~

- ``Spectrum`` object has been removed entirely.

:mod:`~chemspipy.api` Module
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Removed ``DIMENSIONS`` mapping.
- Replaced :attr:`~chemspipy.api.FIELDS` mapping with a list of available properties fields.
- Removed ``xml_to_dict`` function.