msnoisedb 0.1.4__tar.gz

msnoisedb-0.1.4/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

msnoisedb-0.1.4/.github/environment.yml

@@ -0,0 +1,10 @@
+name: test
+channels:
+  - conda-forge
+  - defaults
+dependencies:
+  - click
+  - pymysql
+  - postgresql
+
+

msnoisedb-0.1.4/.github/workflows/publish.yml

@@ -0,0 +1,125 @@
+name: Publish to PyPI
+
+# Triggered on every published GitHub Release.
+#
+# Routing logic:
+#   - ALL releases  → TestPyPI  (alphas, betas, RCs, final)
+#   - Stable only   → PyPI      (tags matching vN.N.N exactly, e.g. v1.2.3)
+#
+# "Stable" is defined by the regex  ^v[0-9]+\.[0-9]+\.[0-9]+$
+# Pre-releases (v1.0.0a1, v1.0.0rc2, v1.0.0.post1, …) go to TestPyPI only.
+#
+# No API tokens required — OIDC trusted publishing handles authentication.
+#
+# One-time setup (already done):
+#   PyPI    → Trusted Publisher: ROBelgium/msnoise-db, publish.yml, env=pypi
+#   TestPyPI→ Trusted Publisher: ROBelgium/msnoise-db, publish.yml, env=testpypi
+#   GitHub  → Settings → Environments → "pypi" + "testpypi" created
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  # ── 1. Build sdist + wheel ────────────────────────────────────────────────
+  build:
+    name: Build distribution packages
+    runs-on: ubuntu-latest
+
+    outputs:
+      is_stable: ${{ steps.check_tag.outputs.is_stable }}
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0        # setuptools-scm needs full history for version
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install build tooling
+        run: python -m pip install --upgrade pip build twine
+
+      - name: Check whether this is a stable release tag (N.N.N)
+        id: check_tag
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          echo "Tag: $TAG"
+          if [[ "$TAG" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "is_stable=true" >> "$GITHUB_OUTPUT"
+            echo "→ stable release, will publish to PyPI"
+          else
+            echo "is_stable=false" >> "$GITHUB_OUTPUT"
+            echo "→ pre-release tag, TestPyPI only"
+          fi
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Check dist contents
+        run: |
+          twine check dist/*
+          ls -lh dist/
+
+      - name: Upload dist as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  # ── 2. Publish to TestPyPI (every release) ───────────────────────────────
+  publish-testpypi:
+    name: Publish to TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/msnoisedb
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          print-hash: true
+
+  # ── 3. Publish to PyPI (stable releases only: vN.N.N) ────────────────────
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [build, publish-testpypi]
+    if: needs.build.outputs.is_stable == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/msnoisedb
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true

msnoisedb-0.1.4/.github/workflows/test_linux.yml

@@ -0,0 +1,67 @@
+name: Test install - all OS
+
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: '0 0 * * 1'
+
+jobs:
+  run_tests:
+    runs-on: ${{ matrix.os }}
+    if: |
+      !contains(github.event.head_commit.message, '+ONLYDOCS') &&
+      !contains(github.event.head_commit.message, '+NOFULLTEST')
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12']
+        os: [macos-latest, ubuntu-latest, windows-latest]
+        include:
+          - os: ubuntu-latest
+            label: linux-64
+            prefix: /usr/share/miniconda3/envs/test
+
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v4
+      - name: Get current date
+        id: date
+        run: echo "::set-output name=date::$(date +'%Y-%m-%d')"
+
+      - uses: conda-incubator/setup-miniconda@v3.1.1
+        with:
+          activate-environment: test${{ matrix.python-version }}
+          python-version: ${{ matrix.python-version }}
+
+      - uses: actions/cache@v5
+        with:
+          path: ${{ matrix.prefix }}${{ matrix.python-version }}
+          key: ${{ matrix.label }}-conda-py${{ matrix.python-version }}-${{ hashFiles('.github/environment.yml') }}-${{ steps.date.outputs.date }}-${{ env.CACHE_NUMBER }}
+        env:
+          # Increase this value to reset cache if etc/example-environment.yml has not changed
+          CACHE_NUMBER: 1
+        id: cache
+
+      - name: Update environment
+        run: conda env update -n test${{ matrix.python-version }} -f .github/environment.yml
+        if: steps.cache.outputs.cache-hit != 'true'
+
+      - name: print package info
+        shell: bash -l {0}
+        run: |
+          conda info -a
+          conda list
+
+      - name: Install MSNoise-DB
+        shell: bash -l {0}
+        run: |
+          pip install .
+
+      - name: Test suite
+        shell: bash -l {0}
+        run: |
+          msnoisedb start
+          msnoisedb create-db bubu
+          msnoisedb list-db
+          msnoisedb drop-db bubu
+          msnoisedb stop

msnoisedb-0.1.4/.gitignore

@@ -0,0 +1,29 @@
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+# setuptools-scm generated version file (written at build time, not committed)
+msnoise_db/_version.py
+
+# Old version tracking file (replaced by setuptools-scm)
+msnoise_db/RELEASE-VERSION
+
+# Python
+__pycache__/
+*.py[cod]
+*.so
+.eggs/
+
+# Environments
+.env
+.venv
+env/
+venv/
+
+# IDE
+.vscode/
+.idea/
+
+# postgres data dir (created by msnoisedb start)
+postgres_data/

msnoisedb-0.1.4/LICENSE.TXT

@@ -0,0 +1,287 @@
+                      EUROPEAN UNION PUBLIC LICENCE v. 1.2
+                      EUPL © the European Union 2007, 2016
+
+This European Union Public Licence (the ‘EUPL’) applies to the Work (as defined
+below) which is provided under the terms of this Licence. Any use of the Work,
+other than as authorised under this Licence is prohibited (to the extent such
+use is covered by a right of the copyright holder of the Work).
+
+The Work is provided under the terms of this Licence when the Licensor (as
+defined below) has placed the following notice immediately following the
+copyright notice for the Work:
+
+        Licensed under the EUPL
+
+or has expressed by any other means his willingness to license under the EUPL.
+
+1. Definitions
+
+In this Licence, the following terms have the following meaning:
+
+- ‘The Licence’: this Licence.
+
+- ‘The Original Work’: the work or software distributed or communicated by the
+  Licensor under this Licence, available as Source Code and also as Executable
+  Code as the case may be.
+
+- ‘Derivative Works’: the works or software that could be created by the
+  Licensee, based upon the Original Work or modifications thereof. This Licence
+  does not define the extent of modification or dependence on the Original Work
+  required in order to classify a work as a Derivative Work; this extent is
+  determined by copyright law applicable in the country mentioned in Article 15.
+
+- ‘The Work’: the Original Work or its Derivative Works.
+
+- ‘The Source Code’: the human-readable form of the Work which is the most
+  convenient for people to study and modify.
+
+- ‘The Executable Code’: any code which has generally been compiled and which is
+  meant to be interpreted by a computer as a program.
+
+- ‘The Licensor’: the natural or legal person that distributes or communicates
+  the Work under the Licence.
+
+- ‘Contributor(s)’: any natural or legal person who modifies the Work under the
+  Licence, or otherwise contributes to the creation of a Derivative Work.
+
+- ‘The Licensee’ or ‘You’: any natural or legal person who makes any usage of
+  the Work under the terms of the Licence.
+
+- ‘Distribution’ or ‘Communication’: any act of selling, giving, lending,
+  renting, distributing, communicating, transmitting, or otherwise making
+  available, online or offline, copies of the Work or providing access to its
+  essential functionalities at the disposal of any other natural or legal
+  person.
+
+2. Scope of the rights granted by the Licence
+
+The Licensor hereby grants You a worldwide, royalty-free, non-exclusive,
+sublicensable licence to do the following, for the duration of copyright vested
+in the Original Work:
+
+- use the Work in any circumstance and for all usage,
+- reproduce the Work,
+- modify the Work, and make Derivative Works based upon the Work,
+- communicate to the public, including the right to make available or display
+  the Work or copies thereof to the public and perform publicly, as the case may
+  be, the Work,
+- distribute the Work or copies thereof,
+- lend and rent the Work or copies thereof,
+- sublicense rights in the Work or copies thereof.
+
+Those rights can be exercised on any media, supports and formats, whether now
+known or later invented, as far as the applicable law permits so.
+
+In the countries where moral rights apply, the Licensor waives his right to
+exercise his moral right to the extent allowed by law in order to make effective
+the licence of the economic rights here above listed.
+
+The Licensor grants to the Licensee royalty-free, non-exclusive usage rights to
+any patents held by the Licensor, to the extent necessary to make use of the
+rights granted on the Work under this Licence.
+
+3. Communication of the Source Code
+
+The Licensor may provide the Work either in its Source Code form, or as
+Executable Code. If the Work is provided as Executable Code, the Licensor
+provides in addition a machine-readable copy of the Source Code of the Work
+along with each copy of the Work that the Licensor distributes or indicates, in
+a notice following the copyright notice attached to the Work, a repository where
+the Source Code is easily and freely accessible for as long as the Licensor
+continues to distribute or communicate the Work.
+
+4. Limitations on copyright
+
+Nothing in this Licence is intended to deprive the Licensee of the benefits from
+any exception or limitation to the exclusive rights of the rights owners in the
+Work, of the exhaustion of those rights or of other applicable limitations
+thereto.
+
+5. Obligations of the Licensee
+
+The grant of the rights mentioned above is subject to some restrictions and
+obligations imposed on the Licensee. Those obligations are the following:
+
+Attribution right: The Licensee shall keep intact all copyright, patent or
+trademarks notices and all notices that refer to the Licence and to the
+disclaimer of warranties. The Licensee must include a copy of such notices and a
+copy of the Licence with every copy of the Work he/she distributes or
+communicates. The Licensee must cause any Derivative Work to carry prominent
+notices stating that the Work has been modified and the date of modification.
+
+Copyleft clause: If the Licensee distributes or communicates copies of the
+Original Works or Derivative Works, this Distribution or Communication will be
+done under the terms of this Licence or of a later version of this Licence
+unless the Original Work is expressly distributed only under this version of the
+Licence — for example by communicating ‘EUPL v. 1.2 only’. The Licensee
+(becoming Licensor) cannot offer or impose any additional terms or conditions on
+the Work or Derivative Work that alter or restrict the terms of the Licence.
+
+Compatibility clause: If the Licensee Distributes or Communicates Derivative
+Works or copies thereof based upon both the Work and another work licensed under
+a Compatible Licence, this Distribution or Communication can be done under the
+terms of this Compatible Licence. For the sake of this clause, ‘Compatible
+Licence’ refers to the licences listed in the appendix attached to this Licence.
+Should the Licensee's obligations under the Compatible Licence conflict with
+his/her obligations under this Licence, the obligations of the Compatible
+Licence shall prevail.
+
+Provision of Source Code: When distributing or communicating copies of the Work,
+the Licensee will provide a machine-readable copy of the Source Code or indicate
+a repository where this Source will be easily and freely available for as long
+as the Licensee continues to distribute or communicate the Work.
+
+Legal Protection: This Licence does not grant permission to use the trade names,
+trademarks, service marks, or names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Work and
+reproducing the content of the copyright notice.
+
+6. Chain of Authorship
+
+The original Licensor warrants that the copyright in the Original Work granted
+hereunder is owned by him/her or licensed to him/her and that he/she has the
+power and authority to grant the Licence.
+
+Each Contributor warrants that the copyright in the modifications he/she brings
+to the Work are owned by him/her or licensed to him/her and that he/she has the
+power and authority to grant the Licence.
+
+Each time You accept the Licence, the original Licensor and subsequent
+Contributors grant You a licence to their contributions to the Work, under the
+terms of this Licence.
+
+7. Disclaimer of Warranty
+
+The Work is a work in progress, which is continuously improved by numerous
+Contributors. It is not a finished work and may therefore contain defects or
+‘bugs’ inherent to this type of development.
+
+For the above reason, the Work is provided under the Licence on an ‘as is’ basis
+and without warranties of any kind concerning the Work, including without
+limitation merchantability, fitness for a particular purpose, absence of defects
+or errors, accuracy, non-infringement of intellectual property rights other than
+copyright as stated in Article 6 of this Licence.
+
+This disclaimer of warranty is an essential part of the Licence and a condition
+for the grant of any rights to the Work.
+
+8. Disclaimer of Liability
+
+Except in the cases of wilful misconduct or damages directly caused to natural
+persons, the Licensor will in no event be liable for any direct or indirect,
+material or moral, damages of any kind, arising out of the Licence or of the use
+of the Work, including without limitation, damages for loss of goodwill, work
+stoppage, computer failure or malfunction, loss of data or any commercial
+damage, even if the Licensor has been advised of the possibility of such damage.
+However, the Licensor will be liable under statutory product liability laws as
+far such laws apply to the Work.
+
+9. Additional agreements
+
+While distributing the Work, You may choose to conclude an additional agreement,
+defining obligations or services consistent with this Licence. However, if
+accepting obligations, You may act only on your own behalf and on your sole
+responsibility, not on behalf of the original Licensor or any other Contributor,
+and only if You agree to indemnify, defend, and hold each Contributor harmless
+for any liability incurred by, or claims asserted against such Contributor by
+the fact You have accepted any warranty or additional liability.
+
+10. Acceptance of the Licence
+
+The provisions of this Licence can be accepted by clicking on an icon ‘I agree’
+placed under the bottom of a window displaying the text of this Licence or by
+affirming consent in any other similar way, in accordance with the rules of
+applicable law. Clicking on that icon indicates your clear and irrevocable
+acceptance of this Licence and all of its terms and conditions.
+
+Similarly, you irrevocably accept this Licence and all of its terms and
+conditions by exercising any rights granted to You by Article 2 of this Licence,
+such as the use of the Work, the creation by You of a Derivative Work or the
+Distribution or Communication by You of the Work or copies thereof.
+
+11. Information to the public
+
+In case of any Distribution or Communication of the Work by means of electronic
+communication by You (for example, by offering to download the Work from a
+remote location) the distribution channel or media (for example, a website) must
+at least provide to the public the information requested by the applicable law
+regarding the Licensor, the Licence and the way it may be accessible, concluded,
+stored and reproduced by the Licensee.
+
+12. Termination of the Licence
+
+The Licence and the rights granted hereunder will terminate automatically upon
+any breach by the Licensee of the terms of the Licence.
+
+Such a termination will not terminate the licences of any person who has
+received the Work from the Licensee under the Licence, provided such persons
+remain in full compliance with the Licence.
+
+13. Miscellaneous
+
+Without prejudice of Article 9 above, the Licence represents the complete
+agreement between the Parties as to the Work.
+
+If any provision of the Licence is invalid or unenforceable under applicable
+law, this will not affect the validity or enforceability of the Licence as a
+whole. Such provision will be construed or reformed so as necessary to make it
+valid and enforceable.
+
+The European Commission may publish other linguistic versions or new versions of
+this Licence or updated versions of the Appendix, so far this is required and
+reasonable, without reducing the scope of the rights granted by the Licence. New
+versions of the Licence will be published with a unique version number.
+
+All linguistic versions of this Licence, approved by the European Commission,
+have identical value. Parties can take advantage of the linguistic version of
+their choice.
+
+14. Jurisdiction
+
+Without prejudice to specific agreement between parties,
+
+- any litigation resulting from the interpretation of this License, arising
+  between the European Union institutions, bodies, offices or agencies, as a
+  Licensor, and any Licensee, will be subject to the jurisdiction of the Court
+  of Justice of the European Union, as laid down in article 272 of the Treaty on
+  the Functioning of the European Union,
+
+- any litigation arising between other parties and resulting from the
+  interpretation of this License, will be subject to the exclusive jurisdiction
+  of the competent court where the Licensor resides or conducts its primary
+  business.
+
+15. Applicable Law
+
+Without prejudice to specific agreement between parties,
+
+- this Licence shall be governed by the law of the European Union Member State
+  where the Licensor has his seat, resides or has his registered office,
+
+- this licence shall be governed by Belgian law if the Licensor has no seat,
+  residence or registered office inside a European Union Member State.
+
+Appendix
+
+‘Compatible Licences’ according to Article 5 EUPL are:
+
+- GNU General Public License (GPL) v. 2, v. 3
+- GNU Affero General Public License (AGPL) v. 3
+- Open Software License (OSL) v. 2.1, v. 3.0
+- Eclipse Public License (EPL) v. 1.0
+- CeCILL v. 2.0, v. 2.1
+- Mozilla Public Licence (MPL) v. 2
+- GNU Lesser General Public Licence (LGPL) v. 2.1, v. 3
+- Creative Commons Attribution-ShareAlike v. 3.0 Unported (CC BY-SA 3.0) for
+  works other than software
+- European Union Public Licence (EUPL) v. 1.1, v. 1.2
+- Québec Free and Open-Source Licence — Reciprocity (LiLiQ-R) or Strong
+  Reciprocity (LiLiQ-R+).
+
+The European Commission may update this Appendix to later versions of the above
+licences without producing a new version of the EUPL, as long as they provide
+the rights granted in Article 2 of this Licence and protect the covered Source
+Code from exclusive appropriation.
+
+All other changes or additions to this Appendix require the production of a new
+EUPL version.

msnoisedb-0.1.4/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: msnoisedb
+Version: 0.1.4
+Summary: The database minion for MSNoise — a self-contained, user-run PostgreSQL server
+Author-email: Thomas Lecocq & MSNoise dev team <Thomas.Lecocq@seismology.be>
+License: EUPL-1.1
+Project-URL: Homepage, http://www.msnoise.org
+Project-URL: Repository, https://github.com/ROBelgium/msnoise-db
+Project-URL: Bug Tracker, https://github.com/ROBelgium/msnoise-db/issues
+Keywords: noise,monitoring,seismic,velocity,change,dvv,dtt,cross-correlation,seismology,postgresql,database
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.TXT
+Requires-Dist: click
+Dynamic: license-file
+
+# MSNoise-DB CLI Tool
+
+This is a Python-based command-line interface (CLI) tool for managing a portable postgresql server for MSNoise.
+
+The tool allows you to install, start, stop, create, and drop databases.
+
+[![Github Action Status](https://github.com/ROBelgium/msnoise-db/actions/workflows/test_linux.yml/badge.svg)](https://github.com/ROBelgium/msnoise-db/actions)
+
+
+## Features
+
+- Setup PostgreSQL.
+- Start PostgreSQL server in the background (custom port by default 5099, configurable)
+- Stop PostgreSQL server.
+- Create a new database.
+- Drop an existing database.
+
+## Prerequisites
+
+- Python 3.11 or above.
+- `click` package: Install using `conda install -c conda-forge click`.
+- `postgresql` package: Install using `conda install -c conda-forge postgresql`.
+
+## Installation
+
+1. Install the code
+
+    ```sh
+    pip install git+https://github.com/ROBelgium/msnoise-db
+    ```
+
+    if your console doesn't have git, you can access the zip directly:
+
+    ```sh
+    pip install https://github.com/ROBelgium/msnoise-db/archive.master.zip
+    ```
+   
+
+3. Create a new folder to store the database data
+
+
+## Usage
+
+### Start a PostgreSQL Server (and set up if not existing)
+
+Start the PostgreSQL server in the background.
+
+```sh
+msnoisedb start
+```
+
+### Stop PostgreSQL Server
+
+Stop the running PostgreSQL server.
+
+```sh
+msnoisedb stop
+```
+
+### Create a New Database
+
+Create a new database.
+
+```sh
+msnoisedb create-db DATABASE_NAME
+```
+
+### Drop an Existing Database
+
+Drop an existing database.
+
+```sh
+msnoisedb drop-db DATABASE_NAME
+```
+
+### List databases
+
+Drop an existing database.
+
+```sh
+msnoisedb list-db
+```
+
+## Configuring an MSNoise project
+
+Create a new project database
+
+```sh
+msnoisedb create-db test_database
+```
+
+Initialise the db in msnoise:
+
+```sh
+msnoise db init
+```
+
+```sh
+Launching the init
+Welcome to MSNoise
+
+What database technology do you want to use?
+ [1] sqlite
+ [2] mysql
+ [3] postgresql
+Choice: 3
+Server: [localhost]: localhost:5099
+Database: [msnoise]: test_database
+Username: [msnoise]: msnoise
+Password (not shown as you type): msnoise
+Table prefix: []:
+Installation Done! - Go to Configuration Step!
+```
+
+
+## Notes
+
+- **Supported Platforms**: The tool is designed to work on Windows, Linux and MacOS platforms.
+
+## License
+
+This project is licensed under the EUPL License. See the [LICENSE](LICENSE.TXT) file for more details.
+
+## Acknowledgements
+
+- [Click](https://palletsprojects.com/p/click/) for creating powerful command-line interfaces.

msnoisedb-0.1.4/README.md

@@ -0,0 +1,126 @@
+# MSNoise-DB CLI Tool
+
+This is a Python-based command-line interface (CLI) tool for managing a portable postgresql server for MSNoise.
+
+The tool allows you to install, start, stop, create, and drop databases.
+
+[![Github Action Status](https://github.com/ROBelgium/msnoise-db/actions/workflows/test_linux.yml/badge.svg)](https://github.com/ROBelgium/msnoise-db/actions)
+
+
+## Features
+
+- Setup PostgreSQL.
+- Start PostgreSQL server in the background (custom port by default 5099, configurable)
+- Stop PostgreSQL server.
+- Create a new database.
+- Drop an existing database.
+
+## Prerequisites
+
+- Python 3.11 or above.
+- `click` package: Install using `conda install -c conda-forge click`.
+- `postgresql` package: Install using `conda install -c conda-forge postgresql`.
+
+## Installation
+
+1. Install the code
+
+    ```sh
+    pip install git+https://github.com/ROBelgium/msnoise-db
+    ```
+
+    if your console doesn't have git, you can access the zip directly:
+
+    ```sh
+    pip install https://github.com/ROBelgium/msnoise-db/archive.master.zip
+    ```
+   
+
+3. Create a new folder to store the database data
+
+
+## Usage
+
+### Start a PostgreSQL Server (and set up if not existing)
+
+Start the PostgreSQL server in the background.
+
+```sh
+msnoisedb start
+```
+
+### Stop PostgreSQL Server
+
+Stop the running PostgreSQL server.
+
+```sh
+msnoisedb stop
+```
+
+### Create a New Database
+
+Create a new database.
+
+```sh
+msnoisedb create-db DATABASE_NAME
+```
+
+### Drop an Existing Database
+
+Drop an existing database.
+
+```sh
+msnoisedb drop-db DATABASE_NAME
+```
+
+### List databases
+
+Drop an existing database.
+
+```sh
+msnoisedb list-db
+```
+
+## Configuring an MSNoise project
+
+Create a new project database
+
+```sh
+msnoisedb create-db test_database
+```
+
+Initialise the db in msnoise:
+
+```sh
+msnoise db init
+```
+
+```sh
+Launching the init
+Welcome to MSNoise
+
+What database technology do you want to use?
+ [1] sqlite
+ [2] mysql
+ [3] postgresql
+Choice: 3
+Server: [localhost]: localhost:5099
+Database: [msnoise]: test_database
+Username: [msnoise]: msnoise
+Password (not shown as you type): msnoise
+Table prefix: []:
+Installation Done! - Go to Configuration Step!
+```
+
+
+## Notes
+
+- **Supported Platforms**: The tool is designed to work on Windows, Linux and MacOS platforms.
+
+## License
+
+This project is licensed under the EUPL License. See the [LICENSE](LICENSE.TXT) file for more details.
+
+## Acknowledgements
+
+- [Click](https://palletsprojects.com/p/click/) for creating powerful command-line interfaces.

msnoisedb-0.1.4/msnoise_db/__init__.py

@@ -0,0 +1,7 @@
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("msnoise-db")
+except PackageNotFoundError:
+    # Package not installed (e.g. running from source without pip install -e .)
+    __version__ = "unknown"

msnoisedb-0.1.4/msnoise_db/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.4'
+__version_tuple__ = version_tuple = (0, 1, 4)
+
+__commit_id__ = commit_id = 'gbf2f8b430'

msnoisedb-0.1.4/msnoise_db/cli.py

@@ -0,0 +1,274 @@
+#!/usr/bin/env python3
+import click
+import os
+import subprocess
+import sys
+import time
+from pathlib import Path
+
+
+class PostgresManager:
+    def __init__(self, data_dir=None, port=5099, host='localhost'):
+        self.data_dir = data_dir and Path(data_dir) or Path.cwd() / 'postgres_data'
+        self.port = port
+        self.host = host
+        self.data_dir.parent.mkdir(parents=True, exist_ok=True)
+
+    def init_db(self):
+        """Initialize PostgreSQL data directory if it doesn't exist."""
+        if not (self.data_dir / 'PG_VERSION').exists():
+            click.echo(f"Initializing PostgreSQL data directory at {self.data_dir}")
+            subprocess.run(['initdb', '-D', str(self.data_dir)], check=True)
+
+            # Modify pg_hba.conf to allow password authentication
+            hba_path = self.data_dir / 'pg_hba.conf'
+            with open(hba_path, 'a') as f:
+                f.write("\n# MSNoise user authentication\n")
+                f.write("host    all             msnoise         127.0.0.1/32            md5\n")
+                f.write("host    all             msnoise         ::1/128                 md5\n")
+                f.write("host    all             msnoise         localhost               md5\n")
+            # Configure postgresql.conf for high number of connections
+            conf_path = self.data_dir / 'postgresql.conf'
+            click.echo("Configuring postgresql.conf for 1000 connections")
+            with open(conf_path, 'a') as f:
+                f.write("\n# MSNoise custom settings\n")
+                f.write("max_connections = 1000\n")
+                f.write("shared_buffers = 256MB\n")  # Increased for many connections
+                f.write("listen_addresses = '*'\n")  # Listen on all interfaces
+
+    def create_msnoise_user(self):
+        """Create msnoise user with password if it doesn't exist."""
+        try:
+            # Create a temporary script to create user
+            create_user_sql = """
+            DO
+            $do$
+            BEGIN
+               IF NOT EXISTS (SELECT FROM pg_catalog.pg_roles WHERE rolname = 'msnoise') THEN
+                  CREATE USER msnoise WITH PASSWORD 'msnoise';
+               END IF;
+            END
+            $do$;
+            ALTER USER msnoise CREATEDB;
+            """
+
+            # Use psql to execute the SQL
+            process = subprocess.Popen(
+                ['psql', '-p', str(self.port), '-h', self.host, 'postgres'],
+                stdin=subprocess.PIPE,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE
+            )
+            process.communicate(input=create_user_sql.encode())
+
+            if process.returncode == 0:
+                click.echo("MSNoise user created/verified successfully")
+            else:
+                click.echo("Failed to create MSNoise user", err=True)
+
+        except subprocess.CalledProcessError as e:
+            click.echo(f"Failed to create MSNoise user: {e}", err=True)
+            sys.exit(1)
+
+    def start_server(self):
+        """Start PostgreSQL server."""
+        if self.is_server_running():
+            click.echo(f"PostgreSQL server is already running on port {self.port}")
+            return
+
+        self.init_db()
+
+        cmd = [
+            'pg_ctl', 'start',
+            '-D', str(self.data_dir),
+            '-o', f'-p {self.port} -h {self.host}',
+            '-l', str(self.data_dir / 'postgres.log')
+        ]
+
+        try:
+            subprocess.run(cmd, check=True)
+            time.sleep(2)  # Wait for server to start
+            click.echo(f"PostgreSQL server started on {self.host}:{self.port}")
+
+            # Create msnoise user after server starts
+            self.create_msnoise_user()
+
+        except subprocess.CalledProcessError as e:
+            click.echo(f"Failed to start PostgreSQL server: {e}", err=True)
+            sys.exit(1)
+
+    def stop_server(self):
+        """Stop PostgreSQL server."""
+        if not self.is_server_running():
+            click.echo("PostgreSQL server is not running")
+            return
+
+        cmd = ['pg_ctl', 'stop', '-D', str(self.data_dir)]
+        try:
+            subprocess.run(cmd, check=True)
+            click.echo("PostgreSQL server stopped")
+        except subprocess.CalledProcessError as e:
+            click.echo(f"Failed to stop PostgreSQL server: {e}", err=True)
+            sys.exit(1)
+
+    def create_database(self, db_name):
+        """Create a new database."""
+        if not self.is_server_running():
+            click.echo("PostgreSQL server is not running. Please start it first.", err=True)
+            return
+
+        try:
+            # Create database owned by msnoise user
+            subprocess.run([
+                'createdb',
+                '-p', str(self.port),
+                '-h', self.host,
+                '-O', 'msnoise',
+                db_name
+            ], check=True)
+            click.echo(f"Database '{db_name}' created successfully (owned by msnoise)")
+        except subprocess.CalledProcessError as e:
+            click.echo(f"Failed to create database: {e}", err=True)
+            sys.exit(1)
+
+    def drop_database(self, db_name):
+        """Drop an existing database."""
+        if not self.is_server_running():
+            click.echo("PostgreSQL server is not running. Please start it first.", err=True)
+            return
+
+        try:
+            subprocess.run([
+                'dropdb',
+                '-p', str(self.port),
+                '-h', self.host,
+                db_name
+            ], check=True)
+            click.echo(f"Database '{db_name}' dropped successfully")
+        except subprocess.CalledProcessError as e:
+            click.echo(f"Failed to drop database: {e}", err=True)
+            sys.exit(1)
+
+    def list_databases(self):
+        """List all databases."""
+        if not self.is_server_running():
+            click.echo("PostgreSQL server is not running. Please start it first.", err=True)
+            return
+
+        try:
+            result = subprocess.run(
+                ['psql', '-p', str(self.port), '-h', self.host,
+                 '-U', 'msnoise', '-l', ],
+                check=True,
+                capture_output=True,
+                text=True,
+                env={**os.environ, 'PGPASSWORD': 'msnoise'}
+            )
+            click.echo("Available databases:")
+            click.echo(result.stdout)
+        except subprocess.CalledProcessError as e:
+            click.echo(f"Failed to list databases: {e}", err=True)
+            if e.stderr:
+                click.echo(e.stderr, err=True)
+            sys.exit(1)
+
+    def is_server_running(self):
+        """Check if PostgreSQL server is running."""
+        try:
+            subprocess.run(
+                ['pg_ctl', 'status', '-D', str(self.data_dir)],
+                check=True,
+                capture_output=True
+            )
+            return True
+        except subprocess.CalledProcessError:
+            return False
+
+
+# Shared options for all commands
+def common_options(f):
+    f = click.option('--port', default=5099, help='Port number (default: 5099)')(f)
+    f = click.option('--host', default='localhost', help='Listen address (default: localhost)')(f)
+    f = click.option('--data-dir', type=click.Path(), help='Custom data directory path')(f)
+    return f
+
+
+@click.group()
+def cli():
+    """PostgreSQL Server Management CLI for MSNoise
+
+    This CLI tool manages a PostgreSQL server instance configured for MSNoise,
+    with automatic user creation (msnoise:msnoise) and appropriate permissions.
+    """
+    pass
+
+
+@cli.command()
+@common_options
+def start(port, host, data_dir):
+    """Start PostgreSQL server with MSNoise user configuration"""
+    pg_manager = PostgresManager(
+        data_dir=data_dir and Path(data_dir),
+        port=port,
+        host=host
+    )
+    pg_manager.start_server()
+
+
+@cli.command()
+@common_options
+def stop(port, host, data_dir):
+    """Stop PostgreSQL server"""
+    pg_manager = PostgresManager(
+        data_dir=data_dir and Path(data_dir),
+        port=port,
+        host=host
+    )
+    pg_manager.stop_server()
+
+
+@cli.command()
+@click.argument('db_name')
+@common_options
+def create_db(db_name, port, host, data_dir):
+    """Create a new database owned by msnoise user"""
+    pg_manager = PostgresManager(
+        data_dir=data_dir and Path(data_dir),
+        port=port,
+        host=host
+    )
+    pg_manager.create_database(db_name)
+
+
+@cli.command()
+@common_options
+def list_db(port, host, data_dir):
+    """List all databases"""
+    pg_manager = PostgresManager(
+        data_dir=data_dir and Path(data_dir),
+        port=port,
+        host=host
+    )
+    pg_manager.list_databases()
+
+
+@cli.command()
+@click.argument('db_name')
+@common_options
+def drop_db(db_name, port, host, data_dir):
+    """Drop an existing database"""
+    pg_manager = PostgresManager(
+        data_dir=data_dir and Path(data_dir),
+        port=port,
+        host=host
+    )
+    pg_manager.drop_database(db_name)
+
+
+
+def run():
+    cli(obj={})
+
+
+if __name__ == '__main__':
+    run()

msnoisedb-0.1.4/msnoisedb.egg-info/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: msnoisedb
+Version: 0.1.4
+Summary: The database minion for MSNoise — a self-contained, user-run PostgreSQL server
+Author-email: Thomas Lecocq & MSNoise dev team <Thomas.Lecocq@seismology.be>
+License: EUPL-1.1
+Project-URL: Homepage, http://www.msnoise.org
+Project-URL: Repository, https://github.com/ROBelgium/msnoise-db
+Project-URL: Bug Tracker, https://github.com/ROBelgium/msnoise-db/issues
+Keywords: noise,monitoring,seismic,velocity,change,dvv,dtt,cross-correlation,seismology,postgresql,database
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.TXT
+Requires-Dist: click
+Dynamic: license-file
+
+# MSNoise-DB CLI Tool
+
+This is a Python-based command-line interface (CLI) tool for managing a portable postgresql server for MSNoise.
+
+The tool allows you to install, start, stop, create, and drop databases.
+
+[![Github Action Status](https://github.com/ROBelgium/msnoise-db/actions/workflows/test_linux.yml/badge.svg)](https://github.com/ROBelgium/msnoise-db/actions)
+
+
+## Features
+
+- Setup PostgreSQL.
+- Start PostgreSQL server in the background (custom port by default 5099, configurable)
+- Stop PostgreSQL server.
+- Create a new database.
+- Drop an existing database.
+
+## Prerequisites
+
+- Python 3.11 or above.
+- `click` package: Install using `conda install -c conda-forge click`.
+- `postgresql` package: Install using `conda install -c conda-forge postgresql`.
+
+## Installation
+
+1. Install the code
+
+    ```sh
+    pip install git+https://github.com/ROBelgium/msnoise-db
+    ```
+
+    if your console doesn't have git, you can access the zip directly:
+
+    ```sh
+    pip install https://github.com/ROBelgium/msnoise-db/archive.master.zip
+    ```
+   
+
+3. Create a new folder to store the database data
+
+
+## Usage
+
+### Start a PostgreSQL Server (and set up if not existing)
+
+Start the PostgreSQL server in the background.
+
+```sh
+msnoisedb start
+```
+
+### Stop PostgreSQL Server
+
+Stop the running PostgreSQL server.
+
+```sh
+msnoisedb stop
+```
+
+### Create a New Database
+
+Create a new database.
+
+```sh
+msnoisedb create-db DATABASE_NAME
+```
+
+### Drop an Existing Database
+
+Drop an existing database.
+
+```sh
+msnoisedb drop-db DATABASE_NAME
+```
+
+### List databases
+
+Drop an existing database.
+
+```sh
+msnoisedb list-db
+```
+
+## Configuring an MSNoise project
+
+Create a new project database
+
+```sh
+msnoisedb create-db test_database
+```
+
+Initialise the db in msnoise:
+
+```sh
+msnoise db init
+```
+
+```sh
+Launching the init
+Welcome to MSNoise
+
+What database technology do you want to use?
+ [1] sqlite
+ [2] mysql
+ [3] postgresql
+Choice: 3
+Server: [localhost]: localhost:5099
+Database: [msnoise]: test_database
+Username: [msnoise]: msnoise
+Password (not shown as you type): msnoise
+Table prefix: []:
+Installation Done! - Go to Configuration Step!
+```
+
+
+## Notes
+
+- **Supported Platforms**: The tool is designed to work on Windows, Linux and MacOS platforms.
+
+## License
+
+This project is licensed under the EUPL License. See the [LICENSE](LICENSE.TXT) file for more details.
+
+## Acknowledgements
+
+- [Click](https://palletsprojects.com/p/click/) for creating powerful command-line interfaces.

msnoisedb-0.1.4/msnoisedb.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+.gitignore
+LICENSE.TXT
+README.md
+pyproject.toml
+.github/dependabot.yml
+.github/environment.yml
+.github/workflows/publish.yml
+.github/workflows/test_linux.yml
+msnoise_db/__init__.py
+msnoise_db/_version.py
+msnoise_db/cli.py
+msnoisedb.egg-info/PKG-INFO
+msnoisedb.egg-info/SOURCES.txt
+msnoisedb.egg-info/dependency_links.txt
+msnoisedb.egg-info/entry_points.txt
+msnoisedb.egg-info/requires.txt
+msnoisedb.egg-info/top_level.txt

msnoisedb-0.1.4/msnoisedb.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

msnoisedb-0.1.4/msnoisedb.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+msnoisedb = msnoise_db.cli:run

msnoisedb-0.1.4/msnoisedb.egg-info/requires.txt

@@ -0,0 +1 @@
+click

msnoisedb-0.1.4/msnoisedb.egg-info/top_level.txt

@@ -0,0 +1 @@
+msnoise_db

msnoisedb-0.1.4/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=64", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "msnoisedb"
+dynamic = ["version"]
+description = "The database minion for MSNoise — a self-contained, user-run PostgreSQL server"
+readme = "README.md"
+license = { text = "EUPL-1.1" }
+authors = [
+    { name = "Thomas Lecocq & MSNoise dev team", email = "Thomas.Lecocq@seismology.be" }
+]
+requires-python = ">=3.10"
+keywords = [
+    "noise", "monitoring", "seismic", "velocity", "change",
+    "dvv", "dtt", "cross-correlation", "seismology", "postgresql", "database"
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Physics",
+]
+dependencies = [
+    "click",
+]
+
+[project.urls]
+Homepage = "http://www.msnoise.org"
+Repository = "https://github.com/ROBelgium/msnoise-db"
+"Bug Tracker" = "https://github.com/ROBelgium/msnoise-db/issues"
+
+[project.scripts]
+msnoisedb = "msnoise_db.cli:run"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["msnoise_db*"]
+
+[tool.setuptools_scm]
+# Writes the version into msnoise_db/_version.py at build time.
+# The installed package reads it from there via importlib.metadata.
+write_to = "msnoise_db/_version.py"
+version_scheme = "guess-next-dev"
+local_scheme = "no-local-version"   # keeps TestPyPI uploads clean (no +local suffix)

msnoisedb-0.1.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+