Pickpocket

An Android library for content provider queries with reactive streams and coroutines.

• Calendar
• Contacts
• SMS
• MMS
• Files/Media
• Call Log
• Bookmarks
• Browser History
• Settings
• Device Info
• Installed Apps
• GPS Location
• Accounts
• Dictionary

User Instructions

1. Add the maven repository to your project's build.gradle file

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

2. Add the dependency to your app's build.gradle file

dependencies {
    implementation 'com.github.evilthreads669966:pickpocket:0.2.1'
}

3. Use a pickpocket coroutine builder function to retrieve a collection of the data types you want

//flow
calendarFlow().collect { calendarEvent ->
    Log.d("PICKPOCKET", "${calendarEvent.title} - ${calendarEvent.startDate}")
}

//async
//takes android context as argument
val events = calendarAsync(this)
Log.d("ASYNC PICKPOCKET","${events.await().size}")

//producer channel
//takes android context as argument
calendarProducer(this).consumeEach { event -> Log.d("PICKPOCKET PRODUCER", event.toString()) }

//launch
calendarLaunch(this@MyService).forEach { event -> Log.d("PICKPOCKET LAUNCH", event.toString()) }

Ask a Question?

• Use Github issues
• Send an email to [email protected]

Reporting issues

Found a bug on a specific feature? Open an issue on Github issues

Contributing

SMS Backdoor is released under the Apache 2.0 license. If you would like to contribute something, or simply want to hack then this document should help you get started.

Code of Conduct

• Please refrain from using any profanity
• Please be respectful on GitHub Issues
• Have fun

Pull Requests

• Please create a branch prefixed with what you're working on.
  • FEATURE_ADDING_SOMETHING
  • BUG_FIXING_SOMETHING
  • REFACTOR_CHANGING_SOMETHING
• Once you're done with your commits to this branch hit a pull request off and I'll look at it and most likely accept it if it looks good.

Using GitHub Issues

We use GitHub issues to track bugs and enhancements.

• If you find a bug please fill out an issue report. Provide as much information as possible.
• If you think of a great idea please fill out an issue as a proposal for your idea.

Code Conventions

None of these is essential for a pull request, but they will all help. They can also be added after the original pull request but before a merge.

• We use idiomatic kotlin conventions
• Add yourself as an @author to the .kt files that you modify or create.
• Add some comments
• A few unit tests would help a lot as well -- someone has to do it.
• If you are able to provide a unit test then do.
  • Because of the types of libraries I develop often times it is hard to test.

Working with the code

If you don't have an IDE preference we would recommend that you use Android Studio

Contributors

This project exists thanks to all the people who contribute.

Talking about Pickpocket

Articles

• No articles have been written yet

License

Copyright 2019 Chris Basinger

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.