v3.1.0

What's Changed

• [SYNPY-49] Aggregate acl based on groups by @BryanFauble in #979
• [SYNPY-967] deprecated memoize and added @lru_cache by @BryanFauble, @linglp in #983
• SYNPY-1285: Create pipfile by @BryanFauble in #984
• [SYNPY-1282] Adds Type Hinting to client.py by @BWMac in #987
• [SYNPY-1293] Update urllib3 version dependency by @BryanFauble in #988
• [SYNPY-1283] Replace Broken Link URL by @BWMac in #989
• [SYNPY-1296] Config client error with api key or PAT by @BryanFauble in #990* * [SYNPY-1283] Adds Missing Trailing Space (Broken Link Fix) by @BWMac in #991
• [SYNPY-1295] Adding to the credentials.rst doc by @BryanFauble in #992

New Contributors

• @BryanFauble made their first contribution in #979
• @BWMac made their first contribution in #987

Full Changelog: v3.0.0...v3.1.0-rc

v3.0.0

What's Changed

• update name of utils function: is_synapse_id by @vpchung in #949
• SYNPY-1248: add is_synapse_id function to the client by @vpchung in #950
• [SYNPY-1241] Don't remove files from downloadCart if empty list of files by @thomasyu888 in #944
• [SYNPY-1242] Refactor _loggedIn function by @thomasyu888 in #945
• [SYNPY-1246] Add Python 3.11 support by @thomasyu888 in #951
• [SYNPY-737] Remove non-standard single dash long cli parameters by @thomasyu888 in #883
• [SYNPY-1255] Update pandas to support 2.0 and deprecate support for python 3.7 by @thomasyu888 in #954
• [SYNPY-1266] Add support for GCP bucket by @thomasyu888 in #959
• [SYNPY-1229, SYNPY-1230, SYNPY-1231] Lint synapseclient and synapseutils by @thomasyu888 in #961
• Add pre-commit by @thomasyu888 in #963
• [SYNPY-1227] Lint all code with black by @thomasyu888 in #965
• [SYNPY-570] Make sure warning doesn't appear ifcollision is overwrite.local by @thomasyu888 in #967
• [SYNPY-622] Improve evaluation.py syntax by @thomasyu888 in #968
• [SYNPY-1269] Edit synapse config file to use auth token and edit tests by @thomasyu888 in #970
• [Bug fix]: Fixed test related to pandas issue on window 2019 by @linglp in #971
• [SYNPY-1270] Deprecated parameter date_parser to support pandas2.0.0 and above by @linglp in #973
• [SYNPY-1199] Implement low-level functions for JSON Schema API by @BrunoGrandePhD in #894
• pkg_resources is a deprecated API - replace with importlib.resources by @thomasyu888 in #975
• [SYNPY-645] improve file entity name docs by @thomasyu888 in #969
• [SYNPY-716] Remove asInteger() feature by @thomasyu888 in #962
• Clean up setup.py by using setup.cfg by @thomasyu888 in #974
• [SYNPY-1213, SYNPY-1245] Improve doc site by @thomasyu888 in #946

New Contributors

• @linglp made their first contribution in #971

Full Changelog: v2.7.2...v3.0.0

v3.0.0-rc

What's Changed

• update name of utils function: is_synapse_id by @vpchung in #949
• SYNPY-1248: add is_synapse_id function to the client by @vpchung in #950
• [SYNPY-1241] Don't remove files from downloadCart if empty list of files by @thomasyu888 in #944
• [SYNPY-1242] Refactor _loggedIn function by @thomasyu888 in #945
• [SYNPY-1246] Add Python 3.11 support by @thomasyu888 in #951
• [SYNPY-737] Remove non-standard single dash long cli parameters by @thomasyu888 in #883
• [SYNPY-1255] Update pandas to support 2.0 and deprecate support for python 3.7 by @thomasyu888 in #954
• [SYNPY-1266] Add support for GCP bucket by @thomasyu888 in #959
• [SYNPY-1229, SYNPY-1230, SYNPY-1231] Lint synapseclient and synapseutils by @thomasyu888 in #961
• Add pre-commit by @thomasyu888 in #963
• [SYNPY-1227] Lint all code with black by @thomasyu888 in #965
• [SYNPY-570] Make sure warning doesn't appear ifcollision is overwrite.local by @thomasyu888 in #967
• [SYNPY-622] Improve evaluation.py syntax by @thomasyu888 in #968
• [SYNPY-1269] Edit synapse config file to use auth token and edit tests by @thomasyu888 in #970
• [Bug fix]: Fixed test related to pandas issue on window 2019 by @linglp in #971
• [SYNPY-1270] Deprecated parameter date_parser to support pandas2.0.0 and above by @linglp in #973
• [SYNPY-1199] Implement low-level functions for JSON Schema API by @BrunoGrandePhD in #894
• pkg_resources is a deprecated API - replace with importlib.resources by @thomasyu888 in #975
• [SYNPY-645] improve file entity name docs by @thomasyu888 in #969
• [SYNPY-716] Remove asInteger() feature by @thomasyu888 in #962
• Clean up setup.py by using setup.cfg by @thomasyu888 in #974
• [SYNPY-1213, SYNPY-1245] Improve doc site by @thomasyu888 in #946

New Contributors

• @linglp made their first contribution in #971

Full Changelog: v2.7.2...v3.0.0-rc

v2.7.2

What's Changed

• [SYNPY-1267] Lock down urllib3 by @thomasyu888 in #958
• [SYNPY-1268] Add deprecation warning for non-supported login arguments by @thomasyu888 in #960

Full Changelog: v2.7.1...v2.7.2

v2.7.1

What's Changed

• Mint patch release: Lock down pandas version since pandas >1.5 doesn't work by @thomasyu888 in #955
• [SYNPY-1257] Hotfix - upgrade github actions by @thomasyu888 in #956

Full Changelog: v2.7.0...v2.7.1

v2.7.0

Bug Fixes

• [SYNPY-226] - isConsistent fails as parameter for table query
• [SYNPY-562] - Make sure SQL functions, including "year", are quoted correctly
• [SYNPY-1031] - File version increments with 400 client error
• [SYNPY-1219] - Update Entity class to be compatible with the new Dataset entity
• [SYNPY-1224] - Correct SynapseUnmetAccessRestrictions message
• [SYNPY-1237] - as_table_columns function is mishandling mixed data types

Stories

• [SYNPY-63] - py: use metaclass to replace the _entity_type_to_class hack
• [SYNPY-992] - synapseutils changeFileMetadata missing syn parameter docstring
• [SYNPY-1175] - Programmatic Support for Download V2 via Py Client
• [SYNPY-1193] - Support Datasets functionality
• [SYNPY-1221] - Set up gh-action: black, the python auto formatter on the python client

Sub-Tasks

• [SYNPY-1207] - Support syn.get() on a dataset

Tasks

• [SYNPY-566] - Clarify expected list format for sync manifest
• [SYNPY-1053] - Increase documentation of forceVersion in syncToSynapse
• [SYNPY-1145] - Link to manifest format in CLI sync command usage help
• [SYNPY-1226] - Leverage ViewBase for Datasets instead of SchemaBase
• [SYNPY-1235] - Create codeql scanning workflow

Contributors

• @danlu1
• @thomasyu888
• @allaway
• @vpchung

New Contributors

• @vpchung made their first contribution in #914

Full Changelog: v2.6.0...v2.7.0

v2.6.0

Bug Fixes

• [SYNPY-1204] - Python 3.10 compatibility

Stories

• [SYNPY-728] - Improve error message when pandas is not available
• [SYNPY-974] - Documentation for generateManifest
• [SYNPY-1209] - Support for MaterializedViews in Py Client

Tasks

• [SYNPY-1174] - Add function to create Synapse config file
• [SYNPY-1176] - syncToSynapse aborted + silent failure of file upload
• [SYNPY-1184] - Add includeTypes to synapseutils.walk()
• [SYNPY-1189] - Document "maximumListLength" parameter for Column
• [SYNPY-1196] - Expose forceVersion on changeFileMetadata
• [SYNPY-1205] - Python 3.6 EOL - Remove support for 3.6
• [SYNPY-1212] - Include dataset as an entity type to return in getChildren()

Contributors: @danlu1 , @BrunoGrandePhD , @thomasyu888

Full Changelog: v2.5.1...v2.6.0-rc

v2.6.0-rc

Bug Fixes

• [SYNPY-1204] - Python 3.10 compatibility

Stories

• [SYNPY-728] - Improve error message when pandas is not available
• [SYNPY-974] - Documentation for generateManifest
• [SYNPY-1209] - Support for MaterializedViews in Py Client

Tasks

• [SYNPY-1174] - Add function to create Synapse config file
• [SYNPY-1176] - syncToSynapse aborted + silent failure of file upload
• [SYNPY-1184] - Add includeTypes to synapseutils.walk()
• [SYNPY-1189] - Document "maximumListLength" parameter for Column
• [SYNPY-1196] - Expose forceVersion on changeFileMetadata
• [SYNPY-1205] - Python 3.6 EOL - Remove support for 3.6
• [SYNPY-1212] - Include dataset as an entity type to return in getChildren()

Contributors: @danlu1 , @BrunoGrandePhD , @thomasyu888

Full Changelog: v2.5.1...v2.6.0-rc

v2.5.1

Bug Fixes

• [SYNPY-1197] - Schema is a string and strings don't have columns_to_store attributes

Stories

• [SYNPY-772] - update statement that appears on PyPi about Synapse to be consistent
• [SYNPY-997] - Typos in Views documentation

Contributors: @thomasyu888, @danlu1

New Contributors

• @danlu1 made their first contribution in #892

GitHub Changelog: v2.5.0...v2.5.1

v2.5.0

Highlights

• Added ability to generate a manifest file from your local directory structure.

  # from the command line
  # write the manifest to manifest.tsv
  synapse manifest --parent-id syn123 --manifest-file ./manifest.tsv /path/to/local/directory
  # stdout
  synapse manifest --parent-id syn123 /path/to/local/directory
  

• Added ability to pipe manifest stdout into sync function.

  # from the command line
  synapse manifest --parent-id syn123 ./docs/ | synapse sync -
  

• Added ability to return summary statistics of csv and tsv files stored in Synapse.

  # from python
  import synapseclient
  import synapseutils
  syn = synapseclient.login()
  statistics = synapseutils.describe(syn=syn, entity="syn12345")
  print(statistics)
  {
      "column1": {
          "dtype": "object",
          "mode": "FOOBAR"
      },
      "column2": {
          "dtype": "int64",
          "mode": 1,
          "min": 1,
          "max": 2,
          "mean": 1.4
      },
      "column3": {
          "dtype": "bool",
          "mode": false,
          "min": false,
          "max": true,
          "mean": 0.5
      }
  }
  

• Next major release (3.0.0) there will be major cosmetic changes to the cli such as removing all camel case or non-standard single dash long command line interface (cli) parameters.
  Example: command line arguments like -parent will become --parent. Commands that support camel case like --parentId will be changed to --parent-id.

Bug Fixes

• [SYNPY-669] - Signing of Synapse authentication header does not correctly URL encode the URL path
• [SYNPY-770] - Files failing to upload using syncToSynapse
• [SYNPY-1123] - All tables erroring when indexing
• [SYNPY-1146] - Error writing Booleans from Python dataframes into Boolean columns in a Synapse table
• [SYNPY-1156] - datetimes in a Pandas dataframe are not properly stored to Synapse

Stories

• [SYNPY-726] - mirror local folder structure for bulk upload
• [SYNPY-1163] - Expose synId with syn get -r
• [SYNPY-1165] - Generate manifest template from local folder structure
• [SYNPY-1167] - Support for Quick Summary Statistics on CSV and TSV files

Tasks

• [SYNPY-1169] - Integration tests failures in develop branch against stack-371
• [SYNPY-1172] - Passing a pandas dataframe with a column called "read" breaks the type parsing in as_table_columns()
• [SYNPY-1173] - Support DATE_LIST, ENTITYID_LIST, USERID_LIST table columns
• [SYNPY-1188] - Support piping of synapse manifest stdout in synapse sync function

@jkiang13, @linchiahuisage, @esurface, @thomasyu888, @BrunoGrandePhD, @mattfazza

New Contributors

• @esurface made their first contribution in #876
• @mattfazza made their first contribution in #877

Full Changelog: v2.4.0...v2.5.0