gitea-client/README.md

51 lines
2.0 KiB
Markdown
Raw Permalink Normal View History

2022-05-05 16:17:54 +08:00
# Gitea::Client
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/gitea`. To experiment with that code, run `bin/console` for an interactive prompt.
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
TODO: Delete this and the text above, and describe your gem
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
## Installation
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
Add this line to your application's Gemfile:
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
```ruby
gem 'gitea-client'
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install gitea-client
## Usage
2022-04-15 15:50:33 +08:00
```ruby
require 'gitea-client'
client = Gitea::Api::Client.new({domain: YOUR_GITEA_SERVER_DOMAIN, base_url: YOUR_GITEA_API_BASE_URL, token: YOUR_TOKRN, username: YOUR_USERNAME, password: YOUR_PASSWORD})
client.get_users_search({query: {q: 'viletyy'}})
```
2022-05-05 16:17:54 +08:00
## Development
After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/viletyy/gitea-client. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/viletyy/gitea-client/blob/master/CODE_OF_CONDUCT.md).
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
## License
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
## Code of Conduct
2022-04-15 15:50:33 +08:00
2022-05-05 16:17:54 +08:00
Everyone interacting in the Gitea::Client project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/viletyy/gitea-client/blob/master/CODE_OF_CONDUCT.md).