2018-01-24 08:00:59 +09:00
# activity
`go get github.com/go-fed/activity`
2019-02-25 00:27:02 +09:00
This repository contains two libraries and a tool:
2018-01-24 08:00:59 +09:00
2019-02-25 00:27:02 +09:00
* `astool` : A linked-data aware tool to generate golang native types for any
ActivityStreams vocabulary.
* `streams` : The ActivityStreams native types generated with the `astool` .
* `pub` : ActivityPub Social Protocol (Client-to-Server or C2S) and Federating
Protocol (Server-to-Server or S2S)
2018-08-20 01:39:54 +09:00
2018-01-24 08:00:59 +09:00
## Status
2019-02-25 00:27:02 +09:00
**Preview (unstable) 1.0.0** ([Semantic Versioning](https://semver.org/))
2018-04-05 03:32:55 +09:00
2018-08-20 01:26:02 +09:00
An [official implementation report ](https://activitypub.rocks/implementation-report/ )
was last submitted for version **0.2.0** [here ](https://github.com/w3c/activitypub/issues/318 ).
2018-06-14 06:23:46 +09:00
2018-08-20 01:26:02 +09:00
Previous unofficial implementation reports are available in [issue #46 ](https://github.com/go-fed/activity/issues/46 ).
2018-06-14 06:23:46 +09:00
Please see CHANGELOG for changes between versions.
## Getting Started
2018-04-05 03:32:55 +09:00
2019-02-25 00:27:02 +09:00
See `astool` , `streams` , or `pub` for their own README.
2018-04-05 03:32:55 +09:00
2018-06-14 06:23:46 +09:00
## How can I get help, file issues, or contribute?
Please see the CONTRIBUTING.md file!
2018-05-31 06:48:34 +09:00
## How well tested are these libraries?
2018-04-05 03:32:55 +09:00
2018-05-31 06:48:34 +09:00
I took great care to add numerous tests using examples directly from
specifications, official test repositories, and my own end-to-end tests.
2018-04-05 03:32:55 +09:00
2019-02-25 00:27:02 +09:00
**v1.0.0** still has a lot of unit tests to be written. Bug fixes and small
backwards-incompatible behavior is expected before it is blessed as being
released.
2018-05-31 06:48:34 +09:00
## Who is using this library currently?
2018-08-20 01:20:58 +09:00
| Application | Description | Repository | Point Of Contact | Homepage |
|:-----------:|:-------------------------------------------------:|:--------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------:|:------------------------------------:|
2018-11-18 00:41:00 +09:00
| Anancus | Self-hosted and federated social link aggregation | [https://gitlab.com/tuxether/anancus ](https://gitlab.com/tuxether/anancus ) | [@tuxether@floss.social ](https://floss.social/@tuxether ) or [tuxether@protonmail.ch ](mailto:tuxether@protonmail.ch ) | N/A |
| WriteFreely | Simple, open-source, privacy-focused blogging platform | [https://github.com/writeas/writefreely ](https://github.com/writeas/writefreely ) | [@write_as@writing.exchange ](https://writing.exchange/@write_as ) or [hello@write.as ](mailto:hello@write.as ) | [https://writefreely.org ](https://writefreely.org ) |
| Read.as | Long-form reader built on open protocols | [https://github.com/writeas/Read.as ](https://github.com/writeas/Read.as ) | [@write_as@writing.exchange ](https://writing.exchange/@write_as ) or [hello@write.as ](mailto:hello@write.as ) | [https://read.as ](https://read.as ) |
2018-05-31 06:48:34 +09:00
## How do I use these libraries?
2018-04-05 03:32:55 +09:00
2019-02-25 00:27:02 +09:00
Please see each subdirectory for its own README for further elaboration.
2018-04-05 03:32:55 +09:00
## FAQ
2018-06-14 06:23:46 +09:00
Please see the CONTRIBUTING.md file!
2018-01-24 08:00:59 +09:00
## Useful References
* [ActivityPub Specification ](https://www.w3.org/TR/activitypub )
* [ActivityPub GitHub Repo ](https://github.com/w3c/activitypub )
* [ActivityStreams Core Specification ](https://www.w3.org/TR/activitystreams-core )
* [ActivityStreams Vocabulary Specification ](https://www.w3.org/TR/activitystreams-vocabulary )
* [ActivityStreams GitHub Repo ](https://github.com/w3c/activitystreams )
## Thanks
I would like to thank those that have worked hard to create the technologies
and standards that created the opportunity to implement this suite of
libraries.
2019-02-25 00:27:02 +09:00
Thanks to those who have been early adopters with v0 and/or provided early
feedback.