synapsedesktopclient/v0.1.2-beta

Synapse Desktop Client - Beta Release v0.1.2

Welcome to the first iteration of the Synapse Desktop Client. This is an attempt to provide you with a low-tech, user-friendly solution to start contributing data to, or retrieving data from Synapse.

What's Included in This Release

Core Functionality:

• Upload data to Synapse resources you have access to
• Download data from Synapse resources you have access to
• Simple desktop interface for managing your Synapse interactions
• Access token based authentication

This initial release focuses on the fundamental operations that most users need: getting your data into Synapse and getting it back out when you need it.

⚠️ EXPERIMENTAL SOFTWARE DISCLAIMER ⚠️

IMPORTANT NOTICE - READ BEFORE USE

THE SYNAPSE DESKTOP CLIENT IS EXPERIMENTAL BETA SOFTWARE

This software is in early development and may contain bugs, security vulnerabilities, or cause system instability. By proceeding, you acknowledge that:

• Data loss may occur - Always backup important data before use
• Features may not work as expected or change without notice
• System crashes or freezes are possible
• Security risks may exist due to unfinished code
• No warranty or support is provided for this beta version

Use at your own risk. This software is intended for testing and feedback purposes only.

---

By continuing to use this software, you accept full responsibility for any consequences.

---

What to Expect

As our first beta release, you might encounter:

• Rough edges in the user interface
• Limited error handling for edge cases
• Performance issues with large files or datasets
• Missing features that will be added in future releases

Your Feedback Matters

We're building this tool with and for the Synapse community. Your experience, bug reports, and suggestions are invaluable in helping us create something truly useful.

Please share your feedback with us:

• 🐛 Bug reports and technical issues
• 💡 Feature requests and suggestions
• 📝 General feedback about your experience
• 🤔 Questions about usage or functionality

Submit feedback here: https://sagebionetworks.jira.com/servicedesk/customer/portal/5/group/7/create/144

Getting Started

1. Download the appropriate installer for your operating system
2. Install the application following the setup wizard
3. Launch the Synapse Desktop Client
4. Log in with your Synapse access token or your synapseConfig file with profile based authentication.
5. Start uploading or downloading your data

System Requirements

• Windows: Windows 10 or later
• macOS: macOS 14 or later

Install instructions:

• Windows
• MacOs

synapsedesktopclient/v0.1.1-beta

Synapse Desktop Client - Beta Release v0.1.1

Welcome to the first iteration of the Synapse Desktop Client. This is an attempt to provide you with a low-tech, user-friendly solution to start contributing data to, or retrieving data from Synapse.

What's Included in This Release

Core Functionality:

• Upload data to Synapse resources you have access to
• Download data from Synapse resources you have access to
• Simple desktop interface for managing your Synapse interactions
• Access token based authentication

This initial release focuses on the fundamental operations that most users need: getting your data into Synapse and getting it back out when you need it.

⚠️ EXPERIMENTAL SOFTWARE DISCLAIMER ⚠️

IMPORTANT NOTICE - READ BEFORE USE

THE SYNAPSE DESKTOP CLIENT IS EXPERIMENTAL BETA SOFTWARE

This software is in early development and may contain bugs, security vulnerabilities, or cause system instability. By proceeding, you acknowledge that:

• Data loss may occur - Always backup important data before use
• Features may not work as expected or change without notice
• System crashes or freezes are possible
• Security risks may exist due to unfinished code
• No warranty or support is provided for this beta version

Use at your own risk. This software is intended for testing and feedback purposes only.

---

By continuing to use this software, you accept full responsibility for any consequences.

---

What to Expect

As our first beta release, you might encounter:

• Rough edges in the user interface
• Limited error handling for edge cases
• Performance issues with large files or datasets
• Missing features that will be added in future releases

Your Feedback Matters

We're building this tool with and for the Synapse community. Your experience, bug reports, and suggestions are invaluable in helping us create something truly useful.

Please share your feedback with us:

• 🐛 Bug reports and technical issues
• 💡 Feature requests and suggestions
• 📝 General feedback about your experience
• 🤔 Questions about usage or functionality

Submit feedback here: https://sagebionetworks.jira.com/servicedesk/customer/portal/5/group/7/create/144

Getting Started

1. Download the appropriate installer for your operating system
2. Install the application following the setup wizard
3. Launch the Synapse Desktop Client
4. Log in with your Synapse access token or your synapseConfig file with profile based authentication.
5. Start uploading or downloading your data

System Requirements

• Windows: Windows 10 or later
• macOS: macOS 14 or later

Install instructions:

• Windows
• MacOs

v4.10.0

Highlights

• Added new object-oriented models and APIs for various Synapse entities including Curation, RecordSet, and Grids
• Enhanced tutorials and documentation for the new object models
• Deprecated multiple methods and services in the Synapse Python client

Features

• [SYNPY-1625] Added JSON schema organization management functions by @BryanFauble in #1225
• [SYNPY-1653] Created RecordSet, Grid, and CurationTask classes by @BryanFauble in #1246
• [SYNPY-1623] Implemented factory function for get and creation of link entity by @BryanFauble in #1243
• [SYNPY-1613] Enabled download from pre-signed URL by @danlu1 in #1249

Bug Fixes

• [SYNPY-1642] Ensured paramiko is < 4.0.0 by @linglp in #1231
• [SYNPY-1198] Handled S3 upload errors by retrying without ACL for IBM buckets by @BryanFauble in #1239

Tech Debt

• [SYNPY-1426] Deprecated user, team, activity, column, move, and annotation services by multiple contributors in #1212, #1215, #1217, #1218, #1219, #1221, #1223, #1226
• [SYNPY-1632] Deprecated tables from the Synapse class and table.py module by @linglp in #1233
• [SYNPY-1633] Deprecated old method for getting user membership status by @linglp in #1235
• Updated SonarCloud action to use [email protected] by @BryanFauble in #1238
• [SYNPY-1634, SYNPY-1377] Used new OOP models in tutorials by @thomasyu888 in #1241

Other

• [SYNPY-1599] Fixed line references in JSON schema tutorial and updated syn class usage by @BryanFauble in #1213
• [SYNPY-1588] Enabled Agent Integration tests by @linglp in #1229
• [SYNPY-1637] Added 'Contact Us' section with support link in navigation by @BryanFauble in #1230
• [GEN-1667] Enabled deleting table rows using filtered DataFrame by @danlu1 in #1254
• [SYNPY-1592] Dedicated test accounts for each set of integration test runs by @BryanFauble in #1240
• [SYNPY-1634] Added walk method to containers by @BryanFauble in #1242
• Implemented UUID in naming convention for updated collection by @jaymedina in #1224
• Removed unnecessary line in Pipfile by @linglp in #1234

Full Changelog: v4.9.0...v4.10.0-rc

v4.10.0-rc

Highlights

• Added new object-oriented models and APIs for various Synapse entities including Curation, RecordSet, and Grids
• Updated support for JSON schemas and organizations
• Enhanced tutorials and documentation for the new object models
• Deprecated multiple methods and services in the Synapse Python client

Features

• [SYNPY-1625] Added JSON schema organization management functions by @BryanFauble in #1225
• [SYNPY-1653] Created RecordSet, Grid, and CurationTask classes by @BryanFauble in #1246
• [SYNPY-1623] Implemented factory function for get and creation of link entity by @BryanFauble in #1243
• [SYNPY-1613] Enabled download from pre-signed URL by @danlu1 in #1249

Bug Fixes

• [SYNPY-1642] Ensured paramiko is < 4.0.0 by @linglp in #1231
• [SYNPY-1198] Handled S3 upload errors by retrying without ACL for IBM buckets by @BryanFauble in #1239

Tech Debt

• [SYNPY-1426] Deprecated user, team, activity, column, move, and annotation services by multiple contributors in #1212, #1215, #1217, #1218, #1219, #1221, #1223, #1226
• [SYNPY-1632] Deprecated tables from the Synapse class and table.py module by @linglp in #1233
• [SYNPY-1633] Deprecated old method for getting user membership status by @linglp in #1235
• Updated SonarCloud action to use [email protected] by @BryanFauble in #1238
• [SYNPY-1634, SYNPY-1377] Used new OOP models in tutorials by @thomasyu888 in #1241

Other

• [SYNPY-1599] Fixed line references in JSON schema tutorial and updated syn class usage by @BryanFauble in #1213
• [SYNPY-1588] Enabled Agent Integration tests by @linglp in #1229
• [SYNPY-1637] Added 'Contact Us' section with support link in navigation by @BryanFauble in #1230
• [GEN-1667] Enabled deleting table rows using filtered DataFrame by @danlu1 in #1254
• [SYNPY-1592] Dedicated test accounts for each set of integration test runs by @BryanFauble in #1240
• [SYNPY-1634] Added walk method to containers by @BryanFauble in #1242
• Implemented UUID in naming convention for updated collection by @jaymedina in #1224
• Removed unnecessary line in Pipfile by @linglp in #1234

Full Changelog: v4.9.0...v4.10.0-rc

synapsedesktopclient/v0.1.0-beta

Synapse Desktop Client - Beta Release v0.1.0

Welcome to the first iteration of the Synapse Desktop Client. This is an attempt to provide you with a low-tech, user-friendly solution to start contributing data to, or retrieving data from Synapse.

What's Included in This Release

Core Functionality:

• Upload data to Synapse resources you have access to
• Download data from Synapse resources you have access to
• Simple desktop interface for managing your Synapse interactions
• Access token based authentication

This initial release focuses on the fundamental operations that most users need: getting your data into Synapse and getting it back out when you need it.

⚠️ EXPERIMENTAL SOFTWARE DISCLAIMER ⚠️

IMPORTANT NOTICE - READ BEFORE USE

THE SYNAPSE DESKTOP CLIENT IS EXPERIMENTAL BETA SOFTWARE

This software is in early development and may contain bugs, security vulnerabilities, or cause system instability. By proceeding, you acknowledge that:

• Data loss may occur - Always backup important data before use
• Features may not work as expected or change without notice
• System crashes or freezes are possible
• Security risks may exist due to unfinished code
• No warranty or support is provided for this beta version

Use at your own risk. This software is intended for testing and feedback purposes only.

---

By continuing to use this software, you accept full responsibility for any consequences.

---

What to Expect

As our first beta release, you might encounter:

• Rough edges in the user interface
• Limited error handling for edge cases
• Performance issues with large files or datasets
• Missing features that will be added in future releases

Your Feedback Matters

We're building this tool with and for the Synapse community. Your experience, bug reports, and suggestions are invaluable in helping us create something truly useful.

Please share your feedback with us:

• 🐛 Bug reports and technical issues
• 💡 Feature requests and suggestions
• 📝 General feedback about your experience
• 🤔 Questions about usage or functionality

Submit feedback here: https://sagebionetworks.jira.com/servicedesk/customer/portal/5/group/7/create/144

Getting Started

1. Download the appropriate installer for your operating system
2. Install the application following the setup wizard
3. Launch the Synapse Desktop Client
4. Log in with your Synapse access token or your synapseConfig file with profile based authentication.
5. Start uploading or downloading your data

System Requirements

• Windows: Windows 10 or later
• macOS: macOS 14 or later

Install instructions:

• Windows
• MacOs

v4.9.0

Highlights

• Multi-Profile support is now available when using the .synapseConfig file. Check out the updated Authentication instructions that covers how to take advantage of this feature.
• Introduced streamlined functionality for managing JSON schemas and access control lists (ACLs)
• Enhanced OpenTelemetry tracing for file transfers and MD5 calculations
• Added support for Virtual Tables

Features

• [SYNPY-893] Added support for multiple authentication profiles (#1194)
• [SYNPY-1580] Implemented VirtualTable OOP model (#1195)
• [SYNPY-1599] Added JSON schema mixin class for binding, validating, and unbinding schemas (#1205)
• [SYNPY-1607] Enabled string-based conversion for ColumnType and FacetType (#1210)
• [SYNPY-1604] Introduced dry_run flag and list_acl method for ACL management (#1207)
• [SYNPY-1244] Implemented recursive ACL deletion and permission inheritance detection (#1200, #1202)

Bug Fixes

• [SYNPY-1581] Removed exception logging and raising in async methods (#1203)

Tech Debt

• [SYNPY-1295] Trimmed down integration tests and combined similar logic (#1199)
• [SYNPY-1606] Added OpenTelemetry metrics for file uploads, downloads, and MD5 calculations (#1204)
• [SYNPY-1618] Added scripts for cleaning up test resources in Synapse (#1209)
• [SYNPY-1599] Patched JSON schema code and improved examples (#1211)

New Contributors

• @SageGJ made their first contribution in #1203
• @carmmmm made their first contribution in #1183

Full Changelog: v4.8.0...v4.9.0

v4.9.0-rc

Highlights

• Multi-Profile support is now available when using the .synapseConfig file. Check out the updated Authentication instructions that covers how to take advantage of this feature.
• Introduced streamlined functionality for managing JSON schemas and access control lists (ACLs)
• Enhanced OpenTelemetry tracing for file transfers and MD5 calculations
• Added support for Virtual Tables

Features

• [SYNPY-893] Added support for multiple authentication profiles (#1194)
• [SYNPY-1580] Implemented VirtualTable OOP model (#1195)
• [SYNPY-1599] Added JSON schema mixin class for binding, validating, and unbinding schemas (#1205)
• [SYNPY-1607] Enabled string-based conversion for ColumnType and FacetType (#1210)
• [SYNPY-1604] Introduced dry_run flag and list_acl method for ACL management (#1207)
• [SYNPY-1244] Implemented recursive ACL deletion and permission inheritance detection (#1200, #1202)

Bug Fixes

• [SYNPY-1581] Removed exception logging and raising in async methods (#1203)

Tech Debt

• [SYNPY-1295] Trimmed down integration tests and combined similar logic (#1199)
• [SYNPY-1606] Added OpenTelemetry metrics for file uploads, downloads, and MD5 calculations (#1204)
• [SYNPY-1618] Added scripts for cleaning up test resources in Synapse (#1209)
• [SYNPY-1599] Patched JSON schema code and improved examples (#1211)

New Contributors

• @SageGJ made their first contribution in #1203
• @carmmmm made their first contribution in #1183

Full Changelog: v4.8.0...v4.9.0-rc

v4.8.0

Highlights

• Introduced new object-oriented models for working with Synapse Datasets, DatasetCollections, EntityViews, MaterializedViews, and SubmissionViews. This includes tutorials for each of these models.
• Improved handling of progress bars, logging, and error messages
• Added support for Python 3.13
• Patch CWE-444

Features

• [SYNPY-1571] Adds Dataset Model & Introduces Composition Model for Table/View-like Classes by @BWMac in #1175
• [SYNPY-1575] Introduce EntityView model by @BryanFauble in #1181
• [SYNPY-1579] Introduce the materialized view by @BryanFauble in #1190
• [SYNPY-1578] DatasetCollection OOP Model by @BWMac in #1189
• [SYNPY-1577] Submission View by @BryanFauble in #1192

Bug Fixes

• [SYNPY-1547] parentWikiId="" Bug by @BWMac in #1165
• [SYNPY-1553] Update to support python 3.13 by @BryanFauble in #1171
• [SYNPY-1575] Correct regular expression for invalid column name by @BryanFauble in #1187
• [SYNPY-1584] Add a buffer.tell when truncating bytes during dataframe upload and drop writing header to csv by @BryanFauble in #1193

Tech Debt

• [SYNPY-1488] Patch nested tqdm progress bars and messages to logger by @BryanFauble in #1177
• [SYNPY-1551] Tables refactor by @BryanFauble in #1151
• [SYNPY-1497] refactored version check to use Pypi for version info by @andrewelamb in #1191

Other

• Update the docstring for setPermissions to be clearer by @BryanFauble in #1164
• Update Dockerfile - Fixes pandas installation by @BWMac in #1169
• [SYNPY-1570, SYNPY-1555] Support passing user_agent to the Synapse class constructor, and HTTPX Library usage by @BryanFauble in #1170
• Prevent concurrent builds per branch by @BryanFauble in #1178
• [DPE-1253] Add PR template for GH Pull requests by @BryanFauble in #1182
• [SYNPY-1542] Upgrade readthedocs os, python version, and search ranking by @BryanFauble in #1184
• [SYNPY-1553] Removes Blank Auth Header by @BWMac in #1185
• Include a default timeout for HTTP requests library to 70 seconds by @BryanFauble in #1188
• Add table and file versioning tutorial updates by @rxu17 in #1172
• Updates dataset tutorial to fix typo by @BWMac in #1186
• Create SECURITY.md by @thomasyu888 in #1166

New Contributors

• @andrewelamb made their first contribution in #1191

Full Changelog: v4.7.0...v4.8.0-rc

v4.7.0

Highlights

• Added functionality for interacting with Synapse Agents:
  • The new Agent OOP model allows you to chat with the baseline Synapse Agent,
    register and chat with custom Synapse Agents, manage multiple chat sessions and more.
  • See the Agent documentation for more details and example code to get started.

What's Changed

• [SYNPY-1544] Synapse Agent OOP Model by @BWMac in #1152
• [SYNPY-1544] Fixes docstring by @BWMac in #1155
• Removes example setting annotations with Agent class by @BWMac in #1156
• [SYNPY-1557] Sync a Linked Folder Bug by @BWMac in #1157
• [SYNPY-1544] Return the AgentPrompt when calling the prompt function by @BryanFauble in #1158

Full Changelog: v4.6.1...v4.7.0