# Dart API wrapper

**URL:** <https://farmos.discourse.group/t/dart-api-wrapper/663>\
**Category:** Development\
**Created:** [February 16, 2021, 4:49am UTC](https://farmos.discourse.group/t/dart-api-wrapper/663 "2021-02-16T04:49:51Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![Kipling](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/kipling/32/377_2.png) [@Kipling](https://farmos.discourse.group/u/Kipling)\
**Post date:** [February 16, 2021, 4:49am UTC](https://farmos.discourse.group/t/dart-api-wrapper/663/1 "2021-02-16T04:49:51Z")

</div>

Hey all,

I’m thinking of starting work on a dart API wrapper for the FarmOS API. This would be a spin-off project from my [Soil Mate](https://github.com/Open-Source-Agriculture/soil_mate) app where I’d like to give the user the option to add and sync their data to their FarmOS platform.

I just want to make sure that It’s cool to use the FarmOS trademark as the package name; specifically “farm\_os” or “farmos” as snake case is the convention on the [dart package index](https://pub.dev/). I plan to license it with a LGPL 3.0 licence.

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [February 16, 2021, 4:19pm UTC](https://farmos.discourse.group/t/dart-api-wrapper/663/2 "2021-02-16T16:19:04Z")

</div>

Hi @Kipling - welcome to the farmOS forum!

Thanks for asking about this! And excited to hear about the potential integration!

Take a look at the farmOS Trademark Guidelines, specifically the section titled “Statements about compatibility, interoperability or derivation”: [farmOS Trademark Guidelines | farmOS](https://farmos.org/community/trademark/#statements-about-compatibility-interoperability-or-derivation)

> You may use the Word Marks, but not the Logos, to truthfully describe the relationship between your software and ours. Our Mark should be used after a verb or preposition that describes the relationship between your software and ours. So you may say, for example, “Bob’s software for the farmOS platform” but may not say “Bob’s farmOS software.” Some other examples that may work for you are:
> 
> - [Your software] works with farmOS software
> - [Your software] uses farmOS software
> - [Your software] is compatible with farmOS software
> - [Your software] is powered by farmOS software
> - [Your software] runs on farmOS software
> - [Your software] for use with farmOS software
> - [Your software] for farmOS software

One of the main goals of the trademark is to prevent confusion. Specifically you just want to make sure it doesn’t appear to be an “official” library supported by the farmOS maintainers, and obviously it shouldn’t confuse anyone into thinking that it is “farmOS” itself. So be sure to make that clear in your README or other project documentation.

As for the package name itself, I think it’s fine to use the name “farmos”, as long as the docs/description make it clear that it’s “unofficial”.

It does make me wonder… should farmOS have an “official” Dart library? 🙂

We have Python and JavaScript libs:

- [GitHub - farmOS/farmOS.py: A Python library for interacting with farmOS over API.](https://github.com/farmOS/farmOS.py)
- [GitHub - farmOS/farmOS.js: A JavaScript library for working with farmOS data structures and interacting with farmOS servers.](https://github.com/farmOS/farmOS.js)

---

<div class="post-metadata">

**Author:** ![Kipling](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/kipling/32/377_2.png) [@Kipling](https://farmos.discourse.group/u/Kipling)\
**Post date:** [February 16, 2021, 9:59pm UTC](https://farmos.discourse.group/t/dart-api-wrapper/663/3 "2021-02-16T21:59:34Z")

</div>

Hi @mstenta - thanks for the warm welcome.

And thanks for clearing that up for me. It’s always better to ask

> [@mstenta](#):
>
> should farmOS have an “official” Dart library?

Yes!

Flutter is great for rapid cross-platform mobile development. A FarmOS library for dart would be great as it would allow developers to punch out Apps that can be customised for a specific farm or discipline; in my case soil observations and mapping.

I’m happy for this thread to be used for continued discussions on this and of course, I’d be keen to contribute to an _official_ dart library.

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [February 22, 2021, 11:49am UTC](https://farmos.discourse.group/t/dart-api-wrapper/663/4 "2021-02-22T11:49:40Z")

</div>

Thanks @Kipling - exciting!

Have you started a Git repository for your Dart library? I suppose we could always make that “official” in the future if you were willing to maintain it.

Curious to learn more about what your immediate needs and use-cases are with the Soil Mate app! As it pertains to connecting to farmOS, but also more generally!

---

<div class="post-metadata">

**Author:** ![Kipling](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/kipling/32/377_2.png) [@Kipling](https://farmos.discourse.group/u/Kipling)\
**Post date:** [February 23, 2021, 9:22am UTC](https://farmos.discourse.group/t/dart-api-wrapper/663/5 "2021-02-23T09:22:41Z")

</div>

> [@mstenta](#):
>
> Have you started a Git repository for your Dart library?

Not yet. I will post updates here when I do (I need to find a bit of time away from my day job).

> [@mstenta](#):
>
> I suppose we could always make that “official” in the future if you were willing to maintain it.

Yeah, for sure! let’s see how we go.

---

<div class="post-metadata">

**Author:** ![jgaehring](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/jgaehring/32/927_2.png) [@jgaehring](https://farmos.discourse.group/u/jgaehring)\
**Post date:** [October 18, 2021, 1:47pm UTC](https://farmos.discourse.group/t/dart-api-wrapper/663/6 "2021-10-18T13:47:19Z")

</div>

Dart/Flutter has been popping up on my radar a lot lately, and really starting to pique my interest. I’m especially intrigued by its many compilation targets, but also the fact that the Dart VM could be used to host other languages [like the JVM does](https://www.reddit.com/r/dartlang/comments/b6hr6e/will_dart_vm_eventually_support_other_languages/) for the likes of Kotlin, Clojure, Groovy, etc.

Any recent developments with SoilLogR, @Kipling?
