v1.5.5

v1.5.5 - Just squashing some bugs..

🛠️ Added

• allow the CS Tools bootstrapper to hop through a proxy (_bootstrapper.py --proxy)

🔧 Modified

• enforce only Basic Authentication for Falcon Syncer and remote tsload operations

🐛 Bugfix

• fix for #127 | sqla-redshift has incorrect version
• fix for case-sensitivity of orgId in the searchable bi-server data pull
• fix for when Orgs is not enabled on Software deployments in the searchable bi-server data pull
• fix for searchable deploy not reporting errors properly
• fix for display configs in git config

📜 Documentation

• clarify optionality and default parameters on Snowflake Syncer

🫀 CS Tools Internals

• removed some dead code

---

This is part of the major 1.5.0 series of releases, read about it in Our Documentation.

---

**1.5.4 yanked 😬

Full Changelog: v1.5.3...v1.5.5

v1.5.3

v1.5.3 - New Syncers!

🛠️ Added

• #121 | Databricks Syncer from @SameerJain901 ( First Contributor! ✨ )
• #102 | Redshift Syncer from @saurabhsingh1608 ( First Contributor! ✨ )
• Mock Syncer, simply use --syncer mock:// to print all DDL operations on a command
• #84 | Add Support for defining a proxy in config files (format: http://[<username>:<password>]@<host>:<port>)

🔧 Modified

• CSV , JSON , Parquet Syncers will now automatically create their directory and warn if it does not yet exist
• Snowflake Syncer will now treat empty values as NULL
• hid more secrets from log files
• config creation/modification will now prompt for your password if you specify --password prompt (compat back to 1.4.x series)
• you may now override --temp-dir in commands (compat back to 1.4.x series)

🐛 Bugfix

• fix for deleted auto-generated synonyms polluting TS_COLUMN_SYNONYM
• fix for syncer errors showing incorrect documentation links
• fix for certain environments not supporting site customization
• fix for searchable deploy improperly customizing TML other than Snowflake connections
• fix for #124 | compression errors on secrets
• fix for user-management rename | sync commands not recognizing the underlying data model
• fix for some commands missing their --help option
• fix for bulk-sharing cls-ui not recognizing the provided port number
• hotfix: some new caching behavior misses

❎ Removed

• personalization settings used to demo Worksheet Column Utilization during beta
• #123 | removed mention of cs_tools self pip internal command from @paulkaefer ( First Contributor! ✨ )

🫀 CS Tools Internals

• Github Actions / CI should trigger less often, more meaningfully
• apparently sys.base_prefix is a lie :) .. switch to sys.executable for CS Tools virtual env creation
• switch Windows install documentation from Invoke-WebRequest to Invoke-RestMethod for more reliability
• enforce Powershell usage on Windows install documentation
• warn users when bootstrapping from an Anaconda environment

---

This is part of the major 1.5.0 series of releases, read about it in Our Documentation.

---

**1.5.2 yanked 😬

Full Changelog: v1.5.1...v1.5.3

v1.5.1

v1.5.1 - Primarily Bugfixes

🐛 Bugfix

• fix for SpotApp handling on Falcon
• fix for processing unhandled arguments in scriptability

❎ Removed

• interactive mode for configuration file definitions

🫀 CS Tools Internals

• syncing the underlying dependencies has been limited to thoughtspot_tml
• searchable.gather should have better backwards compatability with the rename searchable.metadata
• fix for some internal datastructures references

---

This is part of the major 1.5.0 series of releases, read about it in Our Documentation.

---

Full Changelog: v1.5.0...v1.5.1

v1.5.0

v1.5.0 - Lots of Organization

Read about the whole release in Our Documentation.

🛠️ Added

• support for ThoughtSpot Orgs in Config file
• cs_tools self sync - to align the underlying dependencies without requiring an update of CS Tools itself
• a new tool for interacting with the ThoughtSpot Git APIs
• support pulling from ENVIRONMENT_VARIABLES for the CS Tools config
• CS Tools Searchable additional tables (TS_CLUSTER , TS_DATA_SOURCE , TS_ORG, TS_XREF_ORG)
• CS Tools Searchable Spot App: Worksheet Column Utilization
• CS Tools Searchable Spot App: ThoughtSpot Adoption

🔧 Modified

• noisiness of the analytics capture ~ now with more silence ~
• gave cs_tools tools bulk-deleter a confirmation gate so users don't accidentally delete large quantities of content

🐛 Bugfix

• tons of minor fixes for Scriptability and parent library thoughtspot_tml
• fix for #63 , #64 , #66 , #71 , #72 , #81 , #93 , #94 , #95
• bugfixes to [optional] analytics data capture

❎ Removed

• temporarily removed BigQuery Database Syncer
• all private APIs have been removed from CS Tools

🫀 CS Tools Internals

• added support for V2.0 REST APIs
• the minimum supported version of ThoughtSpot is now 9.0.1
• switched to pytest framework for testing
• switched to ruff for code quality
• separated the cs_tools core from the cs_tools CLI
• bump python version to 3.9, adding support through the latest version
• bump httpx >= 0.27.0
• bump pydantic >= 2.6.4
• bump sqlmodel >= 0.0.16 (sqlalchemy >= 2.0.0)
• bump typer >= 0.12.0
• bump pendulum >= 3.0.0

---

Full Changelog: v1.4.16...v1.5.0

v1.4.16

It's been nearly a year since our last major release, and this one huuuge one!

Read about the whole release in Our Documentation.

---

1.4.x Series Changelog

v1.4.0

🛠️ Added

• cs_tools self - perform operations on CS Tools itself
• Programmatic access to CS Tools via cs_tools.programmatic.get_cs_tool(name: str) -> CSTool
• More Archiver selection and filtering criteria
• V1 of the Searchable ThoughtSpot SpotApp
• Allow transfer of dataflow jobs to User Management transfer-ownership
• Syncers can be configured at runtime, directly on the command line

🔧 Modified

• The minimum supported version of ThoughtSpot is now 8.4.1
• Significant performance gains to Archiver, Searchable, User Management
• Renamed Security Sharing to Bulk Sharing
• Syncers now defer table creation until the first execution
• Increased readability of all Command Line screens and Errors

🐛 Bugfix

• Tons of minor fixes for Scriptability and parent library thoughtspot_tml
• Handle empty response to and from Syncers
• Fix typo in security API endpoint
• Fix virtual environment creation for Microsoft Store Python installs

❎ Removed

• All private APIs have been removed from CS Tools

🫀 CS Tools Internals

• Bump python version to 3.7, adding support through the latest version
• Bump typer >= 0.0.8 and rich >= 13.0.0
• Bump thoughtspot_tml version to >= 2.0.0
• Separated cs_tools[cli] (the application) from cs_tools (the library)
• Much of the Documentation is now auto-generated from the latest CLI
• Replaced poetry with setuptools because of poetry#6314 drama
• CS Tools manages its own Virtual Environment more appropriately long-term now

---

v1.4.1 - 1.4.4 - Bugfixes

• Scriptability bugfixes
• Typing compat for py37
• Documentation image relative links
• Documentation tpyos
• Documentation image relative links (actually this time)
• Fix for Snowflake Syncer schema attribute not being parsed
• Remove pynput and horde as dependencies
• Don't create app_dir unless we're building a CS Tools venv

Full Changelog: v1.4.0...v1.4.4

---

v1.4.5 - 1.4.7 - CS Tools Internals

• enable CS Tools team to generate an offline distributable
• remove unnecessary raise from Archiver
• handle internal database errors better
• fix for #63 verbose errors report UnboundLocalError
• cs_tools.utils.chunker doesn't care about input data type, as long as it's iterable
• fix for GET user fails, order is maintained in User Management -rename
• add support for user caching in User Management -rename and -sync
• fix for pydantic#4011

Full Changelog: v1.4.4...v1.4.7

---

v1.4.8 - v1.4.9 - Bugfixes

• fix for #64 - syncer cannot be optional
• bump thoughtspot_tml --> v2.0.5
• run cs_tools as a python module (access to the cli only)
• analytics fixes

Full Changelog: v1.4.8...v1.4.9

---

v1.4.10 - Scriptability v3.0

Major rewrite of Scriptability, breaking backwards compatibility, introducing a new folder structure for exports and imports, a new mapping file format, and strict naming conventions.
❗ If you have older version of scriptability-exported content, please re-export use the new structure ❗

Full Changelog: v1.4.9...v1.4.10

---

v1.4.11 - Bugfixes

• fix for #71 - type_from_friendly_type typo
• fix for #72 - extra types empty causes error
• fix for user-management rename

Full Changelog: v1.4.10...v1.4.11

---

v1.4.12 - Bugfixes

• hotfix for changes to the internal API HTTP client structure (prep for V2 support)

Full Changelog: v1.4.11...v1.4.12

---

v1.4.13 - Git Tool

• [BETA] a new tool for interacting with the ThoughtSpot git APIs is out now!
• fix for #66 - sorting on cs_tools config show
• fix for internally reported - archiver identify --only-groups / --ignore-groups not respecting some groups
• fix for internally reported - metadata/tml/export middleware failing silently on API timeouts

Full Changelog: v1.4.12...v1.4.13

---

v1.4.14 - Bugfixes

• [BETA] a new tool for interacting with the ThoughtSpot git APIs is out now!
• fix for #81 - archiver commands have better context on the underlying table
• fix for #93 - restrict pendulum < 3.0.0
• fix for transitive dependency resolution within the CS Tool virtual environment

Full Changelog: v1.4.13...v1.4.14

---

v1.4.15 - Bugfixes

• fix for #94 - unknown privileges fail gracefully
• fix for #95 - restrict sqlalchemy < 2.0.0

Full Changelog: v1.4.14...v1.4.15

v1.4.16 - Bugfixes

• internal fixes

Full Changelog: v1.4.15...v1.4.16

v1.3.4

🛠️ Added

• more scriptability improvements

🔧 Modified

• limit for returned objects in metadata/list

🐛 Bugfix

• fix for Archiver not using public tagging endpoints
• fix for required optional color on Tag (TS_TAG)
• fix for some dead links in docs
• fix for invalid Falcon Syncer timeout when supplied with a 0s timeout value

🫀 CS Tools Internals

• added offline support for win32 platform

v1.3.3

🛠️ Added

• lots of scriptability improvements
• timeout allowed on all Falcon operations

🔧 Modified

• some typo fixes and os-specific changes to tutorial
• support for the M1 chipset in the offline installer
• more graceful handling of errors
• user-management sync now has a clearer option for --dont-remove-deleted/--remove-deleted

🐛 Bugfix

• fix for when tags are missing their colors
• fix for bad enum value on extractor
• fix for ambiguous content search
• fix for content missing authors due to Falcon/Callosum errors
• fix for broken help command

🫀 CS Tools Internals

• automatic version-bump
• fix debug logging for outgoing http requests
• added warning for M1 Chip Users (workaround for #29 until remote installs are allowed)
• added .zprofile as a target for shell profile PATH envvar addition

v1.3.2 - xkcd#1987

🐛 Bugfix

• gracefully handle more configuration errors

💖 CS Tools Internals

• hopefully, we've fixed the dependency hell that is python local installs
• new installer
• new tutorial
• cli has friendlier errors
• remove lots of dead code

v1.3.1

🐛 Bugfix

• user-management sync --apply-changes now actually does something
• remote tql workflows now honor deactivated load balancers

💖 CS Tools Internals

• cli has more color to it
• formalize CSTool concept for future modularity
• add a beta flag so tools can release more often
• remove lots of dead code

🧹 Spring Cleaning

This release of the tools bring a lot of much-needed organization and cleanup. v1.3.0 comes the week before our annual customer conference, Beyond 2022. Along with plenty of cleanup, we have an official release on ThoughtSpot Community as well as Knowledge Articles on how to implement tools to achieve certain objectives.

Another big change in this release is the provisional release of Syncers. Syncers allow CS Tools to interact with a data storage layer without having to know the explicit details of how to do so. We've implemented syncers to many popular data storage formats. Head on over to the documentation page to learn more about them!

We've also released new tools for Scriptability, bulk User Management, and the Searchable family of tools have been vastly improved as well.

Head on over to the docs site for all the details:
https://thoughtspot.github.io/cs_tools/changelog/1.3.0/