Skip to content

Commit 848fe03

Browse files
authored
Merge pull request #158 from aditosoftware/improve-name-and-icon
fix: Changed icon and name to better reflect that this extension does not rewrite Liquibase, but instead uses Liquibase CLI in version 4
2 parents 8132aee + c0833b9 commit 848fe03

18 files changed

+56
-1220
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ eslint-results.json
1212

1313
# misc
1414
.DS_Store
15+
.idea
1516

1617
# locally downloaded jar files during devolopment
1718
src/resources/**/*.jar

CHANGELOG.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@ All notable changes to the "Liquibase" extension will be documented in this file
44

55
The format is based on [Keep a Changelog](http://keepachangelog.com/) and and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
66

7+
## 1.2.0
8+
9+
### Changed
10+
11+
- Changed icon and name to better reflect that this extension does not rewrite Liquibase, but instead uses Liquibase CLI in version 4
12+
- Upgraded some dependencies
13+
714
## 1.1.1
815

916
### Added

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2024 ADITO Software GmbH http://www.adito.de
3+
Copyright (c) 2024-2025 ADITO Software GmbH http://www.adito.de
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 22 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,24 @@
22
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=aditosoftware_vscode-liquibase&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=aditosoftware_vscode-liquibase)
33
[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=aditosoftware_vscode-liquibase&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=aditosoftware_vscode-liquibase)
44

5-
# Liquibase
5+
# Liquibase 4 Integration for Visual Studio Code
66

77
A Visual Studio Code extension that supports executing [Liquibase commands](https://docs.liquibase.com/commands/command-list.html) without needing to use the command line.
8+
It invokes the official Liquibase command-line tool to run commands; it does not reimplement Liquibase itself.
9+
810

911
You can also create and edit [`liquibase.properties`](https://docs.liquibase.com/concepts/connections/creating-config-properties.html) files, which are used as a foundation for any command execution.
1012

13+
## Disclaimer
14+
15+
This extension integrates Liquibase with VS Code.
16+
17+
Liquibase® is a registered trademark of Liquibase, Inc.
18+
19+
This project is not affiliated with or endorsed by Liquibase, Inc.
20+
21+
Liquibase is licensed separately under the Functional Source License (FSL-1.1).
22+
1123
## Getting started
1224

1325
You can also get a brief overview of the extension with our **Walkthrough**.
@@ -32,7 +44,7 @@ All commands can be accessed from the "Liquibase" item in the status bar.
3244

3345
![Status bar item of Liquibase Extension](/media/walkthrough/statusBar.png)
3446

35-
You can also access all commands by using the the command palette. It can be accessed with the keyboard shortcut <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>).
47+
You can also access all commands by using the command palette. It can be accessed with the keyboard shortcut <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>).
3648

3749
If you execute any command, you notice a general pattern of inputs. You will be always asked the following steps in this order:
3850

@@ -41,11 +53,13 @@ If you execute any command, you notice a general pattern of inputs. You will be
4153
3. Select the **contexts**. Some commands allow you to filter the changelogs by contexts. See ["Executing commands with and without contexts"](#executing-commands-with-and-without-contexts) for more details.
4254
4. Any **additional options** you need to give before you can execute the command.
4355

56+
The extension passes the selected options to the Liquibase CLI and executes the corresponding command.
57+
4458
Some commands are accessible from the context menu. The context menu is available for all `xml`, `json`, `yaml`, `yml` and `sql` files, because those are the languages where you can write Liquibase changelogs. All commands are found in the _"Liquibase"_ sub menu. When executing a command from the context menu, it will use the current file as your changelog.
4559

4660
## Supported Liquibase Commands
4761

48-
Currently, the following Liquibase commands are supported:
62+
Currently, the following Liquibase commands are supported via the Liquibase CLI:
4963

5064
> **Tip:** The link on the command itself will lead you to the Liquibase documentation. This will give you a better understanding of the technical details of each command.
5165
>
@@ -87,7 +101,7 @@ If you want to control the storage location of the overview output, you can use
87101

88102
### Executing commands with and without contexts
89103

90-
Many liquibase commands can be executed with a context. After a connection and a changelog file was selected, you might be prompted with a context selection. There you have different options:
104+
Many Liquibase commands can be executed with a context. After a connection and a changelog file was selected, you might be prompted with a context selection. There you have different options:
91105

92106
- **Use any of the recently loaded contexts**: This will give you **all contexts that were recently loaded** by "Load all contexts from the changelog file". You should use this option, if you want to use contexts and these have not changed from any recently loaded contexts. This option is only visible, if cached contexts are there.
93107
- **Load all contexts from the changelog file**: This will **parse and read all changelog files** based on your root changelog file. Anytime you load new contexts, the old ones for this connection will be discarded. This option should be used, if you never have loaded your contexts before or your contexts have changed from any recently loaded context and you want to execute the query with contexts.
@@ -97,9 +111,9 @@ Both "Load all contexts from the changelog file" and "Use any of the recently lo
97111

98112
The recently loaded contexts are saved per database connection. That means, if you have three connections, then you have three sections of the contexts. For more information regarding caching, see [the caching section](#caching).
99113

100-
## Converting changelogs from one liquibase format to another format
114+
## Converting changelogs from one Liquibase format to another format
101115

102-
With the two commands `Liquibase: Converts a file from one liquibase format to another` and `Liquibase: Converts a folder from one liquibase format to another`, you can convert changelogs from one format to another.
116+
With the two commands `Liquibase: Converts a file from one Liquibase format to another` and `Liquibase: Converts a folder from one Liquibase format to another`, you can convert changelogs from one format to another.
103117

104118
> **NOTE:** It is very important, that you check to produced results by the command. We do not guarantee the completeness and correctness of the files.
105119
@@ -122,6 +136,6 @@ You can remove any values from the cache with the `Liquibase: Cache: Remove any
122136

123137
## View logs
124138

125-
This extension write to the output. It can be viewed by executing the command `Output: Focus on Output View` and then selecting the channel _"Liquibase"_.
139+
This extension writes to the output. It can be viewed by executing the command `Output: Focus on Output View` and then selecting the channel _"Liquibase"_.
126140

127-
Logs will be also written to a log folder on your OS. You can reach the log folder by executing the command `Developer: Open Extension Logs Folder` and then navigating to the liquibase folder.
141+
Logs will be also written to a log folder on your OS. You can reach the log folder by executing the command `Developer: Open Extension Logs Folder` and then navigating to the folder containing the log files.

media/icons/extension-icon.png

3.43 KB
Loading

media/icons/liquibase-logo.svg

Lines changed: 0 additions & 3 deletions
This file was deleted.

media/icons/liquibase_logo.png

-7.5 KB
Binary file not shown.

media/walkthrough/statusBar.png

-4.39 KB
Loading
-8.27 KB
Loading

0 commit comments

Comments
 (0)