1
0
mirror of https://github.com/oceanprotocol/commons.git synced 2023-03-15 18:03:00 +01:00
🏄‍♀️ Marketplace front-end and backend server to explore, download, and publish open data sets. https://commons.oceanprotocol.com
Go to file
2019-05-27 15:32:21 +02:00
.github Added GH templates 2019-04-08 16:44:03 +02:00
client remove AI For Good as category 2019-05-27 11:21:55 +02:00
scripts Fix versions vwv.y.z 2019-05-17 14:43:09 +02:00
server add range error handling 2019-05-27 15:22:01 +02:00
.dockerignore docker-compose + dockerfiles 2019-04-04 11:30:31 +02:00
.editorconfig one dev interface for client & server 2019-03-23 22:10:00 -03:00
.eslintrc one dev interface for client & server 2019-03-23 22:10:00 -03:00
.gitignore one dev interface for client & server 2019-03-23 22:10:00 -03:00
.prettierignore one dev interface for client & server 2019-03-23 22:10:00 -03:00
.prettierrc one dev interface for client & server 2019-03-23 22:10:00 -03:00
.stylelintrc one dev interface for client & server 2019-03-23 22:10:00 -03:00
.travis.yml travis fix 2019-05-06 16:40:14 +02:00
CHANGELOG.md update changelog 2019-05-27 15:32:21 +02:00
docker-compose.yml Command in compose not needed with entrypoint 2019-04-05 11:59:26 +02:00
library.json bump required component versions 2019-05-21 11:16:52 +02:00
LICENSE one dev interface for client & server 2019-03-23 22:10:00 -03:00
package-lock.json Release 0.3.2 2019-05-27 15:32:10 +02:00
package.json Release 0.3.2 2019-05-27 15:32:10 +02:00
README.md clarify changelog updating 2019-05-20 16:17:41 +02:00
tsconfig.json one dev interface for client & server 2019-03-23 22:10:00 -03:00

banner

Commons

🏄‍♀️ Marketplace front-end and backend server to explore, download, and publish open data sets. https://commons.oceanprotocol.com

Build Status Codacy Badge Codacy Badge code style: prettier js oceanprotocol css bigchaindb

Commons UI

🦑🦑🦑
This marketplace is deployed under commons.oceanprotocol.com and can be used there. Feel free to report any issues you encounter.
🦑🦑🦑


If you're a developer and want to contribute to, or want to utilize this marketplace's code in your projects, then keep on reading.

🏄 Get Started

This repo contains a client and a server, both written in TypeScript:

  • client: React app setup with squid-js, bootstrapped with Create React App
  • server: Node.js app, utilizing Express. The server provides various microservices, like remote file checking.

To spin up both, the client and the server in a watch mode for local development, execute:

npm install
npm start

Open http://localhost:3000 to view the client in the browser. The page will reload if you make edits to files in either ./client or ./server.

🏖 Remote Ocean: Nile

To make use of all the functionality, you need to connect to the Ocean network. By default, the client will connect to Ocean components running within Ocean's Nile test network remotely.

This means you need to connect with your MetaMask to the Nile network too. To do this:

  1. select Custom RPC in the network dropdown in MetaMask
  2. under New Network, enter https://nile.dev-ocean.com as the custom RPC URL
  3. Hit Save, and youre now connected to Nile

🐳 Use with Barge

If you prefer to connect to locally running components instead of remote connections to Ocean's Nile network, you can spin up barge and use a local network:

git clone git@github.com:oceanprotocol/barge.git
cd barge

./start_ocean.sh --latest --no-pleuston --local-spree-node

Modify ./client/src/config.ts to use those local connections.

👩‍🔬 Testing

Test suite is setup with Jest and react-testing-library.

To run all tests, including all linting tests:

npm test

For local development, you can start the test runners for client & server in a watch mode.

npm run test:watch

This will work for daily development but it misses the full interactivity of the test runner. If you need that, you will need to run them in individual terminal sessions:

cd client/
npm run test:watch

cd server/
npm run test:watch

Code Style

For linting and auto-formatting you can use from the root of the project:

# auto format all ts & css with eslint & stylelint
npm run lint

# auto format all ts & css with prettier, taking all configs into account
npm run format

🛳 Production

To create a production build of both, the client and the server, run from the root of the project:

npm run build

Builds the client for production to the ./client/build folder, and the server into the ./server/dist folder.

⬆️ Releases

From a clean master branch you can run any release task doing the following:

  • bumps the project version
  • creates a Git tag
  • commits and pushes everything
  • creates a GitHub release with commit messages as description

You can execute the script using {major|minor|patch} as first argument to bump the version accordingly:

  • To bump a patch version: npm run release
  • To bump a minor version: npm run release-minor
  • To bump a major version: npm run release-major

By creating the Git tag with these tasks, Travis will trigger a new Kubernetes deployment automatically aftr a successful tag build.

For the GitHub releases steps a GitHub personal access token, exported as GITHUB_TOKEN is required. Setup

Changelog

See the CHANGELOG.md file.

This file is auto-generated from commit & PR messages upon running:

npm run changelog

This will update the CHANGELOG.md file with commit messages in a nice format. Doing a release will not automatically update that changelog file. So after every release this needs to done with the above command and simply committed back into master.

For convenience, you can use this command which updates the CHANGELOG.md file, commits the result, and pushes changes to master:

npm run changelog:commit

🎁 Contributing

See the page titled "Ways to Contribute" in the Ocean Protocol documentation.

🏛 License

Copyright 2018 Ocean Protocol Foundation Ltd.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.