# One Codex API - Python Client Library and CLI
[](https://github.com/onecodex/onecodex/actions/workflows/test.yml)
[](https://github.com/onecodex/onecodex/actions/workflows/pre-commit.yml)
Command line interface (CLI) and Python client library for interacting with the One Codex v1 API ([API docs](https://docs.onecodex.com)).
MAINTAINERS: [@clausmith](https://github.com/clausmith), [@boydgreenfield](https://github.com/boydgreenfield)
# Installation
This package provides 3 major pieces of functionality: (1) a core Python client library; (2) a simple CLI for interacting with the One Codex platform that uses that core library; and (3) optional extensions to the client library, which offers many features aimed at advanced users and provides functionality for use in interactive notebook environments (e.g., IPython notebooks).
Python 3.9 or later is required. **Python 2 is no longer supported.**
### _Basic installation_
The CLI (and core Python library) may be simply installed using `pip`. To download a minimal installation (#1 and #2), simply run:
```shell
pip install onecodex
```
### _Installation with optional extensions_
To also download the optional extensions to the client library, and all of their dependencies, run:
```shell
pip install 'onecodex[all]'
```
# Using the CLI
## Logging in
The CLI supports authentication using either your One Codex API key or your One Codex username and password.
To log in using your username and password:
```shell
onecodex login
```
This command will save a credentials file at `~/.onecodex`, which will then automatically be used for authentication the next time the CLI or Python client library are used (OS X/Linux only). You can clear this file and remove your API key from your machine with `onecodex logout`.
In a shared environment, we recommend directly using your One Codex API key, rather than logging in and storing it in a credentials file. To use API key authentication, simply pass your key as an argument to the `onecodex` command:
```shell
onecodex --api-key=YOUR_API_KEY samples
```
Your API key can be found on the [One Codex settings page](https://app.onecodex.com/settings) and should be 32 character string. You may also generate a new API key on the settings page in the web application. _Note_: Because your API key provides access to all of the samples and metadata in your account, you should immediately reset your key on the website if it is ever accidentally revealed or saved (e.g., checked into a GitHub repository).
## Uploading files
The CLI supports uploading FASTA or FASTQ files (optionally gzip compressed) via the `upload` command.
```shell
onecodex upload bacterial_reads_file.fq.gz
```
Multiple files can be uploaded in a single command as well:
```shell
onecodex upload file1.fq.gz file2.fq.gz ...
```
You can also upload files using the Python client library:
```python
uploaded_sample1 = ocx.Samples.upload("/path/to/file.fastq")
# Or upload a tuple of paired end files
uploaded_sample2 = ocx.Samples.upload(("/path/to/R1.fastq", "/path/to/R2.fastq"))
```
Which returns a `Samples` resource (as of `0.5.0`). Samples can be associated with tags, metadata, and projects at upload timing using those respective keyword arguments:
```python
# Note format must match the schema defined for our API, with arbitrary
# metadata allowed as a single-level dictionary in the `custom` field.
# See https://developer.onecodex.com/reference#the-metadata-resource for details.
metadata = {
"platform": "Illumina NovaSeq 6000",
"date_collected": "2019-04-14T00:51:54.832048+00:00",
"external_sample_id": "my-lims-ID-or-similar",
"custom": {
"my-string-field": "A most interesting sample...",
"my-boolean-field": True,
"my-number-field-1": 1,
"my-number-field-2": 2.0,
}
}
```
Uploads can be made in parallel using Python threads (or multiple processes), e.g.:
```python
import concurrent.futures
uploaded_samples = []
with concurrent.futures.ThreadPoolExecutor(max_workers=4) as executor:
futures = {executor.submit(ocx.Samples.upload, file) for file in LIST_OF_FILES}
for future in concurrent.futures.as_completed(futures):
try:
uploaded_samples.append(future.result())
except Exception as e:
print("An execption occurred during your upload: {}".format(e))
```
## Resources
The CLI supports retrieving your One Codex samples and analyses. The following resources may be queried:
* Your samples (`Samples`)
* Sample metadata (`Metadata`)
* `Analyses`, which include several subtypes with additional functionality and fields:
* `Classifications`, which are basic metagenomic classification results for your samples
* `Panels`, which are _in silico_ panels for particular genes or other functional markers ([example on One Codex](https://app.onecodex.com/panel/sample))
* `Jobs`, which provide information on the name, version, and type of analysis which was performed for a given `Analyses`
Simply invoke the `onecodex` command, using one of the above resource names as a subcommand (all lowercase). For example:
```shell
# fetch all your samples
onecodex samples
# fetch a list of panels based on their ids
onecodex panels 0123456789abcdef 0987654321fdecba
```
# Using the Python client library
## Initialization
To load the API, use the following import:
```python
from onecodex.api import Api
```
Instantiate an API client either by passing your API key or automatically fetching your credentials from `~/.onecodex` if you've previously called `onecodex login`.
```python
from onecodex.api import Api
# Instantiate a One Codex API object, will attempt to get credentials from ~/.onecodex
ocx = Api()
# Instantiate an API object, manually specifying an API key
ocx = Api(api_key="YOUR_API_KEY_HERE")
```
## Resources
Resources are exposed as attributes on the API object. You can fetch a resource directly by its ID or you can fetch it using the query interface. Currently you can access resources using either `get()` or `where()`. If you need help finding the ID for a sample, its identifier is part of its url on our webpage: e.g. for an analysis at `https://app.onecodex.com/analysis/public/1d9491c5c31345b6`, the ID is `1d9491c5c31345b6`. IDs are all short unique identifiers, consisting of 16 hexadecimal characters (`0-9a-f`).
```python
sample_analysis = ocx.Classifications.get("1d9491c5c31345b6") # Fetch an individual classification
sample_analysis.results() # Returns classification results as JSON object
sample_analysis.table() # Returns a pandas dataframe
```
In addition to methods on individual instances of a given resource (e.g., a `Sample` or an `Analysis`), the library also provides methods for aggregating sets of samples or analyses:
```python
all_completed_analyses = ocx.Classifications.where(complete=True)
all_completed_analyses.to_otu() # Returns classification results as JSON object
all_completed_analyses.to_df() # Returns a pandas dataframe
```
# Development
## Environment Setup
Before developing, `git` and `python` version >=3.9 are needed. We recommend using [pyenv](https://github.com/yyuu/pyenv) for Python version management.
To download the client library from GitHub:
```shell
git clone https://github.com/onecodex/onecodex.git
cd onecodex/
```
To set up the project, first create a virtual environment and then install dependencies:
```shell
# If you are on a M1 Macbook, run the line below, adjusting the version as needed
export HDF5_DIR=/opt/homebrew/Cellar/hdf5/1.12.1_1/
virtualenv venv
source venv/bin/activate
pip install -e '.[all,testing,reports]' # -e specifies development mode so that the package doesn't have to be reinstalled after code edits
```
Test are run via the Makefile. Note this may take awhile at first because of installing dependencies:
```shell
make lint
make test
```
We use [`pre-commit`](https://pre-commit.com) for automated linting using [`black`](https://github.com/ambv/black), `flake8`, and various whitespace and newline formatters during development.
## Writing Unit Tests
We use [pytest](https://docs.pytest.org/) as our unit testing framework. Tests should be able to run without an internet connection, and One Codex API calls must be mocked. We use [responses](https://github.com/getsentry/responses) to mock API responses.
> **Tip:** Any API calls that do not have a matching mock will raise an error. You can figure out which API calls need to be mocked by writing a test, running it, and inspecting the error message to see which route(s) are missing.
> **Warning:** Mocked URLs *without* a query string will ignore query strings in any matching requests. If the mocked URL *includes* a query string, it will be used when matching requests.
### Fixtures
These pytest fixtures may be helpful when writing unit tests:
- `ocx`: this is a mocked `Api` object that uses the `api/v1` One Codex API schema.
- `ocx_experimental`: this is a mocked `Api` object that uses the `api/v1_experimental` One Codex API schema. Use this to test experimental features.
- `api_data`: this mocks some API data for `v1` and `v1_experimental` APIs.
### Mocking API Data
API data, including schemas, are stored in `tests/data/api/`:
```
tests/data/api
├── v1 # the API version
│ ├── ...
│ ├── analyses
│ │ └── index.json # payload for accessing GET::api/v1/analyses. Will also be used to mock each resource instance, e.g. GET::api/v1/analyses/<uuid>
│ ├── classifications
│ │ ├── 0f4ee4ecb3a3412f
│ │ │ └── results
│ │ │ └── index.json # payload for accessing GET::api/v1/classifications/0f4ee4ecb3a3412f/results
│ │ └── index.json # payload for accessing GET::api/v1/classifications. Instance routes are also auto-mocked
│ ├── ...
│ ├── schema
│ │ ├── index.json # payload for accessing GET::api/v1/schema
│ │ └── index_all.json # payload for accessing GET::api/v1/schema?expand=all
│ └── ...
└── v1_experimental
└── ...
```
The directory structure mirrors the One Codex API. For example:
- The payload for API route `api/v1/classifications` is stored at `tests/data/api/v1/classifications/index.json`.
- API route `api/v1/classifications/0f4ee4ecb3a3412f/results` has its payload stored at `tests/data/api/v1/classifications/0f4ee4ecb3a3412f/results/index.json`.
- For the `v1_experimental` API, store things under `api/v1_experimental/`.
This idea can be extended to arbitrary nesting/depths within the API.
> **Note:** If the payload is large, you can gzip it and name it `index.json.gz`.
A resource's instance list payload (e.g. `api/v1/analyses` gives you a list of analyses) is used to auto-mock each resource instance (e.g. `api/v1/analyses/<uuid>`). You don't need to create an `index.json` for each instance.
### Mocking API Schemas
API schemas work similarly to regular API data, but with a couple of special rules:
- Each API schema directory *must* have `index.json` and `index_all.json`. `index.json` contains the payload for e.g. `api/v1/schema`, and `index_all.json` contains the payload for e.g. `api/v1/schema?expand=all`.
- If the schema requires it, you can optionally define resource-specific schemas by including `<resource-name>.json` in the `schema` directory (e.g. `assemblies.json` for `api/v1_experimental/assemblies/schema`).
### conftest.py
API data is loaded in `tests/conftest.py`. If you need to mock API calls in a way that's not supported by this framework, you can add custom mocked calls in `conftest.py`.
Things that are *not* supported by mocking in `tests/data/api/`:
- Non-GET requests (e.g. DELETE)
- Query parameters (with the exception of `schema?expand=all`)
# Jupyter Notebook Custom Exporters
We also package custom Jupyter notebook [`nbconvert`](https://nbconvert.readthedocs.io/en/latest/index.html) exporters. These can be tested with the following snippets and the provided `example.ipynb` report.
Our `OneCodexHTMLExporter`:
```sh
ONE_CODEX_REPORT_FILENAME=example.html jupyter nbconvert --execute --to onecodex_html --ExecutePreprocessor.timeout=-1 --output="$ONE_CODEX_REPORT_FILENAME" --output-dir="." notebook_examples/example.ipynb && open example.html
```
And using the `OneCodexPDFExporter`:
```sh
ONE_CODEX_REPORT_FILENAME=example.pdf jupyter nbconvert --execute --to onecodex_pdf --ExecutePreprocessor.timeout=-1 --output="$ONE_CODEX_REPORT_FILENAME" --output-dir="." notebook_examples/example.ipynb && open example.pdf
```
Note that `OneCodexPDFExporter` requires the `vl-convert-python` package to be installed.
Raw data
{
"_id": null,
"home_page": "https://github.com/onecodex/onecodex",
"name": "onecodex",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "One Codex API Client",
"author": "One Codex",
"author_email": "opensource@onecodex.com",
"download_url": "https://files.pythonhosted.org/packages/eb/5f/f282a453d1c4af0dcc9fb35239eccaa691243b4127c3a5d3c3714ed23d3d/onecodex-0.17.0.tar.gz",
"platform": null,
"description": "# One Codex API - Python Client Library and CLI\n\n[](https://github.com/onecodex/onecodex/actions/workflows/test.yml)\n[](https://github.com/onecodex/onecodex/actions/workflows/pre-commit.yml)\n\nCommand line interface (CLI) and Python client library for interacting with the One Codex v1 API ([API docs](https://docs.onecodex.com)).\n\nMAINTAINERS: [@clausmith](https://github.com/clausmith), [@boydgreenfield](https://github.com/boydgreenfield)\n\n# Installation\n\nThis package provides 3 major pieces of functionality: (1) a core Python client library; (2) a simple CLI for interacting with the One Codex platform that uses that core library; and (3) optional extensions to the client library, which offers many features aimed at advanced users and provides functionality for use in interactive notebook environments (e.g., IPython notebooks).\n\nPython 3.9 or later is required. **Python 2 is no longer supported.**\n\n\n### _Basic installation_\nThe CLI (and core Python library) may be simply installed using `pip`. To download a minimal installation (#1 and #2), simply run:\n```shell\npip install onecodex\n```\n\n### _Installation with optional extensions_\nTo also download the optional extensions to the client library, and all of their dependencies, run:\n\n```shell\npip install 'onecodex[all]'\n```\n\n# Using the CLI\n\n## Logging in\nThe CLI supports authentication using either your One Codex API key or your One Codex username and password.\nTo log in using your username and password:\n\n```shell\nonecodex login\n```\n\nThis command will save a credentials file at `~/.onecodex`, which will then automatically be used for authentication the next time the CLI or Python client library are used (OS X/Linux only). You can clear this file and remove your API key from your machine with `onecodex logout`.\n\nIn a shared environment, we recommend directly using your One Codex API key, rather than logging in and storing it in a credentials file. To use API key authentication, simply pass your key as an argument to the `onecodex` command:\n```shell\nonecodex --api-key=YOUR_API_KEY samples\n```\n\nYour API key can be found on the [One Codex settings page](https://app.onecodex.com/settings) and should be 32 character string. You may also generate a new API key on the settings page in the web application. _Note_: Because your API key provides access to all of the samples and metadata in your account, you should immediately reset your key on the website if it is ever accidentally revealed or saved (e.g., checked into a GitHub repository).\n\n## Uploading files\nThe CLI supports uploading FASTA or FASTQ files (optionally gzip compressed) via the `upload` command.\n```shell\nonecodex upload bacterial_reads_file.fq.gz\n```\n\nMultiple files can be uploaded in a single command as well:\n```shell\nonecodex upload file1.fq.gz file2.fq.gz ...\n```\n\nYou can also upload files using the Python client library:\n\n\n```python\nuploaded_sample1 = ocx.Samples.upload(\"/path/to/file.fastq\")\n\n# Or upload a tuple of paired end files\nuploaded_sample2 = ocx.Samples.upload((\"/path/to/R1.fastq\", \"/path/to/R2.fastq\"))\n```\n\nWhich returns a `Samples` resource (as of `0.5.0`). Samples can be associated with tags, metadata, and projects at upload timing using those respective keyword arguments:\n\n```python\n# Note format must match the schema defined for our API, with arbitrary\n# metadata allowed as a single-level dictionary in the `custom` field.\n# See https://developer.onecodex.com/reference#the-metadata-resource for details.\nmetadata = {\n \"platform\": \"Illumina NovaSeq 6000\",\n \"date_collected\": \"2019-04-14T00:51:54.832048+00:00\",\n \"external_sample_id\": \"my-lims-ID-or-similar\",\n \"custom\": {\n \"my-string-field\": \"A most interesting sample...\",\n \"my-boolean-field\": True,\n \"my-number-field-1\": 1,\n \"my-number-field-2\": 2.0,\n }\n}\n```\n\n\nUploads can be made in parallel using Python threads (or multiple processes), e.g.:\n\n```python\nimport concurrent.futures\nuploaded_samples = []\n\nwith concurrent.futures.ThreadPoolExecutor(max_workers=4) as executor:\n futures = {executor.submit(ocx.Samples.upload, file) for file in LIST_OF_FILES}\n for future in concurrent.futures.as_completed(futures):\n try:\n uploaded_samples.append(future.result())\n except Exception as e:\n print(\"An execption occurred during your upload: {}\".format(e))\n```\n\n\n## Resources\nThe CLI supports retrieving your One Codex samples and analyses. The following resources may be queried:\n\n* Your samples (`Samples`)\n\n* Sample metadata (`Metadata`)\n\n* `Analyses`, which include several subtypes with additional functionality and fields:\n * `Classifications`, which are basic metagenomic classification results for your samples\n * `Panels`, which are _in silico_ panels for particular genes or other functional markers ([example on One Codex](https://app.onecodex.com/panel/sample))\n\n* `Jobs`, which provide information on the name, version, and type of analysis which was performed for a given `Analyses`\n\n\nSimply invoke the `onecodex` command, using one of the above resource names as a subcommand (all lowercase). For example:\n```shell\n# fetch all your samples\nonecodex samples\n\n# fetch a list of panels based on their ids\nonecodex panels 0123456789abcdef 0987654321fdecba\n```\n\n# Using the Python client library\n\n## Initialization\nTo load the API, use the following import:\n```python\nfrom onecodex.api import Api\n```\n\nInstantiate an API client either by passing your API key or automatically fetching your credentials from `~/.onecodex` if you've previously called `onecodex login`.\n\n```python\nfrom onecodex.api import Api\n\n# Instantiate a One Codex API object, will attempt to get credentials from ~/.onecodex\nocx = Api()\n\n# Instantiate an API object, manually specifying an API key\nocx = Api(api_key=\"YOUR_API_KEY_HERE\")\n```\n\n## Resources\n\nResources are exposed as attributes on the API object. You can fetch a resource directly by its ID or you can fetch it using the query interface. Currently you can access resources using either `get()` or `where()`. If you need help finding the ID for a sample, its identifier is part of its url on our webpage: e.g. for an analysis at `https://app.onecodex.com/analysis/public/1d9491c5c31345b6`, the ID is `1d9491c5c31345b6`. IDs are all short unique identifiers, consisting of 16 hexadecimal characters (`0-9a-f`).\n\n```python\nsample_analysis = ocx.Classifications.get(\"1d9491c5c31345b6\") # Fetch an individual classification\nsample_analysis.results() # Returns classification results as JSON object\nsample_analysis.table() # Returns a pandas dataframe\n```\n\nIn addition to methods on individual instances of a given resource (e.g., a `Sample` or an `Analysis`), the library also provides methods for aggregating sets of samples or analyses:\n\n\n```python\nall_completed_analyses = ocx.Classifications.where(complete=True)\nall_completed_analyses.to_otu() # Returns classification results as JSON object\nall_completed_analyses.to_df() # Returns a pandas dataframe\n```\n\n# Development\n\n## Environment Setup\n\nBefore developing, `git` and `python` version >=3.9 are needed. We recommend using [pyenv](https://github.com/yyuu/pyenv) for Python version management.\n\nTo download the client library from GitHub:\n\n```shell\ngit clone https://github.com/onecodex/onecodex.git\ncd onecodex/\n```\n\nTo set up the project, first create a virtual environment and then install dependencies:\n\n```shell\n# If you are on a M1 Macbook, run the line below, adjusting the version as needed\nexport HDF5_DIR=/opt/homebrew/Cellar/hdf5/1.12.1_1/\n\nvirtualenv venv\nsource venv/bin/activate\npip install -e '.[all,testing,reports]' # -e specifies development mode so that the package doesn't have to be reinstalled after code edits\n```\n\nTest are run via the Makefile. Note this may take awhile at first because of installing dependencies:\n\n```shell\nmake lint\nmake test\n```\n\nWe use [`pre-commit`](https://pre-commit.com) for automated linting using [`black`](https://github.com/ambv/black), `flake8`, and various whitespace and newline formatters during development.\n\n## Writing Unit Tests\n\nWe use [pytest](https://docs.pytest.org/) as our unit testing framework. Tests should be able to run without an internet connection, and One Codex API calls must be mocked. We use [responses](https://github.com/getsentry/responses) to mock API responses.\n\n> **Tip:** Any API calls that do not have a matching mock will raise an error. You can figure out which API calls need to be mocked by writing a test, running it, and inspecting the error message to see which route(s) are missing.\n\n> **Warning:** Mocked URLs *without* a query string will ignore query strings in any matching requests. If the mocked URL *includes* a query string, it will be used when matching requests.\n\n### Fixtures\n\nThese pytest fixtures may be helpful when writing unit tests:\n\n- `ocx`: this is a mocked `Api` object that uses the `api/v1` One Codex API schema.\n- `ocx_experimental`: this is a mocked `Api` object that uses the `api/v1_experimental` One Codex API schema. Use this to test experimental features.\n- `api_data`: this mocks some API data for `v1` and `v1_experimental` APIs.\n\n### Mocking API Data\n\nAPI data, including schemas, are stored in `tests/data/api/`:\n\n```\ntests/data/api\n\u251c\u2500\u2500 v1 # the API version\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ...\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 analyses\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 index.json # payload for accessing GET::api/v1/analyses. Will also be used to mock each resource instance, e.g. GET::api/v1/analyses/<uuid>\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 classifications\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0f4ee4ecb3a3412f\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 results\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 index.json # payload for accessing GET::api/v1/classifications/0f4ee4ecb3a3412f/results\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 index.json # payload for accessing GET::api/v1/classifications. Instance routes are also auto-mocked\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ...\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 schema\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 index.json # payload for accessing GET::api/v1/schema\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 index_all.json # payload for accessing GET::api/v1/schema?expand=all\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 ...\n\u2514\u2500\u2500 v1_experimental\n \u2514\u2500\u2500 ...\n```\n\nThe directory structure mirrors the One Codex API. For example:\n\n- The payload for API route `api/v1/classifications` is stored at `tests/data/api/v1/classifications/index.json`.\n- API route `api/v1/classifications/0f4ee4ecb3a3412f/results` has its payload stored at `tests/data/api/v1/classifications/0f4ee4ecb3a3412f/results/index.json`.\n- For the `v1_experimental` API, store things under `api/v1_experimental/`.\n\nThis idea can be extended to arbitrary nesting/depths within the API.\n\n> **Note:** If the payload is large, you can gzip it and name it `index.json.gz`.\n\nA resource's instance list payload (e.g. `api/v1/analyses` gives you a list of analyses) is used to auto-mock each resource instance (e.g. `api/v1/analyses/<uuid>`). You don't need to create an `index.json` for each instance.\n\n### Mocking API Schemas\n\nAPI schemas work similarly to regular API data, but with a couple of special rules:\n\n- Each API schema directory *must* have `index.json` and `index_all.json`. `index.json` contains the payload for e.g. `api/v1/schema`, and `index_all.json` contains the payload for e.g. `api/v1/schema?expand=all`.\n- If the schema requires it, you can optionally define resource-specific schemas by including `<resource-name>.json` in the `schema` directory (e.g. `assemblies.json` for `api/v1_experimental/assemblies/schema`).\n\n### conftest.py\n\nAPI data is loaded in `tests/conftest.py`. If you need to mock API calls in a way that's not supported by this framework, you can add custom mocked calls in `conftest.py`.\n\nThings that are *not* supported by mocking in `tests/data/api/`:\n\n- Non-GET requests (e.g. DELETE)\n- Query parameters (with the exception of `schema?expand=all`)\n\n# Jupyter Notebook Custom Exporters\n\nWe also package custom Jupyter notebook [`nbconvert`](https://nbconvert.readthedocs.io/en/latest/index.html) exporters. These can be tested with the following snippets and the provided `example.ipynb` report.\n\nOur `OneCodexHTMLExporter`:\n\n```sh\nONE_CODEX_REPORT_FILENAME=example.html jupyter nbconvert --execute --to onecodex_html --ExecutePreprocessor.timeout=-1 --output=\"$ONE_CODEX_REPORT_FILENAME\" --output-dir=\".\" notebook_examples/example.ipynb && open example.html\n```\n\nAnd using the `OneCodexPDFExporter`:\n\n```sh\nONE_CODEX_REPORT_FILENAME=example.pdf jupyter nbconvert --execute --to onecodex_pdf --ExecutePreprocessor.timeout=-1 --output=\"$ONE_CODEX_REPORT_FILENAME\" --output-dir=\".\" notebook_examples/example.ipynb && open example.pdf\n```\n\nNote that `OneCodexPDFExporter` requires the `vl-convert-python` package to be installed.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "One Codex API client and Python library",
"version": "0.17.0",
"project_urls": {
"Homepage": "https://github.com/onecodex/onecodex"
},
"split_keywords": [
"one",
"codex",
"api",
"client"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eb5ff282a453d1c4af0dcc9fb35239eccaa691243b4127c3a5d3c3714ed23d3d",
"md5": "56bc8f0ffa4a4ada69e45f1ced55c38f",
"sha256": "2d13020bff7df66630bc185cebfa4384bbc28bfe46867863cd6539dbf7766e37"
},
"downloads": -1,
"filename": "onecodex-0.17.0.tar.gz",
"has_sig": false,
"md5_digest": "56bc8f0ffa4a4ada69e45f1ced55c38f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 2959676,
"upload_time": "2024-12-03T16:07:48",
"upload_time_iso_8601": "2024-12-03T16:07:48.995160Z",
"url": "https://files.pythonhosted.org/packages/eb/5f/f282a453d1c4af0dcc9fb35239eccaa691243b4127c3a5d3c3714ed23d3d/onecodex-0.17.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-03 16:07:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "onecodex",
"github_project": "onecodex",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "onecodex"
}
JSON
