####################################################
SPSS Converter
####################################################
**Simple format converter utility for SPSS data files**
.. list-table::
:widths: 10 90
:header-rows: 1
* - Branch
- Unit Tests
* - `latest <https://github.com/insightindustry/spss-converter/tree/master>`_
-
.. image:: https://travis-ci.com/insightindustry/spss-converter.svg?branch=master
:target: https://travis-ci.com/insightindustry/spss-converter
:alt: Build Status (Travis CI)
.. image:: https://codecov.io/gh/insightindustry/spss-converter/branch/master/graph/badge.svg
:target: https://codecov.io/gh/insightindustry/spss-converter
:alt: Code Coverage Status (Codecov)
.. image:: https://readthedocs.org/projects/spss-converter/badge/?version=latest
:target: http://spss-converter.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status (ReadTheDocs)
* - `v.0.2 <https://github.com/insightindustry/spss-converter/tree/v.0.2.0>`_
-
.. image:: https://travis-ci.com/insightindustry/spss-converter.svg?branch=v.0.2.0
:target: https://travis-ci.com/insightindustry/spss-converter
:alt: Build Status (Travis CI)
.. image:: https://codecov.io/gh/insightindustry/spss-converter/branch/v.0.2.0/graph/badge.svg
:target: https://codecov.io/gh/insightindustry/spss-converter
:alt: Code Coverage Status (Codecov)
.. image:: https://readthedocs.org/projects/spss-converter/badge/?version=v.0.2.0
:target: http://spss-converter.readthedocs.io/en/latest/?badge=v.0.2.0
:alt: Documentation Status (ReadTheDocs)
* - `v.0.1 <https://github.com/insightindustry/spss-converter/tree/v.0.1.0>`_
-
.. image:: https://travis-ci.com/insightindustry/spss-converter.svg?branch=v.0.1.0
:target: https://travis-ci.com/insightindustry/spss-converter
:alt: Build Status (Travis CI)
.. image:: https://codecov.io/gh/insightindustry/spss-converter/branch/v.0.1.0/graph/badge.svg
:target: https://codecov.io/gh/insightindustry/spss-converter
:alt: Code Coverage Status (Codecov)
.. image:: https://readthedocs.org/projects/spss-converter/badge/?version=v.0.1.0
:target: http://spss-converter.readthedocs.io/en/latest/?badge=v.0.1.0
:alt: Documentation Status (ReadTheDocs)
The **SPSS Converter** is a simple utility that facilitates the easy conversion of SPSS
data to / from a variety of formats, including:
* CSV
* JSON
* YAML
* Excel
* Pandas ``DataFrame``
**COMPLETE DOCUMENTATION:** http://spss-converter.readthedocs.org/en/latest/index.html
.. contents::
:depth: 3
:backlinks: entry
-----------------
***************
Installation
***************
To install the **SPSS Converter** via Pip just execute:
.. code:: bash
$ pip install spss-converter
Dependencies
==============
.. list-table::
:widths: 100
:header-rows: 1
* - Python 3.x
* - | * `Pandas v0.24 <https://pandas.pydata.org/docs/>`_ or higher
| * `Pyreadstat v1.0 <https://github.com/Roche/pyreadstat>`_ or higher
| * `OpenPyXL v.3.0.7 <https://openpyxl.readthedocs.io/en/stable/>`_ or higher
| * `PyYAML v3.10 <https://github.com/yaml/pyyaml>`_ or higher
| * `simplejson v3.0 <https://simplejson.readthedocs.io/en/latest/>`_ or higher
| * `Validator-Collection v1.5.0 <https://github.com/insightindustry/validator-collection>`_ or higher
-------------
************************************
Why the SPSS Converter?
************************************
If you work with SPSS data in the Python ecosystem, you probably use a combination of
two or three key libraries: `Pandas <https://pandas.pydata.org>`_,
`Pyreadstat <https://github.com/Roche/pyreadstat>`_, and
`savReaderWriter <https://pythonhosted.org/savReaderWriter/>`_. All three libraries are
vital tools, incredibly well-constructed, designed, and managed. But over the years, I
have found that converting from SPSS to other file formats using these libraries requires
some fairly repetitive boilerplate code. So why not make it easier?
The **SPSS Converter** library is a simple wrapper around the
`Pyreadstat <https://github.com/Roche/pyreadstat>`_ and
`Pandas <https://pandas.pydata.org>`_ libraries that provides a clean and simple API for
reading data files in a variety of formats and converting them to a variety of formats.
The semantics are super simple, and should be as simple as: ``spss_converter.to_csv('my-spss-file.sav')``
or ``spss_converter.from_json('my-json-file.json')``.
Key **SPSS Converter** Features
====================================
* With one function call, convert an SPSS file into:
* a `Pandas <https://pandas.pydata.org>`_ ``DataFrame``
* CSV
* JSON
* YAML
* Excel
* a ``dict``
* With one function call, create an SPSS data file from data in:
* a `Pandas <https://pandas.pydata.org>`_ ``DataFrame``
* CSV
* JSON
* YAML
* Excel
* a ``dict``
* With one function call, generate a Pythonic data map or meta-data collection from your
SPSS data file.
* Decide which variables (columns) you want to include / exclude when doing your
conversion.
**SPSS Converter** vs Alternatives
=========================================
For a comparison of the **SPSS Converter** to various alternative
conversion approaches, please see full documentation:
https://spss-converter.readthedocs.io/en/latest/index.html#spss-converter-vs-alternatives
***********************************
Complete Documentation
***********************************
The **SPSS Converter** is a simple library, but its functions are comprehensively
documented at:
https://spss-converter.readthedocs.org/en/latest/index.html
--------------
*********************
Questions and Issues
*********************
You can ask questions and report issues on the project's
`Github Issues Page <https://github.com/insightindustry/spss-converter/issues>`_
-----------------
*********************
Contributing
*********************
We welcome contributions and pull requests! For more information, please see the
`Contributor Guide <http://spss-converter.readthedocs.org/en/latest/contributing.html>`_
-------------------
*********************
Testing
*********************
We use `TravisCI <http://travisci.org>`_ for our build automation,
`Codecov.io <http://codecov.io>`_ for our test coverage, and
`ReadTheDocs <https://readthedocs.org>`_ for our documentation.
Detailed information about our test suite and how to run tests locally can be
found in our
`Testing Reference <http://spss-converter.readthedocs.org/en/latest/testing.html>`_.
--------------------
**********************
License
**********************
The **SPSS Converter** is made available under an
`MIT License <http://spss-converter.readthedocs.org/en/latest/license.html>`_.
Raw data
{
"_id": null,
"home_page": "https://spss-converter.readthedocs.io/en/latest",
"name": "spss-converter",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7, <4",
"maintainer_email": "",
"keywords": "spss data conversion serialization CSV JSON YAML dict dataframe pandas deserialization",
"author": "Insight Industry Inc.",
"author_email": "software@insightindustry.com",
"download_url": "https://files.pythonhosted.org/packages/f9/a4/af793a3d69cbf7746b355670decb9f60a013c776200e9010320bc1ef36ad/spss-converter-0.2.0.tar.gz",
"platform": null,
"description": "####################################################\nSPSS Converter\n####################################################\n\n**Simple format converter utility for SPSS data files**\n\n.. list-table::\n :widths: 10 90\n :header-rows: 1\n\n * - Branch\n - Unit Tests\n * - `latest <https://github.com/insightindustry/spss-converter/tree/master>`_\n -\n .. image:: https://travis-ci.com/insightindustry/spss-converter.svg?branch=master\n :target: https://travis-ci.com/insightindustry/spss-converter\n :alt: Build Status (Travis CI)\n\n .. image:: https://codecov.io/gh/insightindustry/spss-converter/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/insightindustry/spss-converter\n :alt: Code Coverage Status (Codecov)\n\n .. image:: https://readthedocs.org/projects/spss-converter/badge/?version=latest\n :target: http://spss-converter.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status (ReadTheDocs)\n\n * - `v.0.2 <https://github.com/insightindustry/spss-converter/tree/v.0.2.0>`_\n -\n .. image:: https://travis-ci.com/insightindustry/spss-converter.svg?branch=v.0.2.0\n :target: https://travis-ci.com/insightindustry/spss-converter\n :alt: Build Status (Travis CI)\n\n .. image:: https://codecov.io/gh/insightindustry/spss-converter/branch/v.0.2.0/graph/badge.svg\n :target: https://codecov.io/gh/insightindustry/spss-converter\n :alt: Code Coverage Status (Codecov)\n\n .. image:: https://readthedocs.org/projects/spss-converter/badge/?version=v.0.2.0\n :target: http://spss-converter.readthedocs.io/en/latest/?badge=v.0.2.0\n :alt: Documentation Status (ReadTheDocs)\n\n * - `v.0.1 <https://github.com/insightindustry/spss-converter/tree/v.0.1.0>`_\n -\n .. image:: https://travis-ci.com/insightindustry/spss-converter.svg?branch=v.0.1.0\n :target: https://travis-ci.com/insightindustry/spss-converter\n :alt: Build Status (Travis CI)\n\n .. image:: https://codecov.io/gh/insightindustry/spss-converter/branch/v.0.1.0/graph/badge.svg\n :target: https://codecov.io/gh/insightindustry/spss-converter\n :alt: Code Coverage Status (Codecov)\n\n .. image:: https://readthedocs.org/projects/spss-converter/badge/?version=v.0.1.0\n :target: http://spss-converter.readthedocs.io/en/latest/?badge=v.0.1.0\n :alt: Documentation Status (ReadTheDocs)\n\nThe **SPSS Converter** is a simple utility that facilitates the easy conversion of SPSS\ndata to / from a variety of formats, including:\n\n * CSV\n * JSON\n * YAML\n * Excel\n * Pandas ``DataFrame``\n\n**COMPLETE DOCUMENTATION:** http://spss-converter.readthedocs.org/en/latest/index.html\n\n.. contents::\n :depth: 3\n :backlinks: entry\n\n-----------------\n\n***************\nInstallation\n***************\n\nTo install the **SPSS Converter** via Pip just execute:\n\n.. code:: bash\n\n $ pip install spss-converter\n\nDependencies\n==============\n\n.. list-table::\n :widths: 100\n :header-rows: 1\n\n * - Python 3.x\n * - | * `Pandas v0.24 <https://pandas.pydata.org/docs/>`_ or higher\n | * `Pyreadstat v1.0 <https://github.com/Roche/pyreadstat>`_ or higher\n | * `OpenPyXL v.3.0.7 <https://openpyxl.readthedocs.io/en/stable/>`_ or higher\n | * `PyYAML v3.10 <https://github.com/yaml/pyyaml>`_ or higher\n | * `simplejson v3.0 <https://simplejson.readthedocs.io/en/latest/>`_ or higher\n | * `Validator-Collection v1.5.0 <https://github.com/insightindustry/validator-collection>`_ or higher\n\n-------------\n\n************************************\nWhy the SPSS Converter?\n************************************\n\nIf you work with SPSS data in the Python ecosystem, you probably use a combination of\ntwo or three key libraries: `Pandas <https://pandas.pydata.org>`_,\n`Pyreadstat <https://github.com/Roche/pyreadstat>`_, and\n`savReaderWriter <https://pythonhosted.org/savReaderWriter/>`_. All three libraries are\nvital tools, incredibly well-constructed, designed, and managed. But over the years, I\nhave found that converting from SPSS to other file formats using these libraries requires\nsome fairly repetitive boilerplate code. So why not make it easier?\n\nThe **SPSS Converter** library is a simple wrapper around the\n`Pyreadstat <https://github.com/Roche/pyreadstat>`_ and\n`Pandas <https://pandas.pydata.org>`_ libraries that provides a clean and simple API for\nreading data files in a variety of formats and converting them to a variety of formats.\nThe semantics are super simple, and should be as simple as: ``spss_converter.to_csv('my-spss-file.sav')``\nor ``spss_converter.from_json('my-json-file.json')``.\n\nKey **SPSS Converter** Features\n====================================\n\n* With one function call, convert an SPSS file into:\n\n * a `Pandas <https://pandas.pydata.org>`_ ``DataFrame``\n * CSV\n * JSON\n * YAML\n * Excel\n * a ``dict``\n\n* With one function call, create an SPSS data file from data in:\n\n * a `Pandas <https://pandas.pydata.org>`_ ``DataFrame``\n * CSV\n * JSON\n * YAML\n * Excel\n * a ``dict``\n\n* With one function call, generate a Pythonic data map or meta-data collection from your\n SPSS data file.\n* Decide which variables (columns) you want to include / exclude when doing your\n conversion.\n\n**SPSS Converter** vs Alternatives\n=========================================\n\nFor a comparison of the **SPSS Converter** to various alternative\nconversion approaches, please see full documentation:\nhttps://spss-converter.readthedocs.io/en/latest/index.html#spss-converter-vs-alternatives\n\n***********************************\nComplete Documentation\n***********************************\n\nThe **SPSS Converter** is a simple library, but its functions are comprehensively\ndocumented at:\n\n https://spss-converter.readthedocs.org/en/latest/index.html\n\n--------------\n\n*********************\nQuestions and Issues\n*********************\n\nYou can ask questions and report issues on the project's\n`Github Issues Page <https://github.com/insightindustry/spss-converter/issues>`_\n\n-----------------\n\n*********************\nContributing\n*********************\n\nWe welcome contributions and pull requests! For more information, please see the\n`Contributor Guide <http://spss-converter.readthedocs.org/en/latest/contributing.html>`_\n\n-------------------\n\n*********************\nTesting\n*********************\n\nWe use `TravisCI <http://travisci.org>`_ for our build automation,\n`Codecov.io <http://codecov.io>`_ for our test coverage, and\n`ReadTheDocs <https://readthedocs.org>`_ for our documentation.\n\nDetailed information about our test suite and how to run tests locally can be\nfound in our\n`Testing Reference <http://spss-converter.readthedocs.org/en/latest/testing.html>`_.\n\n--------------------\n\n**********************\nLicense\n**********************\n\nThe **SPSS Converter** is made available under an\n`MIT License <http://spss-converter.readthedocs.org/en/latest/license.html>`_.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Simple format converter utility for SPSS data files",
"version": "0.2.0",
"split_keywords": [
"spss",
"data",
"conversion",
"serialization",
"csv",
"json",
"yaml",
"dict",
"dataframe",
"pandas",
"deserialization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "63d8a2e9d8a7d73e68d1692e24b182d5baab0e5509eb080f2c5b20680d24007e",
"md5": "f647407caab6a6cf7c680f573d4aa775",
"sha256": "688bdc7934a6670f54ec90bd733b4c5a414c6d43f06d35d306ba55bf01d15069"
},
"downloads": -1,
"filename": "spss_converter-0.2.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "f647407caab6a6cf7c680f573d4aa775",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7, <4",
"size": 17012,
"upload_time": "2023-01-05T18:32:08",
"upload_time_iso_8601": "2023-01-05T18:32:08.746241Z",
"url": "https://files.pythonhosted.org/packages/63/d8/a2e9d8a7d73e68d1692e24b182d5baab0e5509eb080f2c5b20680d24007e/spss_converter-0.2.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f9a4af793a3d69cbf7746b355670decb9f60a013c776200e9010320bc1ef36ad",
"md5": "b84df1149921ab6b7ef23e1a65c72ce1",
"sha256": "8495a070f942e0906182d4594764c838041becb7883c16078ba3657263a106e3"
},
"downloads": -1,
"filename": "spss-converter-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "b84df1149921ab6b7ef23e1a65c72ce1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7, <4",
"size": 19939,
"upload_time": "2023-01-05T18:32:10",
"upload_time_iso_8601": "2023-01-05T18:32:10.287769Z",
"url": "https://files.pythonhosted.org/packages/f9/a4/af793a3d69cbf7746b355670decb9f60a013c776200e9010320bc1ef36ad/spss-converter-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-05 18:32:10",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "spss-converter"
}
JSON