a free (libre) open source, mobile OS for Ethereum https://status.im
Go to file
Icaro Motta 5d1e1f8005
Make integration tests more enjoyable to use (#19025)
This commit brings numerous improvements to integration tests. The next step
will be to apply the same improvements to contract tests.

Fixes https://github.com/status-im/status-mobile/issues/18676

Improvements:

- Setting up the application and logged account per test is now done with an
  async test fixture, which is a very idiomatic way to solve this problem. No
  need anymore to write macros to wrap day8.re-frame.test/wait-for. The macros
  in test-helpers.integration will be removed once we apply the same
  improvements to contract tests.
- Integration test timeouts can be controlled per test, with a configurable,
  global default (60s).
- Now the integration test suite will fail-fast by default, i.e. a test failure
  short-circuits the entire suite immediately. This option can be overridden on
  a test-by-test basis. This improvement is very useful when investigating
  failures because the error will be shown on the spot, with no need to search
  backwards across lots of logs.
- Noisy messages from re-frame can be silenced with a test fixture. We can
  silence even more in the future if we remove the hardcoded printf call from
  C++ on every signal and control it with Clojure. We can disable most logs as
  well with the more direct (status-im.common.log/setup "ERROR") at the top of
  tests.integration-test.core. We can make verbosity even more convenient to
  control, but I think this should be designed outside this PR.
- Removed dependency on lib day8.re-frame/test for integration tests (see
  detailed explanation below).
- Each call to (our) wait-for can customize the timeout to process re-frame
  event IDs passed to it.
- Syntax is now flat, instead of being nested on every call to wait-for. You
  can now compose other async operations anywhere in a test.

Notes:

- promesa.core/do is essential in the integration test suite, as it makes sync &
  async operations play nice with each other without the developer having to
  promisify anything manually.
- There are lots of logs related to async storage ("unexpected token u in JSON at
  position..."). This isn't fixed yet.

Are we not going to use day8.re-frame.test?

We don't need this library in integration tests and we won't need it in contract
tests. Whether it will be useful after we remove it from integration and
contract tests is yet to be seen (probably not).

A few reasons:

- The async model of promises is well understood and battle tested. The one
  devised in the lib is poorly understood and rigid.
- There's basically no way to correctly integrate other async operations in the
  test, unless they can be fully controlled via re-frame events. For instance,
  how would you control timeouts? How would you retry in a test? How would
  forcefully delay an operation by a few seconds? These things are useful (to me
  at least) when developing integration/contract tests.
- Every call to day8.re-frame.test/wait-for forces you to nest code one more
  level. Code readability suffers from that choice.
- Have you ever looked up the implementation of wait-for? It's quite convoluted.
  One could say the source code is not that important, but many times I had to
  look it up because I couldn't understand the async model they built with their
  macro approach. The de facto primitive in JS for asynchronicity is promises,
  and we fully leverage it in this PR.
- The lib has an interesting macro run-test-sync, but we have no usage for it. I
  used it in status-mobile for a while. At one point, all event unit tests for
  the Activity Center used it (e.g. commit
  08fb0de7b0), but I replaced them with the
  simpler pure function style.
2024-03-04 22:38:42 -03:00
.clj-kondo Make integration tests more enjoyable to use (#19025) 2024-03-04 22:38:42 -03:00
.dependabot [Fixes: #11518] Fix dependabot directory 2020-12-07 12:14:16 +01:00
.github Adjust PR template to add before/after (#17402) 2023-09-25 13:42:37 +03:00
.lsp chore: add lsp clean-ns in lint-fix (#17661) 2023-10-18 00:17:43 +08:00
.vscode Document how to auto-format Clojure files in VSCode with zprint (#17719) 2023-10-25 23:19:56 -03:00
android chore: remove hermes enable condition (#18723) 2024-02-06 16:57:05 +05:30
ci ci: cleanup more build artifacts 2024-02-28 15:50:47 +01:00
doc UI components coding guidelines (#18926) 2024-02-23 18:30:46 +01:00
fastlane chore: update ios/logs to logs dir (#18974) 2024-02-27 14:21:30 +05:30
ios Fix statusbar color on dark screens (#18785) 2024-02-28 18:53:13 +02:00
logs chore: update ios/logs to logs dir (#18974) 2024-02-27 14:21:30 +05:30
maestro init: maestro dev automation (#18712) 2024-02-06 23:29:35 +05:30
modules/react-native-status feat: new keypair: mnemonic, address, KP name screen (#18790) 2024-02-21 15:53:14 +04:00
nix Add Promesa to simplify working with promises (#18767) 2024-03-04 13:59:52 +02:00
resources feat(quo): implement wallet - input amount component (#18687) 2024-02-12 07:36:23 -08:00
scripts fix: make run-ios-device script (#18845) 2024-02-20 10:54:09 +05:30
src Make integration tests more enjoyable to use (#19025) 2024-03-04 22:38:42 -03:00
test e2e: updated method for a profile picture changing 2024-02-29 02:25:59 +02:00
test-resources Update prettier config for the project. (#16303) 2023-06-19 19:09:12 +05:30
translations feat: update transaction confirmation page to support bridging transactions (#18887) 2024-03-01 16:26:45 -03:00
.buckconfig
.carve_ignore FINAL BOSS! rename status-im2 to status-im (#18241) 2023-12-19 20:59:07 +01:00
.dockerignore Create Nix package for building status-go 2019-04-09 12:44:39 +02:00
.env [#18961] feat: add new contact profile skeleton (#19001) 2024-02-28 15:02:24 +03:00
.env.e2e Add method for fast creation of communities (#16806) 2023-08-03 08:59:28 +08:00
.env.jenkins Add method for fast creation of communities (#16806) 2023-08-03 08:59:28 +08:00
.env.nightly Add method for fast creation of communities (#16806) 2023-08-03 08:59:28 +08:00
.env.release Remove options to create community from mobile from release and nightly builds (#17495) 2023-10-04 15:12:16 +05:30
.envrc Add login integration test 2022-06-08 13:43:32 +01:00
.eslintrc.js upgrade react-native to 0.72.5 (#17241) 2023-12-11 21:22:23 +05:30
.flowconfig RN 63 and xcode12 2021-01-14 09:41:38 +01:00
.gitattributes Desktop branch merged into develop (#5266) 2018-07-23 18:21:31 +03:00
.gitignore fix: make run-ios-device script (#18845) 2024-02-20 10:54:09 +05:30
.mailmap fix my name 2019-02-28 14:50:42 +01:00
.nycrc move status-im under legacy (#18237) 2023-12-19 18:41:30 +01:00
.prettierignore feat: lint direct require quo component outside src/quo (#17828) 2023-11-07 10:21:58 +08:00
.prettierrc.js Update prettier config for the project. (#16303) 2023-06-19 19:09:12 +05:30
.watchmanconfig Ensure shell.nix uses same nixpkgs as the rest of the environment 2019-06-20 09:18:24 -04:00
.zprintrc Make integration tests more enjoyable to use (#19025) 2024-03-04 22:38:42 -03:00
LICENSE.md
Makefile Fix: only run unit tests in test-unit target (#18947) 2024-02-28 09:51:53 -03:00
README.md chore: fix few outdated things in docs & readme (#18920) 2024-02-22 00:17:09 +05:30
RELEASES.md rename quo2 (#17660) 2023-10-17 17:27:18 +02:00
VERSION Bump release to 1.25.0 (#17247) 2023-09-11 14:42:15 +01:00
app.json Lint and fix missing trailing newlines (#16445) 2023-07-04 19:40:13 +00:00
babel.config.js upgrade react-native to 0.72.5 (#17241) 2023-12-11 21:22:23 +05:30
binding.gyp Add status-go tests 2022-05-25 17:59:02 +01:00
default.nix nix: minor cleanup and documentation updates 2020-06-05 14:49:34 +02:00
index.js Update prettier config for the project. (#16303) 2023-06-19 19:09:12 +05:30
metro.config.js upgrade react-native to 0.72.5 (#17241) 2023-12-11 21:22:23 +05:30
package.json Replace unmaintained biometrics package (#18531) 2024-01-29 13:33:46 +02:00
react-native.config.js upgrade react-native to 0.72.5 (#17241) 2023-12-11 21:22:23 +05:30
shadow-cljs.edn Add Promesa to simplify working with promises (#18767) 2024-03-04 13:59:52 +02:00
shell.nix nix: minor cleanup and documentation updates 2020-06-05 14:49:34 +02:00
status-go-version.json chore: bump status-go version to v0.176.2 (#19036) 2024-02-28 20:42:10 +05:30
supervisord.conf Add docker-compose for development build 2018-04-11 14:58:38 +01:00
yarn.lock Replace unmaintained biometrics package (#18531) 2024-01-29 13:33:46 +02:00

README.md

Status - a Mobile Ethereum Operating System

Get it on Google Play Get it on F-Droid

Get it on Github

Join us in creating a browser, messenger, and gateway to a decentralized world. Status is a free (libre) open source mobile client targeting Android & iOS built entirely on Ethereum technologies. That's right, no middlemen and go-ethereum running directly on your device.

Getting started with Status

Why?

We believe in a medium of pure free trade, economies with fair, permission-less access and a world without intermediaries. We want to create policies that can exist between friends or scale globally, we want to communicate securely and be uninhibited by legacy systems.

We want to take responsibility for our data, and the way we conduct ourselves privately and promote this way of life to a mass audience.

We want deep insights into our own economies so we can make informed, data-driven decisions on how to make our lives better. The Ethereum blockchain, Smart Contracts, Swarm and Whisper provide us with a path forward.

If this interests you, help us make Status a reality - anyone can contribute and we need everyone at any skill level to participate.

How to Contribute?

Go straight to the docs and choose what interests you:

  • Developer Developers are the heart of software and to keep Status beating we need all the help we can get! If you're looking to code in ClojureScript or Golang then Status is the project for you! We use React Native and there is even some Java/Objective-C too! Want to learn more about it? Start by reading our Developer Introduction which guides you through the technology stack and start browsing beginner issues. Then you can read how to Build Status, which talks about managing project dependencies, coding guidelines and testing procedures. Check out our coding guidelines.

  • Community Management Metcalfe's law states that the value of a network is proportional to the square of the number of connected users of the system - without community Status is meaningless. We're looking to create a positive, fun environment to explore new ideas, experiment and grow the Status community. Building a community takes a lot of work but the people you'll meet and the long-lasting relationships you form will be well worth it, check out our Mission and Community Principles

  • Specification / Documentation John Dewey once said, "Education is not preparation for life; education is life itself ". Developers and Designers need guidance and it all starts from documentation and specifications. Our software is only as good as its documentation, check out our docs and see how you can improve what we have.

  • Blog Writing Content is King, keeping our blog up to date and informing the community of news helps keep everyone on the same page.

  • Testers It's bug-hunting season! Status is currently under active development and there is sure to be a bunch of learning, build status from scratch or if an android user checks out our nightly builds. You can shake your phone to submit bug reports, or start browsing our Github Issues. Every bug you find brings Status closer to stable, usable software for everyone to enjoy!

  • Security Status is a visual interface to make permanent changes on the Blockchain, it handles crypto-tokens that have real value and allows 3rd party code execution. Security is paramount to its success. You are given permission to break Status as hard as you can, as long as you share your findings with the community!

  • Evangelism Help us spread the word! Tell a friend right now, in fact, tell everyone - yell from a mountain if you have to, every person counts! If you've got a great story to tell or have some interesting way you've spread the word about Status let us know about it in our chat

Give me Binaries!

You can get our Beta builds for both Android and iOS on our website, through our nightly builds, or by building it yourself.

Core Contributors

Core Team Members

Special thanks to @adrian-tiberius. Without the dedication of these outstanding individuals, Status would not exist.

Contact us

Feel free to email us at support@status.im.

License

Licensed under the Mozilla Public License v2.0