Metadata-Version: 2.4
Name: cdcs
Version: 0.2.7
Summary: Python API client for performing REST calls to configurable data curation system (CDCS) databases
Keywords: CDCS,database,rest API,configurable data curation system
Author: Lucas Hale
Author-email: Lucas Hale <lucas.hale@nist.gov>
License-Expression: NIST-Software
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Text Processing :: Markup :: XML
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Dist: requests
Requires-Dist: pandas
Requires-Dist: tqdm
Requires-Dist: ipython
Requires-Python: >=3.7
Project-URL: Homepage, https://github.com/usnistgov/pycdcs/
Project-URL: Documentation, https://github.com/usnistgov/pycdcs
Project-URL: Repository, https://github.com/usnistgov/pycdcs.git
Project-URL: Changelog, https://github.com/usnistgov/pycdcs/blob/master/updates.md
Description-Content-Type: text/markdown

# Python CDCS REST API client

This is a base Python package for accessing instances of the NIST Configurable Data Curation System (CDCS) databases, versions 2.X.X and 3.X.X.  It defines a Python CDCS class that streamlines REST calls to a database by

- Taking access settings once (username, password, etc) and saving them for subsequent REST calls.
- Defining methods that wrap around REST calls to interact with the database in a more Pythonic way.
- Automatically converting any accessed information to pandas Series and DataFrame objects to allow for the information to be easily manipulated.

## Installation

The package can be installed using pip:

    pip install cdcs

or conda:

    conda install -c conda-forge cdcs

Alternatively, the source code can be downloaded from github at

- Stable releases: [https://github.com/usnistgov/pycdcs](https://github.com/usnistgov/pycdcs)
- In development: [https://github.com/lmhale99/pycdcs](https://github.com/lmhale99/pycdcs)

## Documentation

Documentation for the package is given as Jupyter Notebooks that can be found on the github site.  Each Notebook is focused on providing details and examples related to different use cases for the package.

- **CDCS Public Data Exploration** outlines the basic functions allowing an anonymous user (i.e. not logged in) to explore the available public data on a curator.
- **CDCS Data Management** outlines the basic pre-defined functions allowing a logged-in user to manage their own templates, data records and blobs.
- **CDCS Rest Builder** provides a simple explanation of how users can easily build their own functions and make their own REST API calls should they wish to interact with the database in ways outside the pre-defined functions.
