Metadata-Version: 2.3
Name: allotropy
Version: 0.1.30
Summary: Converts to ASM (Allotrope Simple Model) from various file formats.
Project-URL: Documentation, https://github.com/Benchling-Open-Source/allotropy#readme
Project-URL: Issues, https://github.com/Benchling-Open-Source/allotropy/issues
Project-URL: Source, https://github.com/Benchling-Open-Source/allotropy
Author-email: Benchling Open Source <opensource@benchling.com>, Lukas Boelling <lukas.boelling@deepgenomics.com>, Danielle Chou <danielle.chou@benchling.com>, Kathy Garcia <kathy@benchling.com>, Trevor Halum <trevor.halum@deepgenomics.com>, Sebastian Lopez <sebastian.cardona@benchling.com>, Mindren Lu <mindren.lu@benchling.com>, Joe Negri <joe.negri@benchling.com>, Alejando Salgado <alejando.salgado@benchling.com>, Nathan Stender <nathan.stender@benchling.com>, Eihab Syed <eihabsyed@gmail.com>, Yukthi Wickramarachchi <yukthi.wickramarachchi@deepgenomics.com>, Greg Wilson <gvwilson@third-bit.com>, Ben Wolfe <bwolfe@benchling.com>, Stephen Worlow <stephen.worlow@benchling.com>, Brian Worth <brian@benchling.com>
License-Expression: MIT
License-File: LICENSE.txt
Keywords: allotrope,allotropy,asm,benchling,converters
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.9
Requires-Dist: cattrs==23.1.2
Requires-Dist: chardet>=5.2.0
Requires-Dist: jsonschema>=4.3.3
Requires-Dist: numpy>=1.25.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: pandas>=2.1.0
Requires-Dist: pytz
Requires-Dist: rfc3339-validator>=0.1.4
Requires-Dist: xlrd>=2.0.0
Description-Content-Type: text/markdown

\*Allotrope® is a registered trademark of the Allotrope Foundation; no affiliation with the Allotrope Foundation is claimed or implied.

# Introduction
Welcome to `allotropy` -- a Python library by Benchling for converting instrument data into the Allotrope Simple Model (ASM).

The objective of this library is to read text or Excel based instrument software output and return a JSON representation that conforms to the published ASM schema. Note that some schemas do not yet match the published ASM schema, in these cases the CHANGE_NOTES.md file included alongside the schema details the differences and proposed changes to ASM or the library schema. The code in this library does not convert from proprietary/binary output formats and so has no need to interact with any of the specific vendor softwares.

If you aren't familiar with Allotrope, we suggest you start by reading the [Allotrope Product Overview](https://www.allotrope.org/product-overview).

We have chosen to have this library output ASM since JSON is easy to read and consume in most modern systems and can be checked by humans without any special tools needed. All of the published open source ASMs can be found in the [ASM Gitlab repository](https://gitlab.com/allotrope-public/asm).

We currently have parser support for the following instruments:
  - Agilent Gen5
  - Applied Bio QuantStudio
  - Applied Bio AbsoluteQ
  - Beckman Vi-Cell BLU
  - Beckman Vi-Cell XR
  - Biorad Bioplex Manager
  - ChemoMetec Nucleoview
  - Luminex xPONENT
  - MolDev SoftMax Pro
  - NovaBio Flex2
  - PerkinElmer Envision
  - Qiacuity dPCR
  - Roche Cedex BioHT
  - Thermo Fisher NanoDrop Eight
  - Unchained Labs Lunatic

This code is published under the permissive MIT license because we believe that standardized instrument data is a benefit for everyone in science.


# Contributing
We welcome community contributions to this library and we hope that together we can expand the coverage of ASM-ready data for everyone. If you are interested, please read our [contribution guidelines](CONTRIBUTING.md).


# Usage

Convert a file to an ASM dictionary:

```sh
from allotropy.parser_factory import Vendor
from allotropy.to_allotrope import allotrope_from_file

asm_schema = allotrope_from_file("filepath.txt", Vendor.MOLDEV_SOFTMAX_PRO)
```

or, convert any IO:

```sh
from allotropy.parser_factory import Vendor
from allotropy.to_allotrope import allotrope_from_io

with open("filename.txt") as f:
    asm_schema = allotrope_from_io(f, Vendor.MOLDEV_SOFTMAX_PRO)

bytes_io = BytesIO(file_stream)
asm_schema = allotrope_from_io(bytes_io, Vendor.MOLDEV_SOFTMAX_PRO)
```

# Specific setup and build instructions

`.gitignore`: used standard GitHub Python template and added their recommended JetBrains lines


### Setup

Install Hatch: https://hatch.pypa.io/latest/
Install Python: https://www.python.org/downloads/
This library supports Python 3.9 or higher. Hatch will install a matching version of Python (defined in `pyproject.toml`) when it sets up your environment.

Add pre-push checks to your repo:
```sh
hatch run scripts:setup-pre-push
```

#### Dependencies

To add requirements used by the library, update `dependencies` in `pyproject.toml`:
- For project dependencies, update `dependencies` under `[project]`.
- For script dependencies, update `dependencies` under `[tool.hatch.envs.default]`.
- For lint dependencies, update `dependencies` under `[tool.hatch.envs.lint]`.
- For test dependencies, update `dependencies` under `[tool.hatch.envs.test]`.

### Useful Hatch commands
List all environments:
```sh
hatch env show
```

Run all lint:
```sh
hatch run lint:all
```

Auto-fix all possible lint issues:
```sh
hatch run lint:fmt
```

Run all tests:
```sh
hatch run test:test
```

Run a specific test file (replace the filepath with your own):
```sh
hatch run test:test tests/allotrope/allotrope_test.py
```

Run all tests with coverage:
```sh
hatch run test:cov
```

Spawn a shell within an environment for development:
```sh
hatch shell
```

### Publish

To publish a new version, update the version in `src/allotropy/__about__.py` and run:

```sh
hatch build
hatch publish
```
