2018-01-24 04:30:59 +05:30
# activity
`go get github.com/go-fed/activity`
2019-02-24 20:57:02 +05:30
This repository contains two libraries and a tool:
2018-01-24 04:30:59 +05:30
2019-02-24 20:57:02 +05:30
* `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-19 22:09:54 +05:30
2018-01-24 04:30:59 +05:30
## Status
2019-02-24 20:57:02 +05:30
**Preview (unstable) 1.0.0** ([Semantic Versioning](https://semver.org/))
2018-04-05 00:02:55 +05:30
2018-08-19 21:56:02 +05:30
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 02:53:46 +05:30
2018-08-19 21:56:02 +05:30
Previous unofficial implementation reports are available in [issue #46 ](https://github.com/go-fed/activity/issues/46 ).
2018-06-14 02:53:46 +05:30
Please see CHANGELOG for changes between versions.
## Getting Started
2018-04-05 00:02:55 +05:30
2019-02-24 20:57:02 +05:30
See `astool` , `streams` , or `pub` for their own README.
2018-04-05 00:02:55 +05:30
2018-06-14 02:53:46 +05:30
## How can I get help, file issues, or contribute?
Please see the CONTRIBUTING.md file!
2018-05-31 03:18:34 +05:30
## How well tested are these libraries?
2018-04-05 00:02:55 +05:30
2018-05-31 03:18:34 +05:30
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 00:02:55 +05:30
2019-02-24 20:57:02 +05:30
**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 03:18:34 +05:30
## Who is using this library currently?
2018-08-19 21:50:58 +05:30
| Application | Description | Repository | Point Of Contact | Homepage |
|:-----------:|:-------------------------------------------------:|:--------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------:|:------------------------------------:|
2018-11-17 21:11:00 +05:30
| 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 03:18:34 +05:30
## How do I use these libraries?
2018-04-05 00:02:55 +05:30
2019-02-24 20:57:02 +05:30
Please see each subdirectory for its own README for further elaboration.
2018-04-05 00:02:55 +05:30
## FAQ
2018-06-14 02:53:46 +05:30
Please see the CONTRIBUTING.md file!
2018-01-24 04:30:59 +05:30
## 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-24 20:57:02 +05:30
Thanks to those who have been early adopters with v0 and/or provided early
feedback.