deblan-mirror/dnote
1
0
Fork 0
mirror of https://github.com/dnote/dnote synced 2026-03-14 14:35:50 +01:00
Code Issues Projects Releases Packages Wiki Activity
dnote/CONTRIBUTING.md
Sung 4a780574eb
 Upgrade dependencies (#619)
2023-02-05 13:10:45 +11:00

2.4 KiB
Raw Blame History

Contributing to Dnote

Dnote is an open source project.

Setting up

Dnote uses Vagrant to provision a consistent development environment.

Prerequisites

Run the following command from the project root. It starts the virtual machine and bootstraps the project.

vagrant up

Workflow

  • You can make changes to the source code from the host machine.
  • Any commands need to be run inside the virtual machine. You can connect to it by running vagrant ssh.
  • If you want to run tests in a WATCH mode, please do so from the host machine. We cannot watch file changes due to the limitation of file system used in a virtual machine.

Server

The server consists of the frontend web application and a web server.

Development

  • Run make dev-server to start a local server.
  • You can access the server on localhost:3000 on your machine.

Test

# Run tests for app
make test-api

# Run in watch mode
WATCH=true make test-api

Command Line Interface

Build

You can build either a development version or a production version:

# Build a development version for your platform and place it in your `PATH`.
make debug=true build-cli

# Build a production version for all platforms
make version=v0.1.0 build-cli

# Build a production version for a specific platform
# Note: You cannot cross-compile using this method because Dnote uses CGO
# and requires the OS specific headers.
GOOS=[insert OS] GOARCH=[insert arch] make version=v0.1.0 build-cli

Test

  • Run all tests for the command line interface:
make test-cli

Debug

Run Dnote with DNOTE_DEBUG=1 to print debugging statements. For instance:

DNOTE_DEBUG=1 dnote sync

Release

  • Run make version=v0.1.0 release-cli to achieve the following:
    • Build for all target platforms, create a git tag, push all tags to the repository
    • Create a release on GitHub and Dnote Homebrew tap.

Note

  • If a release is not stable,
    • disable the homebrew release by commenting out relevant code in the release script.
    • mark release as pre-release on GitHub release