From bd14f01e78cd48084191fad06ed1e91a8dcf291b Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Wed, 12 Apr 2023 00:51:02 +0000 Subject: automatic import of python-qualtricsapi --- .gitignore | 1 + python-qualtricsapi.spec | 424 +++++++++++++++++++++++++++++++++++++++++++++++ sources | 1 + 3 files changed, 426 insertions(+) create mode 100644 python-qualtricsapi.spec create mode 100644 sources diff --git a/.gitignore b/.gitignore index e69de29..86b9ba0 100644 --- a/.gitignore +++ b/.gitignore @@ -0,0 +1 @@ +/QualtricsAPI-0.5.8.tar.gz diff --git a/python-qualtricsapi.spec b/python-qualtricsapi.spec new file mode 100644 index 0000000..37b4973 --- /dev/null +++ b/python-qualtricsapi.spec @@ -0,0 +1,424 @@ +%global _empty_manifest_terminate_build 0 +Name: python-QualtricsAPI +Version: 0.5.8 +Release: 1 +Summary: QualtricsAPI is a lightweight Python library for the Qualtrics Web API. +License: MIT +URL: https://github.com/Jaseibert/QualtricsAPI +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/e2/6c/4b9e77922499a44528db066d36cb7adbbfd16120d6aaf53a082ad28b2681/QualtricsAPI-0.5.8.tar.gz +BuildArch: noarch + +Requires: python3-pandas +Requires: python3-numpy +Requires: python3-requests +Requires: python3-dateutil + +%description +# QualtricsAPI + +[![Build Status](https://travis-ci.com/Jaseibert/QualtricsAPI.svg?branch=master)](https://travis-ci.com/Jaseibert/QualtricsAPI) +![PyPI](https://img.shields.io/pypi/v/QualtricsAPI) +![PyPI - Downloads](https://img.shields.io/pypi/dm/QualtricsAPI) + +**Author:** [Jeremy Seibert](https://www.jeremyseibert.com)
+**License:** [MIT](https://opensource.org/licenses/MIT)
+**Package Documentation:** [Documentation](https://www.qualtricsapi-pydocs.com)
+ + +[Qualtrics](https://www.qualtrics.com) is an awesome company that builds software which gives users the ability to collect online data through online surveys. This python package, exists as a wrapper on top of the Qualtrics API. This package's primary goal is to be a super convenient way for python users to ingest, or upload their data from Qualtrics to their development environment, and vice versa. + +Before we continue, I want to mention two things: + +First, you must have Qualtrics API access in order to use this package. Contact whomever your Qualtrics Account Manager is for further clarification on your account's access credentials. + +Secondly, this package is not affiliated with Qualtrics. Thus, I the author of this package, Jeremy Seibert, is not affiliated with Qualtrics, and Qualtrics does not offer support for this package. For specific information about the Qualtrics API, you can refer to their official documentation. + +# R Users +For any R users there is an equally awesome package called ["qualtRics"](https://github.com/ropensci/qualtRics) which functions in very similar ways to this package. I have tried to keep consistent with some of the methods that are used in the qualtRics package and this one, so that there is a cohesion between the two. However, I don't believe that it supports functionality to work within the XM Contacts Data (i.e. the XMDirectory, or Mailing Lists). [CRAN]('https://cran.r-project.org/web/packages/qualtRics/index.html') + +**Authors:** [Julia Silge](https://juliasilge.com/), [Jasper Ginn](http://www.jasperginn.io)
+**License:** [MIT](https://opensource.org/licenses/MIT) + +# Basic Usage + +## Credentials Code Flow +We first create environment variables that will hold your API credentials, so you don't have to continually declare them. To do this we import the Credentials module, create and call the `qualtrics_api_credentials()`method. + +```python +from QualtricsAPI.Setup import Credentials + +#Call the qualtrics_api_credentials() method (Non-XM Directory Users) +Credentials().qualtrics_api_credentials(token='Your API Token',data_center='Your Data Center') + +#Call the qualtrics_api_credentials() method (XM Directory Users) +Credentials().qualtrics_api_credentials(token='Your API Token',data_center='Your Data Center',directory_id='Your Directory ID') + +``` +This will generate environment variables that will be used to populate the HTTP headers which are necessary to make your API calls. + +## Contact Data + +Now the generation of the necessary HTTP headers will be handled automatically, so we don't have to worry about it. We have 2 modules available to work with Contact Data. The first is `XMDirectory()`, and `MailingList()`. We import each as follows below. + +```python +from QualtricsAPI.XM import XMDirectory +from QualtricsAPI.XM import MailingList + +#Create instances of each +x = XMDirectory() +m = MailingList() +``` +Once imported, there are 10 methods that are available between both modules. + +1. XMDirectory() Class Methods + +```python +# Creates contacts in the XMDirectory +x.create_contact_in_XM() + +#Deletes a contact in the XMDirectory (use cautiously!) +x.delete_contact() + +#lists Contacts in the XMDirectory +x.list_contacts_in_directory() +``` + +2. MailingList() Class Methods + +```python +#Creates a new Mailing list for the given Qualtrics User() +m.create_list() + +#Lists the Mailing Lists for the given Qualtrics User() +m.list_lists() + +#Gets the Attributes of the defined Mailing List +m.get_list() + +#Renames the defined Mailing List +m.rename_list() + +#Deletes a defined Mailing List (use cautiously!) +m.delete_list() + +#Lists the contacts in the defined Mailing List +m.list_contacts() + +#Creates contacts in a Mailing List +m.create_contact_in_list() +``` +## Survey Module + +The `Responses()` module has two methods. Each of those methods can be called using the following methodology. + +```python +from QualtricsAPI.Survey import Responses + +#Get Survey Responses (Updated) +Responses().get_survey_responses(survey="") + +#Get Survey Questions (Updated) +Responses().get_survey_questions(survey="") +``` + +# Wrap-up + +Again this is currently under development so there may be reduced functionality, but I hope this helps fellow Qualtrics users to expedite their current workflow! + +### Want to Contribute? + +This project abides by the [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms. Feedback, bug reports (and fixes!), and feature requests are welcome! + + + + +%package -n python3-QualtricsAPI +Summary: QualtricsAPI is a lightweight Python library for the Qualtrics Web API. +Provides: python-QualtricsAPI +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-QualtricsAPI +# QualtricsAPI + +[![Build Status](https://travis-ci.com/Jaseibert/QualtricsAPI.svg?branch=master)](https://travis-ci.com/Jaseibert/QualtricsAPI) +![PyPI](https://img.shields.io/pypi/v/QualtricsAPI) +![PyPI - Downloads](https://img.shields.io/pypi/dm/QualtricsAPI) + +**Author:** [Jeremy Seibert](https://www.jeremyseibert.com)
+**License:** [MIT](https://opensource.org/licenses/MIT)
+**Package Documentation:** [Documentation](https://www.qualtricsapi-pydocs.com)
+ + +[Qualtrics](https://www.qualtrics.com) is an awesome company that builds software which gives users the ability to collect online data through online surveys. This python package, exists as a wrapper on top of the Qualtrics API. This package's primary goal is to be a super convenient way for python users to ingest, or upload their data from Qualtrics to their development environment, and vice versa. + +Before we continue, I want to mention two things: + +First, you must have Qualtrics API access in order to use this package. Contact whomever your Qualtrics Account Manager is for further clarification on your account's access credentials. + +Secondly, this package is not affiliated with Qualtrics. Thus, I the author of this package, Jeremy Seibert, is not affiliated with Qualtrics, and Qualtrics does not offer support for this package. For specific information about the Qualtrics API, you can refer to their official documentation. + +# R Users +For any R users there is an equally awesome package called ["qualtRics"](https://github.com/ropensci/qualtRics) which functions in very similar ways to this package. I have tried to keep consistent with some of the methods that are used in the qualtRics package and this one, so that there is a cohesion between the two. However, I don't believe that it supports functionality to work within the XM Contacts Data (i.e. the XMDirectory, or Mailing Lists). [CRAN]('https://cran.r-project.org/web/packages/qualtRics/index.html') + +**Authors:** [Julia Silge](https://juliasilge.com/), [Jasper Ginn](http://www.jasperginn.io)
+**License:** [MIT](https://opensource.org/licenses/MIT) + +# Basic Usage + +## Credentials Code Flow +We first create environment variables that will hold your API credentials, so you don't have to continually declare them. To do this we import the Credentials module, create and call the `qualtrics_api_credentials()`method. + +```python +from QualtricsAPI.Setup import Credentials + +#Call the qualtrics_api_credentials() method (Non-XM Directory Users) +Credentials().qualtrics_api_credentials(token='Your API Token',data_center='Your Data Center') + +#Call the qualtrics_api_credentials() method (XM Directory Users) +Credentials().qualtrics_api_credentials(token='Your API Token',data_center='Your Data Center',directory_id='Your Directory ID') + +``` +This will generate environment variables that will be used to populate the HTTP headers which are necessary to make your API calls. + +## Contact Data + +Now the generation of the necessary HTTP headers will be handled automatically, so we don't have to worry about it. We have 2 modules available to work with Contact Data. The first is `XMDirectory()`, and `MailingList()`. We import each as follows below. + +```python +from QualtricsAPI.XM import XMDirectory +from QualtricsAPI.XM import MailingList + +#Create instances of each +x = XMDirectory() +m = MailingList() +``` +Once imported, there are 10 methods that are available between both modules. + +1. XMDirectory() Class Methods + +```python +# Creates contacts in the XMDirectory +x.create_contact_in_XM() + +#Deletes a contact in the XMDirectory (use cautiously!) +x.delete_contact() + +#lists Contacts in the XMDirectory +x.list_contacts_in_directory() +``` + +2. MailingList() Class Methods + +```python +#Creates a new Mailing list for the given Qualtrics User() +m.create_list() + +#Lists the Mailing Lists for the given Qualtrics User() +m.list_lists() + +#Gets the Attributes of the defined Mailing List +m.get_list() + +#Renames the defined Mailing List +m.rename_list() + +#Deletes a defined Mailing List (use cautiously!) +m.delete_list() + +#Lists the contacts in the defined Mailing List +m.list_contacts() + +#Creates contacts in a Mailing List +m.create_contact_in_list() +``` +## Survey Module + +The `Responses()` module has two methods. Each of those methods can be called using the following methodology. + +```python +from QualtricsAPI.Survey import Responses + +#Get Survey Responses (Updated) +Responses().get_survey_responses(survey="") + +#Get Survey Questions (Updated) +Responses().get_survey_questions(survey="") +``` + +# Wrap-up + +Again this is currently under development so there may be reduced functionality, but I hope this helps fellow Qualtrics users to expedite their current workflow! + +### Want to Contribute? + +This project abides by the [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms. Feedback, bug reports (and fixes!), and feature requests are welcome! + + + + +%package help +Summary: Development documents and examples for QualtricsAPI +Provides: python3-QualtricsAPI-doc +%description help +# QualtricsAPI + +[![Build Status](https://travis-ci.com/Jaseibert/QualtricsAPI.svg?branch=master)](https://travis-ci.com/Jaseibert/QualtricsAPI) +![PyPI](https://img.shields.io/pypi/v/QualtricsAPI) +![PyPI - Downloads](https://img.shields.io/pypi/dm/QualtricsAPI) + +**Author:** [Jeremy Seibert](https://www.jeremyseibert.com)
+**License:** [MIT](https://opensource.org/licenses/MIT)
+**Package Documentation:** [Documentation](https://www.qualtricsapi-pydocs.com)
+ + +[Qualtrics](https://www.qualtrics.com) is an awesome company that builds software which gives users the ability to collect online data through online surveys. This python package, exists as a wrapper on top of the Qualtrics API. This package's primary goal is to be a super convenient way for python users to ingest, or upload their data from Qualtrics to their development environment, and vice versa. + +Before we continue, I want to mention two things: + +First, you must have Qualtrics API access in order to use this package. Contact whomever your Qualtrics Account Manager is for further clarification on your account's access credentials. + +Secondly, this package is not affiliated with Qualtrics. Thus, I the author of this package, Jeremy Seibert, is not affiliated with Qualtrics, and Qualtrics does not offer support for this package. For specific information about the Qualtrics API, you can refer to their official documentation. + +# R Users +For any R users there is an equally awesome package called ["qualtRics"](https://github.com/ropensci/qualtRics) which functions in very similar ways to this package. I have tried to keep consistent with some of the methods that are used in the qualtRics package and this one, so that there is a cohesion between the two. However, I don't believe that it supports functionality to work within the XM Contacts Data (i.e. the XMDirectory, or Mailing Lists). [CRAN]('https://cran.r-project.org/web/packages/qualtRics/index.html') + +**Authors:** [Julia Silge](https://juliasilge.com/), [Jasper Ginn](http://www.jasperginn.io)
+**License:** [MIT](https://opensource.org/licenses/MIT) + +# Basic Usage + +## Credentials Code Flow +We first create environment variables that will hold your API credentials, so you don't have to continually declare them. To do this we import the Credentials module, create and call the `qualtrics_api_credentials()`method. + +```python +from QualtricsAPI.Setup import Credentials + +#Call the qualtrics_api_credentials() method (Non-XM Directory Users) +Credentials().qualtrics_api_credentials(token='Your API Token',data_center='Your Data Center') + +#Call the qualtrics_api_credentials() method (XM Directory Users) +Credentials().qualtrics_api_credentials(token='Your API Token',data_center='Your Data Center',directory_id='Your Directory ID') + +``` +This will generate environment variables that will be used to populate the HTTP headers which are necessary to make your API calls. + +## Contact Data + +Now the generation of the necessary HTTP headers will be handled automatically, so we don't have to worry about it. We have 2 modules available to work with Contact Data. The first is `XMDirectory()`, and `MailingList()`. We import each as follows below. + +```python +from QualtricsAPI.XM import XMDirectory +from QualtricsAPI.XM import MailingList + +#Create instances of each +x = XMDirectory() +m = MailingList() +``` +Once imported, there are 10 methods that are available between both modules. + +1. XMDirectory() Class Methods + +```python +# Creates contacts in the XMDirectory +x.create_contact_in_XM() + +#Deletes a contact in the XMDirectory (use cautiously!) +x.delete_contact() + +#lists Contacts in the XMDirectory +x.list_contacts_in_directory() +``` + +2. MailingList() Class Methods + +```python +#Creates a new Mailing list for the given Qualtrics User() +m.create_list() + +#Lists the Mailing Lists for the given Qualtrics User() +m.list_lists() + +#Gets the Attributes of the defined Mailing List +m.get_list() + +#Renames the defined Mailing List +m.rename_list() + +#Deletes a defined Mailing List (use cautiously!) +m.delete_list() + +#Lists the contacts in the defined Mailing List +m.list_contacts() + +#Creates contacts in a Mailing List +m.create_contact_in_list() +``` +## Survey Module + +The `Responses()` module has two methods. Each of those methods can be called using the following methodology. + +```python +from QualtricsAPI.Survey import Responses + +#Get Survey Responses (Updated) +Responses().get_survey_responses(survey="") + +#Get Survey Questions (Updated) +Responses().get_survey_questions(survey="") +``` + +# Wrap-up + +Again this is currently under development so there may be reduced functionality, but I hope this helps fellow Qualtrics users to expedite their current workflow! + +### Want to Contribute? + +This project abides by the [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms. Feedback, bug reports (and fixes!), and feature requests are welcome! + + + + +%prep +%autosetup -n QualtricsAPI-0.5.8 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-QualtricsAPI -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed Apr 12 2023 Python_Bot - 0.5.8-1 +- Package Spec generated diff --git a/sources b/sources new file mode 100644 index 0000000..4ee7f61 --- /dev/null +++ b/sources @@ -0,0 +1 @@ +6de605dbdc6339c587fdaee5e375df9e QualtricsAPI-0.5.8.tar.gz -- cgit v1.2.3