Metadata-Version: 2.4
Name: pycarta-service-agent
Version: 0.2.0.dev1
Summary: Packaged Carta service agent binary and utilities for pycarta[service].
Author: Contextualize
Author-email: branden.kappes@contextualize.us.com
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Dynamic: license-file

# pycarta-service-agent

Executable delivery for [`pycarta`](https://pypi.org/project/pycarta/)'s Service Manager support.

Carta managed services turn your own code into something the Carta platform can permission, share,
and invoke, while it runs on hardware you control.

This package exists to deliver a platform-specific service agent executable, as installed by pip.
Alongside it, the package exports the utilities that wrap that executable for use
from Python. They cover locating it, building its arguments, reading the configuration it writes,
and exchanging messages with it while it runs. Those utilities ship in the same wheel as the
executable, so the two always agree on how it is launched and how it is spoken to.

`pycarta` is the consumer, and it handles all of that on your behalf. There is no need to install or
call this package directly.

## Installation

It comes in as part of the `pycarta` service extra:

```bash
pip install "pycarta[service]"
```

`pip` selects the wheel matching your OS and architecture and installs the single
binary bundled in it. Wheels are published for:

- macOS, Apple Silicon and Intel
- Linux, x86-64 and aarch64, glibc and musl
- Windows, x86-64

Standard library only, no third-party dependencies.

## Usage

`find_binary()` reports the installed path of the executable:

```python
import pycarta_service_agent

path = pycarta_service_agent.find_binary()
```

The remaining utilities are grouped by concern into `command`, `config`, `errors`, `ipc`, and
`messages`, and are documented in place. Every name they export carries a docstring covering what it
is and how the executable behaves around it.

# Feature Request/Bug-Fix

For issues, please contact
<customer.service@contextualize.us.com>.

To request a new feature or to report a bug, please email
[pycarta](mailto:a.t.901104402411.u-26296181.4165918c-9632-497d-8601-dfcb2f66ba78@tasks.clickup.com).
Please be sure to describe the goal of the new feature or, for a bug
report, a minimum code that reproduces the error. Note that if you
submit a feature request or bug report, the developers reserve the right
to contact you about that request.
