Metadata-Version: 2.3
Name: jup-ag-sdk
Version: 1.0.0
Summary: Python SDK for Jupiter Exchange APIs.
License: MIT
Keywords: solana,jupiter,sdk
Author: Fiji
Author-email: charismoutafidis@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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
Requires-Dist: base58 (>=2.1.1,<3.0.0)
Requires-Dist: httpx (>=0.28.1,<0.29.0)
Requires-Dist: pydantic (>=2.11.3,<3.0.0)
Requires-Dist: solana (>=0.36.6,<0.37.0)
Requires-Dist: solders (>=0.26.0,<0.27.0)
Project-URL: Homepage, https://github.com/cmoutafidis/jup-ag-sdk
Project-URL: Repository, https://github.com/cmoutafidis/jup-ag-sdk
Description-Content-Type: text/markdown

# **Jup-Ag-SDK**

A Python SDK for interacting with Jupiter Exchange APIs.

## **Installation**
To install the SDK globally from PyPI, run:
```sh
pip install jup-ag-sdk
```

## **Local Development**
If you want to make changes to the SDK and test it locally:

1. In this project's directory, install the package in editable mode by running:
   ```sh
   pip install -e .
   ```

2. To use this library in another project while making changes to it, install the package from its local path in that project:
   ```sh
   pip install -e /path/to/jup-ag-sdk
   ```

   Replace `/path/to/jup-ag-sdk` with the absolute or relative path to this project directory.

By installing in editable mode, any changes you make to the SDK will immediately reflect in your tests without needing to reinstall the package.

## **Making a New Release**
To create and publish a new release of the package to PyPI:

1. **Update the Version:**
   - Update the version in your `pyproject.toml` file following [semantic versioning](https://semver.org/), e.g., `0.0.1` → `0.1.0` for a minor update.

2. **Commit the Changes:**
   - Commit and push the version update to the main branch:
     ```sh
     git add pyproject.toml
     git commit -m "Bump version to vX.Y.Z"
     git push origin main
     ```

3. **Create a Tag:**
   - Tag the commit with the new version:
     ```sh
     git tag vX.Y.Z
     git push origin vX.Y.Z
     ```

   Replace `vX.Y.Z` with the actual version number.

4. **GitHub Actions Workflow:**
   - When the tag is pushed, the `release.yml` GitHub Actions workflow will automatically:
      - Build the package using Poetry.
      - Publish the package to PyPI.

5. **Confirm the Release:**
   - Check [PyPI](https://pypi.org/project/jup-ag-sdk/) to ensure the new version has been published successfully.

## **Disclaimer**
🚨 **This project is a work in progress and should not be used in production systems.**  
Expect breaking changes as the SDK evolves.
