Skip to content
This repository was archived by the owner on Sep 9, 2024. It is now read-only.

Commit 17e0a39

Browse files
mike-ganglanilnathariverma
authored
Develop 0.2.2 into main (#66)
* Downgrade38 (#59) * downgrade to support python3.8 * updated poetry version --------- Co-authored-by: Anil Natha <anilnatha@users.noreply.github.com> * Pytest (#57) * adding pytest coverage commands * remove unneeded python versions form testing * updated poetry version * updated coverate command * Update python-app.yml added coverall support * fixed poetry lock --------- Co-authored-by: Anil Natha <anilnatha@users.noreply.github.com> * version bump and release fix to use python 3.8 and correct poetry version (#61) Co-authored-by: Anil Natha <anilnatha@users.noreply.github.com> * Added missing files and improved README (#55) Co-authored-by: mike-gangl <59702631+mike-gangl@users.noreply.github.com> Co-authored-by: Anil Natha <anilnatha@users.noreply.github.com> * 0.2.1 merge (#62) (#63) * Downgrade38 (#59) * downgrade to support python3.8 * updated poetry version --------- * Pytest (#57) * adding pytest coverage commands * remove unneeded python versions form testing * updated poetry version * updated coverate command * Update python-app.yml added coverall support * fixed poetry lock --------- * version bump and release fix to use python 3.8 and correct poetry version (#61) --------- Co-authored-by: Anil Natha <anilnatha@users.noreply.github.com> * Issues/58 (#64) * removed un-needed mercury dashboard * restructured environments to dev/test/prod values * added environment settings, added process tests (high level) to ensure venue and project setting was successfully available. * updated unity environments with correct endpoints * updated changelog --------- Co-authored-by: Anil Natha <anilnatha@users.noreply.github.com> Co-authored-by: Rishi Verma <riverma@users.noreply.github.com>
1 parent 759174c commit 17e0a39

File tree

14 files changed

+319
-1114
lines changed

14 files changed

+319
-1114
lines changed
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
name: Bug Report
3+
about: Report a bug to help us improve
4+
title: '[Bug]: '
5+
labels: 'bug'
6+
assignees: ''
7+
8+
---
9+
10+
**Checked for duplicates**
11+
12+
> Have you checked for duplicate issue tickets?
13+
14+
- Ex. Yes - I've already checked
15+
- Ex. No - I haven't checked
16+
17+
**Describe the bug**
18+
19+
> A clear and concise description of what the bug is. Plain-text snippets preferred but screenshots welcome.
20+
21+
Ex. When I did [...] action, I noticed [...]
22+
23+
**What did you expect?**
24+
25+
> A clear and concise description of what you expect to happen
26+
27+
Ex. I expected [...]
28+
29+
**Reproducible steps**
30+
31+
> How would we reproduce this bug? Please walk us through it step by step. Plain-text snippets preferred but screenshots welcome.
32+
33+
1.
34+
2.
35+
3.
36+
37+
**What is your environment?**
38+
39+
> Include any computer hardware, operating system, framework, browser, time-of-day or other contextual information related to your issue
40+
41+
- Ex. Version of this software [e.g. vX.Y.Z]
42+
- Ex. Operating System: [e.g. MacOSX with Docker Desktop vX.Y]
43+
- ...
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
name: New Feature
3+
about: Suggest a new feature for us to implement
4+
title: '[New Feature]: '
5+
labels: 'enhancement'
6+
assignees: ''
7+
8+
---
9+
10+
**Checked for duplicates**
11+
12+
> Have you checked for duplicate issue tickets?
13+
14+
- Ex. Yes - I've already checked
15+
- Ex. No - I haven't checked
16+
17+
**Alternatives considered**
18+
19+
> Have you considered alternative solutions to your feature request?
20+
21+
- Ex. Yes - and alternatives don't suffice
22+
- Ex. No - I haven't considered
23+
24+
**Related problems**
25+
26+
> Is your feature request related to any problems? Please help us understand if so, including linking to any other issue tickets.
27+
28+
Ex. I'm frustrated when [...] happens as documented in issue-XYZ
29+
30+
**Describe the feature request**
31+
32+
> A clear and concise description of your request.
33+
34+
Ex. I need or want [...]

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
## Purpose
2+
- Clear, easy-to-understand sentences outlining the purpose of the PR
3+
## Proposed Changes
4+
- [ADD] ...
5+
- [CHANGE] ...
6+
- [FIX] ...
7+
## Issues
8+
- Links to relevant issues
9+
- Example: issue-XYZ
10+
## Testing
11+
- Provide some proof you've tested your changes
12+
- Example: test results available at ...
13+
- Example: tested on operating system ...

CHANGELOG.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

88
--------
9+
## [0.2.2] - 2024-01-03
10+
### Added
11+
* Added project/venue support [5](https://github.com/unity-sds/unity-py/issues/58)
12+
### Fixed
13+
### Changed
14+
### Removed
15+
### Security
16+
### Deprecated
17+
18+
## [0.2.1] - 2023-11-29
19+
### Added
20+
* python code coverage via coveralls
21+
### Fixed
22+
### Changed
23+
* updated install to support python 3.8 and above.
24+
### Removed
25+
### Security
26+
### Deprecated
927

1028
## [0.2.1] - 2023-11-29
1129
### Added

README.md

Lines changed: 95 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,87 @@
1-
# Unity-Py
21

3-
Unity-Py is a Python client to simplify interactions with NASA's Unity Platform.
2+
<hr>
43

5-
## Installation
4+
<div align="center">
65

7-
### Install from pypi
8-
```
9-
pip install unity-sds-client
10-
```
6+
![logo](https://user-images.githubusercontent.com/3129134/163255685-857aa780-880f-4c09-b08c-4b53bf4af54d.png)
117

12-
### Install from Github
13-
```
14-
python -m pip install git+https://github.com/unity-sds/unity-py.git
15-
```
8+
<h1 align="center">Unity-Py</h1>
169

17-
### Building and installing locally using poetry
10+
</div>
1811

19-
```
20-
git clone https://github.com/unity-sds/unity-py.git
21-
cd unity-py
22-
poetry install
23-
```
12+
<pre align="center">A Python client to simplify interactions with NASA's Unity Platform.</pre>
2413

25-
## Getting Started
14+
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](code_of_conduct.md) [![SLIM](https://img.shields.io/badge/Best%20Practices%20from-SLIM-blue)](https://nasa-ammos.github.io/slim/)
2615

27-
### Authorization
16+
[INSERT SCREENSHOT OF YOUR SOFTWARE, IF APPLICABLE]
2817

29-
Authorization can be handled interactively, in which case you will be prompted for a username/password when calling the Unity() method, or can be handled by way of environment variables:
18+
Unity-Py provides a seamless way to interact with NASA's Unity Platform using Python. Built to simplify the connection and data retrieval process, this client offers a programmatic interface to Unity's services.
19+
20+
## Features
3021

22+
* Pythonic interface to NASA's Unity Platform
23+
* Support for interactive and environment variable-based authorization
24+
25+
## Contents
26+
27+
* [Quick Start](#quick-start)
28+
* [Changelog](#changelog)
29+
* [FAQ](#frequently-asked-questions-faq)
30+
* [Contributing Guide](#contributing)
31+
* [License](#license)
32+
* [Support](#support)
33+
34+
## Quick Start
35+
36+
### Requirements
37+
38+
* Python
39+
* pip
40+
41+
### Setup Instructions
42+
43+
1. Install via pypi:
44+
```
45+
pip install unity-sds-client
46+
```
47+
2. Install from Github:
48+
```
49+
python -m pip install git+https://github.com/unity-sds/unity-py.git
50+
```
51+
3. Building and installing locally using poetry:
52+
```
53+
git clone https://github.com/unity-sds/unity-py.git
54+
cd unity-py
55+
poetry install
56+
```
57+
58+
### Run Instructions
59+
60+
Authorization can be handled interactively, in which case you will be prompted for a username/password when calling the Unity() method, or can be handled by way of environment variables:
3161
```
3262
export UNITY_USER=MY_UNITY_USERNAME
3363
export UNITY_PASSWORD=MY_UNITY_PASSWORD
3464
```
35-
36-
The order of Authentication Parameters is as follows:
37-
65+
Order of Authentication Parameters:
3866
1. Environment variables
3967
2. Prompt for username and password
4068

41-
### Running your first command
69+
### Usage Examples
4270

4371
```
4472
from unity_sds_client.unity import Unity
4573
from unity_sds_client.unity_session import UnitySession
4674
from unity_sds_client.unity_services import UnityServices as services
4775
4876
s = Unity()
77+
# set the venue for interacting with venue specific services
78+
# if your venue id is a single string, use the following
79+
s.set_venue_id("unity-sips-test")
80+
81+
# otherwise set the project and venue:
82+
# s.set_project("sbg")
83+
# s.set_venue("dev")
84+
4985
dataManager = s.client(services.DATA_SERVICE)
5086
collections = dataManager.get_collections()
5187
print(collections)
@@ -54,19 +90,44 @@ cd = dataManager.get_collection_data(collections[0])
5490
for dataset in cd:
5591
print(f'dataset name: {dataset.id}' )
5692
for f in dataset.datafiles:
57-
print("\t" + f.location)
93+
print(" " + f.location)
5894
```
5995

60-
## Testing
61-
To run unit and regression tests:
96+
### Test Instructions
6297

63-
```
64-
# run all tests and include printouts:
65-
poetry run pytest -s
98+
1. Run all tests and include printouts:
99+
```
100+
poetry run pytest -s
101+
```
66102

67-
# run non-regression tests:
68-
poetry run pytest -m "not regression"
103+
2. Run non-regression tests:
104+
```
105+
poetry run pytest -m "not regression"
106+
```
69107

70-
# run regression tests (and include logs)
108+
3. Run regression tests (and include logs)
109+
```
110+
(Not Available Yet)
111+
```
71112

72-
```
113+
## Changelog
114+
115+
See our [CHANGELOG.md](CHANGELOG.md) for a history of our changes.
116+
117+
See our [releases page](https://github.com/unity-sds/unity-py/releases) for our key versioned releases.
118+
119+
## Frequently Asked Questions (FAQ)
120+
121+
No questions yet. Propose a question to be added here by reaching out to our contributors! See support section below.
122+
123+
## Contributing
124+
125+
Interested in contributing to our project? Please see our: [CONTRIBUTING.md](CONTRIBUTING.md)
126+
127+
## License
128+
129+
See our: [LICENSE](LICENSE)
130+
131+
## Support
132+
133+
Please reach out to [@anilnatha](https://github.com/anilnatha), [@mike-gangl](https://github.com/mike-gangl)

0 commit comments

Comments
 (0)