ShitLib 4.0.0

ShitLib 4.0.0

Maintained by Cristina De Rito.

ShitLib 4.0.0

  • By
  • artemisia-absynthium

ShitLib (oh Shit!)

Build Status License Platform Codacy Badge Version Carthage compatible Swift Package Manager compatible Join the chat at



ShitLib is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'ShitLib', '~> 4.0'


ShitLib is compatible with Carthage. To use it, add the following line to your Cartfile:

github "ShitLib/shitlib-swift" ~> 4.0.0

Swift Package Manager

ShitLib is compatible with Swift Package Manager. To use it, add the following as a dependency to your Package.swift file:

.package(url: "", .upToNextMajor(from: "4.0.0"))


iOS 8.0
OS X 10.9
tvOS 9.0
watchOS 2.0

The only library you hope to remove!

The library that helps you remember about things done bad. With ShitLib you will be always aware of the shitty code inside your application.


Are you writing unwanted code, antipatterns, magic numbers? Are you scared about what you are doing? Use ShitLib to refer your shitty code so you will remember it. How? Remove ShitLib dependency and your code will not compile anymore until you will remove all of the shitty code.

Oh your boss forced you to get the first element of a list and you know that it's wrong: you can use OhShit!

import ShitLib

class MyBeautifulClass {

    let elements: [String] = [**some elements inside**]

    func iDontWantToDoThisButWeMustReleaseASAP() {
        let element = elements[OhShit.os0] // <--- OhShit Constant
        doSomeThing(with: element)

    func doSomeThing(with element: String) {
        // anything


Maybe you are thinking where the convenience is in using this lib. It's simple, this is the most useful library when it is removed from dependencies. After doing that, your project will not compile anymore and you will be immediately aware of what to do. Fix it!

Other ways to use ShitLib? Let's give a try to the method API

import ShitLib

class MyBeautifulUnconfigurableClass {

    enum PasswordError: Error {
        case length(maxLength: Int)

    let maxPasswordSize: Int = OhShit.ohShit(7)! // I cannot parameterize now

    public func set(password: String) throws {
        if password.count > maxPasswordSize {
            throw PasswordError.length(maxLength: maxPasswordSize)


What's new?

Checkout our changelog.


ShitLib is available under the MIT license. See the LICENSE file for more info.